urban-http 0.1.0__tar.gz

urban_http-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,62 @@
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Installer le paquet et les dépendances de test
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install ".[dev]" pyyaml
+
+      - name: Lancer les tests
+        run: pytest -q
+
+  build:
+    name: Build & vérification du paquet
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+
+      - name: Vérifier les métadonnées du paquet
+        run: python -m twine check dist/*
+
+      - name: Conserver les artefacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/

urban_http-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,87 @@
+name: Publier sur PyPI
+
+# Déclenché en poussant un tag de version, ex. : git tag v0.2.0 && git push origin v0.2.0
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+    inputs:
+      repository:
+        description: "Cible : pypi ou testpypi"
+        default: "pypi"
+        type: choice
+        options: ["pypi", "testpypi"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Construire le paquet
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Vérifier que le tag correspond à la version du paquet
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          TAG="${GITHUB_REF_NAME#v}"
+          VERSION="$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml","rb"))["project"]["version"])')"
+          echo "tag=$TAG  version_pyproject=$VERSION"
+          if [ "$TAG" != "$VERSION" ]; then
+            echo "::error::Le tag v$TAG ne correspond pas à project.version=$VERSION dans pyproject.toml"
+            exit 1
+          fi
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+          python -m twine check dist/*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+
+  publish-testpypi:
+    name: Publier sur TestPyPI
+    if: github.event_name == 'workflow_dispatch' && inputs.repository == 'testpypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/urban-http
+    permissions:
+      id-token: write   # OIDC pour le Trusted Publishing, aucun token stocké
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+      - name: Téléverser vers TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    name: Publier sur PyPI
+    if: startsWith(github.ref, 'refs/tags/v') || (github.event_name == 'workflow_dispatch' && inputs.repository == 'pypi')
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/urban-http
+    permissions:
+      id-token: write   # OIDC pour le Trusted Publishing, aucun token stocké
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+      - name: Téléverser vers PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

urban_http-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Environnements virtuels
+.venv/
+venv/
+env/
+
+# Tests et couverture
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Éditeurs / OS
+.DS_Store
+.idea/
+.vscode/

urban_http-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 black beard
+
+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.

urban_http-0.1.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.5
+Name: urban-http
+Version: 0.1.0
+Summary: Transformer une commande curl ou une collection Postman en appel exécutable (HTTP et autres protocoles).
+Project-URL: Repository, https://github.com/gaelgael5/urban-http
+Author: urban-http
+License: MIT License
+        
+        Copyright (c) 2026 black beard
+        
+        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.
+License-File: LICENSE
+Keywords: curl,http,parser,postman,sdk
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Provides-Extra: all
+Requires-Dist: flask>=3; extra == 'all'
+Requires-Dist: paho-mqtt>=2; extra == 'all'
+Requires-Dist: paramiko>=3; extra == 'all'
+Requires-Dist: smbprotocol>=1.12; extra == 'all'
+Requires-Dist: websockets>=12; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: mqtt
+Requires-Dist: paho-mqtt>=2; extra == 'mqtt'
+Provides-Extra: openapi
+Requires-Dist: pyyaml>=6; extra == 'openapi'
+Provides-Extra: scp
+Requires-Dist: paramiko>=3; extra == 'scp'
+Provides-Extra: sftp
+Requires-Dist: paramiko>=3; extra == 'sftp'
+Provides-Extra: smb
+Requires-Dist: smbprotocol>=1.12; extra == 'smb'
+Provides-Extra: web
+Requires-Dist: flask>=3; extra == 'web'
+Provides-Extra: websocket
+Requires-Dist: websockets>=12; extra == 'websocket'
+Description-Content-Type: text/markdown
+
+# urban-http
+
+[![CI](https://github.com/gaelgael5/urban-http/actions/workflows/ci.yml/badge.svg)](https://github.com/gaelgael5/urban-http/actions/workflows/ci.yml)
+
+SDK **Python** pour transformer une commande **curl** ou une **collection Postman**
+en **appel exécutable** — HTTP via la bibliothèque standard, et les autres
+protocoles de curl (SMTP, FTP, SFTP, POP3, MQTT, TFTP, FILE, SMB, WebSocket) via
+des adaptateurs dont les dépendances sont gérées en **extras PyPI**. Protocoles
+couverts : HTTP, SMTP, FTP/FTPS, SFTP, SCP, POP3, IMAP, MQTT, TFTP, FILE, SMB,
+WebSocket.
+
+```
+commande curl ───▶ parse_curl() ────┐
+                                    ├──▶ HttpRequestModel ──▶ prepare_request() / execute()
+collection Postman ─▶ parse_postman() ┘
+                    └▶ parse_command() ──▶ ProtocolRequest ──▶ run() (adaptateur)
+```
+
+## Installation
+
+```bash
+pip install urban-http                       # cœur : HTTP + SMTP/FTP/POP3/TFTP/FILE (stdlib, zéro dépendance)
+pip install "urban-http[sftp,mqtt,smb]"      # extras pour les protocoles qui requièrent une bibliothèque
+pip install "urban-http[all]"                # tout
+```
+
+Le **cœur n'a aucune dépendance obligatoire**. Chaque protocole qui s'appuie sur
+une bibliothèque tierce est un extra :
+
+| Extra | Protocole | Bibliothèque PyPI |
+|---|---|---|
+| `sftp` | SFTP | paramiko |
+| `mqtt` | MQTT / MQTTS | paho-mqtt |
+| `smb` | SMB / SMBS | smbprotocol |
+| `websocket` | WS / WSS | websockets |
+| `web` | site de test local | flask (optionnel) |
+
+SMTP, FTP/FTPS, POP3, IMAP, TFTP et FILE utilisent uniquement la bibliothèque
+standard (`smtplib`, `ftplib`, `poplib`, `imaplib`, `socket`, `open`) : aucun
+extra. SCP partage paramiko avec SFTP.
+
+## Utilisation
+
+```python
+from urban_http import parse_curl, execute
+
+result = parse_curl(
+    "curl -X POST https://api.example.com/items "
+    "-H 'Content-Type: application/json' -d '{\"name\": \"clavier\"}' -u alice:secret -m 10"
+)
+req = result.requests[0]
+req.method          # "POST"
+req.url             # "https://api.example.com/items"
+req.header("Content-Type")  # "application/json"
+
+resp = execute(req).response
+print(resp.status, resp.text())
+```
+
+Tout ce qui n'est pas reproductible est **signalé dans `warnings`** (jamais ignoré
+en silence) : chaque warning a un `code` stable, un `message` et un niveau.
+
+## Variables
+
+```python
+# {{nom}} partout, et $NOM / ${NOM} comme dans le shell (quotes doubles et nu)
+parse_curl('curl -H "Authorization: Bearer $TOKEN" {{baseUrl}}/users',
+           {"baseUrl": "https://api.example.com", "TOKEN": "tok-42"})
+
+# Dynamiques Postman générées : {{$guid}}, {{$randomUUID}}, {{$timestamp}}, {{$isoTimestamp}}, {{$randomInt}}
+from urban_http import parse_postman_environment
+variables = parse_postman_environment(env_json)  # export d'environnement Postman
+```
+
+## Collections Postman
+
+```python
+from urban_http import parse_postman, is_postman_collection
+
+result = parse_postman(collection_json, {"baseUrl": "https://api.example.com"})
+for req in result.requests:
+    print(req.name, req.method, req.url)
+```
+
+Format Collection v2.0 / v2.1 : dossiers imbriqués, variables, tous les modes de
+corps (raw, urlencoded, formdata, file, graphql), auth basic/bearer/apikey avec
+héritage collection → dossier → requête.
+
+## Autres protocoles
+
+```python
+from urban_http import run, register_default_adapters
+
+register_default_adapters()  # une fois
+
+# Envoi d'un mail (smtplib), téléversement FTP (ftplib), publication MQTT (paho)...
+result = run("curl smtp://mail.example.com --mail-from moi@x.com --mail-rcpt toi@y.com -T message.eml")
+print(result.protocol.summary)
+```
+
+`run()` détecte le protocole et route : HTTP via urllib, sinon l'adaptateur
+enregistré. Chaque adaptateur accepte un `client_factory` injectable (tests sans
+réseau, ou autre bibliothèque). Détail : **[docs/protocols.md](docs/protocols.md)**.
+
+## OpenAPI → curl
+
+`openapi_to_curl(contrat)` lit un contrat OpenAPI v3.x (dict, JSON, ou YAML avec
+l'extra `openapi`) et renvoie, pour chaque opération, une commande curl avec des
+variables injectables, le tableau de ses paramètres, et un modèle générique du
+corps de requête.
+
+```python
+from urban_http import openapi_to_curl, parse_curl
+
+for op in openapi_to_curl(contrat):
+    print(op.method, op.path)
+    print(op.curl)                 # avec des {{placeholders}}
+    print(op.example_variables)    # {nom: valeur} prêt pour parse_curl
+    req = parse_curl(op.curl, op.example_variables).requests[0]
+```
+
+Le corps est généré exhaustivement avec des valeurs types : chaîne → nom de la
+propriété, entier → 0, date/date-time → instant courant, sous-objet développé,
+tableau à un seul élément. Détail : **[docs/openapi.md](docs/openapi.md)**.
+
+## Ligne de commande
+
+```bash
+urban-http "curl -X POST https://api.example.com -d a=1"     # analyse et affiche la requête
+urban-http "curl file:///etc/hostname" --run                 # analyse ET exécute
+urban-http "curl {{baseUrl}}/get" --var baseUrl=https://httpbin.org
+urban-http --openapi contrat.json                            # génère les curl d'un contrat OpenAPI
+```
+
+## Site de test
+
+```bash
+python demo/server.py          # http://127.0.0.1:8000
+```
+
+Une page web qui analyse en direct n'importe quelle commande curl ou collection
+Postman (analyse faite en Python côté serveur) et exécute les requêtes HTTP. Les
+exemples HTTP ciblent httpbin.org.
+
+## Développement
+
+```bash
+python -m pytest               # 199 tests : tokenizer, parser, Postman, variables,
+                               # globbing, cookies, Digest, exécution, protocoles,
+                               # options TLS/réseau, OpenAPI
+```
+
+La CI (GitHub Actions) lance les tests sur Python 3.9 → 3.13 et construit le
+paquet à chaque push / PR. Une version se publie sur PyPI en poussant un tag
+`vX.Y.Z` — voir **[RELEASING.md](RELEASING.md)**.
+
+## Couverture de curl
+
+- **HTTP/HTTPS** : requête, corps, multipart, globbing, redirections, retries,
+  timeout, auth Basic/Bearer/Digest, cookies (inline et fichiers Netscape),
+  variables — plus l'import Postman. Détail : [docs/curl-use-cases.md](docs/curl-use-cases.md).
+- **Autres protocoles** : SMTP, FTP/FTPS, SFTP, SCP, POP3, IMAP, MQTT, TFTP,
+  FILE, SMB, WebSocket. Détail : [docs/protocols.md](docs/protocols.md).
+- **Panorama complet** (ce qui est couvert et ce qui ne l'est pas) :
+  [docs/curl-coverage.md](docs/curl-coverage.md).
+
+## Feuille de route
+
+- Protocoles restants : LDAP, TELNET.
+- Auth : AWS SigV4, NTLM/Negotiate, Digest `qop=auth-int`.
+- Requêtes conditionnelles (`-z`, `--etag-compare`), reprise `-C -` automatique.
+- Générateurs de code supplémentaires (httpx, requests).

urban_http-0.1.0/README.md

@@ -0,0 +1,172 @@
+# urban-http
+
+[![CI](https://github.com/gaelgael5/urban-http/actions/workflows/ci.yml/badge.svg)](https://github.com/gaelgael5/urban-http/actions/workflows/ci.yml)
+
+SDK **Python** pour transformer une commande **curl** ou une **collection Postman**
+en **appel exécutable** — HTTP via la bibliothèque standard, et les autres
+protocoles de curl (SMTP, FTP, SFTP, POP3, MQTT, TFTP, FILE, SMB, WebSocket) via
+des adaptateurs dont les dépendances sont gérées en **extras PyPI**. Protocoles
+couverts : HTTP, SMTP, FTP/FTPS, SFTP, SCP, POP3, IMAP, MQTT, TFTP, FILE, SMB,
+WebSocket.
+
+```
+commande curl ───▶ parse_curl() ────┐
+                                    ├──▶ HttpRequestModel ──▶ prepare_request() / execute()
+collection Postman ─▶ parse_postman() ┘
+                    └▶ parse_command() ──▶ ProtocolRequest ──▶ run() (adaptateur)
+```
+
+## Installation
+
+```bash
+pip install urban-http                       # cœur : HTTP + SMTP/FTP/POP3/TFTP/FILE (stdlib, zéro dépendance)
+pip install "urban-http[sftp,mqtt,smb]"      # extras pour les protocoles qui requièrent une bibliothèque
+pip install "urban-http[all]"                # tout
+```
+
+Le **cœur n'a aucune dépendance obligatoire**. Chaque protocole qui s'appuie sur
+une bibliothèque tierce est un extra :
+
+| Extra | Protocole | Bibliothèque PyPI |
+|---|---|---|
+| `sftp` | SFTP | paramiko |
+| `mqtt` | MQTT / MQTTS | paho-mqtt |
+| `smb` | SMB / SMBS | smbprotocol |
+| `websocket` | WS / WSS | websockets |
+| `web` | site de test local | flask (optionnel) |
+
+SMTP, FTP/FTPS, POP3, IMAP, TFTP et FILE utilisent uniquement la bibliothèque
+standard (`smtplib`, `ftplib`, `poplib`, `imaplib`, `socket`, `open`) : aucun
+extra. SCP partage paramiko avec SFTP.
+
+## Utilisation
+
+```python
+from urban_http import parse_curl, execute
+
+result = parse_curl(
+    "curl -X POST https://api.example.com/items "
+    "-H 'Content-Type: application/json' -d '{\"name\": \"clavier\"}' -u alice:secret -m 10"
+)
+req = result.requests[0]
+req.method          # "POST"
+req.url             # "https://api.example.com/items"
+req.header("Content-Type")  # "application/json"
+
+resp = execute(req).response
+print(resp.status, resp.text())
+```
+
+Tout ce qui n'est pas reproductible est **signalé dans `warnings`** (jamais ignoré
+en silence) : chaque warning a un `code` stable, un `message` et un niveau.
+
+## Variables
+
+```python
+# {{nom}} partout, et $NOM / ${NOM} comme dans le shell (quotes doubles et nu)
+parse_curl('curl -H "Authorization: Bearer $TOKEN" {{baseUrl}}/users',
+           {"baseUrl": "https://api.example.com", "TOKEN": "tok-42"})
+
+# Dynamiques Postman générées : {{$guid}}, {{$randomUUID}}, {{$timestamp}}, {{$isoTimestamp}}, {{$randomInt}}
+from urban_http import parse_postman_environment
+variables = parse_postman_environment(env_json)  # export d'environnement Postman
+```
+
+## Collections Postman
+
+```python
+from urban_http import parse_postman, is_postman_collection
+
+result = parse_postman(collection_json, {"baseUrl": "https://api.example.com"})
+for req in result.requests:
+    print(req.name, req.method, req.url)
+```
+
+Format Collection v2.0 / v2.1 : dossiers imbriqués, variables, tous les modes de
+corps (raw, urlencoded, formdata, file, graphql), auth basic/bearer/apikey avec
+héritage collection → dossier → requête.
+
+## Autres protocoles
+
+```python
+from urban_http import run, register_default_adapters
+
+register_default_adapters()  # une fois
+
+# Envoi d'un mail (smtplib), téléversement FTP (ftplib), publication MQTT (paho)...
+result = run("curl smtp://mail.example.com --mail-from moi@x.com --mail-rcpt toi@y.com -T message.eml")
+print(result.protocol.summary)
+```
+
+`run()` détecte le protocole et route : HTTP via urllib, sinon l'adaptateur
+enregistré. Chaque adaptateur accepte un `client_factory` injectable (tests sans
+réseau, ou autre bibliothèque). Détail : **[docs/protocols.md](docs/protocols.md)**.
+
+## OpenAPI → curl
+
+`openapi_to_curl(contrat)` lit un contrat OpenAPI v3.x (dict, JSON, ou YAML avec
+l'extra `openapi`) et renvoie, pour chaque opération, une commande curl avec des
+variables injectables, le tableau de ses paramètres, et un modèle générique du
+corps de requête.
+
+```python
+from urban_http import openapi_to_curl, parse_curl
+
+for op in openapi_to_curl(contrat):
+    print(op.method, op.path)
+    print(op.curl)                 # avec des {{placeholders}}
+    print(op.example_variables)    # {nom: valeur} prêt pour parse_curl
+    req = parse_curl(op.curl, op.example_variables).requests[0]
+```
+
+Le corps est généré exhaustivement avec des valeurs types : chaîne → nom de la
+propriété, entier → 0, date/date-time → instant courant, sous-objet développé,
+tableau à un seul élément. Détail : **[docs/openapi.md](docs/openapi.md)**.
+
+## Ligne de commande
+
+```bash
+urban-http "curl -X POST https://api.example.com -d a=1"     # analyse et affiche la requête
+urban-http "curl file:///etc/hostname" --run                 # analyse ET exécute
+urban-http "curl {{baseUrl}}/get" --var baseUrl=https://httpbin.org
+urban-http --openapi contrat.json                            # génère les curl d'un contrat OpenAPI
+```
+
+## Site de test
+
+```bash
+python demo/server.py          # http://127.0.0.1:8000
+```
+
+Une page web qui analyse en direct n'importe quelle commande curl ou collection
+Postman (analyse faite en Python côté serveur) et exécute les requêtes HTTP. Les
+exemples HTTP ciblent httpbin.org.
+
+## Développement
+
+```bash
+python -m pytest               # 199 tests : tokenizer, parser, Postman, variables,
+                               # globbing, cookies, Digest, exécution, protocoles,
+                               # options TLS/réseau, OpenAPI
+```
+
+La CI (GitHub Actions) lance les tests sur Python 3.9 → 3.13 et construit le
+paquet à chaque push / PR. Une version se publie sur PyPI en poussant un tag
+`vX.Y.Z` — voir **[RELEASING.md](RELEASING.md)**.
+
+## Couverture de curl
+
+- **HTTP/HTTPS** : requête, corps, multipart, globbing, redirections, retries,
+  timeout, auth Basic/Bearer/Digest, cookies (inline et fichiers Netscape),
+  variables — plus l'import Postman. Détail : [docs/curl-use-cases.md](docs/curl-use-cases.md).
+- **Autres protocoles** : SMTP, FTP/FTPS, SFTP, SCP, POP3, IMAP, MQTT, TFTP,
+  FILE, SMB, WebSocket. Détail : [docs/protocols.md](docs/protocols.md).
+- **Panorama complet** (ce qui est couvert et ce qui ne l'est pas) :
+  [docs/curl-coverage.md](docs/curl-coverage.md).
+
+## Feuille de route
+
+- Protocoles restants : LDAP, TELNET.
+- Auth : AWS SigV4, NTLM/Negotiate, Digest `qop=auth-int`.
+- Requêtes conditionnelles (`-z`, `--etag-compare`), reprise `-C -` automatique.
+- Générateurs de code supplémentaires (httpx, requests).

urban_http-0.1.0/RELEASING.md

@@ -0,0 +1,62 @@
+# Publier une version sur PyPI
+
+La CI publie automatiquement sur PyPI quand on **pousse un tag de version**.
+L'authentification utilise le **Trusted Publishing (OIDC)** de PyPI : **aucun
+token n'est stocké** dans le dépôt.
+
+## Configuration (une seule fois)
+
+### 1. Déclarer le « trusted publisher » sur PyPI
+
+Sur <https://pypi.org>, projet `urban-http` → *Settings* → *Publishing* (ou, avant
+le tout premier envoi, <https://pypi.org/manage/account/publishing/> → *pending
+publisher*), ajouter un éditeur GitHub Actions avec :
+
+| Champ | Valeur |
+|---|---|
+| PyPI Project Name | `urban-http` |
+| Owner | `gaelgael5` |
+| Repository name | `urban-http` |
+| Workflow name | `publish.yml` |
+| Environment name | `pypi` |
+
+(Pour TestPyPI, répéter la même chose sur <https://test.pypi.org> avec
+l'environment `testpypi`.)
+
+### 2. Créer les environnements GitHub
+
+Dans le dépôt → *Settings* → *Environments*, créer `pypi` (et `testpypi` si
+souhaité). On peut y ajouter une règle de protection (révision obligatoire avant
+publication).
+
+## Publier une version
+
+1. Mettre à jour la version dans `pyproject.toml` (`project.version`).
+2. Commiter et pousser sur `main`.
+3. Créer et pousser le tag correspondant :
+
+   ```bash
+   git tag v0.2.0
+   git push origin v0.2.0
+   ```
+
+Le workflow `publish.yml` vérifie que le tag (`v0.2.0`) correspond bien à
+`project.version` (`0.2.0`), construit le sdist + wheel, les passe à
+`twine check`, puis publie sur PyPI.
+
+### Tester d'abord sur TestPyPI
+
+Lancer manuellement le workflow *Publier sur PyPI* (onglet Actions →
+*Run workflow*) en choisissant la cible `testpypi`.
+
+## Repli : token d'API
+
+Si le Trusted Publishing n'est pas souhaité, créer un token sur PyPI, l'ajouter
+en secret `PYPI_API_TOKEN`, et passer le mot de passe à l'action dans
+`publish.yml` :
+
+```yaml
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+```