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

ekam

Package Overview
Dependencies
Maintainers
1
Versions
11
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

ekam

Package builder with includes

  • 0.0.10
  • latest
  • Source
  • npm
  • Socket score

Version published
Maintainers
1
Created
Source

Package builder

Synopsis

Ekam is yet another build tool for node, designed to handle file includes, regardless of the file format, although it is primarily aimed at building javascript, html and css files. It comes as a single command line utility.

As of the current version, only JavaScript is supported, although html and css are planned and easy to add, as well as other formats.

Download

It is published on node package manager (npm). To install, do:

npm install ekam -g

Usage

ekam --help

Usage: ekam [options]

  Options:

    -h, --help                     output usage information
    -V, --version                  output the version number
    -b, --build <js or json file>  Use the specified build file
    -i, --init                     Creates default sample build files (build.json build.js)
	-f, --force                    Overwrite existing build files

Ekam takes either a json file or a JavaScript file containing information about what it has to do.

ekam --build src/build.json

or

ekam --build src/build.js

Sample build.json and build.js files can be produced with the option init (overwrite existing files with the force option)

ekam --init
  • build.json
{
	"input": {
		"include": "**/*.js"
	, "exclude": "build.json build.js"
	}
,	"output": {
		"path": "../build"
	, "mode": "0755"
	, "clean": true
	}
,	"uglify": {
		"mangle": {
			"defines": {
				"DEBUG": [ "name", "false" ]
			}
		}
	,	"squeeze": {
			"make_seqs": true
		,	"dead_code": true
		}
	,	"gen": {
		}
	}
}
  • build.js
build(
	{
		"input": {
			"include": "**/*.js"
		, "exclude": "build.json build.js"
		}
	,	"output": {
			"path": "../build"
		, "mode": "0755"
		, "clean": true
		}
	,	"uglify": {
			"mangle": {
				"defines": {
					"DEBUG": [ "name", "false" ]
				}
			}
		,	"squeeze": {
				"make_seqs": true
			,	"dead_code": true
			}
		,	"gen": {
			}
		}
	}
)

The following properties are required:

  • input
    • include (String): list of expressions or files to be processed
    • exclude (String): list of expressions or files to be excluded
  • output: the properties are the same as the ones defined in the fstream module
    • path (String): path to the generated files

The following properties are optional:

  • uglify: contains the options object passed to the uglify() method

To run the tool with DEBUG information, set the DEBUG environment variable to a list of comma separated values:

DEBUG=ekam,build,include,file,js-parser,js-ast ekam --build src/build.json
  • ekam
  • build
  • include
  • file
  • js-ast

Example

Let's say we have to build a single javascript file split up in two files as well as its minified and debug versions. The example is provided in the examples/example1 directory.

Important only files with no parent dependency get built in the output directory.

The input files are defined under the src/ directory:

  • src/file1.js
  • src/file2.js

The output files are to be defined as (yes they are defined in the input directory!):

  • src/file.js
//include("file1.js", "file2.js")
  • src/file.debug.js
//var DEBUG=true
//include("file1.js", "file2.js")

The files file1.js and file2.js should contain a line like the following one to include some debug traces:

//if(DEBUG)
console.log('DEBUG', ...)
//endif
  • src/file.min.js
//uglify("_file.js")
  • src/_file.js

This is a temporary file that collects the content for the minified version.

//include("file1.js", "file2.js")

When the ekam command is run, it creates the following files (note that the www/ directory is automatically created if it does not exist already):

  • www/file.js - concatenation of file1.js and file2.js
  • www/file.debug.js - same as file.js but with debug commands
  • www/file.min.js - minified version of file.js

Keywords

FAQs

Package last updated on 13 Mar 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