shwary-python 2.0.0__tar.gz → 2.0.2__tar.gz

{shwary_python-2.0.0 → shwary_python-2.0.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: shwary-python
-Version: 2.0.0
+Version: 2.0.2
 Summary: SDK Python moderne (Async/Sync) pour l'API de paiement Shwary.
 Author-email: Josué Luis Panzu <josuepanzu8@gmail.com>
 License: MIT
 License-File: LICENSE
 Keywords: africa,fintech,kenya,mobile-money,payment,rdc,shwary,uganda
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -24,9 +24,9 @@ Description-Content-Type: text/markdown
 [![Python versions](https://img.shields.io/pypi/pyversions/shwary-python.svg)](https://pypi.org/project/shwary-python/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Shwary Python** est une bibliothèque cliente moderne, asynchrone et performante (non officielle) pour l'intégration de l'API [Shwary](https://shwary.com). Elle permet d'initier des paiements Mobile Money en **RDC**, au **Kenya** et en **Ouganda** avec une validation stricte des données avant l'envoi.
+**Shwary Python** est une bibliothèque cliente moderne, asynchrone et performante pour l'intégration de l'API [Shwary](https://shwary.com). Elle permet d'initier des paiements Mobile Money en **RDC**, au **Kenya** et en **Ouganda** avec une validation stricte des données avant l'envoi.
 
-## Quoi de neuf dans la v2.0.0
+## Quoi de neuf dans la v2.0.2
 
 - **Retry automatique** : Les erreurs réseau transitoires (timeout, connexion) sont automatiquement retentées avec backoff exponentiel
 - **Types stricts** : TypedDict pour les réponses (`PaymentResponse`, `TransactionResponse`, `WebhookPayload`)
@@ -36,6 +36,7 @@ Description-Content-Type: text/markdown
 - **Docstrings améliorées** : Documentation complète avec exemples d'utilisation
 - **Tests étendus** : Couverture complète des retries, erreurs et validations
 - **Modèles de réponse** : Schemas Pydantic pour les webhooks et transactions
+- **Correction des bugs** : Correction des imports et des bugs mineurs
 
 ## Caractéristiques
 
@@ -170,12 +171,12 @@ async def handle_webhook(payload: WebhookPayload):
     """Shwary envoie une notification de changement d'état."""
     
     if payload.status == "completed":
-        # ✅ Transaction réussie
+        # Transaction réussie
         print(f"Paiement {payload.id} reçu ({payload.amount})")
         # La livrez le service ici
     
     elif payload.status == "failed":
-        # ❌ Transaction échouée
+        # Transaction échouée
         print(f"Paiement {payload.id} échoué")
         # Notifiez le client
     

{shwary_python-2.0.0 → shwary_python-2.0.2}/README.md

@@ -4,9 +4,9 @@
 [![Python versions](https://img.shields.io/pypi/pyversions/shwary-python.svg)](https://pypi.org/project/shwary-python/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**Shwary Python** est une bibliothèque cliente moderne, asynchrone et performante (non officielle) pour l'intégration de l'API [Shwary](https://shwary.com). Elle permet d'initier des paiements Mobile Money en **RDC**, au **Kenya** et en **Ouganda** avec une validation stricte des données avant l'envoi.
+**Shwary Python** est une bibliothèque cliente moderne, asynchrone et performante pour l'intégration de l'API [Shwary](https://shwary.com). Elle permet d'initier des paiements Mobile Money en **RDC**, au **Kenya** et en **Ouganda** avec une validation stricte des données avant l'envoi.
 
-## Quoi de neuf dans la v2.0.0
+## Quoi de neuf dans la v2.0.2
 
 - **Retry automatique** : Les erreurs réseau transitoires (timeout, connexion) sont automatiquement retentées avec backoff exponentiel
 - **Types stricts** : TypedDict pour les réponses (`PaymentResponse`, `TransactionResponse`, `WebhookPayload`)
@@ -16,6 +16,7 @@
 - **Docstrings améliorées** : Documentation complète avec exemples d'utilisation
 - **Tests étendus** : Couverture complète des retries, erreurs et validations
 - **Modèles de réponse** : Schemas Pydantic pour les webhooks et transactions
+- **Correction des bugs** : Correction des imports et des bugs mineurs
 
 ## Caractéristiques
 
@@ -150,12 +151,12 @@ async def handle_webhook(payload: WebhookPayload):
     """Shwary envoie une notification de changement d'état."""
     
     if payload.status == "completed":
-        # ✅ Transaction réussie
+        # Transaction réussie
         print(f"Paiement {payload.id} reçu ({payload.amount})")
         # La livrez le service ici
     
     elif payload.status == "failed":
-        # ❌ Transaction échouée
+        # Transaction échouée
         print(f"Paiement {payload.id} échoué")
         # Notifiez le client
     

{shwary_python-2.0.0 → shwary_python-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "shwary-python"
-version = "2.0.0"
+version = "2.0.2"
 description = "SDK Python moderne (Async/Sync) pour l'API de paiement Shwary."
 readme = "README.md"
 authors = [
@@ -20,7 +20,7 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Topic :: Software Development :: Libraries :: Python Modules",
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
 ]
 
 [build-system]
@@ -45,7 +45,10 @@ line-length = 88
 select = ["E", "F", "I"] # Erreurs, Flakes, et tris d'Imports
 
 [tool.hatch.build.targets.sdist]
-packages = ["src/shwary"]
+only-include = ["src/shwary"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/shwary"]
+
+[tool.hatch.build.targets.wheel.sources]
+"src" = ""

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/clients/async_client.py

@@ -1,14 +1,7 @@
-from typing import Any
-
 import httpx
-from tenacity import (
-    AsyncRetrying,
-    retry_if_exception_type,
-    stop_after_attempt,
-    wait_exponential,
-)
-
-from ..core import prepare_payment_request
+from tenacity import AsyncRetrying
+
+from ..core import get_retrying_options, prepare_payment_request
 from ..exceptions import raise_from_response
 from ..schemas import PaymentResponse, TransactionResponse
 from .base import BaseShwaryClient
@@ -76,17 +69,6 @@ class ShwaryAsync(BaseShwaryClient):
         """Sortie du context manager asynchrone."""
         await self.close()
 
-    @property
-    def _retrying_options(self) -> dict[str, Any]:
-        return {
-            "retry": retry_if_exception_type(
-                (httpx.TimeoutException, httpx.ConnectError)
-            ),
-            "stop": stop_after_attempt(3),
-            "wait": wait_exponential(multiplier=1, min=2, max=10),
-            "reraise": True,
-        }
-
     async def initiate_payment(
         self,
         country: str,
@@ -129,7 +111,7 @@ class ShwaryAsync(BaseShwaryClient):
 
         self._log_request(endpoint, json_data)
 
-        async for attempt in AsyncRetrying(**self._retrying_options):
+        async for attempt in AsyncRetrying(**get_retrying_options()):
             with attempt:
                 try:
                     response = await self._client.post(endpoint, json=json_data)
@@ -166,7 +148,7 @@ class ShwaryAsync(BaseShwaryClient):
 
         self.logger.debug(f"Fetching transaction: {transaction_id}")
 
-        async for attempt in AsyncRetrying(**self._retrying_options):
+        async for attempt in AsyncRetrying(**get_retrying_options()):
             with attempt:
                 try:
                     response = await self._client.get(endpoint)

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/clients/sync.py

@@ -1,12 +1,7 @@
 import httpx
-from tenacity import (
-    retry,
-    retry_if_exception_type,
-    stop_after_attempt,
-    wait_exponential,
-)
-
-from ..core import prepare_payment_request
+from tenacity import retry
+
+from ..core import get_retrying_options, prepare_payment_request
 from ..exceptions import raise_from_response
 from ..schemas import PaymentResponse, TransactionResponse
 from .base import BaseShwaryClient
@@ -74,12 +69,7 @@ class Shwary(BaseShwaryClient):
         """Sortie du context manager."""
         self.close()
 
-    @retry(
-        retry=retry_if_exception_type((httpx.TimeoutException, httpx.ConnectError)),
-        stop=stop_after_attempt(3),
-        wait=wait_exponential(multiplier=1, min=2, max=10),
-        reraise=True,
-    )
+    @retry(**get_retrying_options())
     def initiate_payment(
         self,
         country: str,
@@ -133,12 +123,7 @@ class Shwary(BaseShwaryClient):
             self._log_error(endpoint, e)
             raise
 
-    @retry(
-        retry=retry_if_exception_type((httpx.TimeoutException, httpx.ConnectError)),
-        stop=stop_after_attempt(3),
-        wait=wait_exponential(multiplier=1, min=2, max=10),
-        reraise=True,
-    )
+    @retry(**get_retrying_options())
     def get_transaction(self, transaction_id: str) -> TransactionResponse:
         """
         Récupère les détails d'une transaction par son ID.

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/core.py

@@ -1,7 +1,7 @@
 """
 Logique métier partagée entre les clients Sync et Async.
 
-Ce module contient les fonctions de validation et de préparation des requêtes
+Ce module contient notamment les fonctions de validation et de préparation des requêtes
 utilisées par tous les clients Shwary pour éviter la duplication de code.
 
 Fonctions principales:
@@ -20,6 +20,15 @@ Exemple d'utilisation directe:
     # payload = {"amount": 5000, "clientPhoneNumber": "+243972345678"}
 """
 
+from typing import Any
+
+import httpx
+from tenacity import (
+    retry_if_exception_type,
+    stop_after_attempt,
+    wait_exponential,
+)
+
 from .exceptions import ValidationError
 from .schemas import CountryCode, PaymentPayload
 
@@ -166,3 +175,14 @@ def prepare_payment_request(
     endpoint: str = f"/payment/{env_path}{country_enum.value}"
 
     return endpoint, payload.model_dump(exclude={'country_target'}, exclude_none=True)
+
+
+def get_retrying_options() -> dict[str, Any]:
+    return {
+            "retry": retry_if_exception_type(
+                (httpx.TimeoutException, httpx.ConnectError)
+            ),
+            "stop": stop_after_attempt(3),
+            "wait": wait_exponential(multiplier=1, min=2, max=10),
+            "reraise": True,
+        }

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/schemas.py

@@ -122,6 +122,9 @@ class PaymentResponse(BaseModel):
 
     id: str = Field(..., description="Identifiant unique de la transaction (UUID)")
     status: str = Field(..., description="État de la transaction")
+    isSandbox: bool = Field(
+        ..., description="Indique si la transaction est en mode sandbox"
+    )
 
     model_config = {"extra": "allow"}
 
@@ -134,7 +137,7 @@ class TransactionResponse(BaseModel):
         id: Identifiant unique de la transaction
         status: État actualisé de la transaction
         amount: Montant de la transaction
-        clientPhoneNumber: Numéro du client (peut être partiellement masqué)
+        recipientPhoneNumber: Numéro du receveur
         createdAt: Timestamp de création
         updatedAt: Timestamp de dernière mise à jour
         metadata: Données métier additionnelles
@@ -145,7 +148,7 @@ class TransactionResponse(BaseModel):
         ..., description="État actualisé (pending, completed, failed, etc.)"
     )
     amount: float = Field(..., description="Montant de la transaction")
-    clientPhoneNumber: Optional[str] = Field(None, description="Numéro du client")
+    recipientPhoneNumber: Optional[str] = Field(None, description="Numéro du receveur")
     createdAt: Optional[datetime] = Field(None, description="Timestamp de création")
     updatedAt: Optional[datetime] = Field(
         None, description="Timestamp de dernière mise à jour"

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/tests/test_client_async.py

@@ -146,18 +146,29 @@ async def test_async_retry_on_timeout(async_client):
 async def test_async_parallel_payments(async_client):
     """Teste la capacité à gérer plusieurs requêtes simultanées."""
     respx.post("https://api.shwary.com/api/v1/merchants/payment/sandbox/DRC").mock(
-        return_value=Response(200, json={"id": "p1", "status": "pending"})
+        return_value=Response(
+            200, json={"id": "p1", "status": "pending", "isSandbox": True}
+        )
     )
     respx.post("https://api.shwary.com/api/v1/merchants/payment/sandbox/KE").mock(
-        return_value=Response(200, json={"id": "p2", "status": "pending"})
+        return_value=Response(
+            200, json={"id": "p2", "status": "pending", "isSandbox": True}
+        )
+    )
+    respx.post("https://api.shwary.com/api/v1/merchants/payment/sandbox/UG").mock(
+        return_value=Response(
+            200, json={"id": "p3", "status": "pending", "isSandbox": True}
+        )
     )
 
     async with async_client as c:
-        # On lance les deux en même temps
+        # On lance les trois en même temps
         results = await asyncio.gather(
             c.initiate_payment("DRC", 5000, "+243972345678"),
             c.initiate_payment("KE", 10, "+254700000000"),
+            c.initiate_payment("UG", 50, "+256700000000"),
         )
 
     assert results[0].id == "p1"
     assert results[1].id == "p2"
+    assert results[2].id == "p3"

{shwary_python-2.0.0 → shwary_python-2.0.2/src}/shwary/tests/test_schemas.py

@@ -144,7 +144,7 @@ class TestPaymentResponse:
             id="trans-123",
             status="pending",
             isSandbox=True,
-            extra_field="extra_value",  # Accepté grâce à extra="allow"
+            extra_field="extra_value",
         )
         
         assert response.id == "trans-123"
@@ -160,7 +160,7 @@ class TestTransactionResponse:
             id="trans-456",
             status="completed",
             amount=5000,
-            clientPhoneNumber="+243972345678",
+            recipientPhoneNumber="+243972345678",
         )
         
         assert response.id == "trans-456"
@@ -174,10 +174,10 @@ class TestTransactionResponse:
             status="pending",
             amount=1000,
             # Les champs suivants sont optionnels:
-            # clientPhoneNumber, createdAt, updatedAt, metadata
+            # recipientPhoneNumber, createdAt, updatedAt, metadata
         )
         
-        assert response.clientPhoneNumber is None
+        assert response.recipientPhoneNumber is None
 
 
 class TestWebhookPayload:
@@ -185,12 +185,10 @@ class TestWebhookPayload:
     
     def test_valid_webhook_payload(self):
         """Teste la création d'une charge webhook valide."""
-        now = datetime.now()
         payload = WebhookPayload(
             id="trans-webhook",
             status="completed",
             amount=5000,
-            timestamp=now,
         )
         
         assert payload.id == "trans-webhook"

shwary_python-2.0.0/shwary/logger.py

@@ -1,32 +0,0 @@
-import logging
-import sys
-
-# Create a custom logger
-logger = logging.getLogger(__name__)
-
-# Create handlers
-console_handler = logging.StreamHandler(sys.stdout)
-file_handler = logging.FileHandler('app.log')
-
-# Create formatters and add them to the handlers
-console_format = logging.Formatter('%(name)s - %(levelname)s - %(message)s')
-file_format = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
-console_handler.setFormatter(console_format)
-file_handler.setFormatter(file_format)
-
-# Set level for handlers
-console_handler.setLevel(logging.DEBUG)
-file_handler.setLevel(logging.ERROR)
-
-# Add the handlers to the logger
-logger.addHandler(console_handler)
-logger.addHandler(file_handler)
-
-# Set the default logging level
-def set_log_level(level):
-    logger.setLevel(level)
-
-# Example usage
-if __name__ == '__main__':
-    logger.info('This is an info message')
-    logger.error('This is an error message')