Plynt

Plynt is a modular, framework-agnostic Python library for building external API clients and services.

Plynt focuses on a stable integration foundation:

• framework-agnostic design
• sync and async support from one codebase
• explicit configuration and minimal hidden behavior
• typed settings and reusable middleware patterns

Installation

Supports Python 3.12-3.15 on Linux. Django/DRF extras require Django 6.1.

pip install plynt

Optional extras:

pip install "plynt[httpx]"       # httpx2 transport
pip install "plynt[salesforce]"  # Salesforce REST connector

Canonical extras matrix

Install plynt[grpc,salesforce] for experimental CDC support, including vendored Pub/Sub messages and the Avro decoder. Real Salesforce-org validation is still required before production CDC use.

Public API surface

Plynt treats package exports in plynt.base and plynt.http as the main public contract boundaries for core usage.

• Prefer importing from these package roots instead of internal submodules.
• Internal module paths may evolve as long as public exports remain compatible.
• Compatibility and deprecation policy is defined in ADR-0027.

Salesforce connector

plynt[salesforce] ships a ready-to-use Salesforce REST API integration with typed query services, Bulk API 2.0, AI APIs, and sync/async support:

from plynt.connectors.salesforce.auth import SalesforceClientCredentialsAuthMiddleware
from plynt.connectors.salesforce.client import SalesforceAPIClient
from plynt.connectors.salesforce.facade import SalesforceAPIFacade
from plynt.http.transport import HttpxSyncTransport

auth = SalesforceClientCredentialsAuthMiddleware(
    client_id="...",
    client_secret="...",
    token_url="https://login.salesforce.com/services/oauth2/token",
)
transport = HttpxSyncTransport(middlewares=[auth])
client = SalesforceAPIClient(auth=auth, transport=transport)
sf = SalesforceAPIFacade(client)

result = sf.query().query("SELECT Id, Name FROM Account LIMIT 5")
for record in result.records:
    print(record["Name"])

See the Salesforce connector docs for the full guide including JWT Bearer auth, pagination, bulk ingest, and more.

Generic LLM connector

plynt.connectors.llm provides a provider-agnostic contract for:

• neutral message and completion models,
• sync and async service parity,
• streaming chunk parsing helpers,
• optional tool-calling primitives.

Use it with any API that can map to the generic contract, while keeping provider-specific fields in opaque provider_extensions payloads.

Project Status

Plynt remains in the 0.x release line. Documented APIs follow the compatibility and deprecation policy in ADR-0027. Current capabilities include HTTP, middleware, caching, streaming, Salesforce REST/Bulk/AI, LLM provider adapters, Django/DRF/FastAPI adapters, and async gRPC.

Release acceptance includes distribution and installation checks. Local and CI tests do not replace validation against real external providers. Non-prerelease GitHub releases are published to PyPI through trusted publishing after the build and installed-wheel checks pass.

Documentation

• README
• Changelog
• Architecture ADRs
• Salesforce connector docs

License

MIT