合并和简化脚本:用于管理、组合和缩小web项目javascript资产的自动化工具。
mass的Python项目详细描述
mass受到sass的启发,是一个管理javascript的自动化工具。 Web项目中的文件。
目标
- 将多个文件合并为单个资产请求的简单方法
- 自动缩小/优化
- 扩展javascript以允许导入其他脚本
要求
- Mac OS X(当前使用fsevents跟踪文件更改。以后会的 添加对Linux和Windows的支持)
使用的python包
- jsmin(http://pypi.python.org/pypi/jsmin)
- macfsevents(http://pypi.python.org/pypi/MacFSEvents/0.2.1)
- virtualenv(http://pypi.python.org/pypi/virtualenv)
- argparse(http://pypi.python.org/pypi/argparse)
安装
质量可通过PIP安装:
pip install mass
要手动安装mass,请克隆repo并使用setup.py进行安装:
python setup.py install
默认情况下,mass通过virutalenv提供必要的python包。
在安装mass之前,用户可以通过导航到 存储库和虚拟环境的来源。
cd path/to/MASS source env/bin/activate
源文件
源文件使用扩展名“.xjs”,它暂时表示 扩展的javascript。这些文件用于定义javascript文件 它将包含在一个“编译”版本中,并以质量输出。
包括文件
在“扩展”javascript文件中,可以导入其他脚本。全部 源文件中列出的javascript文件将被合并、缩小 并输出到与原始xjs同名的javascript文件 文件。导入的javascript文件的路径应与 导入到的XJS文件的目录。
下面的示例指定了两个javascript文件,并将输出到 文件foo.min.js:
// foo.xjs // import "foo.js" // import "plugins/jquery.jnotify.js"
可以使用require命令来确保文件已经 已导入,如果没有,则将导入脚本。
// foo.xjs // import "foo.js" // import "bar.js" // foo.js // require "bar.js"
在上面的例子中,由于foo.xjs已经 已经导入了。
mass还支持“内联”javascript
// bar.js // import "foo.js" // now some javascript $(document).ready(function(){ // jquery is ready }); // another import! // import "plugins/jquery.jnotify.js"
cli参数
基本命令
mass有两个基本的cli命令,watch和compile。watch 开始监视指定的目录并编译文件 在compile将简单地缩小和合并文件时进行编辑 位于指定目录中。
mass watch -s path/to/source mass compile -s path/to/source
定义目标目录
默认情况下,mass将编译后的js文件保存在与 源文件。-d参数可用于指定不同的 输出目录。
mass watch -d path/to/output
定义源目录
如果未指定源目录,mass将使用当前目录 默认情况下。-s参数可用于指定 大批量查找文件。
mass watch -s path/to/source -d path/to/output