mirror of
https://github.com/Fare-spec/get_ovh_bills.git
synced 2025-12-07 10:20:36 +00:00
Complete readme.md file
This commit is contained in:
60
README.md
60
README.md
@@ -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
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user