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.
3 maintainers
Metadata
3 maintainers
Release files for pop-create-idem 4.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pop-create-idem-4.5.1.tar.gz | 51.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pop_create_idem-4.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 137.8 kB
Release files / pop-create-idem-4.5.1.tar.gz
| Download URL | pop-create-idem-4.5.1.tar.gz |
|---|---|
| Size | 51.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2692dea3eb770fe7584d361b51d88ed29c5b04cd801d3eca5ec8a3586c3d430e
|
|
BLAKE2b-256 checksum How to use checksums |
d4523ca03bcf4b13e635f9e32f884d42c452e5f5758db39fd2f695f955609195
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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.5 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
|
Release files / pop_create_idem-4.5.1-py3-none-any.whl
| Download URL | pop_create_idem-4.5.1-py3-none-any.whl |
|---|---|
| Size | 86.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fa9c03be8ea9dcae0b595e3b0fec88463ddbc49c26d65317217c682af1c1ab50
|
|
BLAKE2b-256 checksum How to use checksums |
a06d4d56508e3b809e2fb818eabf2f17ba45f58c9c615fc3318202842d19334f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is 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.5 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
|
