Metadata-Version: 2.4
Name: pytest_podman
Version: 0.0.1
Summary: Pytest plugin for Podman integration
Project-URL: Homepage, https://github.com/azeddinebouabdallah/pytest_podman
Project-URL: Issues, https://github.com/azeddinebouabdallah/pytest_podman/issues
Author-email: Azeddine Bouabdallah <bouabdallahazeddine@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# Pytest Podman Plugin

A Pytest plugin for managing Podman containers during tests, similar to `pytest-docker` but tailored for Podman. It simplifies integration testing by automatically starting and stopping services defined in a `podman-compose.yml` file.

## Features

- **Automatic Lifecycle Management**: Starts services (`podman compose up`) before tests and stops them (`podman compose down`) afterwards.
- **Service Discovery**: Helper methods to find the host port mapped to a container port.
- **Readiness Waiting**: Built-in mechanism to wait for services to become responsive.
- **Scoped Fixtures**: Configurable scope (default: `session`) to share containers across tests or restart them per test.

## Installation

You can install the plugin via pip:

```bash
pip install podman_pytest
```

## Usage

### 1. Create a `podman-compose.yml`

Create a `podman-compose.yml` file in your `tests/` directory (or configure the path).

```yaml
version: '3'
services:
  httpbin:
    image: kennethreitz/httpbin
    ports:
      - "80"
```