Ravenports generated: 10 Aug 2021 02:58
[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.1
5 KEYWORDS=               python
6 VARIANTS=               py38 py39
7 SDESC[py38]=            Django CSS/JS cache and compressor (PY38)
8 SDESC[py39]=            Django CSS/JS cache and compressor (PY39)
9 HOMEPAGE=               https://django-compressor.readthedocs.io/en/latest/
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPIWHL/ae/7d/5cc45560591c1a8b3c180c3fd89975e4cb9d4097dcec6b7736530099f093
14 DISTFILE[1]=            django_compressor-2.4.1-py2.py3-none-any.whl:main
15 DF_INDEX=               1
16 SPKGS[py38]=            single
17 SPKGS[py39]=            single
18
19 OPTIONS_AVAILABLE=      PY38 PY39
20 OPTIONS_STANDARD=       none
21 VOPTS[py38]=            PY38=ON PY39=OFF
22 VOPTS[py39]=            PY38=OFF PY39=ON
23
24 DISTNAME=               django_compressor-2.4.1.dist-info
25
26 GENERATED=              yes
27
28 [PY38].RUN_DEPENDS_ON=                  python-django-appconf:single:py38
29                                         python-rcssmin:single:py38
30                                         python-rjsmin:single:py38
31                                         python-six:single:py38
32 [PY38].USES_ON=                         python:py38,wheel
33
34 [PY39].RUN_DEPENDS_ON=                  python-django-appconf:single:py39
35                                         python-rcssmin:single:py39
36                                         python-rjsmin:single:py39
37                                         python-six:single:py39
38 [PY39].USES_ON=                         python:py39,wheel
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:123:distinfo]
128 f8313f59d5e65712fc28787d084fe834997c9dfa92d064a1a3ec3d3366594d04       145292 django_compressor-2.4.1-py2.py3-none-any.whl
129