Complete readme.md file

This commit is contained in:
2025-10-10 10:02:54 +02:00
parent 0d997fc41d
commit 6a290a1b3e

View File

@@ -0,0 +1,60 @@
# OVH Invoice Fetcher
Automated script for retrieving, indexing, and archiving invoices from the OVH API.
Handles logging, database persistence, and email notifications for both normal operations and errors.
---
## Overview
This application connects to the OVH API to:
1. Fetch all invoice IDs.
2. Compare them with previously downloaded or recorded invoices.
3. Download missing invoice PDFs.
4. Store metadata in a SQLite database.
5. Send an email report with the list of newly downloaded invoices.
It automatically categorizes invoices by year and stores them in year-specific directories.
---
## Requirements
- Python 3.10+
- Valid OVH API credentials
- SMTP server access for email notifications
---
## Installation
You would need to create a .env file that contain:
```env
APP_KEY
APP_SECRET
CONSUMER_KEY
PATH_OVH
DB_PATH
EMAIL
EMAIL_PASSWORD
SMTP_MAIL_ADDRESS
SMTP_PORT
EMAIL_TO
YEAR
```
```bash
git clone git@github.com:Fare-spec/get_ovh_bills.git
cd get_ovh_bills
pip install -r requirements.txt
```
With uv:
```bash
git clone git@github.com:Fare-spec/get_ovh_bills.git
cd get_ovh_bills
uv venv
uv run main.py
```