fix(api): publish real HTTP class contracts and typed async client - #100
Merged
Merged
Conversation
added 5 commits
September 15, 2026 08:52
…ntracts-tip # Conflicts: # README.md # docs/api-reference/README.md # docs/api-reference/generated/overview.md # src/flext_api/_protocols/transports.py # src/flext_api/protocols.py # src/flext_api/services/_services/base_request.py # src/flext_api/services/async_client.py # src/flext_api/services/base_client.py # src/flext_api/services/client.py # tests/unit/__init__.py # tests/unit/test_transports_facade_httpx.py
marlon-costa-dc
changed the title
added 5 commits
September 18, 2026 20:59
… with 1f0add9 - Normalized corrupted fences (4-backtick openers, indented closers, orphan pairs) in docs/architecture/decisions/002-railway-pattern.md and docs/api/core.md so embedded python blocks extract cleanly (markdown-code gate: 41 -> 0 findings) - prettier reflow via canonical make fmt (markdown-format: 9 -> 0) - gen fixed point against integration tip 1f0add9
The new namespace structure rule requires each test facade to declare exactly one nested class composing the production letter. The five test facades carried empty helper nesteds plus a second Tests class; collapsed to the canonical single Tests MRO shape. Full check (19 gates) and test suite green locally.
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
fix(api): publish real HTTP class contracts and typed async client
What this delivers
Flext-API's HTTP surface gains owner-derived class-object contracts and a
typed async client, converging the salvage of
fix/api-http-contracts-tipwith the current
0.12.0-devintegration line (merged--no-ff, commit206ccb80).1.
Httpxprotocol namespace with owner-derived status contractsFlextApiProtocolsTransports.Httpx(_protocols/transports.py): runtime-checkableprotocol namespace carrying
CONFLICT: ClassVar[int] = int(httpx.codes.CONFLICT).isinstancesemantics stay intact and the Protocol/namespace census contractis preserved (rationale documented in the class docstring).
2. Module-level
Httpx*class-object re-exportsprotocols.pynow publishesHttpxAsyncClient,HttpxClient,HttpxHTTPError,HttpxHTTPStatusError,HttpxRequestError,HttpxResponse,HttpxTimeoutExceptionthrough an explicit__all__— consumers can constructand isinstance-narrow these names with both static and runtime class semantics.
tests/unit/test_transports_facade_httpx.py(TestsFlextApiHttpxContracts)covers the facade.
3. Typed async client
FlextApiAsyncClient(andFlextApiClient) construction stays on theintegration convention: explicit
runtime_settings=binding through thesservice base — no global-singleton fallback, per the dependency-injection law.
Convergence with integration (fork
822a53a1→ integration9e418cd8)The branch merged
origin/0.12.0-devwith--no-ffand resolves the divergencein integration's favor wherever the two lineages overlapped:
c.Apimessage constants(
URL_PATH_EMPTY_ERROR,URL_PATH_SEPARATOR),self.settings.Apibinding,integration MRO order
(RequestMixin, Base).Httpx*re-exports, facadetests) is kept from this branch — it does not exist in integration.
tests/unit/__init__.pylazy map, workspace projections)regenerated through the canonical
make gen;make fix/make fmtapplied.Fleet audit context (bead
flext-v4fmn)This PR is the single surviving open PR of the 2026-09-18 fleet supersession
audit: every other branch/PR evaluated was either fully absorbed by the
integration line (evidence recorded in the bead) or retained as active lane
state. The HTTP contract work here is real undelivered functionality verified
absent from
0.12.0-dev(git grep Httpx|CONFLICTempty on the integration tipbefore this change).
Validation
make setup,make gen,make fix,make fmtfrom the workspace dispatcher(exit 0, receipts in bead flext-v4fmn).
CI=Y make genfixed point,make check,make test— see PRchecks.