Metadata-Version: 2.4
Name: unspsc-fr
Version: 0.1.0
Summary: UNSPSC v26 bilingue EN/FR : lookup, hiérarchie et recherche floue sur la nomenclature des marchés publics
Project-URL: Homepage, https://github.com/codebysaadbouh/unspsc-fr
Project-URL: Source, https://github.com/codebysaadbouh/unspsc-fr
Author: Saadbouh
License-Expression: MIT
Keywords: bilingual,classification,marchés publics,procurement,unspsc
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Natural Language :: French
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# unspsc-fr

La nomenclature **UNSPSC v26** bilingue EN/FR, requêtable en Python : lookup de codes,
navigation hiérarchique et recherche plein texte insensible aux accents.

Données : 149 849 produits, 21 706 traductions françaises sourcées (gouvernement du
Canada). Détails, couverture et licences :
[github.com/codebysaadbouh/unspsc-fr](https://github.com/codebysaadbouh/unspsc-fr).

## Installation

```bash
pip install unspsc-fr
```

La base SQLite (~88 Mo) est téléchargée au premier usage puis mise en cache
(`~/.cache/unspsc-fr/`). Pour utiliser une base locale : variable d'environnement
`UNSPSC_FR_DB` ou `UNSPSC(db_path=...)`.

## Usage

```python
from unspsc_fr import UNSPSC

u = UNSPSC()

u.get(10101501)
# Entry(code=10101501, level='commodity', title_en='Cats', title_fr='Chats', …)
# .title → 'Chats' (repli automatique sur l'anglais si non traduit)

u.search("béton", lang="fr")             # plein texte, accents ignorés
u.search("cemen", lang="en")             # préfixe : saisie incrémentale
u.children()                              # les 58 segments
u.children(10101500)                      # produits d'une classe
u.ancestors(10101501)                     # segment > famille > classe
```

## CLI

```bash
unspsc-fr get 10101501
unspsc-fr search "ciment" --lang fr
unspsc-fr children 10100000
unspsc-fr ancestors 10101501 --json
```

## Licences

Code MIT. Codeset © UNDP (UNSPSC®) ; traductions françaises sous Licence du
gouvernement ouvert – Canada. Voir le
[NOTICE](https://github.com/codebysaadbouh/unspsc-fr/blob/main/NOTICE) du dépôt.
