Delta Systems CLI Tools
Command-line tools used at Delta Systems for common development workflow needs.
Delta CLI is an open source project started to improve development workflows at Delta Systems. Before Delta CLI, each project had its own ad-hoc shell scripts, Phing configuration files, git hooks, etc. When switching between projects, developers would have to learn the particular idiosyncracies of that project's deployment scripts. Beyond that, these scripts were typically written without robust error handling, logging or notifications. Delta CLI scripts have a handful of important properties that address these issues.
- Original Intro to the Delta-CLI Project https://youtu.be/lm4iAuW4sIk
- Working with remote dev environments in Delta-CLI https://youtu.be/QlSR8enp_Cg
- Installing Delta CLI Tools using composer https://youtu.be/JTM429G2fps
- In Delta CLI 2.0 we added logging and Slack notifications https://youtu.be/Va_1Tsx5FFk
- Delta CLI v3.27.0 New Feature Update 2017-01-05 https://youtu.be/5I_fq9yEl1A
- Delta-CLI: Custom Scripts Walkthrough https://youtu.be/Nmkc_AIHe_g
After cloning the repository, install dependencies with Composer, as in the following example:
$ git clone firstname.lastname@example.org:DeltaSystems/delta-cli-tools.git $ cd delta-cli-tools $ composer install
$ vendor/bin/phpunit --bootstrap 'tests/bootstrap.php' tests/ &>phpunit.out ; less phpunit.out
You will need to run
composer install in order to pass all tests.
Docker / Windows Support
For Windows users (or any OS), there is a Docker environment and commands available to run Delta CLI from your environment.
To get started, you need to have Docker installed, with both the
docker-compose commands available.
You also need to make sure that your source files are shared for mounting and that you are signed into the Docker Store.
It is also necessary to add the ./bin-docker folder to your local OS PATH variable to
access the docker commands once installed (even in a global installation).
Once those are prerequisites are met, simply execute delta in your Windows environment.
delta-docker.bat which passes through to
delta-docker.ps1, a specialised script that uses
docker run to execute your delta-cli commands.
Note: when you first execute
delta on Windows it will init a build of the delta-cli docker container. Subsequent runs won't have this overhead.
To enable code inspections in PHPStorm, in the PHP section of Languages & Frameworks settings add
~/.composer/vendor to your include paths