CloudFormation Tools by Ellation
EllationFormation: CloudFormation Tools for AWS by Ellation
The easiest way to install ef-open is to use pip in a virtualenv:
$ pip install ef-open
or, if you are not installing in a virtualenv, to install globally:
$ sudo pip install ef-open
or for your user:
$ pip install --user ef-open
If you have the ef-open installed and want to upgrade to the latest version you can run:
$ pip install --upgrade ef-open
You may need to use python3 on your local system this may map to: $ pip3 install ef-open
ef-cf - Evaluate templatized CloudFormation templates, with the option to generate changesets or apply them
ef-cf-diff - Test some or all templates against a target environment, for differences
ef-check-config - Validate the config files for JSON correctness
ef-generate - Ensure the existence of various standard elements for a target environment
ef-instanceinit - Host startup script which copies customized instance config from S3 to the local host
ef-password - Manage an encrypted secrets file, with the keys stored in AWS's KMS
ef-resolve-config - Generate late-bind config assets, for testing
ef-version - Manage versioned tagging for AMI's and static assets
Testing and Linting
This project uses Python
unittest framework for unit tests, and
pylint for lint checking.
python setup.py test pylint --rcfile=./pylintrc ./efopen
This project uses Versioneer to manage the release versions, based on Git tags on the code repository.
Versions for Git working copies are generated on the fly based on the commit status of the working copy, and will change automatically as modifications are made and committed to the repository. For released packages, versions are frozen during packaging, and reflect the state of the working copy at the time the package was built.
Generated package versions follow the PEP440 spec, and will be of the form:
TAG - the most recent Git tag string (written by the user when the Git tag was created)
DISTANCE - the number of commits between the current commit and the given TAG. If this git commit is the tagged commit, this value will be omitted.
SHORTHASH - the short Git ref hash, specifying the specific Git ref of the current commit. If this git commit is the tagged commit, this value will be omitted.
".dirty" - will be appended if the working copy has uncommitted changes to tracked files (but importantly, un-tracked files will not affect this flag).
Creating a new Release
To cut a new package release (for example, for a version
- Git tag the target Git commit:
git tag -a 1.2.3 -m "Some reasonable tag message"
- Push the code and tag:
git push && git push --tags
The Jenkins CI pipeline will then recognize the new tag, build it, and publish it to PyPI. To be sure, watch the Jenkins pipeline progress and ensure that the new package tag is published to PyPI.
DO NOT delete a tag and retag the same tag on a different commit. This will not result in a replacement in PyPI, it will just make you sad.
Copyright 2016-2017 Ellation, Inc. Licensed under the Apache 2.0 License
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size ef_open-1.34.6-py2-none-any.whl (86.8 kB)||File type Wheel||Python version py2||Upload date||Hashes View|
|Filename, size ef-open-1.34.6.tar.gz (85.0 kB)||File type Source||Python version None||Upload date||Hashes View|