Stilus: Stylus in Python

Release 0.9.0.

Stilus is the Python implementation of Stylus.


Install Stilus on your machine using pip:

$ python -m pip install -U stilus
$ pip install -U stilus

It might be that you’ll need to install some extra dev packages. Like this:

$ sudo apt install libjpeg-dev libxml2-dev libxslt1-dev


$ stilus --help
Usage: stilus [OPTIONS] [INPUT] [OUTPUT]

  -v, --verbose       Be more verbose.
  -w, --watch         Watch file(s) for changes and re-compile.
  -c, --compress      Compress CSS output.
  -p, --print         Print out the compiled CSS.
  -I, --include TEXT  Add <path> to lookup paths.
  -o, --out TEXT      Output to <dir> when passing files.
  -P, --prefix TEXT   Prefix all css classes by <prefix>.
  --hoist-atrules     Move @import and @charset to the top
  -V, --version       Display the version of Stilus.
  -h, --help          Show this message and exit.

Comparison between Stylus and Stilus

Most of Stylus is implemented in Stilus, but some parts are missing:

  • Plugins (and tests)
  • Caching (and tests)
  • Documentation: missing an architecture document and almost all the docstrings
  • We are missing a few tests. Currently more than 96% of the Stylus tests pass successfully through Stilus. These are missing.

Below you’ll find the comparison between Stylus and Stilus.

All help is appreciated!

The Plan

The ongoing work, the future plans and the work done.

Developing Stilus

The development of Stilus, some todo’s and thoughts.


Some built-in functions do not work properly yet; arrays/lists of blocks are handled weirdly.


If you are looking for information on a specific function, class, or method, this part of the documentation is for you.

Indices and tables