Metadata-Version: 2.4
Name: ansible-creator
Version: 25.10.0
Summary: A CLI tool for scaffolding Ansible Content.
Author-email: Nilashish Chakarborty <nchakrab@redhat.com>
Maintainer-email: Ansible by Red Hat <info@ansible.com>
License: Apache
Project-URL: changelog, https://github.com/ansible/ansible-creator/releases
Project-URL: documentation, https://ansible.readthedocs.io/projects/creator/
Project-URL: homepage, https://github.com/ansible/ansible-creator
Project-URL: repository, https://github.com/ansible/ansible-creator
Keywords: ansible
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: importlib-resources; python_full_version < "3.10"
Requires-Dist: jinja2>=3.1.2
Requires-Dist: pyyaml>=6.0.2
Dynamic: license-file

[![codecov](https://codecov.io/github/ansible/ansible-creator/graph/badge.svg?token=QZKqxsNNsL)](https://codecov.io/github/ansible/ansible-creator)
[![PyPI - Status](https://img.shields.io/pypi/status/ansible-creator)](https://pypi.org/project/ansible-creator/)
[![PyPI - Version](https://img.shields.io/pypi/v/ansible-creator)](https://pypi.org/project/ansible-creator/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ansible-creator)
![License](https://img.shields.io/github/license/ansible/ansible-creator)
[![Ansible Code of Conduct](https://img.shields.io/badge/Code%20of%20Conduct-Ansible-silver.svg)](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)
[![GitHub issues](https://img.shields.io/github/issues/ansible/ansible-creator)](https://github.com/ansible/ansible-creator/issues)

# ansible-creator

A CLI tool for scaffolding all your Ansible Content.

## Installation

```shell
pip install ansible-creator
```

```shell
$ 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](https://ansible.readthedocs.io/projects/creator/).

## Command line completion

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

```shell
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](https://github.com/ansible-community/ansible-creator/tree/create)
  branch and try it out!

## Communication

Refer to the
[Get in Touch](https://ansible.readthedocs.io/projects/creator/contributing/#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](https://docs.ansible.com/ansible/devel/community/communication.html).

## Contributing

See
[Contributing to ansible-creator](https://ansible.readthedocs.io/projects/creator/contributing/).

## Code of Conduct

Please see the
[Ansible Community Code of Conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html).

## Licensing

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

See the [LICENSE](https://github.com/ansible/ansible-creator/blob/main/LICENSE)
file for more details.
