Skip to content
This repository was archived by the owner on Jan 20, 2026. It is now read-only.
This repository was archived by the owner on Jan 20, 2026. It is now read-only.

Allow consumption of preconfigured httpx client #41

@Apxdono

Description

@Apxdono

Description

Today's approach for declarativex executors (both sync and async) creates new clients under the hood. This works fine as long as you are fine with basic httpx settings. Use Case section lists a number of additional features that can be unlocked if declarativex API can consume pre-configured httpx (and other) clients.

Use Case

  • Support for cookie retention between API calls
  • Support for self-signed certificates added at runtime (not via OS certificate chains)
  • Support for httpx event hooks. This is a big one since declarativex Middleware consumes transformed responses, while httpx event hook can access raw request.
  • Advanced transport usage
  • Other httpx benefits
  • Async settings

Proposed Solution

Introduce new base_client (or client) BaseClient property (similar to base_url, timeout and others) / @http argument. When supplied respective Executor uses supplied client inside _execute method instead of creating new one during each _execute call.

The drawback is that follow_redirects, http2 and proxies settings will be ignored. Users must set those inside the client, but if they opt for custom client, they kinda know what they're doing.

Alternatives

Custom executor can be used instead, but this implies creation of custom @http annotation, which is kinda ugly.

Will try to file a PR once I get spare time to work on this.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions