katana_public_api_client.domain.base¶

`katana_public_api_client.domain.base` ¶

Base domain model for Katana entities.

This module provides the foundation for Pydantic domain models that represent business entities from the Katana Manufacturing ERP system.

Domain models are separate from the generated API request/response models and are optimized for: - ETL and data processing - Business logic - Data validation - JSON schema generation - Clean, ergonomic APIs

Classes¶

`KatanaBaseModel` ¶

Bases: BaseModel

Base class for all Pydantic domain models.

Provides: - Immutability by default (frozen=True) - Automatic validation - JSON schema generation - Easy serialization for ETL - Common timestamp fields

Example

class ProductDomain(KatanaBaseModel):
    id: int
    name: str
    sku: str

    @computed_field
    @property
    def display_name(self) -> str:
        return f"{self.name} ({self.sku})"

Functions¶

`model_dump_for_etl()` ¶

Export to ETL-friendly format.

Removes None values and uses field aliases for cleaner output.

Returns:

dict[str, Any] –

Dictionary with all non-None fields

Example

variant = KatanaVariant(id=123, sku="ABC-001", sales_price=99.99)
data = variant.model_dump_for_etl()
# {"id": 123, "sku": "ABC-001", "sales_price": 99.99}

Source code in katana_public_api_client/domain/base.py

def model_dump_for_etl(self) -> dict[str, Any]:
    """Export to ETL-friendly format.

    Removes None values and uses field aliases for cleaner output.

    Returns:
        Dictionary with all non-None fields

    Example:
        ```python
        variant = KatanaVariant(id=123, sku="ABC-001", sales_price=99.99)
        data = variant.model_dump_for_etl()
        # {"id": 123, "sku": "ABC-001", "sales_price": 99.99}
        ```
    """
    return self.model_dump(exclude_none=True, by_alias=True)

`to_dict_with_computed()` ¶

Export including computed fields.

Unlike model_dump(), this includes @computed_field properties.

Returns:

dict[str, Any] –

Dictionary with all fields including computed ones

Source code in katana_public_api_client/domain/base.py

def to_dict_with_computed(self) -> dict[str, Any]:
    """Export including computed fields.

    Unlike model_dump(), this includes @computed_field properties.

    Returns:
        Dictionary with all fields including computed ones
    """
    # Pydantic v2 automatically includes computed fields in model_dump
    return self.model_dump(mode="python", exclude_none=True)

`to_warehouse_json()` ¶

Export as JSON for data warehouse.

Returns:

str –

JSON string with all non-None fields

Example

variant = KatanaVariant(id=123, sku="ABC-001")
json_str = variant.to_warehouse_json()
# '{"id":123,"sku":"ABC-001"}'

Source code in katana_public_api_client/domain/base.py

def to_warehouse_json(self) -> str:
    """Export as JSON for data warehouse.

    Returns:
        JSON string with all non-None fields

    Example:
        ```python
        variant = KatanaVariant(id=123, sku="ABC-001")
        json_str = variant.to_warehouse_json()
        # '{"id":123,"sku":"ABC-001"}'
        ```
    """
    return self.model_dump_json(exclude_none=True, by_alias=True)

katana_public_api_client.domain.base¶