LessCSS Compiler

A Java library which compiles Less source files to the CSS code.

License	The BSD 3-Clause License
GroupId	biz.gabrys.lesscss
ArtifactId	compiler
Last Version	1.2.2
Release Date	Nov 12, 2016
Type	jar
Description	LessCSS Compiler A Java library which compiles Less source files to the CSS code.
Project URL	http://lesscss-compiler.projects.gabrys.biz/1.2.2/
Project Organization	gabrys.biz
Source Code Management	https://github.com/gabrysbiz/lesscss-compiler

Download compiler

Filename	Size
compiler-1.2.2.pom
compiler-1.2.2.jar	87 KB
compiler-1.2.2-sources.jar	88 KB
compiler-1.2.2-javadoc.jar	83 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/biz.gabrys.lesscss/compiler/ -->
<dependency>
    <groupId>biz.gabrys.lesscss</groupId>
    <artifactId>compiler</artifactId>
    <version>1.2.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/biz.gabrys.lesscss/compiler/
implementation 'biz.gabrys.lesscss:compiler:1.2.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/biz.gabrys.lesscss/compiler/
implementation ("biz.gabrys.lesscss:compiler:1.2.2")

Apache Buildr

'biz.gabrys.lesscss:compiler:jar:1.2.2'

Apache Ivy

<dependency org="biz.gabrys.lesscss" name="compiler" rev="1.2.2">
  <artifact name="compiler" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='biz.gabrys.lesscss', module='compiler', version='1.2.2')
)

Scala SBT

libraryDependencies += "biz.gabrys.lesscss" % "compiler" % "1.2.2"

Leiningen

[biz.gabrys.lesscss/compiler "1.2.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
org.mozilla : rhino	jar	1.7R5

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.mockito : mockito-core	jar	1.10.19

Project Modules

There are no modules declared in this project.

About

The LessCSS Compiler is a Java library which compiles Less source files to CSS code.

From Less website:

Less is a CSS pre-processor, meaning that it extends the CSS language, adding features that allow variables, mixins, functions and many other techniques that allow you to make CSS that is more maintainable, themable and extendable.

Compatibility

The compiler is compatible with version 1.7.5. The library is based on the official Less JavaScript compiler adapted to the Rhino engine.

It supports sources located at:

• local drives
• protocols:
  • HTTP and HTTPS
  • FTP (requires Apache Commons Net library in the class path)
  • class path (prefix classpath://)
• custom - defined by programmers (see FileSystem)

Requirements

The compiler to run requires:

• Java 8 or higher
• Third-Party Dependencies (see list)

Download

You can download the library from this page or using various dependency management tools.

Concept

The library contains two compilers:

• NativeLessCompiler is a compiler with a shell-type API
• LessCompiler is a facade for the NativeLessCompiler with a developer-friendly API

The idea for the NativeLessCompiler class was based on the lesscss-java library by Marcel Overdijk.

Usage

The LessCompiler contains 32 methods. Below is an example of how to use some of them:

String cssCode = null;
LessOptions options = null;

// create compiler
LessCompiler compiler = new LessCompiler();

// compile source code
cssCode = compiler.compileCode(".basic { display: block; }");

// compile source code with custom options
options = new LessOptionsBuilder().ieCompatibilityOff().build();
cssCode = compiler.compileCode(".basic { display: block; }", options);

// compile source file specified by path
cssCode = compiler.compile("http://www.example.org/style.less");

// compile source file
cssCode = compiler.compile(new File("source.less"));

// compile source file specified by path and save CSS code in an output file
compiler.compile("http://www.example.org/style.less", new File("output.css"));

// compile source file and save CSS code in an output file
compiler.compile(new File("source.less"), new File("output.css"));

// compile source file and compress CSS code
cssCode = compiler.compileAndCompress(new File("source.less"));

// compile source file specified by path and compress CSS code using custom encoding
cssCode = compiler.compileAndCompress("http://www.example.org/style.less", Charset.forName("UTF-8"));

// compile source code and generate inline source map
cssCode = compiler.compileCodeWithInlineSourceMap(".basic { display: block; }", new LessOptions());

// compile source file and generate source map (save it in output.map file)
options = new LessOptionsBuilder().sourceMapBasePath("basePath").build();
compiler.compileWithSourceMap(new File("source.less"), new File("output.css"), new File("output.map"), options);

// compile source file specified by path and generate source map (save it in output.css.map file)
compiler.compileWithSourceMap("http://www.example.org/style.less", new File("output.css"), options);

gabrys.biz [archived]

Versions

Version
1.2.2 Nov 12, 2016
1.2.1 Oct 2, 2016
1.2 Dec 5, 2015
1.1 Sep 8, 2015
1.0 Jul 19, 2015