python-missive 0.2.0__tar.gz

python_missive-0.2.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: python-missive
+Version: 0.2.0
+Summary: Framework-agnostic messaging library for multi-channel communication.
+Author-email: Charl <charl@example.com>
+License: MIT
+Project-URL: Homepage, https://example.com/python-missive
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: scaleway
+Requires-Dist: boto3>=1.34; extra == "scaleway"
+Requires-Dist: scaleway>=2.0; extra == "scaleway"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: flake8-simplify>=0.21; extra == "dev"
+Requires-Dist: flake8-docstrings>=1.7; extra == "dev"
+
+# python-missive
+
+Bibliothèque Python légère et agnostique pour l'envoi de missives multi-canaux (emails, SMS, notifications push, courrier postal, etc.).
+
+## Présentation
+
+**python-missive** est une bibliothèque Python framework-agnostic qui fournit des providers unifiés pour l'envoi de messages multi-canaux. Elle sert de base à **django-missive** et peut être utilisée indépendamment dans n'importe quel projet Python.
+
+### Fonctionnalités principales
+
+- 🔌 **15+ providers intégrés** pour différents canaux de communication
+- 📧 **Email** : SendGrid, Mailgun, SES, Brevo, SMTP, Django Email
+- 📱 **SMS & Voix** : Twilio, Vonage, SMSPartner
+- 💬 **Messaging** : Telegram, Signal, Messenger, Slack, Teams
+- 📮 **Courrier postal & LRE** : La Poste, Maileva, AR24, Certeurope
+- 🔔 **Notifications push** : FCM (Firebase), APN (Apple), In-App
+- 🏗️ **Architecture modulaire** basée sur ProviderKit
+- ✅ **Framework-agnostic** : utilisable avec ou sans framework
+- 🎯 **Type hints complets** et documentation
+
+## Installation
+
+```bash
+# Installation basique
+pip install python-missive
+
+# Avec dépendances pour providers spécifiques
+pip install python-missive[email]      # Providers email
+pip install python-missive[sms]        # SMS et vocal
+pip install python-missive[messaging]  # Telegram, Signal, etc.
+pip install python-missive[push]       # FCM, APN
+pip install python-missive[postal]     # Courrier postal
+pip install python-missive[all]        # Tous les providers
+```
+
+## Usage rapide
+
+```python
+from pymissive.providers.sendgrid import SendGridProvider
+
+# Configurer le provider
+provider = SendGridProvider(config={
+    'SENDGRID_API_KEY': 'your-api-key'
+})
+
+# Envoyer un email
+result = provider.send_email(
+    from_email='sender@example.com',
+    to_email='recipient@example.com',
+    subject='Hello',
+    body='<p>Message content</p>'
+)
+```
+
+## Providers disponibles
+
+### Email
+- `DjangoEmailProvider` - Utilise le backend email Django
+- `SMTPProvider` - SMTP générique
+- `SendGridProvider` - SendGrid API
+- `MailgunProvider` - Mailgun API
+- `SESProvider` - Amazon SES
+- `BrevoProvider` - Brevo (ex-Sendinblue)
+- `ScalewayProvider` - Scaleway Transactional Email
+
+### SMS & Voix
+- `TwilioProvider` - Twilio SMS et appels vocaux
+- `VonageProvider` - Vonage (ex-Nexmo)
+- `SMSPartnerProvider` - SMSPartner
+
+### Messaging
+- `TelegramProvider` - Telegram Bot API
+- `SignalProvider` - Signal Messenger
+- `MessengerProvider` - Facebook Messenger
+- `SlackProvider` - Slack
+- `TeamsProvider` - Microsoft Teams
+
+### Courrier postal & LRE
+- `LaPosteProvider` - La Poste (courrier physique)
+- `MailevaProvider` - Maileva
+- `AR24Provider` - AR24 (LRE)
+- `CerteuropeProvider` - Certeurope
+
+### Notifications push
+- `FCMProvider` - Firebase Cloud Messaging
+- `APNProvider` - Apple Push Notification
+- `InAppNotificationProvider` - Notifications in-app
+
+## Architecture
+
+La bibliothèque utilise **ProviderKit** pour la gestion des providers :
+
+```python
+from pymissive.providers import get_missive_providers
+
+# Découvrir tous les providers disponibles
+providers = get_missive_providers()
+
+# Filtrer par type de service
+email_providers = [p for p in providers if 'email' in p.services]
+```
+
+## Documentation
+
+Pour plus de détails, consultez la documentation dans le dossier `docs/` :
+
+- `docs/purpose.md` - Objectifs et architecture du projet
+- `docs/structure.md` - Structure des modules et organisation
+- `docs/development.md` - Guidelines de développement
+- `docs/AI.md` - Contrat pour assistants IA
+
+## Développement
+
+```bash
+# Créer un environnement virtuel
+python service.py dev venv
+
+# Installer en mode développement
+python service.py dev install-dev
+
+# Exécuter les tests
+python service.py dev test
+
+# Formater le code
+python service.py dev format
+
+# Lancer tous les checks qualité
+python service.py quality check
+```
+
+## Licence
+
+Ce projet est sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.
+

