## AWS CloudFormation Resource Provider Go 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 Go 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 Go Plugin](https://github.com/aws-cloudformation/cloudformation-cli-go-plugin) - this will automatically install the the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli)! A Python virtual environment is recommended.
```bash
pip3 install cloudformation-cli-go-plugin
```
Refer to the documentation for the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli) for usage instructions.
Development
-----------
For changes to the plugin, a Python virtual environment is recommended. Check out and install the plugin in editable mode:
```bash
python3 -m venv env
source env/bin/activate
pip3 install -e /path/to/cloudformation-cli-go-plugin
```
You may also want to check out the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli) if you wish to make edits to that. In this case, installing them in one operation works well:
```bash
pip3 install \
-e /path/to/cloudformation-cli \
-e /path/to/cloudformation-cli-go-plugin
```
That ensures neither is accidentally installed from PyPI.
Linting and running unit tests is done via [pre-commit](https://pre-commit.com/), and so is performed automatically on commit. The continuous integration also runs these checks. Manual options are available so you don't have to commit:
```bash
# 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, isort, pytest-local
pre-commit run pytest-local
```
Use `./generate-examples.sh` to run install `cloudformation-cli-go-plugin` locally and run `cfn generate` in each example.
Getting started
---------------
This plugin create a sample Go project and requires golang 1.8 or above and [godep](https://golang.github.io/dep/docs/introduction.html). For more information on installing and setting up your Go environment, please visit the official [Golang site](https://golang.org/).
Community
---------------
Join us on Discord! Connect & interact with CloudFormation developers &
experts, find channels to discuss and get help for cfn-lint, CloudFormation registry, StackSets,
Guard and more:
[](https://discord.gg/9zpd7TTRwq)
License
-------
This library is licensed under the Apache 2.0 License.
Raw data
{
"_id": null,
"home_page": "https://github.com/aws-cloudformation/cloudformation-cli-go-plugin/",
"name": "cloudformation-cli-go-plugin",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "Amazon Web Services AWS CloudFormation",
"author": "Amazon Web Services",
"author_email": "aws-cloudformation-developers@amazon.com",
"download_url": "https://files.pythonhosted.org/packages/bd/e2/07731582bdbdeac245da88cfa3154530a26688d14fa4153f49271608c9ca/cloudformation-cli-go-plugin-2.2.0.tar.gz",
"platform": null,
"description": "## AWS CloudFormation Resource Provider Go Plugin\n\nThe CloudFormation CLI (cfn) allows you to author your own resource providers that can be used by CloudFormation.\n\nThis plugin library helps to provide Go runtime bindings for the execution of your providers by CloudFormation.\n\nUsage\n-----\n\nIf you are using this package to build resource providers for CloudFormation, install the [CloudFormation CLI Go Plugin](https://github.com/aws-cloudformation/cloudformation-cli-go-plugin) - this will automatically install the the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli)! A Python virtual environment is recommended.\n\n```bash\npip3 install cloudformation-cli-go-plugin\n```\n\nRefer to the documentation for the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli) for usage instructions.\n\nDevelopment\n-----------\n\nFor changes to the plugin, a Python virtual environment is recommended. Check out and install the plugin in editable mode:\n\n```bash\npython3 -m venv env\nsource env/bin/activate\npip3 install -e /path/to/cloudformation-cli-go-plugin\n```\n\nYou may also want to check out the [CloudFormation CLI](https://github.com/aws-cloudformation/cloudformation-cli) if you wish to make edits to that. In this case, installing them in one operation works well:\n\n```bash\npip3 install \\\n -e /path/to/cloudformation-cli \\\n -e /path/to/cloudformation-cli-go-plugin\n```\n\nThat ensures neither is accidentally installed from PyPI.\n\nLinting and running unit tests is done via [pre-commit](https://pre-commit.com/), and so is performed automatically on commit. The continuous integration also runs these checks. Manual options are available so you don't have to commit:\n\n```bash\n# run all hooks on all files, mirrors what the CI runs\npre-commit run --all-files\n# run unit tests only. can also be used for other hooks, e.g. black, isort, pytest-local\npre-commit run pytest-local\n```\n\nUse `./generate-examples.sh` to run install `cloudformation-cli-go-plugin` locally and run `cfn generate` in each example.\n\nGetting started\n---------------\n\nThis plugin create a sample Go project and requires golang 1.8 or above and [godep](https://golang.github.io/dep/docs/introduction.html). For more information on installing and setting up your Go environment, please visit the official [Golang site](https://golang.org/).\n\nCommunity\n---------------\n\nJoin us on Discord! Connect & interact with CloudFormation developers &\nexperts, find channels to discuss and get help for cfn-lint, CloudFormation registry, StackSets,\nGuard and more:\n\n[](https://discord.gg/9zpd7TTRwq)\n\nLicense\n-------\n\nThis library is licensed under the Apache 2.0 License.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "",
"version": "2.2.0",
"project_urls": {
"Homepage": "https://github.com/aws-cloudformation/cloudformation-cli-go-plugin/"
},
"split_keywords": [
"amazon",
"web",
"services",
"aws",
"cloudformation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b9dee82f0579b1449787f84e9aab50d51d3c7db5f3f7034130d11f521b3eb3c2",
"md5": "007b94cb5bffeea426c2718d2397b4b0",
"sha256": "a1f5325460f98acf61acf7da9c98f4be9818c51d3495edeb1153c3dab653d59a"
},
"downloads": -1,
"filename": "cloudformation_cli_go_plugin-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "007b94cb5bffeea426c2718d2397b4b0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 17183,
"upload_time": "2023-12-11T19:44:58",
"upload_time_iso_8601": "2023-12-11T19:44:58.713562Z",
"url": "https://files.pythonhosted.org/packages/b9/de/e82f0579b1449787f84e9aab50d51d3c7db5f3f7034130d11f521b3eb3c2/cloudformation_cli_go_plugin-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bde207731582bdbdeac245da88cfa3154530a26688d14fa4153f49271608c9ca",
"md5": "ead24e0cb29fe1738cdb61c46e4444b9",
"sha256": "d79ea4341d204cebd4fd290aef847efb84adf33719bf19444ec45208b8c12f14"
},
"downloads": -1,
"filename": "cloudformation-cli-go-plugin-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "ead24e0cb29fe1738cdb61c46e4444b9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14326,
"upload_time": "2023-12-11T19:45:02",
"upload_time_iso_8601": "2023-12-11T19:45:02.751565Z",
"url": "https://files.pythonhosted.org/packages/bd/e2/07731582bdbdeac245da88cfa3154530a26688d14fa4153f49271608c9ca/cloudformation-cli-go-plugin-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-11 19:45:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aws-cloudformation",
"github_project": "cloudformation-cli-go-plugin",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cloudformation-cli-go-plugin"
}
JSON
