Compatibility¶

dpone follows a compatibility-first approach for manifests, public imports, CLI commands, and runtime connector contracts.

Supported Python versions¶

dpone targets modern Python versions supported by the current packaging metadata. Use the published PyPI metadata as the source of truth for exact supported versions.

Public compatibility surface¶

The stable surface includes:

Manifest schema fields documented in this site.
CLI commands documented in CLI reference.
Public imports exported by dpone and connector modules.
Connector contracts used by source, sink, state, schema evolution, and quality services.

Internal modules may change between minor versions when they are not part of the documented public surface.

Backward compatibility policy¶

Patch releases should be backward-compatible.
Minor releases may add new optional fields, connectors, and strategies.
Breaking changes require a migration note and should be reserved for major releases.
Deprecated behavior should remain available for at least one minor release when practical.

Connector maturity labels¶

certified - covered by unit, contract, local integration, and live or mock certification artifacts.
experimental - usable but still missing part of the certification matrix.
community - maintained through public contribution flow and must declare its supported capabilities.

Generated compatibility matrix¶

Deprecated path	Canonical path	Scope	Status	Removal policy
`dpone.core.artifacts`	`dpone.runtime.artifacts`	module	transitional-shim	after internal callers migrate to runtime.artifacts
`dpone.core.errors`	`dpone.contracts.errors`	module	transitional-shim	after internal callers migrate to contracts.errors
`dpone.core.etl_types`	`dpone.contracts.process_types`	module	transitional-shim	after internal callers migrate to contracts.process_types
`dpone.core.runtime`	`dpone.contracts.run_context`	module	transitional-shim	after internal callers migrate to contracts.run_context
`dpone.credentials`	`dpone.runtime.credentials`	package	deprecated-shim	after one dedicated deprecation release
`dpone.etl`	`dpone.runtime.etl`	package	deprecated-shim	after one dedicated deprecation release
`dpone.etl_logging`	`dpone.runtime.etl_logging`	package	deprecated-shim	after one dedicated deprecation release
`dpone.lib.connectors`	`dpone.runtime.connectors`	package	deprecated-shim	after one dedicated deprecation release
`dpone.lib.connectors.base`	`dpone.ports.db_connector`	module	transitional-shim	after internal callers migrate to ports.db_connector
`dpone.lib.technical_columns`	`dpone.contracts.technical_columns`	module	transitional-shim	after internal callers migrate to contracts.technical_columns
`dpone.lib.utils.data_type_mapper`	`dpone.runtime.support.data_type_mapper`	module	transitional-shim	after internal callers migrate to runtime.support.data_type_mapper
`dpone.lib.utils.timezone_converter`	`dpone.runtime.support.timezone`	module	transitional-shim	after internal callers migrate to runtime.support.timezone
`dpone.reconciliation`	`dpone.runtime.reconciliation`	package	deprecated-shim	after one dedicated deprecation release
`dpone.sink`	`dpone.runtime.sinks`	package	deprecated-shim	after one dedicated deprecation release
`dpone.source`	`dpone.runtime.sources`	package	deprecated-shim	after one dedicated deprecation release
`dpone.sql_helpers`	`dpone.runtime.sql_helpers`	package	deprecated-shim	after one dedicated deprecation release
`dpone.state`	`dpone.runtime.state`	package	deprecated-shim	after one dedicated deprecation release
`dpone.xmin`	`dpone.runtime.xmin`	package	deprecated-shim	after one dedicated deprecation release
`dpone.yaml_config_handler`	`dpone.dag`	package	deprecated-shim	after one dedicated deprecation release
				Legacy DAG package kept as re-export shim during migration.