Metadata-Version: 2.4
Name: gedeon
Version: 0.0.1
Summary: Client Python de l'API GEDEON — catalogue d'événements culturels
Author: Eric-Marc
License: Proprietary
Keywords: gedeon,evenements,events,api,culture,agenda
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# gedeon

Client Python de l'API GEDEON — catalogue d'événements culturels.

## État : réservation de nom

Cette version `0.0.1` **ne fait rien**. Elle existe pour réserver le nom du
paquet avant la publication du client, et n'apporte aucune fonctionnalité.

N'installez pas cette version en attendant qu'elle fasse quelque chose : elle
n'a aucune dépendance et aucun code utile.

## Ce qui est prévu en 0.1.0

Un client mince sur l'API de lecture, qui absorbe les trois choses que chaque
consommateur réécrirait sinon à sa façon :

- la **pagination**, rendue invisible derrière un itérateur ;
- la **reprise sur quota** — un `429` porte le délai exact, marteler n'avance rien ;
- l'**export en flux**, qui ne charge pas le jeu complet en mémoire.

```python
from gedeon import Gedeon

api = Gedeon()                                   # lit GEDEON_API_KEY
for e in api.evenements(city="Marseille", upcoming=True):
    print(e.dates.begin, e.title)
```

L'authentification se fait par clé d'API, transmise en en-tête
`Authorization`, jamais en paramètre d'URL — elle finirait sinon dans les
journaux d'accès et les en-têtes `Referer`.

## Licence

Propriétaire. Tous droits réservés.
