Blend 0.1.5

A cross-platform tool for merging and processing client-side assets for a web application.

=====
Blend
=====

Merge, analyze, and optimize client-side assets for web applications and static web sites.

Example
=======

Given the following directory structure::

project
lib
jquery-1.7.2.min.js
src
app.js
components
menu.js
common
helpers.js

And the following ``app.js``::

/* app.js */

//= require jquery
//= require menu
var app = {};

And the following ``menu.js``::

/* menu.js */

//= require jquery
//= require helpers
var menu = {};

And the following ``helpers.js``::

/* helpers.js */

var helpers = {};

Running ``blend`` with no arguments from the ``project`` directory will produce this directory structure::

project
lib
jquery-1.7.2.min.js
output
app.js
app.min.js
menu.js
menu.min.js
src
app.js
components
menu.js
common
helpers.js

Where ``app.js`` has the following content::

/* app.js */

/* ... the minified JQuery code, included only once */
var helpers = {};
var menu = {}
var app = {};

Usage
=====

blend [options] [file1 [file2 [fileN]]]

Command Line Options
--------------------

Output
~~~~~~
``-o OUTPUT, --output=OUTPUT``

Where the file output will be written. The default is a directory at the root of the
project directory named ``output``

Path
~~~~~
``-p PATH, --path=PATH``

A directory to be searched for required files. Multiple directories can specified by
repeating the flag. If you do not
specify any directory with the PATH flag then only the working directory will be searched for required files.

Skip Working Directory
~~~~~~~~~~~~~~~~~~~~~~
``-s, --skipcwd``

Exclude the current working directory from the requirement search paths.

Specify A Configuration File
~~~~~~~~~~~~~~~~~~~~~~~~~~
``-c, --config``

Specify a JSON confguration file that describes the analyzers and minifiers to be used.

Installation
============

From the Python Package Index
-----------------------------
::

pip install blend

From Source
-----------
::

git clone git://github.com/azavea/blend.git
cd blend
python setup.py install

Documentation
=============
http://azavea-blend.readthedocs.org

License
============

MIT