Jump to >

This documentation covers the in-development release of Djblets. You can see the latest stable docs or all previous versions.

djblets.pipeline.settings

Utilities and constants for configuring Pipeline.

Note

This is safe to import from a project’s settings.py without side effects (for instance, it will not load any Django models or apps).

New in version 2.1.

DEFAULT_PIPELINE_COMPILERS = [u'djblets.pipeline.compilers.es6.ES6Compiler', u'djblets.pipeline.compilers.less.LessCompiler'][source]

Default list of compilers used by Djblets.

build_pipeline_settings(pipeline_enabled, node_modules_path, static_root, javascript_bundles=[], stylesheet_bundles=[], compilers=[u'djblets.pipeline.compilers.es6.ES6Compiler', u'djblets.pipeline.compilers.less.LessCompiler'], babel_extra_plugins=[], babel_extra_args=[], less_extra_args=[], validate_paths=True)[source]

Build a standard set of Pipeline settings.

This can be used to create a PIPELINE settings dictionary in a settings.py file 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 node_modules_path in the NODE_PATH environment variable.

Parameters:
  • 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 DEBUG is False (or, better, use another variable indicating a production vs. development environment).

  • node_modules_path (unicode) – The path to the loal node_modules directory for the project.
  • static_root (unicode) – The value of the settings.STATIC_ROOT. This must be provided explicitly, since settings.py is likely the module calling this.
  • javascript_bundles (list of dict, optional) – A list of JavaScript bundle packages for Pipeline to handle.
  • 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.