#3 Support for Source Maps

- rename packages (allow developers to use 1.X and 2.X at the same time)
- use developer-friendly RuntimeExceptions
- introduce LessCompiler, NativeLessCompiler and LessOptions
- use fluent API in builders
- use own path separator instead of the system operators (; or :)
- upgrade mMckito to 2.7.22

Author: agabrys

CHANGELOG.md

@@ -3,7 +3,7 @@
 ## 2.0.0
 Features:
 * Added support for `HTTP`, `HTTPS`, `FTP` and `classpath` protocols
-* Added support for Source maps
+* Added support for Source Maps
 
 [See documentation](http://lesscss-compiler.projects.gabrys.biz/2.0.0/)
 

README.md

@@ -24,11 +24,45 @@ You can download the library from [this page](http://lesscss-compiler.projects.g
 or using various [dependency management tools](http://lesscss-compiler.projects.gabrys.biz/LATEST/dependency-info.html).
 
 # Concept
-The idea for the `LessCompilerImpl` class was based on the [lesscss-java](https://github.com/marceloverdijk/lesscss-java)
+The library contains two compilers:
+* `NativeLessCompiler` a compiler with a shell-type API
+* `LessCompiler` a facade for the `NativeLessCompiler` with a developer-friendly API
+
+The idea for the `NativeLessCompiler` class was based on the [lesscss-java](https://github.com/marceloverdijk/lesscss-java)
 library by [Marcel Overdijk](https://github.com/marceloverdijk).
 
 # Usage
-How to compile a source file:
+The `LessCompiler` contains 14 methods. Below is an example of how to use some of them:
 ```
-// TODO
+String cssCode = null;
+LessOptions options = null;
+
+// create compiler
+LessCompiler compiler = new LessCompiler();
+
+// compile source code
+cssCode = compiler.compile(".basic { display: block; }");
+
+// compile source code with custom options
+options = new LessOptionsBuilder().ieCompatibilityOff().build();
+cssCode = compiler.compile(".basic { display: block; }", options);
+
+// compile source file
+cssCode = compiler.compile(new File("source.less"));
+
+// 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 code and generate inline source map
+cssCode = compiler.compileWithInlineSourceMap(".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 and generate source map (save it in output.css.map file)
+compiler.compileWithSourceMap(new File("source.less"), new File("output.css"), options);
 ```

pom.xml

@@ -95,7 +95,7 @@
         <dependency>
             <groupId>org.mockito</groupId>
             <artifactId>mockito-core</artifactId>
-            <version>2.7.2</version>
+            <version>2.7.22</version>
             <scope>test</scope>
         </dependency>
     </dependencies>
@@ -187,7 +187,7 @@
                 <plugin>
                     <groupId>org.jacoco</groupId>
                     <artifactId>jacoco-maven-plugin</artifactId>
-                    <version>0.7.8</version>
+                    <version>0.7.9</version>
                     <configuration>
                         <rules>
                             <rule>