Jump to >

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

djblets.pipeline.compilers.less.LessCompiler

class LessCompiler(verbose, storage)[source]

Bases: pipeline.compilers.less.LessCompiler

A LESS compiler which doesn’t redirect the output.

Pipeline’s LESS compiler outputs to stdout and redirects that output to the target file, because of some bug in old versions of lessc. We don’t want to do that, because it interferes with the generation of sourcemaps.

To use this, add the path to this class to settings.PIPELINE['COMPILERS'].

Changed in version 2.1.2: Added in-memory caching of import lists and file information to speed up performance of compilations.

__init__(verbose, storage)[source]

x.__init__(…) initializes x; see help(type(x)) for signature

Methods

__init__(verbose, storage) x.__init__(…) initializes x; see help(type(x)) for signature
clear_caches() Clear the caches used for faster compilation.
compile_file(infile, outfile[, outdated, force]) Compile a given file.
execute_command(command[, cwd, stdout_captured]) Execute a command at cwd, saving its normal output at stdout_captured.
is_outdated(infile, outfile) Return whether a given file is outdated.
match_file(filename)
output_path(path, extension)
read_file(path)
save_file(path, content)

Attributes

less_imports_command Command line and arguments for less-imports.js.
output_extension
classmethod clear_caches()[source]

Clear the caches used for faster compilation.

less_imports_command[source]

Command line and arguments for less-imports.js.

Type:
unicode
compile_file(infile, outfile, outdated=False, force=False)[source]

Compile a given file.

Parameters:
  • infile (unicode) – The input filename.
  • outfile (unicode) – The output filename.
  • outdated (bool) – Whether the file is outdated.
  • force (bool) – Whether the compilation should proceed, regardless of whether the file is out of date.
is_outdated(infile, outfile)[source]

Return whether a given file is outdated.

This will compare the timestamps of the infile and outfile, but also compare the timestamp of outfile against any import depedencies that exist.

Parameters:
  • infile (unicode) – The path to the input file.
  • outfile (unicode) – The path to the output file.
Returns:

True if the file is out of date and needs to be recompiled.

Return type:

bool