Utilities and constants for configuring Pipeline.
This is safe to import from a project’s
side effects (for instance, it will not load any Django models or apps).
New in version 2.1.
- DEFAULT_PIPELINE_COMPILERS = ['djblets.pipeline.compilers.es6.ES6Compiler', 'djblets.pipeline.compilers.less.LessCompiler']¶
Default list of compilers used by Djblets.
Build a standard set of Pipeline settings.
This can be used to create a
PIPELINEsettings dictionary in a
settings.pyfile based on the standard Djblets Pipeline settings, which makes use of Babel, LessCSS, and UglifyJS, along with a preset list of plugins.
The following base set of Babel plugins are used:
The following LessCSS plugin is used:
This will also set the value of
pipeline_enabled (bool) –
Whether Pipelining of static media should be enabled.
This must be provided by a caller. It’s recommended to enable this if
False(or, better, use another variable indicating a production vs. development environment).
node_modules_path (unicode) – The path to the loal
node_modulesdirectory for the project.
static_root (unicode) – The value of the
settings.STATIC_ROOT. This must be provided explicitly, since
settings.pyis likely the module calling this.
stylesheet_bundles (list of dict, optional) – A list of stylesheet bundle packages for Pipeline to handle.
compilers (list of unicode, optional) – A list of compilers to use for static media.
babel_extra_plugins (list of unicode, optional) – A list of additional Babel plugins to enable.
babel_extra_args (list of unicode, optional) – Extra command line arguments to pass to Babel.
less_extra_args (list of unicode, optional) – Extra command line arguments to pass to LessCSS.
validate_paths (bool, optional) –
Whether to validate any expected paths to binary files.
It’s recommended to set this based on
DEBUG, or another variable indicating a production vs. development environment.
DJBLETS_SKIP_PIPELINE_VALIDATIONenvironment variable is set to
1, then this will be forced to
False. This is primarily used for packaging building.