Metadata-Version: 2.1
Name: jiav-backend-ansible
Version: 0.2.0
Summary: Ansible backed for jiav
Home-page: https://github.com/vkhitrin/jiav-backend-ansible
License: BSD-3-Clause
Author: Vadim Khitrin
Author-email: me@vkhitrin.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
Requires-Dist: ansible-runner (==2.3.6)
Requires-Dist: docutils (!=0.21.post1)
Requires-Dist: ruamel-yaml (>=0.18.6,<0.19.0)
Project-URL: Documentation, https://jiav.readthedocs.io
Project-URL: Repository, https://github.com/vkhitrin/jiav-backend-ansible
Description-Content-Type: text/markdown

# jiav-backend-ansible

> [!WARNING]
> This backend is risky since it allows users to execute arbitrary commands, and use it at your own risk.

> [!NOTE]
> This package does not install Ansible itself;

An Ansible backend for [jiav](https://github.com/vkhitrin/jiav).

## Documentation

Visit <https://jiav.readthedocs.io/en/latest/ansible_backend.html>.

## Requirements

Install [jiav](<[jiav](https://github.com/vkhitrin/jiav)>).  
`jiav` requires Python `>= 3.8`.

Ansible installed.

## Installation

### Remote

Install from remote:

```bash
pip3 install jiav-backend-ansible
```

Inject to a `pipx` environment:

```bash
pipx inject jiav jiav-backend-ansible
```

### Local

Install from the local repository:

```bash
pip3 install .
```

Inject to a `pipx` environment:

```bash
pipx inject jiav ../jiav-backend-ansible
```

## Contributing

**All contributions are welcome!**

