Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

kmc

Package Overview
Dependencies
Maintainers
1
Versions
44
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

kmc

KISSY Module Compiler

  • 1.0.17
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
7
decreased by-46.15%
Maintainers
1
Weekly downloads
 
Created
Source

ModuleCompiler

Build Status

NPM version

简介

KISSY Module Compiler(kmc)是一个基于NodeJS的KISSY模块打包工具,目前适用于KISSY 1.2+的代码打包

如果您有任何问题,请邮件或者来往(daxingplay)上联系我。

特点

  • 支持GruntJS,参见grunt-kmc.
  • 基于NodeJS,相比于KISSY自带的Java工具,打包快速
  • 参照浏览器端的KISSY的config进行配置,无需额外知识,只需要改一下包路径即能快速打包
  • 支持混合编码打包,不同的包可以使用不同的编码
  • 支持GBK输出
  • 支持KISSY 1.3的自动combo功能,可以生成依赖关系文件
  • 提供底层依赖分析接口,方便集成到其他工具当中
  • 支持map功能,可以使用正则自由替换输出的模块名

版本说明

  • 0.0.7版本适用于KISSY 1.2、1.3的打包,目前已经在淘宝多个业务广泛使用,单纯打包没有任何问题,但是不具备依赖分析生成功能,此版本已经不再维护,推荐使用新版本。
  • 1.0.0版本开始支持KISSY 1.3的自动combo功能,推荐使用

使用

安装

npm install kmc

or

git clone git://github.com/daxingplay/ModuleCompiler.git

注意: 新版本的KISSY Module Compiler的npm包已经更名为kmc,如果使用老版本(此版已经不再维护),请npm install module-compiler

编写你的打包脚本

var kmc = require('kmc');

// 这里和KISSY.config一样,先配置包
kmc.config({
    packages: [{
        'name': 'sh',
        'path': '这里建议写绝对路径,即sh这个包所在的目录',
        'charset': 'gbk'
    }]
});

// 将xxx.js打包为xxx.combine.js,输出编码为GBK
kmc.build('xxx.js', 'xxx.combine.js', 'gbk');

// 用node执行你这个打包脚本就ok啦~

高级使用指南

var kmc = require('kmc');

kmc.config({
    // 和KISSY一样,可以配置多个包
    packages: [{
        'name': 'app1',
        'path': 'app1这个包所在目录的绝对路径',
        // 这里是指app1这个包中的文件的编码,同一个包内的编码请保持一致
        'charset': 'gbk'
    }, {
        'name': 'app2',
        'path': 'app2这个包所在目录的绝对路径',
        // 这里是指app2这个包源码的编码
        'charset': 'utf-8'
    }],
    // 可以设置哪些模块不打包进来。注意,这里exclude的是具体的模块名,支持正则
    exclude: ['base', 'event'],
    // 如果是对一个目录下的所有文件进行打包,可以设置哪些文件不打包进来,支持正则。注意和上面的exclude的配置的区别。
    ignoreFiles: ['.combo.js', '-min.js'],
    // 输出的文件名后缀,不带.js,比如打包后你想输出为xxx.combine.js,那么这里就配置为:.combine
    suffix: '',
    // 类似于KISSY的map方法,可以自己定义把模块名中的路径进行替换
    map: [
        // 这样配置的话,那么,如果原先输出的app1的模块名中含有app1/2.0/字样的话,就会被替换成app1/19891014/
        ['app1/2.0/', 'app1/19891014/']
    ],
    // 这里设置的是最后打包出来的文件的编码,默认UTF-8,这里的设置相当于是全局设置,下面build中的设置是针对单一打包实例的
    charset: 'gbk'
});

/**
 * 打包一个文件/目录
 * @param inputPath {String} 源文件/目录的绝对路径.
 * @param outputPath {String} 打包出来的文件/目录的路径.
 * @param outputCharset {String} 输出编码,这里的设置会覆盖config.charset中的设置,默认UTF-8
 * @return {Object} 打包出来的文件信息
 */
kmc.build('xxx.js', 'xxx.combine.js', 'gbk');

更详细的文档,请参见wiki

API汇总

  • kmc.config(cfg):配置包,返回当前所有配置信息。如果不带参数,直接返回当前所有配置信息。
  • kmc.analyze(inputPath):只分析该文件依赖,不打包。
  • kmc.build(inputPath, outputPath, outputCharset, depFilePath, traverse):打包函数,具体见wiki
  • kmc.combo(inputPath, depFilePath, depFileCharset, fixModuleName): 不打包,只生成KISSY 1.3的自动combo依赖文件,fixModuleName默认为false
  • kmc.clean(): 可以清空config中的设置。因为ModuleCompiler是单例运行,所以如果出现一些特别情况,可以在config前执行clean方法清空之前的配置。

CHANGELOG

版本更新记录

License

遵守 "MIT":https://github.com/daxingplay/ModuleCompiler/blob/master/LICENSE.md 协议

Keywords

FAQs

Package last updated on 30 Oct 2013

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc