brew install commandbox

curl -fsSl https://downloads.ortussolutions.com/debs/gpg | sudo apt-key add -

echo "deb https://downloads.ortussolutions.com/debs/noarch /" | sudo tee -a /etc/apt/sources.list.d/commandbox.list

sudo apt-get update && sudo apt-get install apt-transport-https commandbox

CommandBox> set foo=bar
CommandBox> REPL

CFSCRIPT-REPL: echo( '${foo}' )
bar

CFSCRIPT-REPL: breakfast = ['bacon','eggs']
=> [
    "bacon",
    "eggs"
]
CFSCRIPT-REPL: breakfast.len()
=> 2
CFSCRIPT-REPL: breakfast.append( 'orange juice' )
=> [
    "bacon",
    "eggs",
    "orange juice"
]

CommandBox> jq [1,2,-3,4,-5,6,-7,-8,9] [?contains('-8',@)]
=> [
    -8
]

CommandBox> jq box.json pluck(@,'name') # only show 'name' key

CommandBox> jq box.json omit(@,'name,version') # show all keys except 'name & version' keys

CommandBox> jq box.json keys(@) # list an array of all keys in a struct

CommandBox> jq box.json values(@) # list an array of all values in a struct

CommandBox> jq box.json to_entries(@)
=> [
  {
    "key":"author",
    "value":"Scott Steinbeck"
  },
  {
    "key":"bugs",
    "value":""
  },
  {
    "key":"changelog",
    "value":""
  }...
  
  

Commandbox> jq box.json key_contains(@,'on')
=> {
  "shortDescription":"",
  "instructions":"",
  "version":"0.0.0",
  "location":"ForgeboxStorage",
  "documentation":"",
  "contributors":[],
  "description":""
}

# filter the server list and then group by the value of the status key
Commandbox>  server list --json | jq "group_by([].{name: name, status: status},'status')" 

# Can also be written with pipes
# Step 1. filter server list array to just name and status keys
# Step 2. group by @ (each item) where the value of 'status' is the same
Commandbox> server list --json | jq "[].{name: name, status: status} | group_by(@,'status')" 

=> {
  "running":[
    {
      "status":"running",
      "name":"Server 1"
    }
  ],
  "stopped":[
    {
      "status":"stopped",
      "name":"Server 2"
    },...

# commandbox CLI settings
config set tabCompleteInline=true #show autocomplete as dropdown
config set preferredBrowser=chrome #set preferred browser 

# server defaults (get used if not set in a sites box.json)
config set server.defaults.web.rewrites.enable=true
config set server.defaults.openbrowser=false
config set server.defaults.jvm.heapsize=1024

# commandbox module setting overrides 
config set modules.TestModule.mySetting=overridden
config set modules.TestModule.somethingEnabled=false

server list

site1 (starting)
  https://127.0.0.1:8081
  C:\site1

site1 (running)
  https://127.0.0.1:8082
  C:\site2

site3 (stopped)
  https://127.0.0.1:8083
  C:\site3
  

# Running servers
server list --running

# Stop Servers
server stop site1
server stop --all

# Clean up old severs
server prune days=30

# CommandBox CLI config settings
# config set tabCompleteInline=true #show autocomplete as dropdown
env set box_config_tabCompleteInline=true


# CFConfig Settings
# configure admin password for all servers
env set cfconfig_adminPassword myPassword
env set cfconfig_scopeCascading "standard"
env set cfconfig_whitespaceManagement= "smart"

# Server.json settings
env set box_server_profile=production
env set box_server_web_http_port=8080
env set box_server_web_ssl={ "enabled" : true, "port": 443 }

// current directory
cd .   -> ./
// back 1 directory
cd ..  -> ../
// back 2 directories
cd ... -> cd ../../
// back 3 directories
cd .... -> cd ../../../ 

box> !myApp.exe
box> !git pull
box> !dir

box> #now
> {ts '2016-01-19 16:14:23'}
box> #hash mypass
> A029D0DF84EB5549C641E04A9EF389E5
box> #reverse abc
> cba

box> #listGetAt www.foo.com 2 . | #ucase | #reverse
> OOF
box> package show name | #lcase
> my package
box> !java -ver | #ucase
> JAVA VERSION "1.8.0_92"

#extensionlist  | sql select=id,name >> extentions.json

# Recomended CommandBox system modules
install commandbox-bullet-train,commandbox-cfconfig,commandbox-cfformat,commandbox-dotenv,commandbox-update-check,commandbox-fusionreactor,cfdocs,commandbox-githooks,commandbox-migrations,quick-commands,commandbox-cflint,commandbox-bookmarks

# Recommended CommandBox shortcuts
config set command.aliases.git="!git"
config set command.aliases.gulp="!gulp"
config set command.aliases.npm="!npm"

box> recipe essentials.boxr

/**
* Description of task
*/
component {

	/**
	* 
	*/
	function run() {
		print.greenLine( 'Complete!' );
	}

}

CommandBox> task run task.cfc
Complete!

component{
    function greet( string name, boolean verbose ){
        print.line( 'Well, hello there #name#!' );
        if( verbose ) {
            print.line( "You're looking quite well today." );
        }
    }
}

task run taskFile=fun target=greet :name=Brad :verbose=false

// Returns the AsyncManager class
async()

// Convenience method for getting stuff from WireBox
getInstance( name, dsl, initArguments={}, targetObject='' )

// Retuns current exit code
getExitCode()

// Sets exit code to be returned when task completes
setExitCode( required numeric exitCode )

// Returns the current working directory of the shell
getCWD()

// ask the user a question and wait for response
ask( message, string mask='', string defaultResponse='', keepHistory=false, highlight=true, complete=false )

// Wait until the user's next keystroke amd return the char code
waitForKey( message='' )

// Ask the user a question looking for a yes/no response and return a boolean
confirm( required message )

// Intiator for multiselect DSL. (Check "task interactiviy" page in docs)
multiSelect()

// Run another command by name.
runCommand( required command, returnOutput=false )

// Intiator for Command DSL. (Check "running other commands" page in docs)
command( required name )

// Intiator for directory watcher DSL.  (Check "Watchers" page in docs)
watch()

// This resolves an absolute or relative path using the rules of the operating system and CLI.
resolvePath( required string path, basePath=shell.pwd() )

// Intiator for PropertyFile DSL (check "property files" page in docs)
propertyFile( propertyFilePath='' )

// Report error in your task. Raises an exception that will not print the stack trace
error( required message, detail='', clearPrintBuffer=false, exitCode=1 )

// Open a file or folder externally in the default editor for the user.
openPath( path )

// Open a URL in the user's browser
openURL( theURL, browser='' )

// Get and Set Environment Variables
setSystemSetting( required string key, string value )
getSystemSetting( required string key, defaultValue )
getSystemProperty( required string key, defaultValue )
getEnv( required string key, defaultValue )

// Call this method periodically in a long-running task to check and see
// if the user has hit Ctrl-C.
checkInterrupted( thisThread=variables.thisThread )

// Loads up Java classes into the class loader that loaded the CLI for immediate use.
classLoad( paths )

job.start( 'Starting server' );
  job.addLog( 'This is the server name' );
  job.addWarnLog( 'Hey, don''t touch that dial' );

    job.start( 'Installing CF Engine first' );
      job.addLog( 'This was the version used' );
      job.addLog( 'Yeah, we''re done' );
    job.complete();

  job.addLog( 'Aaand, we''re back!.' );
  job.addErrorLog( 'I think we''re going to crash' );

job.error( 'Didn''t see that coming' );

component {

    this.config = [
        {'name': 'Update models', 'file':'weather_models.cfc','timespan': createtimespan(0,0,60,0)},
        {'name': 'Setup stations','file':'setup_station.cfc', 'timespan': createtimespan(0,1,0,0)}    ];

    function run(){
        if(!this.config.len())print.greenLine("We have no cron jobs..... goodbye").toConsole();  return;
        
        //setup config vars
        for(var cronItem in this.config){ cronItem.lastRun = 0; }

        while( true ) {
            for(var cronItem in this.config){
                var timeElapsedMs = GetTickCount() - cronItem.lastRun;
                if(timeElapsedMs > cronItem.millis) {

                    //run our task
                    try{
                        task(cronItem.file).run(); //run the task
                    } catch (any e) {
                        print.line(e.Message).toConsole();
                        print.line(e.Detail).toConsole()
                        savecontent variable="mailBody" {  writeDump(e); };

                        // Send
                        mailService.send();
                    }
                    cronItem.lastRun = GetTickCount(); //record last run in milliseconds

                }
                sleep( 10000 ); //just a safety 
            }

        }
    }


}

box install commandbox-command-scaffold

{
  "author":"Scott Steinbeck",
  "location":"ForgeboxStorage",
  "name":"bookmarks Command",
  "private":false,
  "slug":"commandbox-bookmarks-command",
  "type":"commandbox-modules",
  "version":"0.0.0"
}

/**
* This is a description of what 
* this command does!
*
* {code:bash}
* bookmarks param1
* {code} 
**/
component {
  
  /**
  * @param1.hint Description of 
  * the first parameter
  */
  function run( required String param1 ){
      return  'Hello ' & param1 & '!'; 
  }
}

component {
  function configure(){
    settings = {}; // settings specific to the module
    interceptors = []; //interception points within the module 
  }

  function onCLIStart( interceptData ) {} // when commandbox starts
  function onCLIExit() {} // when commandbox exits
  function onBulletTrain( interceptData ) {   // when bullet train starts    
    var print = wirebox.getInstance( 'print' );
    interceptData.cars.myBulletTrainCar.text = print.whiteOnRed(' This sure is easy! ');
    interceptData.cars.myBulletTrainCar.background = 'red';   
  } 
  function preCommandParamProcess( interceptData ) {} // prior to the time the system settings are expanded
  function preCommand( interceptData ) {} // before the execution of a command
  function postCommand( interceptData ) {} // after command execution is complete
  function prePrompt( interceptData ) {} // before drawing the prompt in the interactive shell
  function preProcessLine( interceptData ) {} // fire before and after each command
  function postProcessLine( interceptData ) {} // after the entire line has been executed.
}

# Start the default engine
CommandBox> start

# Start the latest stable Railo engine
CommandBox> start cfengine=railo

# Start a specific engine and version
CommandBox> start cfengine=adobe@10.0.12

# Start the most recent Adobe server that starts with version "11"
CommandBox> start cfengine=adobe@11

# Start the most recent adobe engine that matches the range
CommandBox> start cfengine="adobe@>9.0 <=11"

# Start the most recent adobe engine that matches the range
CommandBox> start cfengine=lucee@5.3 javaVersion=11

CommandBox> install commandbox-cfconfig

cfconfig export myConfig.json
cfconfig import myConfig.json

#automatically export after when the server is stopped
config set modules.commandbox-cfconfig.exportOnStop=true

cfconfig datasource save name=myDSN dbdriver=mysql host=localhost port=3306 database=myDB username=brad password=foobar
cfconfig datasource save name=myDS ... to=serverName
cfconfig datasource save name=myDS ... to=/path/to/server/home

# ColdBox Name and Environment
APPNAME=crazy horse
ENVIRONMENT=development
MYSUPERSECRETPASSWORD=bacon

server log --follow

# You can also look at your server's access log (if enabled) and rewrite log (if enabled).  
server log --follow -access
server log --follow --rewrite

{
  "web": {
    "ssl" : {
      "enable" : true,
      "port" : 443,
      "HSTS" : {
        "enable" : true,
        "maxAge" : 31536000,
        "includeSubDomains" : true
      }
     }
  }
}

{
  "profile": "production",
  "web": {
    "blockCFAdmin": false
  }
}

{
    "web" : {
        "rules" : [
            "path-suffix(/box.json) -> set-error(404)",
            "path-suffix(hidden.js) -> set-error(404)",
            "path-prefix(/admin/) -> ip-access-control(192.168.0.* allow)",
            "path(/sitemap.xml) -> rewrite(/sitemap.cfm)",
       		 "disallowed-methods(trace)"
        ],
        "rulesFile" : "..." //or rules file
    }
}

[Unit]
Description=mySite Service

[Service]
ExecStart=/usr/bin/box server start /var/www/mySiteAPI/server.json
Type=forking

[Install]
WantedBy=multi-user.target

# place in startup directory
Filepath: /usr/lib/systemd/system/mySite.service

#start the service
systemctl start mySite.service

#stop the service
systemctl stop mySite.service

#check service status
systemctl status mySite.service