Metadata-Version: 1.0
Name: zetalibrary
Version: 0.5.2
Summary: Zeta library is css, js framework.

Home-page:  http://github.com/klen/zeta-library
Author: Kirill Klenov
Author-email: horneds@gmail.com
License: GNU LGPL
Description: Zeta library
        ============
        
        **Zeta library** is a framework allows to create, collect and pack css, scss, js files much easier. Documentation_ during development.
        
        .. contents::
        
        
        Features
        ========
        
        - Collect **JS** files;
        - Collect **CSS** and **SCSS** files in any order;
        - Compress output files;
        - Parse custom files in support formats;
        - Watch files or folders and auto repack static;
        - Has included popular js and css frameworks (you can expand);
        - And more...
        
        
        * **CSS import support**::
        
            @import url(path or http);
        
        
        * **JS require support**::
        
            require("path or http");
        
        
        * **SCSS compile and imports support** See SCSS_ for more information about language::
        
            @import url(path or http);
        
            // or Scss style also supported
        
            @import 'compass/css3'
        
        
        * **Blueprint css framework** Ex. ::
        
            @import url(zeta://blueprint.css);
        
        
        * **Compass scss framework** Ex. ::
        
            @import url(zeta://compass.scss);
        
            // or 
        
            @import 'compass/reset'
        
        
        * **Boilerrplate framework support** Ex. ::
        
            @import url(zeta://boilerplate.css);
        
        
        * **Zeta css, js framework** Ex: ::
        
            @import url(zeta://zeta.css);
        
            require("zeta://zeta.js");
        
        
        Installation
        ============
        
        **Zeta library** should be installed using pip or setuptools: ::
        
            pip install zetalibrary
        
            easy_install zetalibrary
        
        
        Usage
        =====
        
        $zeta ::
        
            $ zeta help
        
            usage: zeta [-h] [-v] {pack,watch,shell,libs} ...
        
            positional arguments:
            {pack,watch,shell,libs}
                pack                Parse file or dir, import css, js code and save with
                                    prefix
                watch               Watch directory for changes and auto pack sources
                shell               A helper command to be used for shell integration
                libs                Show zeta libs
        
            optional arguments:
            -h, --help            show this help message and exit
            -v, --version         show program's version number and exit
        
            $ zeta pack --help
        
            usage: zeta pack [-h] [-p PREFIX] [-f FORMAT] [-c] [-d DIRECTORY] [-o OUTPUT]
                            [-s SETUP_FILE]
                            source
        
            positional arguments:
            source
        
            optional arguments:
            -h, --help            show this help message and exit
            -p PREFIX, --prefix PREFIX
                                    Save packed files with prefix. Default is '_'
            -f FORMAT, --format FORMAT
                                    Force format (css, js, ...). By default format parse
                                    from file extension
            -c, --compress        Compress packed sources
            -d DIRECTORY, --directory DIRECTORY
                                    Add custom directory for search with prefix: 'zeta://'
                                    By default $ZETA_LIBDIR
            -o OUTPUT, --output OUTPUT
                                    Set output directory path
            -s SETUP_FILE, --setup-file SETUP_FILE
                                    Configuration ini file, with 'Zeta' section
        
        
        
        
        Changes
        =======
        
        Make sure you`ve read the following document if you are upgrading from previous versions of zetalibrary:
        
        http://packages.python.org/zetalibrary/changes.html
        
        
        Examples
        ==========
        #. Parse all static files in directory ''/tmp/static'' with default prefix::
        
            $> ls -la /tmp/static
            drwxr-xr-x 4 www-data www-data 4096 2011-02-16 15:09 main
            -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 main.css
            -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 main.js
            -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 print.css
        
            $> zeta /tmp/static
            ...
            $> ls -la /tmp/static
            drwxr-xr-x 4 www-data www-data 4096 2011-02-16 15:09 main
            -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 main.css
            -rw-r--r-- 1 www-data www-data  335 2011-02-16 15:09 _main.css
            -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 main.js
            -rw-r--r-- 1 www-data www-data  343 2011-02-16 15:09 _main.js
            -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 print.css
            -rw-r--r-- 1 www-data www-data    0 2011-02-16 15:09 _print.css
        
        
        #. Parse `/static/main.js` and minify ::
        
            $ zeta -c /static/main.js
        
        #. Watch directory `/static/` ::
            
            $ zeta watch /static
        
        
        Options
        ==========
        Under construction.
        
        
        Bug tracker
        ===========
        
        If you have any suggestions, bug reports or
        annoyances please report them to the issue tracker
        at https://github.com/klen/zeta-library/issues
        
        
        Contributing
        ============
        
        Development of zeta-library happens at github: https://github.com/klen/zeta-library
        
        * klen_ (Kirill Klenov)
        
        
        License
        =======
        
        Licensed under a `GNU lesser general public license`_.
        
        
        Copyright
        =========
        
        Copyright (c) 2011 Kirill Klenov (horneds@gmail.com)
        
        Compass_:
            (c) 2009 Christopher M. Eppstein
            http://compass-style.org/
        
        SCSS_:
            (c) 2006-2009 Hampton Catlin and Nathan Weizenbaum
            http://sass-lang.com/
        
        jQuery_:
            (c) 2009-2010 jQuery Project
            http://jquery.org/
        
        
        Note
        ====
        
        **Your feedback are welcome!**
        
        .. _Documentation: http://packages.python.org/zetalibrary/
        .. _zeta-library: http://github.com/klen/zeta-library.git
        .. _GNU lesser general public license: http://www.gnu.org/copyleft/lesser.html
        .. _SCSS: http://sass-lang.com
        .. _compass: http://compass-style.org/
        .. _jQuery: http://jquery.com
        .. _klen: https://klen.github.com
        
Platform: Any
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: Russian
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
Classifier: Programming Language :: Python
Classifier: Environment :: Console
Classifier: Topic :: Software Development :: Code Generators