python_missive-0.2.0/README.md

@@ -0,0 +1,134 @@
+# python-missive
+
+Bibliothèque Python légère et agnostique pour l'envoi de missives multi-canaux (emails, SMS, notifications push, courrier postal, etc.).
+
+## Présentation
+
+**python-missive** est une bibliothèque Python framework-agnostic qui fournit des providers unifiés pour l'envoi de messages multi-canaux. Elle sert de base à **django-missive** et peut être utilisée indépendamment dans n'importe quel projet Python.
+
+### Fonctionnalités principales
+
+- 🔌 **15+ providers intégrés** pour différents canaux de communication
+- 📧 **Email** : SendGrid, Mailgun, SES, Brevo, SMTP, Django Email
+- 📱 **SMS & Voix** : Twilio, Vonage, SMSPartner
+- 💬 **Messaging** : Telegram, Signal, Messenger, Slack, Teams
+- 📮 **Courrier postal & LRE** : La Poste, Maileva, AR24, Certeurope
+- 🔔 **Notifications push** : FCM (Firebase), APN (Apple), In-App
+- 🏗️ **Architecture modulaire** basée sur ProviderKit
+- ✅ **Framework-agnostic** : utilisable avec ou sans framework
+- 🎯 **Type hints complets** et documentation
+
+## Installation
+
+```bash
+# Installation basique
+pip install python-missive
+
+# Avec dépendances pour providers spécifiques
+pip install python-missive[email]      # Providers email
+pip install python-missive[sms]        # SMS et vocal
+pip install python-missive[messaging]  # Telegram, Signal, etc.
+pip install python-missive[push]       # FCM, APN
+pip install python-missive[postal]     # Courrier postal
+pip install python-missive[all]        # Tous les providers
+```
+
+## Usage rapide
+
+```python
+from pymissive.providers.sendgrid import SendGridProvider
+
+# Configurer le provider
+provider = SendGridProvider(config={
+    'SENDGRID_API_KEY': 'your-api-key'
+})
+
+# Envoyer un email
+result = provider.send_email(
+    from_email='sender@example.com',
+    to_email='recipient@example.com',
+    subject='Hello',
+    body='<p>Message content</p>'
+)
+```
+
+## Providers disponibles
+
+### Email
+- `DjangoEmailProvider` - Utilise le backend email Django
+- `SMTPProvider` - SMTP générique
+- `SendGridProvider` - SendGrid API
+- `MailgunProvider` - Mailgun API
+- `SESProvider` - Amazon SES
+- `BrevoProvider` - Brevo (ex-Sendinblue)
+- `ScalewayProvider` - Scaleway Transactional Email
+
+### SMS & Voix
+- `TwilioProvider` - Twilio SMS et appels vocaux
+- `VonageProvider` - Vonage (ex-Nexmo)
+- `SMSPartnerProvider` - SMSPartner
+
+### Messaging
+- `TelegramProvider` - Telegram Bot API
+- `SignalProvider` - Signal Messenger
+- `MessengerProvider` - Facebook Messenger
+- `SlackProvider` - Slack
+- `TeamsProvider` - Microsoft Teams
+
+### Courrier postal & LRE
+- `LaPosteProvider` - La Poste (courrier physique)
+- `MailevaProvider` - Maileva
+- `AR24Provider` - AR24 (LRE)
+- `CerteuropeProvider` - Certeurope
+
+### Notifications push
+- `FCMProvider` - Firebase Cloud Messaging
+- `APNProvider` - Apple Push Notification
+- `InAppNotificationProvider` - Notifications in-app
+
+## Architecture
+
+La bibliothèque utilise **ProviderKit** pour la gestion des providers :
+
+```python
+from pymissive.providers import get_missive_providers
+
+# Découvrir tous les providers disponibles
+providers = get_missive_providers()
+
+# Filtrer par type de service
+email_providers = [p for p in providers if 'email' in p.services]
+```
+
+## Documentation
+
+Pour plus de détails, consultez la documentation dans le dossier `docs/` :
+
+- `docs/purpose.md` - Objectifs et architecture du projet
+- `docs/structure.md` - Structure des modules et organisation
+- `docs/development.md` - Guidelines de développement
+- `docs/AI.md` - Contrat pour assistants IA
+
+## Développement
+
+```bash
+# Créer un environnement virtuel
+python service.py dev venv
+
+# Installer en mode développement
+python service.py dev install-dev
+
+# Exécuter les tests
+python service.py dev test
+
+# Formater le code
+python service.py dev format
+
+# Lancer tous les checks qualité
+python service.py quality check
+```
+
+## Licence
+
+Ce projet est sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.
+

