The CloudFormation CLI (cfn) allows you to author your own resource providers that can be used by CloudFormation.
This plugin library helps to provide Java runtime bindings for the execution of your providers by CloudFormation.
If you are using this package to build resource providers for CloudFormation, install the CloudFormation CLI Java Plugin - this will automatically install the the CloudFormation CLI! A Python virtual environment is recommended.
pip3 install cloudformation-cli-java-plugin
For changes to the plugin, a Python virtual environment is recommended. Check out and install the plugin in editable mode:
python3 -m venv env source env/bin/activate pip3 install -e /path/to/cloudformation-cli-java-plugin
You may also want to check out the CloudFormation CLI if you wish to make edits to that. In this case, installing them in one operation works well:
pip3 install \ -e /path/to/cloudformation-cli \ -e /path/to/cloudformation-cli-java-plugin
That ensures neither is accidentally installed from PyPI.
Linting and running unit tests is done via pre-commit, and so is performed automatically on commit after being installed (
pre-commit install). The continuous integration also runs these checks. Manual options are available so you don't have to commit:
# run all hooks on all files, mirrors what the CI runs pre-commit run --all-files # run unit tests only. can also be used for other hooks, e.g. black, flake8, pylint-local pre-commit run pytest-local
This library is licensed under the Apache 2.0 License.