fr-phonenumbers 0.1.0__tar.gz

fr_phonenumbers-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Internal notes/scripts/...
+hidden/

fr_phonenumbers-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RIENK Consulting
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fr_phonenumbers-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.5
+Name: fr-phonenumbers
+Version: 0.1.0
+Summary: Détecteur d'opérateur pour les numéros de téléphone français.
+Project-URL: Homepage, https://github.com/RIENK-Consulting/fr-phonenumbers
+Author-email: RIENK Consulting <contact@rienkconsulting.fr>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Telephony
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+![Tests](https://github.com/RIENK-Consulting/fr-phonenumbers/actions/workflows/test.yml/badge.svg)
+![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)
+[![PyPI version](https://img.shields.io/pypi/v/fr-phonenumbers.svg)](https://pypi.org/project/fr-phonenumbers/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+# fr-phonenumbers
+
+Bibliothèque Python ultra-légère et sans dépendance externe pour identifier l'opérateur et la zone des numéros de téléphone français.
+
+## Le Parti Pris
+
+Contrairement aux bibliothèques lourdes et complexes, **fr-phonenumbers** fait le choix de la simplicité et de la robustesse :
+* **Zero dépendance :** Utilise exclusivement la bibliothèque standard de Python.
+* **100% Autonome (Offline-friendly) :** Les données sont embarquées directement dans le paquet. Aucun téléchargement réseau à l'exécution, ce qui garantit un fonctionnement parfait derrière les proxys d'entreprise.
+* **Performance ($O(\log N)$) :** La recherche s'appuie sur le module natif `bisect` appliqué à des plages de numéros triées, offrant des performances instantanées.
+
+## Installation
+
+```bash
+pip install fr-phonenumbers
+```
+
+## Utilisation rapide
+
+```python
+from fr_phonenumbers import get_operator
+
+resultat = get_operator("0105712345")
+print(resultat)
+# Sortie : {'code': 'FRTE', 'operator': '...', 'zone': 'Métropole'}
+```
+
+## Sources des Données
+
+Les données de numérotation sont issues des publications officielles de l'ARCEP sur data.gouv.fr :
+* [Ressources en numérotation téléphonique](https://www.data.gouv.fr/datasets/ressources-en-numerotation-telephonique)
+* [Identifiants de communications électroniques](https://www.data.gouv.fr/datasets/identifiants-de-communications-electroniques)
+
+## Licence
+
+Distribué sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.

fr_phonenumbers-0.1.0/README.md

@@ -0,0 +1,41 @@
+![Tests](https://github.com/RIENK-Consulting/fr-phonenumbers/actions/workflows/test.yml/badge.svg)
+![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)
+[![PyPI version](https://img.shields.io/pypi/v/fr-phonenumbers.svg)](https://pypi.org/project/fr-phonenumbers/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+# fr-phonenumbers
+
+Bibliothèque Python ultra-légère et sans dépendance externe pour identifier l'opérateur et la zone des numéros de téléphone français.
+
+## Le Parti Pris
+
+Contrairement aux bibliothèques lourdes et complexes, **fr-phonenumbers** fait le choix de la simplicité et de la robustesse :
+* **Zero dépendance :** Utilise exclusivement la bibliothèque standard de Python.
+* **100% Autonome (Offline-friendly) :** Les données sont embarquées directement dans le paquet. Aucun téléchargement réseau à l'exécution, ce qui garantit un fonctionnement parfait derrière les proxys d'entreprise.
+* **Performance ($O(\log N)$) :** La recherche s'appuie sur le module natif `bisect` appliqué à des plages de numéros triées, offrant des performances instantanées.
+
+## Installation
+
+```bash
+pip install fr-phonenumbers
+```
+
+## Utilisation rapide
+
+```python
+from fr_phonenumbers import get_operator
+
+resultat = get_operator("0105712345")
+print(resultat)
+# Sortie : {'code': 'FRTE', 'operator': '...', 'zone': 'Métropole'}
+```
+
+## Sources des Données
+
+Les données de numérotation sont issues des publications officielles de l'ARCEP sur data.gouv.fr :
+* [Ressources en numérotation téléphonique](https://www.data.gouv.fr/datasets/ressources-en-numerotation-telephonique)
+* [Identifiants de communications électroniques](https://www.data.gouv.fr/datasets/identifiants-de-communications-electroniques)
+
+## Licence
+
+Distribué sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.

fr_phonenumbers-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "fr-phonenumbers"
+version = "0.1.0"
+description = "Détecteur d'opérateur pour les numéros de téléphone français."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "RIENK Consulting", email = "contact@rienkconsulting.fr" }
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Communications :: Telephony",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/RIENK-Consulting/fr-phonenumbers"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/fr_phonenumbers",
+    "README.md",
+    "LICENSE",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+]

fr_phonenumbers-0.1.0/src/fr_phonenumbers/__init__.py

@@ -0,0 +1,92 @@
+import csv
+import bisect
+import importlib.resources
+from typing import Optional, Dict, Tuple, List
+from . import data
+
+_OPERATORS_CACHE: Optional[Dict[str, str]] = None
+_RANGES_CACHE: Optional[List[Tuple[int, int, str, str]]] = None
+
+
+def _load_data() -> Tuple[Dict[str, str], List[Tuple[int, int, str, str]]]:
+    """Charge et met en cache les fichiers CSV au premier appel."""
+    global _OPERATORS_CACHE, _RANGES_CACHE
+    if _OPERATORS_CACHE is not None and _RANGES_CACHE is not None:
+        return _OPERATORS_CACHE, _RANGES_CACHE
+
+    operators = {}
+    with importlib.resources.files(data).joinpath("operators.csv").open("r", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            operators[row["code"].strip()] = row["operateur"].strip()
+
+    ranges = []
+    with importlib.resources.files(data).joinpath("num_ranges.csv").open("r", encoding="utf-8") as f:
+        reader = csv.DictReader(f)
+        for row in reader:
+            start = int(row["num_debut"])
+            end = int(row["num_fin"])
+            op_code = row["operateur"].strip()
+            zone = row["zone"].strip()
+            ranges.append((start, end, op_code, zone))
+
+    ranges.sort(key=lambda x: x[0])
+
+    _OPERATORS_CACHE = operators
+    _RANGES_CACHE = ranges
+    return _OPERATORS_CACHE, _RANGES_CACHE
+
+
+def parse_phone_number(numero_str: str) -> int:
+    """
+    Nettoie, valide un numéro de téléphone français et retourne sa version entière (ex: 105700000).
+    Lève une ValueError si le format est invalide.
+    """
+    if not isinstance(numero_str, str):
+        raise ValueError("Le numéro doit être une chaîne de caractères.")
+
+    cleaned = "".join(c for c in numero_str if c.isdigit() or c == "+")
+
+    if cleaned.startswith("+33"):
+        cleaned = "0" + cleaned[3:]
+    elif cleaned.startswith("0033"):
+        cleaned = "0" + cleaned[4:]
+
+    if not cleaned.startswith("0") or len(cleaned) != 10:
+        raise ValueError(f"Format de numéro français invalide : '{numero_str}'")
+
+    try:
+        return int(cleaned)
+    except ValueError:
+        raise ValueError(f"Impossible de convertir le numéro en entier : '{numero_str}'")
+
+
+def get_operator(numero_str: str) -> Optional[Dict[str, str]]:
+    """
+    Prend un numéro français (string) et retourne un dictionnaire avec les infos de l'opérateur,
+    ou None si le numéro n'est rattaché à aucune plage connue.
+    """
+    operators, ranges = _load_data()
+    
+    try:
+        num_int = parse_phone_number(numero_str)
+    except ValueError:
+        return None
+
+    bornes_min = [r[0] for r in ranges]
+    idx = bisect.bisect_right(bornes_min, num_int) - 1
+
+    if idx < 0:
+        return None
+
+    borne_min, borne_max, op_code, zone = ranges[idx]
+
+    if borne_min <= num_int <= borne_max:
+        operator_name = operators.get(op_code, op_code)
+        return {
+            "code": op_code,
+            "operator": operator_name,
+            "zone": zone,
+        }
+
+    return None