Metadata-Version: 2.4
Name: toggl-invoice-gen
Version: 0.1.2
Summary: Take a mapping of Toggl Track projects and manually inputted rates, download a report, and generate an invoice
Author-email: slashtechno <77907286+slashtechno@users.noreply.github.com>
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: pydantic-settings>=2.10.1
Requires-Dist: pydantic>=2.11.7
Requires-Dist: python-decouple>=3.8
Requires-Dist: reportlab>=4.0.0
Description-Content-Type: text/markdown

# Toggl Invoice Generator

A tool to take mappings of your Toggl projects and hourly rates and generate invoices from them. In addition, a detailed report is downloaded from Toggl as a PDF.

## Example Invoice

Here's what a generated invoice looks like:

[![Example Invoice](example-invoice.png)](example-invoice.pdf)

*Click the image above to view the full PDF invoice*

## Usage

This project is packaged with [uv](https://docs.astral.sh/uv/), so the easiest way to run it is to install uv and run the following command:
```bash
uvx --from toggl-invoice-gen toggl-invoice-generator
```

## Configuration

You do, however, need to either have a `config.toml` file in the current directory. If you don't, you will be prompted to enter the path to your config.toml file. The config.toml file should follow the format of [example.config.toml](example.config.toml)
