<commit_before>=========
Upgrading
=========


When upgrading from an older version, you might encounter some backwards
incompatibility. The ``webassets`` API is not stable yet.


In Development version
~~~~~~~~~~~~~~~~~~~~~~

- **``django_assets`` is no longer included!**
  You need to install it's package separately. See the current
  `development version <https://github.com/miracle2k/django-assets>`_.

- Some filters now run in debug mode. Specifically, there are two things that
  deserve mention:

  - ``cssrewrite`` now runs when ``debug="merge"``. This is always what is
    wanted; it was essentially a bug that this didn't happen before.

  - All kinds of compiler-style filters (Sass, less, Coffeescript, JST
    templates etc). all now run in debug mode. The presence of such a filter
    causes bundles to be merged even while ``debug=True``.

    In practice, if you've been using custom bundle ``debug`` values to get
    such compilers to run, this will continue to work. Though it can now be<commit_msg>Some additional django-assets upgrade notes.<commit_after>=========
Upgrading
=========


When upgrading from an older version, you might encounter some backwards
incompatibility. The ``webassets`` API is not stable yet.


In Development version
~~~~~~~~~~~~~~~~~~~~~~

- **``django_assets`` is no longer included!**
  You need to install it's package separately. See the current
  `development version <https://github.com/miracle2k/django-assets>`_.

  .. warning::
    When upgrading, you need to take extra care to rid yourself of the old
    version of webassets before installing the separate ``django-assets``
    package. This is to avoid that Python still finds the old ``django_assets``
    that used to be included in the ``webassets`` package.

    In some cases, even ``pip uninstall webassets`` is not be enough, and old
    ``*.pyc`` files are kept around. I recommend that you delete the old
    webassets install manually from the filesystem. To find out where it is
    stored, open a Python shell and do::

        >>> import webassets
        >>> webassets
        <module 'webassets' from '/usr/local/lib/python2.7/dist-packages/webassets/src/webassets/__init__.pyc'>

- Some filters now run in debug mode. Specifically, there are two things that
  deserve mention:

  - ``cssrewrite`` now runs when ``debug="merge"``. This is always what is
    wanted; it was essentially a bug that this didn't happen before.

  - All kinds of compiler-style filters (Sass, less, Coffeescript, JST
    templates etc). all now run in debug mode. The presence of such a filter
    causes bundles to be merged even while ``debug=True``.

    In practice, if you've been using custom bundle ``debug`` values to get
    such compilers to run, this will continue to work. Though it can now be
{'fraction_non_alphanumeric': 0.10554371002132196, 'fraction_numerical': 0.0014214641080312722, 'mean_word_length': 3.7874149659863945, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 12, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1023961', 'n_tokens_mistral': 753, 'n_tokens_neox': 719, 'n_words': 368}