Registry / type-stubs / connector-sdk-types

connector-sdk-types

JSON →
library0.54.0pypypiunverified

This library provides generated Python type definitions for the Lumos Connector SDK, enabling developers to build custom connectors for integrating diverse systems with the Lumos identity governance platform. It aims to simplify connector development by offering standardized data models and interfaces for a more type-safe approach. The current version is 0.47.0, and the associated Lumos Connector SDK undergoes frequent updates, indicating active development.

pip install connector-sdk-types
INSTALL
IMPORT
SIG · CONNECTOR-SDK-TYPE
C
connector-sdk-types
type-stubspythonv0.54.0
Install
3.1s avg
Import
Disk
31MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.54.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.915 runs
installs and imports cleanly · install 0.0s · import 0.000s · 35.4MB
glibc
py 3.103.915 runs
installs and imports cleanly · install 3.1s · import 0.000s · 36MB
31MB installed
● package 31MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

ConnectorSettings
from connector_sdk_types import ConnectorSettings
from connector_sdk_types import ConnectorSettings

This quickstart demonstrates how to define custom connector settings and data models using the types provided by `connector-sdk-types`. In a typical Lumos Connector SDK project (built with `connector-py`), these types would be imported and utilized within the `settings.py`, `models.py`, and capability implementation files. It shows how to represent connector configuration and fetched user accounts using the SDK's type-safe structures.

import os from typing import List, Dict, Any from connector_sdk.settings import ConnectorSettings from connector_sdk.models import Account, Identity # This is a simplified example. In a real scenario, you'd scaffold with 'connector-py' # and implement capabilities. The types are used within that implementation. # Define a custom settings model using the generated types class MyConnectorSettings(ConnectorSettings): api_key: str = os.environ.get('MY_CONNECTOR_API_KEY', '') base_url: str = os.environ.get('MY_CONNECTOR_BASE_URL', 'https://api.example.com') # A hypothetical function demonstrating usage of types def fetch_accounts(settings: MyConnectorSettings) -> List[Account]: print(f"Fetching accounts from {settings.base_url} with key: {settings.api_key[:5]}...") # In a real connector, this would make API calls and map responses to Account objects mock_accounts: List[Account] = [ Account(identity=Identity(id='user1', username='john.doe', email='john.doe@example.com'), attributes={'firstName': 'John', 'lastName': 'Doe'}), Account(identity=Identity(id='user2', username='jane.smith', email='jane.smith@example.com'), attributes={'firstName': 'Jane', 'lastName': 'Smith'}) ] return mock_accounts if __name__ == '__main__': # Example usage (usually managed by the connector-py framework) settings_instance = MyConnectorSettings() if not settings_instance.api_key: print("Warning: MY_CONNECTOR_API_KEY not set in environment. Using empty string.") accounts = fetch_accounts(settings_instance) print(f"Fetched {len(accounts)} accounts:") for account in accounts: print(f" - ID: {account.identity.id}, Username: {account.identity.username}, Email: {account.identity.email}")
Debug
Known issues
breakingMajor version changes in the underlying Lumos Connector SDK (`connector-py`) or the Lumos API may introduce breaking changes to the generated types in `connector-sdk-types`. This could require updates to your custom connector's code.
fix
Refer to the Lumos Connector SDK's `CHANGELOG.md` or official documentation when upgrading to new major versions. Update your connector's code to align with any changed type definitions or API contracts. Pin `connector-py` and `connector-sdk-types` to specific versions in your `pyproject.toml` or `requirements.txt`.
affects: All versions
gotchaIt is crucial to explicitly pin the versions of both `connector-py` and `connector-sdk-types` in your project's dependency file (`pyproject.toml` or `requirements.txt`). Failing to do so can lead to unexpected behavior or build failures if incompatible versions are automatically installed.
fix
Always specify exact versions (e.g., `connector-py==X.Y.Z`, `connector-sdk-types==A.B.C`) or use compatible range operators (e.g., `~=X.Y`) to ensure stable and reproducible builds across development and deployment environments.
affects: All versions
gotchaThe Lumos Connector SDK, and thus its generated types, requires Python 3.10 or higher. Using older Python versions can lead to syntax errors, `ModuleNotFoundError` for modern typing features, or other runtime issues.
fix
Ensure your development and deployment environments use Python 3.10 or a newer supported version. Update your `pyproject.toml` or `setup.py` to specify `requires-python = '>=3.10'`.
affects: <3.10
Upgrade
Version history
0.54.0latest on PyPI · released May 28, 2026
Audit
Dependencies
connector-pyrequiredCore Lumos Connector SDK library that these types are generated for.
Agent activity
46 hits · last 30 days
node
38
Amazon
1
OpenAI (training)
1
Resources
connector-sdk-types — pip install connector-sdk-types · libregistry