Skip to main content

No project description provided

Project description

AWS CloudFormation Resource Provider Java Plugin

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.

Usage

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.

Prerequisites

  • Python version 3.8 or above
  • Your choice of Java IDE
  • Lombok: The code generated by the CloudFormation CLI uses Lombok, which requires support in IDEs for some syntax highlighting to work. For the best development experience, it is recommended you install Lombok support in your IDE.

Installation

pip3 install cloudformation-cli-java-plugin

Refer to the CloudFormation CLI User Guide for the CloudFormation CLI for usage instructions.

Alternate Type Formats

The format keyword can be specified on primitive types defined in a resource provider's schema to allow the CloudFormation CLI Java Plugin to generate more than the defaults for primitive types. Consult the table below for what formats are available and defaults for various types. The default value is used if omitted:

JSON Schema Type Format value Generated variable type
boolean default Boolean
integer default, int32 Integer
integer int64 Long
number default Double
string default String

For example, the below schema for a property would generate a variable of type Long.

{
    "type": "integer",
    "format": "int64"
}

Development

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

Install pytest-cov, used when running unit tests for this plugin:

pip3 install pytest-cov

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

License

This library is licensed under the Apache 2.0 License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cloudformation-cli-java-plugin-2.2.3.tar.gz (39.7 kB view details)

Uploaded Source

Built Distribution

cloudformation_cli_java_plugin-2.2.3-py3-none-any.whl (67.4 kB view details)

Uploaded Python 3

File details

Details for the file cloudformation-cli-java-plugin-2.2.3.tar.gz.

File metadata

File hashes

Hashes for cloudformation-cli-java-plugin-2.2.3.tar.gz
Algorithm Hash digest
SHA256 787288f69c7c85347ce543bc3bc88db5cdcb1295938b73980c2002412963222b
MD5 b956aa212d814e9f2074c4512c5644c5
BLAKE2b-256 16f1d2a2c9a2c3d6452bf57d6335db969203c0a9834e90877e6652caa2af5e89

See more details on using hashes here.

File details

Details for the file cloudformation_cli_java_plugin-2.2.3-py3-none-any.whl.

File metadata

File hashes

Hashes for cloudformation_cli_java_plugin-2.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 644d04dcba212b03b7980772b15b0bb44c781546f605823c04cdd43820a26aec
MD5 a6c30134cd171b94ec2bcdb429d61e0b
BLAKE2b-256 c07224a6a48ca8238ac32860eca28f3cd06f485a22b6e4d07ae245471fa14615

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page