Mason CLI
The Mason CLI provides command line tools to help you manage your configurations in the Mason Platform.
The full docs to get started with the Mason Platform are available here: https://docs.bymason.com/intro/ For docs on using the Mason CLI, see the setup guide here: https://docs.bymason.com/getting-started/
Using the CLI
Find the latest release and download the CLI for your platform under "Assets".
Developing the CLI
Perquisites
- Install Python 3
- Make it the default
- Run
pip install virtualenvwrapper
- Run
echo "source virtualenvwrapper.sh" >> ~/.bashrc
Building the CLI
- Clone this repo:
git clone https://github.com/MasonAmerica/mason-cli.git && cd mason-cli
- Create a virtual environment:
mkvirtualenv mason-cli
- Or use an existing one:
workon mason-cli
- Or use an existing one:
- Install dependencies:
pip install mock && pip install -e .
Testing the CLI
All behavior changes and bug fixes should come with associated test changes. While you can manually
run tests with python3 setup.py test
, the best way to do so is with IntelliJ's
Auto Test feature which
continuously tests your code as you write it. Just run all tests in the tests
folder.
Cutting a release
The release process is automated using tag pushes.
- Create a commit called
v$VERSION
which sets the CLI version inside theVERSION
file at the root of this repository.- The commit message will be used as release notes for this CLI release.
- Create a tag for that commit and call it
$VERSION
. - Push both the commit and tag to master.
For an example, see e50d6981a77e5d1a363cb5a8c97a644a07aaabfb.