python_missive-0.2.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "python-missive"
+version = "0.2.0"
+description = "Framework-agnostic messaging library for multi-channel communication."
+authors = [{ name = "Charl", email = "charl@example.com" }]
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+dependencies = []
+
+[project.scripts]
+pymissive = "pymissive.cli:main"
+
+[project.optional-dependencies]
+scaleway = ["boto3>=1.34", "scaleway>=2.0"]
+dev = [
+    "pytest>=8.3",
+    "ruff>=0.5",
+    "flake8-simplify>=0.21",
+    "flake8-docstrings>=1.7",
+]
+
+[project.urls]
+Homepage = "https://example.com/python-missive"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+ignore_missing_imports = true
+show_error_codes = true
+# Ignore archives directory (old code)
+exclude = [
+    "src/pymissive/archives/.*",
+]
+# Ignore mixin attribute errors (they are provided by BaseProvider)
+[[tool.mypy.overrides]]
+module = [
+    "pymissive.providers.base.*",
+]
+ignore_errors = true

python_missive-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

python_missive-0.2.0/src/pymissive/__init__.py

@@ -0,0 +1,3 @@
+"""Python Missive - Framework-agnostic messaging library."""
+
+__version__ = "0.1.0"

python_missive-0.2.0/src/pymissive/__main__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())
+

python_missive-0.2.0/src/pymissive/archives/__init__.py

