Alibaba Cloud Darabonba Core

1.0.5 · active · verified Sat Apr 11

Darabonba Core is a foundational module within the Alibaba Cloud Python SDK, providing essential functionalities and utility classes for building and interacting with Alibaba Cloud services. It serves as a core component for higher-level SDKs. The current version is 1.0.5 and it maintains an active release cadence with frequent updates.

Warnings

breaking Starting from version 1.0.0, `darabonba-core` explicitly requires Python 3.7 or newer. Older Python versions are no longer supported.
Fix: Upgrade your Python environment to version 3.7 or higher.
breaking Darabonba SDKs (V2.0), which `darabonba-core` is a part of, are not directly compatible with Classic SDKs (V1.0). If you need to use both, ensure different naming conventions are applied for dependencies to avoid conflicts.
Fix: When combining V1.0 and V2.0 SDKs, consult the Alibaba Cloud documentation for recommended dependency management and import alias strategies.
gotcha For production environments, sensitive credentials like AccessKey IDs and Secrets should be configured via environment variables (e.g., `ALIBABA_CLOUD_ACCESS_KEY_ID`, `ALIBABA_CLOUD_ACCESS_KEY_SECRET`) rather than hardcoding them or storing them in plain text files within your repository. This helps prevent credential leaks.
Fix: Utilize environment variables for credential management. Refer to Alibaba Cloud's official documentation on best practices for using access credentials.

Install

pip install darabonba-core Install darabonba-core

Imports

RequestConfiguration

from darabonba.core import RequestConfiguration

TeaPair
```
from darabonba.core import TeaPair
```

ClientOverrideConfiguration

from darabonba.core.client import ClientOverrideConfiguration

CommonUtil

from darabonba.core.utils import CommonUtil

Quickstart

This quickstart demonstrates the instantiation of `RequestConfiguration`, a core class from `darabonba-core`, used to define request-specific parameters like timeouts. In a typical Alibaba Cloud SDK usage, such a configuration object would be passed to a service client during API calls.

from darabonba.core import RequestConfiguration

# Darabonba Core provides fundamental utilities for building SDK requests.
# This example demonstrates creating a basic RequestConfiguration object.

# A RequestConfiguration object allows setting various request-specific parameters.
config = RequestConfiguration(
    connect_timeout=10000, # Connection timeout in milliseconds
    read_timeout=15000     # Read timeout in milliseconds
)

print(f"Created RequestConfiguration with connect_timeout: {config.connect_timeout}ms")
print(f"and read_timeout: {config.read_timeout}ms")

# In a real-world scenario, this configuration would be passed to a client
# when making an API call, e.g., client.call_api(..., runtime=config)

view raw JSON →