Lucky CLI

A Crystal library for creating and running tasks

Installing the CLI by Homebrew

Install homebrew
Run brew tap luckyframework/lucky
Run brew install lucky

Building CLI from source

Install crystal
Clone the repo git clone https://github.com/luckyframework/lucky_cli
Go to the repo directory cd lucky_cli
Run shards install
Run crystal build src/lucky.cr -o /usr/local/bin/lucky (instead of /usr/local/bin/ destination you can choose any other directory that in $PATH)

Run which lucky from the command line to make sure it is installed.

If you're generating a Lucky web project, install the required dependencies. Then run lucky init

Documentation

API (master)

Adding Custom Tasks

Want to add custom tasks? Check out LuckyTask for getting started.

Contributing

Fork it ( https://github.com/luckyframework/lucky_cli/fork )
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Check that specs on GitHub Actions CI pass
Create a new Pull Request

Testing Deployment to Heroku

Testing deployment to Heroku is skipped locally by default. The easiest way to run the deployment tests is to push up a branch and open a PR. This will run tests against Heroku to make sure deployment is working as expected.

If you want though, you can also test deployment locally:

Sign up for a Heroku account and install the CLI.
Run heroku authorizations:create --description="Lucky CLI Integration Tests".
Grab the token from that command and put it in the generated .env file.
Change RUN_HEROKU_SPECS from 0 to 1 in the .env file.
Run script/setup to make sure all dependencies are installed.
Run script/test to test everything, or run script/test specs/integration/deploy_to_heroku_spec.cr