Skip to content

ansible/ansible-creator

Repository files navigation

codecov PyPI - Status PyPI - Version PyPI - Python Version License Ansible Code of Conduct GitHub issues

ansible-creator

A CLI tool for scaffolding all your Ansible Content.

Installation

pip install ansible-creator
$ ansible-creator --help
usage: ansible-creator [-h] command ...

The fastest way to generate all your ansible content.

Positional arguments:
 command
  add           Add resources to an existing Ansible project.
  init          Initialize a new Ansible project.

Options:
 --version      Print ansible-creator version and exit.
 -h     --help  Show this help message and exit

Usage

Full documentation on how to use ansible-creator, including integration with the VS Code Ansible Extension, is available in ansible-creator documentation.

Command line completion

ansible-creator has experimental command line completion for common shells. Please ensure you have the argcomplete package installed and configured.

pip install argcomplete --user
activate-global-python-argcomplete --user

Upcoming features

  • Scaffold Ansible plugins of your choice with the create action. Switch to the create branch and try it out!

Communication

Refer to the Get in Touch section of the Contributor Guide to find out how to communicate with us.

You can also find more information in the Ansible communication guide.

Contributing

See Contributing to ansible-creator.

Code of Conduct

Please see the Ansible Community Code of Conduct.

Licensing

ansible-creator is released under the Apache License version 2.

See the LICENSE file for more details.