Metadata-Version: 2.4
Name: pandoctylus
Version: 0.1.0
Summary: A crazy and opinionated way of generating documents.
Author-email: Sebastian Schaetz <seb.schaetz@gmail.com>
License-Expression: MIT
License-File: LICENSE.md
Requires-Python: >=3.9
Requires-Dist: docxtpl
Requires-Dist: pypandoc-binary
Requires-Dist: pyyaml
Provides-Extra: dev
Requires-Dist: black; extra == 'dev'
Requires-Dist: isort; extra == 'dev'
Requires-Dist: mypy; extra == 'dev'
Requires-Dist: pytest; extra == 'dev'
Requires-Dist: pytest-cov; extra == 'dev'
Description-Content-Type: text/markdown

# Pandoctylus

![Pandoctylus Logo](doc/pandoctylus_small.png)

A crazy and opinionated way of generating documents.

## Installation

```bash
pip install pandoctylus
```

## Use

Check out the example project in [examples/project1](examples/project1) to understand
how to make a document. Key ingredients:
- define the document as yaml file in `docs/` sub-dir
- create or pick an existing jinja template and refernece it in the yaml file
- create or pick an existing docx template and reference it in the yaml file
- run the tool: `python pandoctylus/pandoctylus.py --root-dir examples/project1`
- enjoy the generated docs in `examples/project1/output` 

## Development

This project uses modern Python packaging with `pyproject.toml`. To set up the development environment:

1. Clone the repository:

```bash
git clone https://github.com/yourusername/pandoctylus.git
cd pandoctylus
```

2. Create a virtual environment and install development dependencies:

```bash
uv venv pandoctylus-venv
source .pandoctylus-venv/bin/activate 
uv pip install -e ".[dev]"
```

3. Run tests:
```bash
pytest
```

## Features

- Generate multiple documents from shared Markdown and YAML and a docx template.

## License

MIT License 
