permisapi-client 0.3.0__tar.gz → 0.4.0__tar.gz

{permisapi_client-0.3.0 → permisapi_client-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: permisapi-client
-Version: 0.3.0
+Version: 0.4.0
 Summary: Client Python officiel pour PermisAPI : permis de construire France en API REST.
 Project-URL: Homepage, https://permisapi.fr
 Project-URL: Documentation, https://permisapi.fr/docs

{permisapi_client-0.3.0 → permisapi_client-0.4.0}/permisapi_client/client.py

@@ -130,6 +130,20 @@ class _PermitsResource:
             params["max_distance"] = max_distance
         return self._c._get(f"/v1/permits/{num_pa}/dvf", params=params or None)
 
+    def score_mdb(self, num_pa: str) -> dict[str, Any]:
+        """GET /v1/permits/{num_pa}/score : Score Opportunité MDB v0.1.
+
+        Plans Pro et superieurs uniquement (402 si Free / Explorer).
+        Retourne {num_pa, permit_id, score (0-100), tier (low/medium/
+        high/premium), components (7 signaux ponderes), weights,
+        version, method, dvf_matches_used, density_class}.
+
+        Algo : heuristique ponderee qui combine type permit, surface,
+        DVF voisin €/m², activite dep, demandeur (SCI vs promoteur),
+        coherence DVF/permit, densite INSEE.
+        """
+        return self._c._get(f"/v1/permits/{num_pa}/score")
+
     def export(
         self,
         *,
@@ -405,6 +419,10 @@ class _AsyncPermitsResource:
             params["max_distance"] = max_distance
         return await self._c._get(f"/v1/permits/{num_pa}/dvf", params=params or None)
 
+    async def score_mdb(self, num_pa: str) -> dict[str, Any]:
+        """GET /v1/permits/{num_pa}/score : version async. Plans Pro+ only."""
+        return await self._c._get(f"/v1/permits/{num_pa}/score")
+
     async def export(
         self,
         *,

{permisapi_client-0.3.0 → permisapi_client-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "permisapi-client"
-version = "0.3.0"
+version = "0.4.0"
 description = "Client Python officiel pour PermisAPI : permis de construire France en API REST."
 readme = "README.md"
 requires-python = ">=3.9"

{permisapi_client-0.3.0 → permisapi_client-0.4.0}/tests/test_client.py

@@ -302,6 +302,28 @@ def test_permits_export_403_for_explorer_plan() -> None:
             client.permits.export()
 
 
+@respx.mock
+def test_permits_score_mdb() -> None:
+    respx.get(f"{BASE}/v1/permits/PC-1/score").respond(
+        json={"num_pa": "PC-1", "score": 78, "tier": "high", "components": {}}
+    )
+    with PermisAPI(api_key="pk_test_abc") as client:
+        result = client.permits.score_mdb("PC-1")
+    assert result["score"] == 78
+    assert result["tier"] == "high"
+
+
+@pytest.mark.asyncio
+@respx.mock
+async def test_async_permits_score_mdb() -> None:
+    respx.get(f"{BASE}/v1/permits/PC-A/score").respond(
+        json={"num_pa": "PC-A", "score": 42, "tier": "medium"}
+    )
+    async with AsyncPermisAPI(api_key="pk_test_abc") as client:
+        result = await client.permits.score_mdb("PC-A")
+    assert result["score"] == 42
+
+
 @pytest.mark.asyncio
 @respx.mock
 async def test_async_permits_export() -> None: