feat(cbc): add CBC (Central Business Configuration) client module

.env_integration_tests.example

@@ -39,6 +39,16 @@ AICORE_FILTER_TEST_SELF_HARM_PROMPT=
 CLOUD_SDK_CFG_AUDITLOG_DEFAULT_URL=https://your-auditlog-api-url-here
 CLOUD_SDK_CFG_AUDITLOG_DEFAULT_UAA='{"url":"https://your-auth-url","clientid":"your-client-id","clientsecret":"your-client-secret"}'
 
+# CBC (Central Business Configuration)
+# Resolves the CBC URL from the tenant-mapping Destination Fragment and the mTLS
+# certificate from the Destination Service, so it also needs the DESTINATION
+# binding vars below. The three CLOUD_SDK_CFG_CBC_DEFAULT_* values seed the SDK
+# runtime context (app tenant id, subscriber subdomain) and derive the
+# certificate name from the landscape.
+CLOUD_SDK_CFG_CBC_DEFAULT_APP_TENANT_ID=your-app-tenant-id-here
+CLOUD_SDK_CFG_CBC_DEFAULT_TENANT_SUBDOMAIN=your-subscriber-tenant-subdomain-here
+CLOUD_SDK_CFG_CBC_DEFAULT_LANDSCAPE=your-landscape-here
+
 # DATA ANONYMIZATION
 CLOUD_SDK_CFG_DATA_ANONYMIZATION_DEFAULT_URL=https://your-data-anonymization-api-url-here
 CLOUD_SDK_CFG_DATA_ANONYMIZATION_DEFAULT_CERT=your-base64-encoded-client-certificate-pem

.gitignore

@@ -17,6 +17,9 @@ env.bak/
 venv.bak/
 piperBuild-env/
 
+# Local scratch
+tmp/
+
 # IDEs
 .vscode/
 .idea/

src/sap_cloud_sdk/cbc/__init__.py

@@ -0,0 +1,85 @@
+"""SAP Cloud SDK for Python — CBC (Central Business Configuration) module.
+
+Provides a typed Python client for reading tenant-specific business configuration
+from SAP Central Business Configuration (CBC).
+
+CBC is an SAP service that manages tenant-specific business configuration for
+SAP cloud applications and AI agents.
+
+Quick start::
+
+    from sap_cloud_sdk import cbc
+
+    # Infers everything from provisioning: the app tenant id and subdomain come
+    # from the SDK runtime context (wire bootstrap(app) once at startup), the CBC
+    # URL from the tenant-mapping Destination Fragment, and the mTLS certificate
+    # from the Destination Service.
+    cbc_client = cbc.create_client()
+    config = cbc_client.get_configuration()
+
+    # Access entity data
+    payment = config.get_configuration_object("payment-config")
+    if payment:
+        for row in payment.get_entity_data("payment-mode").as_list():
+            print(row)
+
+To override any individual piece (e.g. for local development or tests), pass a
+:class:`~sap_cloud_sdk.cbc.config.CBCConfig` — see the CBC user guide.
+"""
+
+from __future__ import annotations
+
+from sap_cloud_sdk.cbc.client import (
+    CBCClient,
+    create_client,
+)
+from sap_cloud_sdk.cbc.config import (
+    CBCConfig,
+)
+from sap_cloud_sdk.cbc.exceptions import (
+    CBCError,
+    CBCClientError,
+    CBCConfigError,
+    CBCHttpError,
+    CBCNetworkError,
+    CBCServerError,
+    HttpContext,
+)
+from sap_cloud_sdk.cbc._models import (
+    ApiError,
+    ConfigurationData,
+    ConfigurationEntity,
+    ConfigurationObject,
+    ConsumptionVersion,
+    ConsumptionVersions,
+    EntityData,
+)
+
+
+__all__ = [
+    # factory
+    "create_client",
+    # client
+    "CBCClient",
+    # configuration
+    "CBCConfig",
+    # exceptions
+    "CBCError",
+    "CBCClientError",
+    "CBCConfigError",
+    "CBCHttpError",
+    "CBCNetworkError",
+    "CBCServerError",
+    "HttpContext",
+    # models — consumption versions
+    "ConsumptionVersion",
+    "ConsumptionVersions",
+    # models — entities
+    "EntityData",
+    "ConfigurationEntity",
+    "ConfigurationObject",
+    # models — configuration
+    "ConfigurationData",
+    # models — api error
+    "ApiError",
+]