Django Compressor

---

1. Basic Compressor Configuration

COMPRESS_ENABLED = True
COMPRESS_ROOT = os.path.join(BASE_DIR, 'static/')

2. Specifying Custom Compression Settings

COMPRESS_CSS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
]

3. Using the Output Filter to Optimize Output

COMPRESS_OUTPUT_FILTERS = ['compressor.filters.output.XhtmlOutputFilter']

4. Processing a Single File

from compressor.filters import default

filter = default.CssAbsoluteFilter(BASE_DIR)
css = filter.input('styles/main.css')

5. Compressing All Files

from django.core.management import call_command

call_command('compress')

6. Excluding Specific Files from Compression

COMPRESS_EXCLUDED = [
    '.*\.png$',
    '.*\.jpg$',
    '.*\.gif$',
]

7. Defining Custom Compression Rules

COMPRESS_PRECOMPILERS = (
    ('text/coffeescript',
     'coffee --compile --stdio'),
)

8. Using the `OutputFile' Filter to Control Output Location

COMPRESS_OUTPUT_FILTERS = ['compressor.filters.output.OutputFileFilter',]

9. Customizing Filter Settings

COMPRESS_YUICOMPRESSOR_BINARY = '/path/to/yuicompressor'

10. Handling Broken Source Files

COMPRESS_FAIL_SILENTLY = True

11. Compressing JavaScript Files

COMPRESS_ENABLED = True
COMPRESS_JS_FILTERS = [
    'compressor.filters.jsmin.JSMinFilter'
]

12. Using the `Autoprefixer' Filter

COMPRESS_CSS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.css_default.CssAutoprefixerFilter'
]

13. Specifying the Static Root Directory

COMPRESS_ROOT = '/path/to/static/'

14. Using the `Exclusion' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.exclusion.ExclusionFilter',
]

15. Customizing Error Reporting

COMPRESS_ERROR_MESSAGE = 'Error message to display'

16. Using the `Minify' Filter

COMPRESS_CSS_FILTERS = [
    'compressor.filters.cssmin.CSSMinFilter'
]

17. Specifying the Base URL

COMPRESS_URL = '/static/'

18. Using the `Reorder' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.reordering.ReorderFilter',
]

19. Compressing Images

COMPRESS_ENABLED = True
COMPRESS_IMAGE_FILTERS = [
    'compressor.filters.images.OptimizeImagesFilter'
]

20. Using the `Clean' Command

python manage.py compress --clean

21. Using the `Verbose' Option

python manage.py compress --verbose

22. Customizing File Names

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.filename_suffix.FilenameSuffixFilter',
]

23. Using the `Filter' Class

from compressor.filters import CssAbsoluteFilter

filter = CssAbsoluteFilter(BASE_DIR)
css = filter.input('styles/main.css')

24. Using the `Process' Command

python manage.py compress --process

25. Using the `Detect' Command

python manage.py compress --detect

26. Using the `Compiler' Class

from compressor.compiler import Compressor

compressor = Compressor()
css = compressor.compile('styles/main.css')

27. Using the `Block' Class

from compressor.blocks import Block

block = Block('script', 'scripts/main.js')

28. Using the `Compressor' Class to Process Files

from compressor.compiler import Compressor

compressor = Compressor()
css_files = ['styles/main.css', 'styles/extra.css']
css = compressor.compress_files(css_files)

29. Using the `Override' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.override.OverrideFilter',
]

30. Using the `URL' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.url.UrlFilter',
]

31. Using the `Makefile' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.makefile.MakefileFilter',
]

32. Using the `Merge' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.merge.MergeFilter',
]

33. Using the `Spaceless' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.spaceless.SpacelessFilter',
]

34. Using the `Stats' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.stats.StatsFilter',
]

35. Using the `TemplateFilter' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.template.TemplateFilter',
]

36. Using the `Timeline' Filter

COMPRESS_FILTERS = [
    'compressor.filters.css_default.CssAbsoluteFilter',
    'compressor.filters.cssmin.CSSMinFilter',
    'compressor.filters.timeline.TimelineFilter',
]