| Name | ansible-dev-tools JSON |
| Version |
24.4.4
JSON |
| download |
| home_page | None |
| Summary | Ansible Developtment Tools kit bundles all tools needed for content creation and testing. |
| upload_time | 2024-04-30 15:45:19 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | GPL-3.0-only |
| keywords |
ansible
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<!-- cspell:disable-next-line -->
# Ansible Development Tools (ADT)
The `ansible-dev-tools` python package provides an easy way to install and discover the best tools available to create and test ansible content.
The curated list of tools installed as part of the Ansible automation developer tools package includes:
[ansible-core](https://github.com/ansible/ansible): Ansible is a radically simple IT automation platform that makes your applications and systems easier to deploy and maintain. Automate everything from code deployment to network configuration to cloud management, in a language that approaches plain English, using SSH, with no agents to install on remote systems.
[ansible-builder](https://github.com/ansible/ansible-builder): Ansible Builder is a tool that automates the process of building execution environments using the schemas and tooling defined in various Ansible Collections and by the user.
[ansible-creator](https://github.com/ansible/ansible-creator): The fastest way to generate all your ansible content!
[ansible-lint](https://github.com/ansible/ansible-lint): Checks playbooks for practices and behavior that could potentially be improved.
[ansible-navigator](https://github.com/ansible/ansible-navigator) A text-based user interface (TUI) for Ansible.
[ansible-sign](https://github.com/ansible/ansible-sign): Utility for signing and verifying Ansible project directory contents.
[molecule](https://github.com/ansible/molecule): Molecule aids in the development and testing of Ansible content: collections, playbooks and roles
[pytest-ansible](https://github.com/ansible/pytest-ansible): A pytest plugin that enables the use of ansible in tests, enables the use of pytest as a collection unit test runner, and exposes molecule scenarios using a pytest fixture.
[tox-ansible](https://github.com/ansible/tox-ansible): The tox-ansible plugin dynamically creates a full matrix of python interpreter and ansible-core version environments for running integration, sanity, and unit for an ansible collection both locally and in a Github action. tox virtual environments are leveraged for collection building, collection installation, dependency installation, and testing.
[ansible-dev-environment](https://github.com/ansible/ansible-dev-environment): A pip-like install for Ansible collections.
## Installation
`python3 -m pip install ansible-dev-tools`
## Usage
In addition to installing each of the above tools, `ansible-dev-tools` provides an easy way to show the versions of the content creation tools that make up the current development environment.
```
$ adt --version
ansible-builder <version>
ansible-core <version>
ansible-creator <version>
ansible-dev-environment <version>
ansible-dev-tools <version>
ansible-lint <version>
ansible-navigator <version>
ansible-sign <version>
molecule <version>
pytest-ansible <version>
tox-ansible <version>
```
## Developer Notes
The `ansible-dev-tools` package also offers an Ansible Devtools server which can be launched with `adt server`. Currently, this server only supports REST APIs for `ansible-creator`.
Refer to the [server](https://github.com/ansible/ansible-dev-tools/blob/main/src/ansible_dev_tools/subcommands/server.py) code for available endpoints.
**Note:** This is primarily for backend integrations and is not intended to be an user-facing functionality.
## Documentation
For more information, please visit our [documentation](https://ansible.readthedocs.io/projects/dev-tools/) page.
Raw data
{
"_id": null,
"home_page": null,
"name": "ansible-dev-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Ansible by Red Hat <info@ansible.com>",
"keywords": "ansible",
"author": null,
"author_email": "\"Bradley A. Thornton\" <bthornto@redhat.com>",
"download_url": "https://files.pythonhosted.org/packages/2b/2b/6589626fb55b5b6d47b1f8bd837ea788904c8949634d063f234f9d692607/ansible_dev_tools-24.4.4.tar.gz",
"platform": null,
"description": "<!-- cspell:disable-next-line -->\n\n# Ansible Development Tools (ADT)\n\nThe `ansible-dev-tools` python package provides an easy way to install and discover the best tools available to create and test ansible content.\n\nThe curated list of tools installed as part of the Ansible automation developer tools package includes:\n\n[ansible-core](https://github.com/ansible/ansible): Ansible is a radically simple IT automation platform that makes your applications and systems easier to deploy and maintain. Automate everything from code deployment to network configuration to cloud management, in a language that approaches plain English, using SSH, with no agents to install on remote systems.\n\n[ansible-builder](https://github.com/ansible/ansible-builder): Ansible Builder is a tool that automates the process of building execution environments using the schemas and tooling defined in various Ansible Collections and by the user.\n\n[ansible-creator](https://github.com/ansible/ansible-creator): The fastest way to generate all your ansible content!\n\n[ansible-lint](https://github.com/ansible/ansible-lint): Checks playbooks for practices and behavior that could potentially be improved.\n\n[ansible-navigator](https://github.com/ansible/ansible-navigator) A text-based user interface (TUI) for Ansible.\n\n[ansible-sign](https://github.com/ansible/ansible-sign): Utility for signing and verifying Ansible project directory contents.\n\n[molecule](https://github.com/ansible/molecule): Molecule aids in the development and testing of Ansible content: collections, playbooks and roles\n\n[pytest-ansible](https://github.com/ansible/pytest-ansible): A pytest plugin that enables the use of ansible in tests, enables the use of pytest as a collection unit test runner, and exposes molecule scenarios using a pytest fixture.\n\n[tox-ansible](https://github.com/ansible/tox-ansible): The tox-ansible plugin dynamically creates a full matrix of python interpreter and ansible-core version environments for running integration, sanity, and unit for an ansible collection both locally and in a Github action. tox virtual environments are leveraged for collection building, collection installation, dependency installation, and testing.\n\n[ansible-dev-environment](https://github.com/ansible/ansible-dev-environment): A pip-like install for Ansible collections.\n\n## Installation\n\n`python3 -m pip install ansible-dev-tools`\n\n## Usage\n\nIn addition to installing each of the above tools, `ansible-dev-tools` provides an easy way to show the versions of the content creation tools that make up the current development environment.\n\n```\n$ adt --version\nansible-builder <version>\nansible-core <version>\nansible-creator <version>\nansible-dev-environment <version>\nansible-dev-tools <version>\nansible-lint <version>\nansible-navigator <version>\nansible-sign <version>\nmolecule <version>\npytest-ansible <version>\ntox-ansible <version>\n```\n\n## Developer Notes\n\nThe `ansible-dev-tools` package also offers an Ansible Devtools server which can be launched with `adt server`. Currently, this server only supports REST APIs for `ansible-creator`.\n\nRefer to the [server](https://github.com/ansible/ansible-dev-tools/blob/main/src/ansible_dev_tools/subcommands/server.py) code for available endpoints.\n\n**Note:** This is primarily for backend integrations and is not intended to be an user-facing functionality.\n\n## Documentation\n\nFor more information, please visit our [documentation](https://ansible.readthedocs.io/projects/dev-tools/) page.\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Ansible Developtment Tools kit bundles all tools needed for content creation and testing.",
"version": "24.4.4",
"project_urls": {
"changelog": "https://github.com/ansible/ansible-dev-tools/releases",
"documentation": "https://ansible.readthedocs.io/projects/dev-tools/",
"homepage": "https://github.com/ansible/ansible-dev-tools",
"repository": "https://github.com/ansible/ansible-dev-tools"
},
"split_keywords": [
"ansible"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6ed05dc81ddb4a225361642292dab59e46e120d395f395f28c25e29837c5072b",
"md5": "115be749391791ca598baf81b840c461",
"sha256": "38ceffaa333bd95a5bf591c1d517a5e05dc9e5871d0dbc637b6560e50ddd33ce"
},
"downloads": -1,
"filename": "ansible_dev_tools-24.4.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "115be749391791ca598baf81b840c461",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 24248,
"upload_time": "2024-04-30T15:45:17",
"upload_time_iso_8601": "2024-04-30T15:45:17.929881Z",
"url": "https://files.pythonhosted.org/packages/6e/d0/5dc81ddb4a225361642292dab59e46e120d395f395f28c25e29837c5072b/ansible_dev_tools-24.4.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2b2b6589626fb55b5b6d47b1f8bd837ea788904c8949634d063f234f9d692607",
"md5": "8d04e2839a1584bc964fa08db170192d",
"sha256": "c5293226ee566ffd4b0d26ea1966505023f8724beeaf20b4570b7e81f098fec1"
},
"downloads": -1,
"filename": "ansible_dev_tools-24.4.4.tar.gz",
"has_sig": false,
"md5_digest": "8d04e2839a1584bc964fa08db170192d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 874458,
"upload_time": "2024-04-30T15:45:19",
"upload_time_iso_8601": "2024-04-30T15:45:19.389449Z",
"url": "https://files.pythonhosted.org/packages/2b/2b/6589626fb55b5b6d47b1f8bd837ea788904c8949634d063f234f9d692607/ansible_dev_tools-24.4.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-30 15:45:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ansible",
"github_project": "ansible-dev-tools",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "ansible-dev-tools"
}
