Libsass

by Aaron Leung (@akhleung) and Hampton Catlin (@hcatlin)

Libsass is just a library, but if you want to RUN libsass, then go to https://github.com/sass/sassc or https://github.com/sass/ruby-libsass or find your local implementer.

LibSass requires GCC 4.6+ or Clang/LLVM. If your OS is older, this version may not compile.

On Windows, you need MinGW with GCC 4.6+ or VS 2013 Update 4+. It is also possible to build LibSass with Clang/LLVM on Windows.

About

Libsass is a C/C++ port of the Sass CSS precompiler. The original version was written in Ruby, but this version is meant for efficiency and portability.

This library strives to be light, simple, and easy to build and integrate with a variety of platforms and languages.

Developing

As you may have noticed, the libsass repo itself has no executables and no tests. Oh noes! How can you develop???

Well, luckily, SassC is the official binary wrapper for libsass and is always kept in sync. SassC uses a git submodule to include libsass. When developing libsass, its best to actually check out SassC and develop in that directory with the SassC spec and tests there.

We even run Travis tests for SassC!

Tests

Since libsass is a pure library, tests are run through the SassSpec project using the SassC driver.

To run tests against libsass while developing, you can run ./script/spec. This will clone SassC and Sass-Spec under the project folder and then run the Sass-Spec test suite. You may want to update the clones to ensure you have the latest version.

Library Usage

While libsass is a library primarily written in C++, it provides a simple C interface which should be used by most implementers. Libsass does not do much on its own without an implementer. This can be a command line tool, like sassc or a binding to your favorite programing language.

If you want to build or interface with libsass, we recommend to check out the wiki pages about building libsass and the C-API documentation.

About Sass

Sass is a CSS pre-processor language to add on exciting, new, awesome features to CSS. Sass was the first language of its kind and by far the most mature and up to date codebase.

Sass was originally created by the co-creator of this library, Hampton Catlin (@hcatlin). The extension and continuing evolution of the language has all been the result of years of work by Natalie Weizenbaum (@nex3) and Chris Eppstein (@chriseppstein).

For more information about Sass itself, please visit http://sass-lang.com

Contribution Agreement

Any contribution to the project are seen as copyright assigned to Hampton Catlin, a human on the planet earth. Your contribution warrants that you have the right to assign copyright on your work. The intention here is to ensure that the project remains totally free (liberal, like).

Our MIT license is designed to be as simple, and liberal as possible.

sass2scss was originally written by Marcel Greter and he happily agreed to have it merged into the project.

Name		Name	Last commit message	Last commit date
Latest commit History 2,337 Commits
b64		b64
contrib		contrib
m4		m4
posix		posix
res		res
script		script
support		support
test		test
utf8		utf8
win		win
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.travis.yml		.travis.yml
COPYING		COPYING
INSTALL		INSTALL
LICENSE		LICENSE
Makefile		Makefile
Makefile.am		Makefile.am
Readme.md		Readme.md
appveyor.yml		appveyor.yml
ast.cpp		ast.cpp
ast.hpp		ast.hpp
ast_def_macros.hpp		ast_def_macros.hpp
ast_factory.hpp		ast_factory.hpp
ast_fwd_decl.hpp		ast_fwd_decl.hpp
backtrace.hpp		backtrace.hpp
base64vlq.cpp		base64vlq.cpp
base64vlq.hpp		base64vlq.hpp
bind.cpp		bind.cpp
bind.hpp		bind.hpp
cencode.c		cencode.c
color_names.hpp		color_names.hpp
configure.ac		configure.ac
constants.cpp		constants.cpp
constants.hpp		constants.hpp
context.cpp		context.cpp
context.hpp		context.hpp
contextualize.cpp		contextualize.cpp
contextualize.hpp		contextualize.hpp
contextualize_eval.cpp		contextualize_eval.cpp
contextualize_eval.hpp		contextualize_eval.hpp
cssize.cpp		cssize.cpp
cssize.hpp		cssize.hpp
debug.hpp		debug.hpp
debugger.hpp		debugger.hpp
emitter.cpp		emitter.cpp
emitter.hpp		emitter.hpp
environment.hpp		environment.hpp
error_handling.cpp		error_handling.cpp
error_handling.hpp		error_handling.hpp
eval.cpp		eval.cpp
eval.hpp		eval.hpp
expand.cpp		expand.cpp
expand.hpp		expand.hpp
extconf.rb		extconf.rb
extend.cpp		extend.cpp
extend.hpp		extend.hpp
file.cpp		file.cpp
file.hpp		file.hpp
functions.cpp		functions.cpp
functions.hpp		functions.hpp
inspect.cpp		inspect.cpp
inspect.hpp		inspect.hpp
json.cpp		json.cpp
json.hpp		json.hpp
kwd_arg_macros.hpp		kwd_arg_macros.hpp
lexer.cpp		lexer.cpp
lexer.hpp		lexer.hpp
listize.cpp		listize.cpp
listize.hpp		listize.hpp
mapping.hpp		mapping.hpp
memory_manager.hpp		memory_manager.hpp
node.cpp		node.cpp
node.hpp		node.hpp
operation.hpp		operation.hpp
output.cpp		output.cpp
output.hpp		output.hpp
parser.cpp		parser.cpp
parser.hpp		parser.hpp
paths.hpp		paths.hpp
plugins.cpp		plugins.cpp
plugins.hpp		plugins.hpp
position.cpp		position.cpp
position.hpp		position.hpp
prelexer.cpp		prelexer.cpp
prelexer.hpp		prelexer.hpp
remove_placeholders.cpp		remove_placeholders.cpp
remove_placeholders.hpp		remove_placeholders.hpp
sass.cpp		sass.cpp
sass.h		sass.h
sass2scss.cpp		sass2scss.cpp
sass2scss.h		sass2scss.h
sass_context.cpp		sass_context.cpp
sass_context.h		sass_context.h
sass_functions.cpp		sass_functions.cpp
sass_functions.h		sass_functions.h
sass_interface.cpp		sass_interface.cpp
sass_interface.h		sass_interface.h
sass_util.cpp		sass_util.cpp

License

Licenses found

candid82/libsass

Folders and files

Latest commit

History