Ravenports generated: 23 Sep 2020 16:05
[ravenports.git] / bucket_5A / python-django-compressor
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-django-compressor
4 VERSION=                2.4
5 KEYWORDS=               python
6 VARIANTS=               py38 py37
7 SDESC[py37]=            Django CSS/JS cache and compressor (PY37)
8 SDESC[py38]=            Django CSS/JS cache and compressor (PY38)
9 HOMEPAGE=               https://django-compressor.readthedocs.io/en/latest/
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPI/d/django-compressor
14 DISTFILE[1]=            django_compressor-2.4.tar.gz:main
15 DF_INDEX=               1
16 SPKGS[py37]=            single
17 SPKGS[py38]=            single
18
19 OPTIONS_AVAILABLE=      PY38 PY37
20 OPTIONS_STANDARD=       none
21 VOPTS[py37]=            PY38=OFF PY37=ON
22 VOPTS[py38]=            PY38=ON PY37=OFF
23
24 DISTNAME=               django_compressor-2.4
25
26 GENERATED=              yes
27
28 [PY37].BUILDRUN_DEPENDS_ON=             python-django-appconf:single:py37
29                                         python-rcssmin:single:py37
30                                         python-rjsmin:single:py37
31                                         python-six:single:py37
32 [PY37].USES_ON=                         python:py37
33
34 [PY38].BUILDRUN_DEPENDS_ON=             python-django-appconf:single:py38
35                                         python-rcssmin:single:py38
36                                         python-rjsmin:single:py38
37                                         python-six:single:py38
38 [PY38].USES_ON=                         python:py38
39
40 [FILE:3331:descriptions/desc.single]
41 Django Compressor
42 =================
43
44 Django Compressor processes, combines and minifies linked and inline
45 Javascript or CSS in a Django template into cacheable static files.
46
47 It supports compilers such as coffeescript, LESS and SASS and is
48 extensible by custom processing steps.
49
50 Django Compressor is compatible with Django 1.11 and newer.
51
52 How it works
53 ------------
54 In your templates, all HTML code between the tags ``{% compress js/css %}
55 and
56 {% endcompress %}`` is parsed and searched for CSS or JS. These styles and
57 scripts are subsequently processed with optional, configurable compilers
58 and
59 filters.
60
61 The default filter for CSS rewrites paths to static files to be absolute.
62 Both Javascript and CSS files are by default concatenated and minified.
63
64 As the final step the template tag outputs a ``<script> or <link>``
65 tag pointing to the optimized file. Alternatively it can also
66 inline the resulting content into the original template directly.
67
68 Since the file name is dependent on the content, these files can be given
69 a far future expiration date without worrying about stale browser caches.
70
71 For increased performance, the concatenation and compressing process
72 can also be run once manually outside of the request/response cycle by
73 using
74 the Django management command ``manage.py compress``.
75
76 Configurability & Extensibility
77 -------------------------------
78
79 Django Compressor is highly configurable and extensible. The HTML parsing
80 is done using lxml_ or if it's not available Python's built-in HTMLParser
81 by
82 default. As an alternative Django Compressor provides a BeautifulSoup_ and
83 a
84 html5lib_ based parser, as well as an abstract base class that makes it
85 easy to
86 write a custom parser.
87
88 Django Compressor also comes with built-in support for
89 `YUI CSS and JS`_ compressor, `yUglify CSS and JS`_ compressor, the
90 Google's
91 `Closure Compiler`_, a Python port of Douglas Crockford's JSmin_, a Python
92 port
93 of the YUI CSS Compressor csscompressor_ and a filter to convert (some)
94 images into
95 `data URIs`_.
96
97 If your setup requires a different compressor or other post-processing
98 tool it will be fairly easy to implement a custom filter. Simply extend
99 from one of the available base classes.
100
101 More documentation about the usage and settings of Django Compressor can be
102 found on `django-compressor.readthedocs.org`_.
103
104 The source code for Django Compressor can be found and contributed to on
105 `github.com/django-compressor/django-compressor`_. There you can also file
106 tickets.
107
108 The in-development version of Django Compressor can be installed with
109 ``pip install
110 git+https://github.com/django-compressor/django-compressor.git``
111
112 .. _BeautifulSoup: http://www.crummy.com/software/BeautifulSoup/
113 .. _lxml: http://lxml.de/
114 .. _html5lib: https://github.com/html5lib/html5lib-python
115 .. _YUI CSS and JS: http://developer.yahoo.com/yui/compressor/
116 .. _yUglify CSS and JS: https://github.com/yui/yuglify
117 .. _Closure Compiler: http://code.google.com/closure/compiler/
118 .. _JSMin: http://www.crockford.com/javascript/jsmin.html
119 .. _csscompressor: https://github.com/sprymix/csscompressor
120 .. _data URIs: http://en.wikipedia.org/wiki/Data_URI_scheme
121 .. _django-compressor.readthedocs.org:
122 https://django-compressor.readthedocs.io/en/latest/
123 .. _github.com/django-compressor/django-compressor:
124 https://github.com/django-compressor/django-compressor
125
126
127 [FILE:107:distinfo]
128 d2ed1c6137ddaac5536233ec0a819e14009553fee0a869bea65d03e5285ba74f       111853 django_compressor-2.4.tar.gz
129