Metadata-Version: 2.4
Name: exasol-ansible-modules
Version: 0.1.0
Summary: Python runtime package for Exasol Ansible collection modules.
License-Expression: MIT
License-File: LICENSE
Keywords: exasol,ansible,collection,database,data-warehouse
Author: Mykhailo Skliar
Author-email: mykhailo.skliar@exasol.com
Requires-Python: >=3.11,<3.14
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: pyexasol
Requires-Dist: sqlglot (>=30.11.0)
Project-URL: Homepage, https://github.com/exasol/ansible-collection
Project-URL: Repository, https://github.com/exasol/ansible-collection
Description-Content-Type: text/markdown

# Exasol Ansible Collection

Ansible Collection for automating Exasol database operations.

## Installation

The collection is not published to Ansible Galaxy yet.
To try it locally, build the collection archive from this checkout and install that archive:

```bash
poetry run nox -s collection:build
poetry run ansible-galaxy collection install --force .build_output/collections/exasol-exasol-*.tar.gz
```

Run the Ansible collection sanity checks with:

```bash
poetry run nox -s collection:sanity
```

After the collection is published, installation will use the Galaxy collection
name:

```bash
ansible-galaxy collection install exasol.exasol
```

## Runtime Dependencies

Install the Python dependencies required by the collection modules in the
execution environment that runs Ansible:

```bash
python -m pip install -r requirements.txt
```

The dependency list includes `exasol-ansible-modules`, the Python package with
the Exasol module runtime logic.

## Usage

Use the collection from a playbook with the fully qualified collection name:

```yaml
---
- name: Prepare Exasol hosts
  hosts: all
  collections:
    - exasol.exasol
  tasks:
    - name: Verify the collection is available
      ansible.builtin.debug:
        msg: "Exasol collection is installed."
```

The collection is currently a skeleton. Add module-specific tasks once public
modules are available.

