Metadata-Version: 2.4
Name: reminder-aggregator
Version: 0.2.1
Summary: A simple Python tool that scans files for common reminder tags like TODO and FIXME to generate a report from them.
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
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 :: 3.14
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.3.0
Requires-Dist: pathspec==0.12.1
Requires-Dist: pip==25.2
Description-Content-Type: text/markdown

<div align="center">

# Reminder Aggregator

**A simple Python tool that scans files for common reminder tags like TODO and FIXME to generate a report from them.**

[![PyPI - Version](https://img.shields.io/pypi/v/reminder-aggregator)](https://pypi.org/project/reminder-aggregator/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/reminder-aggregator)](https://pypi.org/project/reminder-aggregator/)
![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)

</div>

## Requirements

- Python 3.10+

## Installation

From PyPI (recommended):

```bash
pip install reminder-aggregator
```

From source with [uv](https://docs.astral.sh/uv/getting-started/installation/):

```bash
git clone https://github.com/NocDerEchte/reminder-aggregator.git
cd reminder-aggregator

uv sync
uv run reminder-aggregator --help
```

## Usage

Scan current directory:

```bash
reminder-aggregator
```

Scan specific directory:

```bash
reminder-aggregator /path/to/directory
```

Specify output file:

```bash
reminder-aggregator --out-file /path/to/report.json
```

Show all available options:

```bash
reminder-aggregator --help
```

## Docker Usage

Run the containerized version by mounting your project directory:

```bash
docker run --rm -it -v "$(pwd):/work" nocderechte/reminder-aggregator:latest
```

## Roadmap

- [ ] Filter to check whether a reminder-tag is inside a comment (currently causes false positives)
- [ ] Support for multiple output formats
  - [ ] junitxml
  - [ ] raw/stdout

## License

GNU General Public License v3.0 or later

See [LICENSE](./LICENSE) to see the full text.
