/jCSS-Parser

Java CSS Stream Parser

Primary LanguageHTMLApache License 2.0Apache-2.0

CSS Stream Parser for Java

Introduction

This is a Stream Parser for reading Cascading Style-Sheets (CSS) using Java. Used correctly, this can provide a fast and efficient way for parsing CSS. It is also designed to be scalable for new versions of CSS, in that adding additional support for At-Rules is straight-forward, adding new syntax is relatively straight-forward, and all of the current features are supported (as of January, 2014).

I am currently using this project in the droidQuery project, to use CSS to manipulate the Android UI. Apart from that, this library has not been extensively tested. If you find any issues, please report them here.

Usage

The simplest way to include jCSS-Parser in your project is to build using ant, then include the jar in your build path. The simplest way to parse a CSS file is using the following code:

try
{
    //First get the input stream. For example, from a file
    InputStream is = new FileInputStream(new File("/path/to/my/CSS/main.css"));

    //Then parse        
    CSSParser parser = new CSSParser(is, new DefaultCSSHandler());
    parser.parse();
}
catch (Throwable t)
{
    t.printStackTrace();
}

For more help, see Tester.java.

License

Copyright 2013 Phil Brown

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.