No project description provided
Project description
About
pop-create-idem is an extension of pop-create that creates boilerplate code for new idem-cloud projects. pop-create-idem includes code that transforms a CloudSpec dictionary into idem states, tools, and exec modules. Your unique pop_create plugin’s purpose is to convert API documentation into the CloudSpec format.
Note: It is recommended that you use a Python virtual environment when creating a new Idem provider plugin.
Getting Started
Before you start, ensure that you installed Python 3.8 or later. If you are running 3.7 or earlier, you might need to use python3 instead of python in the commands in the rest of this tutorial.
To verify your Python version, run the following command:
python -VNext, create your virtual environment:
python -m venv env
source env/bin/activateNow you should be in your new Python virtual environment.
Update pip
Next, update to the latest version of pip inside your virtual environment:
pip install -U pipInstall dependencies
Next, you need to install pop-create:
pip install pop-createYou now have access to the pop-create command for creating Idem plugins.
Install pop-create-idem
Install pop-create-idem with pip from the project root:
pip install -e {project_root}Next, install pop-create-idem with pip from PyPi:
pip install pop-create-idemGenerate an Idem Cloud plugin
Now you are ready to run pop-create to generate an Idem plugin. You can generate a skeleton project to write exec and state modules for your cloud manually or completely auto-generate your plugin based on your cloud OpenAPI or Swagger specification.
Skeleton plugin
To generate a new skeleton Idem Cloud plugin, run the following command:
pop-create idem-cloud --directory /path/to/new/project --project-name=idem-{my_cloud} --simple_cloud_name={my_cloud} --author={company_name}This command creates a new project with the directory structure needed to get started with your plugin.
See Create Idem Provider Plugin for information about developing an Idem plugin.
Swagger specification
To generate a new Idem plugin with a Swagger specification, run the following command:
pop-create swagger --directory /path/to/new/project --specification={swagger-spec-yaml-or-accessible-swagger-spec-json-url} --project-name=idem-{my_cloud} --simple_cloud_name={my_cloud} --author={company_name}OpenAPI3 specification
To generate a new Idem plugin project with an OpenAPI3 specification, run the following command:
pop-create openapi3 --directory /path/to/new/project --specification={openapi3-spec-yaml-or-accessible-openapi3-spec-json-url} --project-name=idem-{my_cloud} --simple_cloud_name={my_cloud} --author={company_name}This command creates a new project with the boilerplate code needed to get started with each respective cloud provider.
Next steps
After you generate your Idem plugin:
Configure the plugin for your provider. See the quickstart for instructions.
Try the example Swagger petstore tutorial Auto-generate an Idem plugin from Swagger, which walks you through generating an Idem plugin with a Swagger specification.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pop-create-idem-4.4.9.tar.gz.
File metadata
- Download URL: pop-create-idem-4.4.9.tar.gz
- Upload date:
- Size: 50.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/41.0 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.4 tqdm/4.66.1 importlib-metadata/6.8.0 keyring/24.2.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | af9f95eb5b6157b4ae04fde4873f279014a6b40b62c087cca3ad6b6db1733f9c |
|
| MD5 | c871821b915a8fa6a10b2679c3ee4515 |
|
| BLAKE2b-256 | 6ade3d9058c67f57f85001e9117a8f0af32aafea49faf4bc8b1b94eebd2d9f6a |
File details
Details for the file pop_create_idem-4.4.9-py3-none-any.whl.
File metadata
- Download URL: pop_create_idem-4.4.9-py3-none-any.whl
- Upload date:
- Size: 86.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/41.0 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.4 tqdm/4.66.1 importlib-metadata/6.8.0 keyring/24.2.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.9.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ac54feb93c7b7fbf0030afeaf1e827cb72163ca386e235a44797baedf3d85aeb |
|
| MD5 | 0bf3b80ab718f20630fe42aeb5e10dd2 |
|
| BLAKE2b-256 | 5e0f656d76d9def7543949c536828f5bbeaa0b8179f7eeff295b9dd7f152fd23 |
