actus-connector-sdk

Actus Connector SDK

Python SDK for building and running Actus connector applications.

Version 0.0.1b3 is a beta release. Python 3.12 or later is required. Application versions are independent of SDK versions. During beta, pin the SDK version explicitly; compatibility across beta releases is not guaranteed.

Changes in 0.0.1b3

• Consume bounded HTTP status, headers, empty responses and SSE within the owned request.
• Preserve deadlines, response ownership and cleanup for custom protocol consumers.
• Report OperationRejected as a definite failure only when the application confirms no business effects; ambiguous writes remain uncertain.

Previous changes in 0.0.1b2

• Preserve the primary client failure when response or client cleanup also fails.
• Report observed cleanup failures through ClientError.cleanup_failed and cancellation.
• Keep cleanup ownership through repeated cancellation without retrying uncertain writes.

Installation

python -m pip install --index-url https://pypi.org/simple \
  'actus-connector-sdk==0.0.1b3'

For application building and serving:

python -m pip install --index-url https://pypi.org/simple \
  'actus-connector-sdk[build,serve]==0.0.1b3'

Use a new isolated environment. Platform consumers using the Tencent mirror must wait for synchronization and verify artifact digests before upgrading; do not automatically fall back to another index. The distribution name is actus-connector-sdk; the Python import is connector_sdk.

Capabilities

• Typed application, configuration, operation and resource declarations.
• Static Manifest generation and declaration consistency checks.
• Per-installation SQLite state, encrypted credentials and connection ownership.
• NoAuth and API Key authorization, connection maintenance and JSON operations.
• Bounded HTTP requests, deadlines, cancellation and lifecycle cleanup.
• Signed platform permits and a public ConnectorClient.
• CLI commands: init, check, build, serve and dev.

This beta does not provide OAuth flows or file streaming. Production platform routing and permit issuance belong to the integrating platform, not to the SDK.

Start an application

connector init --help
connector check --help
connector build --help
connector serve --help
connector dev --help

Declare the SDK dependency in your application's pyproject.toml:

[project]
name = "example-connector"
version = "0.1.0"
requires-python = ">=3.12"
dependencies = ["actus-connector-sdk==0.0.1b3"]

The application build command currently requires an explicit SDK wheel via --sdk-wheel. Pass the absolute path of the matching release wheel installed in the isolated environment; no sibling source checkout or platform environment file is required. Formal consumer upgrades wait for the Tencent mirror's wheel and sdist to match the published artifact digests.

Run connector build --help for the project and output arguments. Local dev creates its own development identity and HTTPS configuration; these credentials are for local testing and are not production platform credentials.

The source distribution includes README.md with detailed APIs, protocol contracts, lifecycle semantics and application examples. Internal development notes there describe the source checkout and may differ from this published package's distribution status.

License

Apache License 2.0. See LICENSE included in the distribution.