/jsass

Java sass compiler using libsass.
  1. CSS 52.3%
  2. Java 32.1%
  3. C 10.7%
  4. Shell 3.4%
  5. CMake 1.5%
Switch branches/tags
Nothing to show
Find file
Clone or download

Clone with HTTPS

Use Git or checkout with SVN using the web URL.

Download ZIP

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching GitHub Desktop...

If nothing happens, download GitHub Desktop and try again.

Launching Xcode...

If nothing happens, download Xcode and try again.

Launching Visual Studio...

If nothing happens, download the GitHub extension for Visual Studio and try again.

Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin Delete css.map when updating test assets Jul 19, 2018
config/checkstyle Introduce docker based build and testing infrastructure. Aug 16, 2015
example/webapp Add comments to the example webapp servlet Sep 21, 2016
gradle/wrapper Upgrade gradle wrapper Jul 10, 2018
src Add test to cover #73 Jul 19, 2018
.gitattributes Remove "binary" .gitignore. Nov 3, 2015
.gitignore Update encrypted gradle properties for travis. Feb 21, 2016
.gitmodules Fix libsass submodule path. Aug 2, 2015
.travis.yml [CI] Use openjdk8 instead of oraclejdk8 Nov 20, 2017
.travis_after_script.sh fixup! [CI] (Temporarily) no longer perform sonar analysis Mar 30, 2018
.travis_before_install.sh fixup! [CI] Upgrade JDK installed on macos Mar 30, 2018
.travis_script.sh [CI] Fix CI issues with ubuntu 14.04 container Mar 30, 2018
CMakeLists.txt Start refactoring to JNI. Jul 29, 2015
CONTRIBUTING.md Add a contributing guide. Apr 24, 2015
LICENSE Add missing license file. Mar 28, 2015
README.md Upgrade libsass to version 3.5.4 May 15, 2018
build.gradle Always pull docker before run Jul 14, 2018
gradle.properties [Gradle Release Plugin] - pre tag commit: '5.7.3'. May 16, 2018
gradlew [CI] Fix CI issues with ubuntu 14.04 container Mar 30, 2018
gradlew.bat [CI] Fix CI issues with ubuntu 14.04 container Mar 30, 2018
maven.gradle add new line at end of file Feb 22, 2016
settings.gradle Finally switch from maven to gradle. Feb 13, 2016

README.md

Build Status Documentation Status Javadoc Status

Java sass compiler

Feature complete java sass compiler using libsass version 3.5.4.

The most advantage of jsass is to hide the libsass complexity from the developer and provide a more java like way.

For complete documentation, see jsass.rtfd.org.

Related (third-party) projects

Example

There is a webapp example containing a servlet sample implementation, to illustrate the way you may integrate jsass into your webapp.

Changelog

You can find the changelog in our documentation at jsass.rtfd.org/en/latest/changelog.html

Compatibility

Compatibility
Java 7 not supported, jsass uses Java 8 features like streams and lambdas!
Java 8 fully supported
Java 9 may be supported, but not tested
CentOS 5 (x86_64) fully supported and tested
CentOS 6 (x86_64) fully supported and tested
CentOS 7 (x86_64) fully supported and tested
ubuntu 12.04 (x86_64) fully supported and tested
ubuntu 14.04 (x86_64) fully supported and tested
Windows 32bit build broken (not analyzed)
Windows 64bit supported, but not tested
OS X fully supported and tested
ARM experimental, untested

A note to Windows: jsass may also work on Windows. But at the moment there are no automated tests and the platform is not well tested!

Gradle tasks you should know

gradle check runs checkstyle, pmd, junit locally.

gradle runDockerTests runs junit tests on all docker containers.

gradle buildNativeLibs build the native libs, using our build docker container.

gradle buildDocker build latest version of all docker containers locally. This should only used for development purpose, the containers are available on Docker Hub!

Build scripts

Our build scripts are mostly deprecated in favor of the gradle tasks!

./bin/make-libjsass-darwin.sh build the native lib for OS X.

./bin/make-libjsass-linux-x64.sh build the native lib for Linux, using our build docker container. This is equivalent to gradle buildDockerBuildLinux64 buildNativeLinux64Libs!

./bin/make-libjsass-windows-x32.sh build the native lib for Windows, using our build docker container. This is equivalent to gradle buildDockerBuildWindows32 buildNativeWindows32Libs!

./bin/make-libjsass-windows-x64.sh build the native lib for Windows, using our build docker container. This is equivalent to gradle buildDockerBuildWindows64 buildNativeWindows64Libs!

How to make a release

$ ./gradlew clean release
$ git checkout $(git describe --abbrev=0)
$ ./gradlew clean uploadArchives
$ git checkout master
$ git merge --no-ff $(git describe --abbrev=0 develop)
$ git push origin master
$ git checkout develop

Dont forget to release the artifact from staging repository!

License

MIT-License