atma

Atma.js Toolkit

> npm install atma -g
# ...
> atma --help

> atma [action] [arg] [...] -KEY VALUE [...]
> atma [*.json | *.js | *.yml]
# Load Config and process
#   .json - JSON
#   .yml - yml
#   .js - JS Module, that exports tasks(s)

Embedded Actions

• Build
• Shell
• Run scripts
• HTTP Server
• Reference
• Generate

... some more, just run atma -help

To get help from cli for a particular action run $ atma actionName -help

Config

Configuration object consists from any number of actions/tasks you want to run.

Javascript sample

// Single action
module.exports = ActionObject;

// Multiple actions
module.exports = [ActionObject, ActionObject, /*..*/];

// Grouped actions
module.exports = {
    groupName: ActionObject, // [ActionObject]
    otherGroup: ActionObject, // [ActionObject]
    
    // optional    
    defaults: ['groupName']
}

/*
 * Normally, if you run `atma config.js` then all grouped actions will be started,
 * but if `defaults` property is used, then only that groups will be activated.
 * Also you can run any group with: 'atma config.js groupName'
*/

ActionObject

{
    action: 'NAME',
    // ... action configuration
}

If ActionObject is in a group, and that groupname has the name of existed action, then you can ommit 'action' property

module.exports = {
    copy: {
        // action: 'copy' - is not required
		files: {
			'filePath': 'destinationPath',
            // ...
		}
    }
}

Actions

build

Application Builder for (IncludeJS)[http://atmajs.com/include]

Features:

• Combine javascript into a single file

  • extract all scripts from main HTML file
  • extract all nested scripts included with IncludeJS
  • preprocess javascript if coffeescript or any other supported loader is used

• Combine style into a single file

  • extract all style links from main HTML file
  • extract all nested styles included with IncludeJS
  • copy images or fonts, when located not in a working directory (e.g. are referened)
  • preprocess css if less or any other supported loader is used

• Combine templates into resulted HTML file

  • extract all nested IncludeJS loads and embed them into the HTML

{
    "action": "build"
    
    // <String> — HTML input file
    "file": "index.dev.html",
    
    // <Boolean> — run MinifyJS and clean-css
    "minify": true,
    
    // <Object> - optional — UglifyJS compressor settings. @default {global_defs: {DEBUG: false}}
    "uglify": {} 
    "jshint" : {
        "options" : // <Object> - JSHINT options
        "globals" : // <Object> - global variables. @default {"window": false, "document": false}
        "ignore"  : // <Object> - file names to ignore
    }
    "outputMain": "index.html" — output name of a built html"
    "outputSources": "build/" — directory of combined/copied resources"
}

project-import

{
    action: "project-import"
}

Copy resources, that are used by current project, from referenced directories in .reference/* to .import directory

project-reference

{
    action: "project-reference"
}

Switch back from "project-import" to resource referencing

shell

{
    action: "shell",

    /* Commands: Array or String */
    command:  [
        "cmd /C copy /B index.html c:/app",
        "cmd /C copy /B index.build/ c:/app/index.build",
        // ... other commands
    ]

}

Execuate shell commands

custom

{
    action: "custom",
    script: "scriptPath.js"
}

Or from CLI

> atma custom scriptPath

Custom script should export process(config, done) function

// scriptPath.js

include.exports = {
    process: function(config, done){
        // config is current ActionObject - it can contain additional information
        // for a script

        // do smth. and call done if ready
        done(/* ?error */);
    }
}

@IMPORTANT

/*
    Any require(module) could also be resolved from global npm directory

    Example, you have installed jQuery globally - > npm install jquery -g
    and you can use it from the script as if it was installed in a directory, where
    scriptPath.js is located.

    var jquery = require('jquery');
    This is perfect for a cli scripting.

    Also you can use IncludeJS API here - as io.File:

    var content = new io.File('someTxt').read();

    new io.Directory().readFiles('*.txt).files.forEach(function(file){
        var txt = file.read() + '...';

        new io.File('path').write(txt);
    });
*/

HTTP Server

{
    action: 'server',
    port: 5777, // default 5777
    open: 'index.dev.html' // auto open file in browser
}

Start integrated server in a current working directory.

To start the server direct from command line, use cli action pattern

atma [action] -KEY VALUE

> atma server -port 5500

Reference (Symbolic Links)

{
    "action": "reference"
    "path": directory path || name of a project from globals.txt
    "name": reference name /* optional @default directory name*/
}

> atma reference atmajs

Creates symbolic link in "%current directory%/.reference" folder

gen

Scaffolding

{
    action: "gen",
    name: "name"
}

> atma gen [name]

Templates:

• starter - MaskJS/mask.bindings/jmask/mask.compo/IncludeJS/Ruqq/jQuery
• compo - creates component template .js/.css/*.mask : ```> atma template compo desiredName"
• server - create node.js bootstrap project
• todoapp - creates todomvc sample application

You can create any other templates - just put the files to: %npm-global-directory%/node_modules/includejs/template/%YourTemplateName%

Clone Atma Libraries

> atma git-clone atma

Global Projects and default routes:

> atma globals

Sample:

{
	"projects":{
		"atma" : {
			"path": "file:///c:/Development/atmajs/"
		}
	},
	"defaultRoutes":{
		"atma_lib": 		"{atma}/{0}/lib/{1}.js",
        "atma_ruqq": 		"{atma}/ruqq/lib/{0}.js",
		"atma_compo": 		"{atma}/compos/{0}/lib/{1}.js"
	}
}