Actus Connector SDK

Python SDK for building and running Actus connector applications.

Version 0.0.1b2 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.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 "actus-connector-sdk==0.0.1b2"

For application building and serving:

python -m pip install "actus-connector-sdk[build,serve]==0.0.1b2"

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.1b2"]

The application build command currently requires an explicit SDK wheel via --sdk-wheel. Download the published wheel from PyPI and pass its absolute path; no sibling source checkout or platform environment file is required:

python -m pip download --no-deps --only-binary=:all: \
  --index-url https://pypi.org/simple \
  --dest ./sdk-artifacts "actus-connector-sdk==0.0.1b2"

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.