stylus

Stylus CLI wrapper for Dart


License
MIT

Documentation

Dart Stylus Compiler

Build Status

Stylus compiler wrapper for Dart.

Install

Just add to your pubspec.yaml:

dependencies:
  stylus: any

You also gonna need to have stylus command into your path. To install stylus, run (you must have Node and NPM installed before):

npm install -g stylus

Usage

Use StylusProcess to compile Stylus code into CSS, the easiest way to call is by using the [start] method:

import 'package:stylus/stylus.dart';

StylusProcess.start(new StylusOptions(path: 'file.styl')).pipe(new File('output.css').openWrite());

As you can see, the [start] returns a [Stream] that you can use to pipe strait on the result.

You can also compile from a [String]:

import 'dart:convert';
import 'package:stylus/stylus.dart';

var input = '''
  body
    .class
      .internal
        color: blue
''';

StylusProcess.start(new StylusOptions(input: input)).pipe(new File('output.css').openWrite());

And finally, a tip on how to get the compiled content as [String]

import 'dart:convert';
import 'package:stylus/stylus.dart';

StylusProcess.start(new StylusOptions(path: 'app.styl')).transform(ASCII.decoder).single.then((String css) {
  print(css); // body .class .internal { color: #00f; }
});

There are many other options that you can send to [StylusOptions] to configure the compilation, check the constructor arguments at StylusOptions

Compiler on Editor Build

We also provide a build helper if you wanna your .styl files to automatic compile to .css on save using Dart Editor, to setup that you gonna need to create a file called build.dart on your project root (if you don't have it already), having it, just base the setup on the following example:

import 'package:stylus/stylus.dart';

void main(List<String> args) {
  buildStylus(args);
}

You can provide custom options if you want:

import 'package:stylus/stylus.dart';

void main(List<String> args) {
  buildStylus(args, new StylusOptions(use: ['nib'], lineNumbers: true, includeCss: true, compress: true));
}