CommandBox Workshop

Description

This workshop will start with the basics of using CommandBox CLI in your everyday workflow. We’ll focus on topics like managing servers, package management, and scripting command line tasks using CFML and Task Runners. We’ll also cover extending the CommandBox core with modules to add your own behaviours. We will focus on hands-on exercises and will end the day with each student building their own module and publishing it to ForgeBox.

Prerequisites

● A working knowledge of CommandBox’s shell and basic commands is desirable but not requried

● Have the latest stable version of CommandBox installed already

● A GitHub account and Git CLI installed (if you want to follow along with publishing packages)

Agenda

● Introductions/checking prerequisites - 15 mins

● Usage Overview - 45 mins

● Native scripting with CFML - 1 hr

● Server Management - 1 hr

● Lunch - 1 hr

● Package Management and Authoring - 1 hr

● Extending CommandBox - 1 hr

● Break - 30 mins

● Exercise Time - 1.5 hr

Introductions/checking prerequisites

● Meet others in the class

● Gather each student’s expectations for the class

● Ensure everyone has CommandBox installed and is ready to go

Usage Overview

● Review help system

● Demo REPL and uses

● Learn about scaffolding commands

● Using shell history, tab completion, and config settings

Native scripting with CFML

● Running .cfm files from your CLI as Task Runners

● Using a database in a stand-alone cfm script

Server Management

● Start/stop servers

● Multi-engine support (Adobe, Lucee, etc)

● Manage servers

● Server.json

● Handling CF configuration with CFConfig

● Using CommandBox for cloud deployments (Heroku, Docker)

Package Management and Authoring

● What is ForgeBox.io

● Find and install packages

● Update packages

● Creating a package

● Package scripts

● Creating a ForgeBox account

● Publish a package to ForgeBox

Creating a Module

● What are modules

● How to use Interceptors

● Packing a model inside a module

● Distributing your work for the world to see

Exercise Time

● Let’s build something!

● Work in teams or alone to create a module that does something cool and publish it to ForgeBox and Github.