@@ -0,0 +1,142 @@
+"""Lightweight multi-channel messaging helpers."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional, Sequence, Union
+
+from .address import Address
+from .address_backends import (BaseAddressBackend, GoogleMapsAddressBackend,
+                               HereAddressBackend, MapboxAddressBackend,
+                               NominatimAddressBackend, PhotonAddressBackend)
+from .helpers import (
+    DEFAULT_MIN_ADDRESS_CONFIDENCE,
+    describe_address_backends,
+    format_phone_international,
+    get_address_backend_by_attribute,
+    get_address_backends_from_config,
+    get_address_by_reference,
+    get_provider_by_attribute,
+    search_addresses,
+)
+from .missive import Missive
+from .providers.base.common import BaseProviderCommon
+from .sender import MissiveSender
+from .status import MissiveStatus
+
+__all__ = [
+    "MissiveStatus",
+    "BaseProviderCommon",
+    "Address",
+    "Missive",
+    "MissiveSender",
+    "send_missive",
+    "format_phone_international",
+    "get_address_backends_from_config",
+    "get_address_by_reference",
+    "search_addresses",
+    "get_address_backend_by_attribute",
+    "describe_address_backends",
+    "get_provider_by_attribute",
+    "DEFAULT_MIN_ADDRESS_CONFIDENCE",
+    "BaseAddressBackend",
+    "GoogleMapsAddressBackend",
+    "HereAddressBackend",
+    "MapboxAddressBackend",
+    "NominatimAddressBackend",
+    "PhotonAddressBackend",
+]
+
+
+def send_missive(
+    missive_type: str,
+    body: str,
+    subject: Optional[str] = None,
+    recipient_email: Optional[str] = None,
+    recipient_phone: Optional[str] = None,
+    recipient: Optional[Any] = None,
+    providers_config: Optional[Union[Sequence[str], Dict[str, Dict[str, Any]]]] = None,
+    config: Optional[Dict[str, Any]] = None,
+    sandbox: bool = False,
+    enable_fallback: bool = True,
+    **kwargs: Any,
+) -> Missive:
+    """Send a missive with automatic provider selection and fallback.
+
+    Args:
+        missive_type: Type of missive (EMAIL, SMS, POSTAL, etc.)
+        body: Message body/content
+        subject: Message subject (required for EMAIL)
+        recipient_email: Recipient email address (for EMAIL)
+        recipient_phone: Recipient phone number (for SMS, VOICE_CALL)
+        recipient: Complex recipient object with metadata (for PUSH_NOTIFICATION, etc.)
+        providers_config: Either:
+            - List of provider import paths: ["pymissive.providers.brevo.BrevoProvider"]
+            - Dict mapping paths to configs: {"path": {"API_KEY": "value"}}
+        config: Default configuration dict merged with provider-specific configs
+        sandbox: If True, forces sandbox mode for all providers (no real sends)
+        enable_fallback: If True, try next provider on failure
+        **kwargs: Additional options (provider_options, is_registered, etc.)
+
+    Returns:
+        Missive object with updated status
+
+    Raises:
+        RuntimeError: If all providers fail
+        ValueError: If required fields are missing
+
+    Example:
+        >>> missive = send_missive(
+        ...     "EMAIL",
+        ...     body="Hello world",
+        ...     subject="Test",
+        ...     recipient_email="user@example.com",
+        ... )
+        >>> print(missive.status)
+        MissiveStatus.SENT
+    """
+    missive_type = missive_type.upper()
+
+    # Validate required fields based on type
+    if missive_type == "EMAIL" and not recipient_email:
+        raise ValueError("recipient_email required for EMAIL missives")
+    if missive_type == "EMAIL" and not subject:
+        raise ValueError("subject required for EMAIL missives")
+    if missive_type in ("SMS", "VOICE_CALL") and not recipient_phone:
+        raise ValueError(f"recipient_phone required for {missive_type} missives")
+    if (
+        missive_type in ("POSTAL", "POSTAL_REGISTERED")
+        and not recipient
+        and not recipient_email
+    ):
+        raise ValueError(
+            f"recipient or recipient_email required for {missive_type} missives"
+        )
+
+    # Create missive object
+    missive = Missive(
+        missive_type=missive_type,
+        body=body,
+        subject=subject,
+        recipient_email=recipient_email,
+        recipient_phone=recipient_phone,
+        recipient=recipient,
+        provider_options=kwargs.get("provider_options", {}),
+        is_registered=kwargs.get("is_registered", missive_type == "POSTAL_REGISTERED"),
+        requires_signature=kwargs.get("requires_signature", False),
+    )
+
+    # Create sender and send
+    sender = MissiveSender(
+        providers_config=providers_config,
+        default_config=config,
+        sandbox=sandbox,
+    )
+
+    try:
+        sender.send(missive, enable_fallback=enable_fallback)
+    except Exception as e:
+        missive.status = MissiveStatus.FAILED
+        missive.error_message = str(e)
+        raise
+
+    return missive

python_missive-0.2.0/src/pymissive/archives/__main__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from .cli import main
+
+if __name__ == "__main__":
+    import sys
+
+    sys.exit(main())
+