tree: 8bfe035a7966cbde4ca12da12477af556a86ba98 [path history] [tgz]
  1. bin/
  2. example/
  3. lib/
  4. test/
  5. CHANGELOG.md
  6. LICENSE
  7. pubspec.yaml
  8. README.md
pkg/csslib/README.md

csslib in Pure Dart

This is a pure Dart [CSS parser][cssparse]. Since it's 100% Dart you can use it safely from a script or server side app.

Installation

Add this to your pubspec.yaml (or create it):

dependencies:
  csslib: any

Then run the Pub Package Manager (comes with the Dart SDK):

pub install

Usage

Parsing CSS is easy!

import 'package:csslib/parser.dart' show parse;
import 'package:csslib/css.dart';

main() {
  var stylesheet = parse(
      '.foo { color: red; left: 20px; top: 20px; width: 100px; height:200px }');
  print(stylesheet.toString());
}

You can pass a String or list of bytes to parse.

Updating

You can upgrade the library with:

pub update

Disclaimer: the APIs are not finished. Updating may break your code. If that happens, you can check the commit log, to figure out what the change was.

If you want to avoid breakage, you can also put the version constraint in your pubspec.yaml in place of the word any.

Running Tests

All tests (both canary and suite) should be passing. Canary are quick test verifies that basic CSS is working. The suite tests are a comprehensive set of ~11,000 tests.

export DART_SDK=path/to/dart/sdk

# Make sure dependencies are installed
pub install

# Run command both canary and the suite tests
test/run.sh

Run only the canary test:

 test/run.sh canary

Run only the suite tests:

 test/run.sh suite