baobab-altered-api 1.0.0__tar.gz

baobab_altered_api-1.0.0/.gitignore

@@ -0,0 +1,405 @@
+# Created by https://www.toptal.com/developers/gitignore/api/python,pycharm,pycharm+all,pycharm+iml
+# Edit at https://www.toptal.com/developers/gitignore?templates=python,pycharm,pycharm+all,pycharm+iml
+
+### PyCharm ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# AWS User-specific
+.idea/**/aws.xml
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# SonarLint plugin
+.idea/sonarlint/
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### PyCharm Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+# https://plugins.jetbrains.com/plugin/7973-sonarlint
+.idea/**/sonarlint/
+
+# SonarQube Plugin
+# https://plugins.jetbrains.com/plugin/7238-sonarqube-community-plugin
+.idea/**/sonarIssues.xml
+
+# Markdown Navigator plugin
+# https://plugins.jetbrains.com/plugin/7896-markdown-navigator-enhanced
+.idea/**/markdown-navigator.xml
+.idea/**/markdown-navigator-enh.xml
+.idea/**/markdown-navigator/
+
+# Cache file creation bug
+# See https://youtrack.jetbrains.com/issue/JBR-2257
+.idea/$CACHE_FILE$
+
+# CodeStream plugin
+# https://plugins.jetbrains.com/plugin/12206-codestream
+.idea/codestream.xml
+
+# Azure Toolkit for IntelliJ plugin
+# https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij
+.idea/**/azureSettings.xml
+
+### PyCharm+all ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+
+# AWS User-specific
+
+# Generated files
+
+# Sensitive or high-churn files
+
+# Gradle
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+
+# Mongo Explorer plugin
+
+# File-based project format
+
+# IntelliJ
+
+# mpeltonen/sbt-idea plugin
+
+# JIRA plugin
+
+# Cursive Clojure plugin
+
+# SonarLint plugin
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+
+# Editor-based Rest Client
+
+# Android studio 3.1+ serialized cache file
+
+### PyCharm+all Patch ###
+# Ignore everything but code style settings and run configurations
+# that are supposed to be shared within teams.
+
+.idea/*
+
+!.idea/codeStyles
+!.idea/runConfigurations
+
+### PyCharm+iml ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio, WebStorm and Rider
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+
+# AWS User-specific
+
+# Generated files
+
+# Sensitive or high-churn files
+
+# Gradle
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/artifacts
+# .idea/compiler.xml
+# .idea/jarRepositories.xml
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+# *.iml
+# *.ipr
+
+# CMake
+
+# Mongo Explorer plugin
+
+# File-based project format
+
+# IntelliJ
+
+# mpeltonen/sbt-idea plugin
+
+# JIRA plugin
+
+# Cursive Clojure plugin
+
+# SonarLint plugin
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+
+# Editor-based Rest Client
+
+# Android studio 3.1+ serialized cache file
+
+### PyCharm+iml Patch ###
+# Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-249601023
+
+*.iml
+modules.xml
+.idea/misc.xml
+*.ipr
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+.my_cache/
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+### Python Patch ###
+# Poetry local configuration file - https://python-poetry.org/docs/configuration/#local-configuration
+poetry.toml
+
+# ruff
+.ruff_cache/
+
+# LSP config files
+pyrightconfig.json
+
+# End of https://www.toptal.com/developers/gitignore/api/python,pycharm,pycharm+all,pycharm+iml

baobab_altered_api-1.0.0/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+Toutes les modifications notables de ce projet seront documentées dans ce fichier.
+
+Le format est inspiré de [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-05-17
+
+Première release stable : portefeuille FEAT-001 à FEAT-012 livré (clients sync/async, ressources métier, Open Data, robustesse transverse, documentation et tests ≥ 90 % de couverture).
+
+### Added
+
+- Alignement cahier des charges Open Data : ``OpenDataResource``, ``AsyncOpenDataResource``, hiérarchie Set→Faction→Carte, ``fetch_snapshot`` / ``load_from_file`` / ``iter_cards`` / ``save_snapshot``, ``OpenDataFileIo``, ``AsyncAlteredClient.open_data``.
+- Documentation : ``docs/decks.md``, ``docs/api_observations/decks.md``, ``marketplace.md``, ``auth.md`` ; index endpoints complété.
+- Test d'intégration optionnel Open Data (``@pytest.mark.integration``).
+
+- FEAT-012 : ``docs/development.md``, ``docs/guide_sync.md``, ``docs/guide_async.md``, ``docs/release_checklist.md``, index ``docs/api_observations/endpoints/``.
+- FEAT-010 : ``AlteredMarketplaceOffer``, mapper et ``MarketplaceResource`` / ``AsyncMarketplaceResource`` (lecture seule).
+- FEAT-009 : ``AlteredDeck``, mapper et ``DecksResource`` / ``AsyncDecksResource``.
+- FEAT-008 : ``AlteredOpenDataSnapshot``, ``OpenDataReader``, ``OpenDataDownloader``, ``OpenDataCatalog``, ``OpenDataAccess`` et propriété ``AlteredClient.open_data`` ; fixtures ``tests/fixtures/open_data/`` ; ``docs/open_data.md``, ``docs/api_observations/open_data.md``.
+- FEAT-009 : tests dédiés ``test_async_decks_resource.py`` (``AsyncDecksResource``).
+- FEAT-010 : ``docs/marketplace.md``, section marketplace dans ``docs/security.md``, test contractuel ``test_marketplace_read_only_contract.py``.
+- FEAT-007 : modèles référentiels, ``ReferentialsResource`` / ``AsyncReferentialsResource`` ; ``docs/api_observations/references.md``.
+- FEAT-006 : ``CardSearchFilters``, ``CardsResource`` / ``AsyncCardsResource``, itération paginée contrôlée ; ``docs/cards.md``, ``docs/api_observations/cards.md``.
+- FEAT-005 (`BL-005-005`) : corpus fixtures JSON + ``tests/fixtures/README.md``, ``json_loader``, tests parseabilité.
+- FEAT-005 (`BL-005-004`) : builder interne ``QueryParamsBuilder`` (`internal/query_params.py`) pour sérialiser filtres, tris et ``AlteredPaginationParams`` vers ``dict[str, str]`` stable ; ``docs/api_observations/query_params.md``.
+- FEAT-005 (`BL-005-003`) : ``AlteredPaginationParams``, ``AlteredPage`` (générique), ``AlteredPaginationJsonMapper`` ; ``docs/api_observations/pagination.md``.
+- FEAT-005 (`BL-005-002`) : ``AlteredCommonModelsJsonMapper`` (résumé carte, faction, extension, rareté, image, libellé localisé, ref) ; tolérance alias JSON et ``AlteredMappingError`` ; fixtures ``tests/fixtures/json/*.json`` ; ``docs/api_observations/mappers.md``.
+- FEAT-005 (`BL-005-001`) : modèles communs immuables `AlteredRef`, `AlteredImage`, `AlteredLocalizedLabel`, `AlteredFaction`, `AlteredSet`, `AlteredRarity`, `AlteredCardSummary` ; exports `models.__all__` ; hypothèses documentées dans `docs/api_observations/models.md`.
+- FEAT-011 (`BL-011-006`) : tests transverses `test_transverse_robustness.py` ; section associée dans `docs/testing.md`.
+- FEAT-011 (`BL-011-005`) : middlewares sync/async `AlteredRateLimitMiddleware` / `AlteredRateLimitMiddlewareAsync` sur `ApiClientConfig` si `rate_limit_per_second` ; tests `test_rate_limit.py` ; `docs/security.md` (débit / 429), `docs/configuration.md`, `docs/clients.md`.
+- FEAT-011 (`BL-011-004`) : timeout global propagé au transport HTTPX par défaut ; `retry_jitter` + plafond `MAX_RETRY_ATTEMPTS` (50) ; `RetryPolicy` du socle alignée ; variable `ALTERED_API_RETRY_JITTER` ; tests `test_retries_timeouts.py`.
+- FEAT-011 (`BL-011-001`) : exceptions `AlteredAuthError`, `AlteredForbiddenError`, `AlteredServiceUnavailableError`, `AlteredTransportError`, `AlteredMappingError` ; tests `test_exceptions.py` ; exports `exceptions.__all__`.
+- FEAT-011 (`BL-011-003`) : logger `baobab_altered_api` (opt-in, sans `basicConfig`) ; `AlteredLogRedactor` / `AlteredApiLogger` ; journaux HTTP minimaux dans les transports sync/async ; tests `internal/test_*` et non-fuite dans `caplog`.
+- FEAT-011 (`BL-011-002`) : `ErrorMapper` (HTTP → exceptions Altered, transport timeout / réseau) ; intégration dans `AlteredTransportResponseHandler` ; `AlteredServiceUnavailableError` accepte le code HTTP 5xx réel ; tests `test_error_mapper.py` et ajustements `test_response_handler.py`.
+- FEAT-004 (BL-004-001, BL-004-002) : clients publics `AlteredClient` et `AsyncAlteredClient` (façade + `http`, context managers, transport par défaut ou injecté) ; exports package racine.
+- FEAT-004 (BL-004-003) : injection optionnelle `api_client_config` sur `AlteredClient` / `AsyncAlteredClient` (alignement `base_url` avec `AlteredApiConfig`, garde-fous transport sync/async, `ApiClientConfigAlignment`, `TransportPortValidator`) ; tests `test_client_injection.py`.
+- FEAT-004 (BL-004-004) : exports publics documentés pour `baobab_altered_api.clients` (`__all__` typé) ; tests `test_public_exports.py` ; clients toujours re-exportés depuis le package racine.
+- FEAT-004 (BL-004-005) : guide `docs/clients.md` (usages minimaux sync/async, injection, pas d’endpoint présenté comme stable).
+- FEAT-003 (BL-003-005) : fakes `tests.fakes.FakeSyncTransport` / `FakeAsyncTransport` (routage méthode + chemin + params, historique, défaut) ; documentation `docs/testing.md` ; `source-roots` Pylint pour les imports `tests.*`.
+- FEAT-003 (BL-003-004) : `AlteredTransportResponseHandler`, `AlteredJsonPayload`, exceptions typées (`AlteredApiError`, 404, 429, timeout, réseau, JSON) ; amorce FEAT-011 pour la hiérarchie d’erreurs.
+- FEAT-003 (BL-003-003) : fermeture idempotente, `with` / `async with` sur `AlteredSyncTransport` et `AlteredAsyncTransport` ; tests de cycle de vie dédiés.
+- Docstrings Sphinx complètes sur le validateur réseau, `__repr__` / `__str__` de
+  `AlteredApiConfig` et `__repr__` de `AlteredAuthFactory` ; jeton Bearer de test
+  `baobab-api-token` dans les tests et exemples de documentation.
+- FEAT-003 (BL-003-002) : transport asynchrone `AlteredAsyncTransport` (HTTPX + port `AsyncTransport`).
+- FEAT-003 (BL-003-001) : transport synchrone `AlteredSyncTransport` (HTTPX + port `SyncTransport`) et exception `AlteredHttpError`.
+- FEAT-002 : configuration immuable `AlteredApiConfig`, chargement explicite `load_config_from_env`, validation réseau, fabrique d’authentification `AlteredAuthFactory` et construction vers le socle `baobab-api-call`.
+- `AlteredApiConfig.from_environment` (alias documentaire), variables d’environnement `ALTERED_API_RETRY_BACKOFF_SECONDS` et `ALTERED_API_RATE_LIMIT_PER_SECOND`.
+- Documentation `docs/configuration.md`, `docs/authentication.md` et `docs/security.md` (variables d’environnement, bonnes pratiques secrets).
+- Socle packaging PEP 621 (`hatchling`) pour la distribution `baobab-altered-api`.
+- Arborescence applicative `src/baobab_altered_api` avec sous-packages (`config`, `clients`, `resources`, etc.).
+- Tests unitaires initiaux, garde anti-réseau par défaut et documentation de test.
+- Marqueur PEP 561 via `py.typed`.
+
+### Documentation
+
+- Pilotage portefeuille : `BOARD.md` étendu (`FEAT-005`–`FEAT-012`), décision **DEC-0001** dans `docs/ia_workflow/communication/003_decision_log.md`, fiche **NO GO** levée (`docs/ia_workflow/no_go/REQUEST_ALL_BACKLOGS_SINGLE_PASS/no_go_1.md`).
+
+### Fixed
+
+- Garde réseau des tests : les sockets ``AF_UNIX`` utilisés en interne par ``asyncio`` ne sont plus bloqués (nécessaire aux tests async / ``pytest-asyncio``).
+- Dépendance dev ``pytest-asyncio>=1.3`` : suppression des warnings ``asyncio.get_event_loop_policy`` sous Python 3.14.

baobab_altered_api-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Contributeurs baobab-altered-api
+
+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.

baobab_altered_api-1.0.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: baobab-altered-api
+Version: 1.0.0
+Summary: Client Python typé pour l’API publique Altered TCG, bâti sur baobab-api-call.
+Author: Contributeurs baobab-altered-api
+License: MIT
+License-File: LICENSE
+Keywords: altered,api,client,httpx,tcg
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: baobab-api-call<3.0,>=2.1.0
+Requires-Dist: httpx<1,>=0.27
+Provides-Extra: dev
+Requires-Dist: bandit<2,>=1.7; extra == 'dev'
+Requires-Dist: black<26,>=24; extra == 'dev'
+Requires-Dist: build<2,>=1.2; extra == 'dev'
+Requires-Dist: coverage[toml]<8,>=7; extra == 'dev'
+Requires-Dist: flake8-pyproject<2,>=1.2; extra == 'dev'
+Requires-Dist: flake8<8,>=7; extra == 'dev'
+Requires-Dist: mypy<2,>=1.10; extra == 'dev'
+Requires-Dist: pylint<5,>=3; extra == 'dev'
+Requires-Dist: pytest-asyncio<2,>=1.3; extra == 'dev'
+Requires-Dist: pytest-cov<6,>=4; extra == 'dev'
+Requires-Dist: pytest<9,>=7; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: sphinx<9,>=7; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# baobab-altered-api
+
+Client Python **typé** et **testable** pour consommer les API publiques liées au jeu de cartes **Altered TCG**.
+
+La librairie est conçue comme une extension métier du socle [`baobab-api-call`](https://pypi.org/project/baobab-api-call/) (`>=2.1,<3`) : elle ne réimplémente pas de pile HTTP générique.
+
+## Statut du projet
+
+- **Version actuelle :** `1.0.0` — première release stable du client (sync/async, cartes, référentiels, decks, marketplace lecture seule, Open Data).
+- **Stabilité :** API publique de la librairie stabilisée ; les **chemins HTTP Altered** restent documentés comme hypothèses dans `docs/api_observations/` jusqu’à validation officielle.
+
+## Statut API Altered
+
+Les chemins d’endpoints, schémas JSON et règles d’accès **doivent être confirmés** via le portail développeur Altered et consignés dans `docs/api_observations/`.  
+Ce dépôt **ne promet pas** de couverture exhaustive tant que ces observations ne sont pas validées.
+
+## Installation (développement)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e ".[dev]"
+pytest
+```
+
+## Qualité
+
+Les seuils et outils sont décrits dans `pyproject.toml` (pytest, coverage, black, flake8, pylint, mypy, bandit, build).
+
+- [Guide des tests et fakes](docs/testing.md) — transports factices `tests.fakes`, garde réseau, exemples.
+- [Usages minimaux des clients](docs/clients.md) — `with` / `async with`, configuration, sans promesse d’endpoints non validés.
+
+## Transports HTTPX
+
+- **Synchrone** : `AlteredSyncTransport` avec `SyncApiClient` du socle ; fermer via `transport.close()` (idempotent) ou `with transport:` pour un client HTTPX créé par le transport.
+- **Asynchrone** : `AlteredAsyncTransport` avec `AsyncApiClient` ; fermer via `await transport.aclose()` (idempotent) ou `async with transport:` dans le même cas.
+- Si vous injectez un `httpx.Client` / `httpx.AsyncClient`, la fermeture du client reste à votre charge ; le transport ne le referme pas.
+- **Réponses JSON** : `AlteredTransportResponseHandler` (`json_payload_or_raise`, `raise_for_client_failure`) normalise les succès en `AlteredJsonPayload` et convertit erreurs HTTP, JSON, timeout et réseau en exceptions Altered typées, sans corps de réponse dans les messages.
+
+## Clients publics
+
+Guide pas à pas : **[docs/clients.md](docs/clients.md)** (sync, async, injection, rappels sur les chemins d’API).
+
+Façades : `AlteredClient` et `AsyncAlteredClient`. Import racine recommandé pour la découverte : `from baobab_altered_api import AlteredClient, AsyncAlteredClient` ; import ciblé : `from baobab_altered_api.clients import AlteredClient, AsyncAlteredClient` (mêmes types, `__all__` du sous-package limité aux deux façades). Elles assemblent `AlteredApiConfig`, le transport HTTPX Altered et le client du socle (`http`). Aucune requête à l’instanciation ; préférez `with AlteredClient(…) as c:` / `async with AsyncAlteredClient(…) as c:` pour la fermeture.
+
+- **Injection** : `transport=` accepte un port `SyncTransport` / `AsyncTransport` du socle. `api_client_config=` permet de remplacer la configuration `ApiClientConfig` produite par défaut (ex. en-têtes, timeouts, stratégie d’auth du socle) ; son `base_url` doit coïncider avec `AlteredApiConfig.base_url` après normalisation (`rstrip('/')`), sinon `AlteredConfigError`. Pour cloner une config du socle, préférez `ApiClientConfig.copy_with(...)` plutôt que `dataclasses.replace` (évite le conflit `timeout_seconds` / `timeouts`).
+- **Sync vs async** : un transport dont `send` est une coroutine est refusé sur `AlteredClient` ; un `send` synchrone est refusé sur `AsyncAlteredClient` (`TypeError` explicite).
+- **Cycle de vie** : la fermeture de la façade (`close` / `aclose`) propage au client du socle, qui ferme le transport exposé. Un transport injecté est donc fermé avec la façade : ne le partagez pas réutilisé après fermeture sans le recréer.
+
+```python
+from baobab_altered_api import AlteredApiConfig, AlteredClient
+
+cfg = AlteredApiConfig(base_url="https://api.test.example", bearer_token="baobab-api-token")
+with AlteredClient(cfg) as client:
+    # Tout chemin doit être validé hors ligne (voir docs/api_observations/).
+    resp = client.http.get("/chemin/relatif/exemple")
+```
+
+## Configuration et sécurité
+
+- [Configuration](docs/configuration.md) — modèle `AlteredApiConfig`, variables `ALTERED_API_*`, exemples avec valeurs fictives.
+- [Authentification](docs/authentication.md) — modes Bearer / clé API, lien avec `AlteredAuthFactory` et le socle.
+- [Sécurité](docs/security.md) — gestion des secrets, représentations masquées, bonnes pratiques CI et dépôt.
+
+## Licence
+
+MIT — voir le fichier `LICENSE`.

baobab_altered_api-1.0.0/README.md

@@ -0,0 +1,68 @@
+# baobab-altered-api
+
+Client Python **typé** et **testable** pour consommer les API publiques liées au jeu de cartes **Altered TCG**.
+
+La librairie est conçue comme une extension métier du socle [`baobab-api-call`](https://pypi.org/project/baobab-api-call/) (`>=2.1,<3`) : elle ne réimplémente pas de pile HTTP générique.
+
+## Statut du projet
+
+- **Version actuelle :** `1.0.0` — première release stable du client (sync/async, cartes, référentiels, decks, marketplace lecture seule, Open Data).
+- **Stabilité :** API publique de la librairie stabilisée ; les **chemins HTTP Altered** restent documentés comme hypothèses dans `docs/api_observations/` jusqu’à validation officielle.
+
+## Statut API Altered
+
+Les chemins d’endpoints, schémas JSON et règles d’accès **doivent être confirmés** via le portail développeur Altered et consignés dans `docs/api_observations/`.  
+Ce dépôt **ne promet pas** de couverture exhaustive tant que ces observations ne sont pas validées.
+
+## Installation (développement)
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -U pip
+pip install -e ".[dev]"
+pytest
+```
+
+## Qualité
+
+Les seuils et outils sont décrits dans `pyproject.toml` (pytest, coverage, black, flake8, pylint, mypy, bandit, build).
+
+- [Guide des tests et fakes](docs/testing.md) — transports factices `tests.fakes`, garde réseau, exemples.
+- [Usages minimaux des clients](docs/clients.md) — `with` / `async with`, configuration, sans promesse d’endpoints non validés.
+
+## Transports HTTPX
+
+- **Synchrone** : `AlteredSyncTransport` avec `SyncApiClient` du socle ; fermer via `transport.close()` (idempotent) ou `with transport:` pour un client HTTPX créé par le transport.
+- **Asynchrone** : `AlteredAsyncTransport` avec `AsyncApiClient` ; fermer via `await transport.aclose()` (idempotent) ou `async with transport:` dans le même cas.
+- Si vous injectez un `httpx.Client` / `httpx.AsyncClient`, la fermeture du client reste à votre charge ; le transport ne le referme pas.
+- **Réponses JSON** : `AlteredTransportResponseHandler` (`json_payload_or_raise`, `raise_for_client_failure`) normalise les succès en `AlteredJsonPayload` et convertit erreurs HTTP, JSON, timeout et réseau en exceptions Altered typées, sans corps de réponse dans les messages.
+
+## Clients publics
+
+Guide pas à pas : **[docs/clients.md](docs/clients.md)** (sync, async, injection, rappels sur les chemins d’API).
+
+Façades : `AlteredClient` et `AsyncAlteredClient`. Import racine recommandé pour la découverte : `from baobab_altered_api import AlteredClient, AsyncAlteredClient` ; import ciblé : `from baobab_altered_api.clients import AlteredClient, AsyncAlteredClient` (mêmes types, `__all__` du sous-package limité aux deux façades). Elles assemblent `AlteredApiConfig`, le transport HTTPX Altered et le client du socle (`http`). Aucune requête à l’instanciation ; préférez `with AlteredClient(…) as c:` / `async with AsyncAlteredClient(…) as c:` pour la fermeture.
+
+- **Injection** : `transport=` accepte un port `SyncTransport` / `AsyncTransport` du socle. `api_client_config=` permet de remplacer la configuration `ApiClientConfig` produite par défaut (ex. en-têtes, timeouts, stratégie d’auth du socle) ; son `base_url` doit coïncider avec `AlteredApiConfig.base_url` après normalisation (`rstrip('/')`), sinon `AlteredConfigError`. Pour cloner une config du socle, préférez `ApiClientConfig.copy_with(...)` plutôt que `dataclasses.replace` (évite le conflit `timeout_seconds` / `timeouts`).
+- **Sync vs async** : un transport dont `send` est une coroutine est refusé sur `AlteredClient` ; un `send` synchrone est refusé sur `AsyncAlteredClient` (`TypeError` explicite).
+- **Cycle de vie** : la fermeture de la façade (`close` / `aclose`) propage au client du socle, qui ferme le transport exposé. Un transport injecté est donc fermé avec la façade : ne le partagez pas réutilisé après fermeture sans le recréer.
+
+```python
+from baobab_altered_api import AlteredApiConfig, AlteredClient
+
+cfg = AlteredApiConfig(base_url="https://api.test.example", bearer_token="baobab-api-token")
+with AlteredClient(cfg) as client:
+    # Tout chemin doit être validé hors ligne (voir docs/api_observations/).
+    resp = client.http.get("/chemin/relatif/exemple")
+```
+
+## Configuration et sécurité
+
+- [Configuration](docs/configuration.md) — modèle `AlteredApiConfig`, variables `ALTERED_API_*`, exemples avec valeurs fictives.
+- [Authentification](docs/authentication.md) — modes Bearer / clé API, lien avec `AlteredAuthFactory` et le socle.
+- [Sécurité](docs/security.md) — gestion des secrets, représentations masquées, bonnes pratiques CI et dépôt.
+
+## Licence
+
+MIT — voir le fichier `LICENSE`.