ExcelAlchemy 2.3.0__tar.gz → 3.0.0__tar.gz

excelalchemy-3.0.0/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: ExcelAlchemy
+Version: 3.0.0
+Summary: Schema-driven Python library for typed Excel import/export workflows with Pydantic and locale-aware workbooks.
+Keywords: excel,openpyxl,pydantic,minio,schema
+Author: Ray
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+License-File: LICENSE
+Requires-Dist: pydantic[email] >=2.12, <3
+Requires-Dist: openpyxl >=3.1.5, <4
+Requires-Dist: pendulum >=3.2.0, <4
+Requires-Dist: minio >=7.2.20, <8 ; extra == "development"
+Requires-Dist: pre-commit ; extra == "development"
+Requires-Dist: pyright==1.1.408 ; extra == "development"
+Requires-Dist: pytest ; extra == "development"
+Requires-Dist: coverage ; extra == "development"
+Requires-Dist: pytest-cov ; extra == "development"
+Requires-Dist: ruff ; extra == "development"
+Requires-Dist: minio >=7.2.20, <8 ; extra == "minio"
+Project-URL: Documentation, https://github.com/RayCarterLab/ExcelAlchemy#readme
+Project-URL: Home, https://github.com/RayCarterLab/ExcelAlchemy
+Project-URL: Issues, https://github.com/RayCarterLab/ExcelAlchemy/issues
+Project-URL: Repository, https://github.com/RayCarterLab/ExcelAlchemy
+Provides-Extra: development
+Provides-Extra: minio
+
+# ExcelAlchemy
+
+Schema-driven Python library for typed Excel import/export workflows with
+Pydantic and locale-aware workbooks.
+
+ExcelAlchemy turns Pydantic models into workbook contracts:
+
+- generate Excel templates from code
+- validate uploaded workbooks
+- map failures back to rows and cells
+- return result workbooks and API-friendly error payloads
+- keep workbook IO pluggable through `ExcelStorage`
+
+The current stable release is ExcelAlchemy 3.0. It uses ordinary Python
+annotations plus explicit `ExcelColumn(...)` metadata. Old 2.x field factories,
+compatibility imports, legacy config fields, and facade aliases are not current
+API.
+
+[GitHub Repository](https://github.com/RayCarterLab/ExcelAlchemy) · [Full README](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/README.md) · [Getting Started](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/getting-started.md) · [Examples](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/examples/README.md) · [Public API](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/public-api.md) · [Migration Notes](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/migrations.md)
+
+## Screenshots
+
+### Template
+
+![Excel template screenshot](https://raw.githubusercontent.com/RayCarterLab/ExcelAlchemy/main/docs/assets/images/portfolio-template-en.png)
+
+### Import Result
+
+![Excel import result screenshot](https://raw.githubusercontent.com/RayCarterLab/ExcelAlchemy/main/docs/assets/images/portfolio-import-result-en.png)
+
+## Install
+
+```bash
+pip install ExcelAlchemy
+```
+
+Optional Minio-compatible storage support:
+
+```bash
+pip install "ExcelAlchemy[minio]"
+```
+
+## Quick Example
+
+```python
+from typing import Annotated
+
+from pydantic import BaseModel, Field
+
+from excelalchemy import EmailCodec, ExcelAlchemy, ExcelColumn, ImporterConfig
+
+
+class EmployeeImport(BaseModel):
+    name: Annotated[str, ExcelColumn(label='Name', order=1)]
+    email: Annotated[
+        str,
+        Field(min_length=8),
+        ExcelColumn(
+            label='Email',
+            codec=EmailCodec(),
+            order=2,
+            hint='Use your work email',
+            example_value='alice@company.com',
+        ),
+    ]
+
+
+alchemy = ExcelAlchemy(ImporterConfig(EmployeeImport, locale='en'))
+template = alchemy.download_template_artifact(filename='employees-template.xlsx')
+
+excel_bytes = template.as_bytes()
+```
+
+## Import Workflow
+
+The shortest import path is:
+
+```text
+template -> preflight -> import -> remediation -> delivery
+```
+
+Minimal backend sketch:
+
+```python
+from excelalchemy.results import ImportLifecycleEvent, build_frontend_remediation_payload
+
+
+events: list[ImportLifecycleEvent] = []
+
+preflight = alchemy.preflight_import('employees.xlsx')
+if preflight.is_valid:
+    result = await alchemy.import_data(
+        'employees.xlsx',
+        'employees-result.xlsx',
+        on_event=events.append,
+    )
+    payload = {
+        'result': result.to_api_payload(),
+        'cell_errors': alchemy.cell_error_map.to_api_payload(),
+        'row_errors': alchemy.row_error_map.to_api_payload(),
+        'remediation': build_frontend_remediation_payload(
+            result=result,
+            cell_error_map=alchemy.cell_error_map,
+            row_error_map=alchemy.row_error_map,
+        ),
+    }
+```
+
+## Why ExcelAlchemy
+
+- Pydantic v2-based schema extraction and validation
+- `Annotated[..., ExcelColumn(...)]` declaration style
+- workbook comments and result workbooks in `zh-CN`, `en`, or `ja`
+- pluggable storage instead of a hard-coded backend
+- `openpyxl`-based runtime path without pandas
+- contract tests, Ruff, and Pyright in the development workflow
+
+## Learn More
+
+- [Full project README](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/README.md)
+- [Getting started](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/getting-started.md)
+- [Examples showcase](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/examples-showcase.md)
+- [Result objects](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/result-objects.md)
+- [API response cookbook](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/api-response-cookbook.md)
+- [Platform architecture](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/platform-architecture.md)
+- [Migration notes](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/migrations.md)
+

excelalchemy-3.0.0/README-pypi.md

@@ -0,0 +1,126 @@
+# ExcelAlchemy
+
+Schema-driven Python library for typed Excel import/export workflows with
+Pydantic and locale-aware workbooks.
+
+ExcelAlchemy turns Pydantic models into workbook contracts:
+
+- generate Excel templates from code
+- validate uploaded workbooks
+- map failures back to rows and cells
+- return result workbooks and API-friendly error payloads
+- keep workbook IO pluggable through `ExcelStorage`
+
+The current stable release is ExcelAlchemy 3.0. It uses ordinary Python
+annotations plus explicit `ExcelColumn(...)` metadata. Old 2.x field factories,
+compatibility imports, legacy config fields, and facade aliases are not current
+API.
+
+[GitHub Repository](https://github.com/RayCarterLab/ExcelAlchemy) · [Full README](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/README.md) · [Getting Started](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/getting-started.md) · [Examples](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/examples/README.md) · [Public API](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/public-api.md) · [Migration Notes](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/migrations.md)
+
+## Screenshots
+
+### Template
+
+![Excel template screenshot](https://raw.githubusercontent.com/RayCarterLab/ExcelAlchemy/main/docs/assets/images/portfolio-template-en.png)
+
+### Import Result
+
+![Excel import result screenshot](https://raw.githubusercontent.com/RayCarterLab/ExcelAlchemy/main/docs/assets/images/portfolio-import-result-en.png)
+
+## Install
+
+```bash
+pip install ExcelAlchemy
+```
+
+Optional Minio-compatible storage support:
+
+```bash
+pip install "ExcelAlchemy[minio]"
+```
+
+## Quick Example
+
+```python
+from typing import Annotated
+
+from pydantic import BaseModel, Field
+
+from excelalchemy import EmailCodec, ExcelAlchemy, ExcelColumn, ImporterConfig
+
+
+class EmployeeImport(BaseModel):
+    name: Annotated[str, ExcelColumn(label='Name', order=1)]
+    email: Annotated[
+        str,
+        Field(min_length=8),
+        ExcelColumn(
+            label='Email',
+            codec=EmailCodec(),
+            order=2,
+            hint='Use your work email',
+            example_value='alice@company.com',
+        ),
+    ]
+
+
+alchemy = ExcelAlchemy(ImporterConfig(EmployeeImport, locale='en'))
+template = alchemy.download_template_artifact(filename='employees-template.xlsx')
+
+excel_bytes = template.as_bytes()
+```
+
+## Import Workflow
+
+The shortest import path is:
+
+```text
+template -> preflight -> import -> remediation -> delivery
+```
+
+Minimal backend sketch:
+
+```python
+from excelalchemy.results import ImportLifecycleEvent, build_frontend_remediation_payload
+
+
+events: list[ImportLifecycleEvent] = []
+
+preflight = alchemy.preflight_import('employees.xlsx')
+if preflight.is_valid:
+    result = await alchemy.import_data(
+        'employees.xlsx',
+        'employees-result.xlsx',
+        on_event=events.append,
+    )
+    payload = {
+        'result': result.to_api_payload(),
+        'cell_errors': alchemy.cell_error_map.to_api_payload(),
+        'row_errors': alchemy.row_error_map.to_api_payload(),
+        'remediation': build_frontend_remediation_payload(
+            result=result,
+            cell_error_map=alchemy.cell_error_map,
+            row_error_map=alchemy.row_error_map,
+        ),
+    }
+```
+
+## Why ExcelAlchemy
+
+- Pydantic v2-based schema extraction and validation
+- `Annotated[..., ExcelColumn(...)]` declaration style
+- workbook comments and result workbooks in `zh-CN`, `en`, or `ja`
+- pluggable storage instead of a hard-coded backend
+- `openpyxl`-based runtime path without pandas
+- contract tests, Ruff, and Pyright in the development workflow
+
+## Learn More
+
+- [Full project README](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/README.md)
+- [Getting started](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/getting-started.md)
+- [Examples showcase](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/examples-showcase.md)
+- [Result objects](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/result-objects.md)
+- [API response cookbook](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/api-response-cookbook.md)
+- [Platform architecture](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/platform-architecture.md)
+- [Migration notes](https://github.com/RayCarterLab/ExcelAlchemy/blob/main/docs/migrations.md)

{excelalchemy-2.3.0 → excelalchemy-3.0.0}/pyproject.toml

@@ -63,7 +63,6 @@ exclude = [
     '**/.mypy_cache',
     '**/__pycache__',
     '**/.pytest_cache',
-    'src/excelalchemy/types/field.py',
 ]
 enableTypeIgnoreComments = false
 reportAbstractUsage = false
@@ -72,48 +71,64 @@ reportCallIssue = false
 reportPrivateImportUsage = false
 reportRedeclaration = false
 strict = [
-    'src/excelalchemy/_primitives/constants.py',
-    'src/excelalchemy/_primitives/deprecation.py',
-    'src/excelalchemy/_primitives/header_models.py',
-    'src/excelalchemy/_primitives/identity.py',
-    'src/excelalchemy/_primitives/payloads.py',
+    'src/excelalchemy/adapters/pydantic.py',
     'src/excelalchemy/artifacts.py',
-    'src/excelalchemy/codecs/base.py',
     'src/excelalchemy/codecs/boolean.py',
+    'src/excelalchemy/codecs/choice.py',
     'src/excelalchemy/codecs/date.py',
     'src/excelalchemy/codecs/date_range.py',
     'src/excelalchemy/codecs/email.py',
-    'src/excelalchemy/codecs/money.py',
-    'src/excelalchemy/codecs/multi_checkbox.py',
+    'src/excelalchemy/codecs/field_codec.py',
     'src/excelalchemy/codecs/number.py',
     'src/excelalchemy/codecs/number_range.py',
-    'src/excelalchemy/codecs/organization.py',
     'src/excelalchemy/codecs/phone_number.py',
-    'src/excelalchemy/codecs/radio.py',
-    'src/excelalchemy/codecs/staff.py',
-    'src/excelalchemy/codecs/string.py',
-    'src/excelalchemy/codecs/tree.py',
+    'src/excelalchemy/codecs/text.py',
     'src/excelalchemy/codecs/url.py',
-    'src/excelalchemy/config.py',
-    'src/excelalchemy/core/alchemy.py',
-    'src/excelalchemy/core/abstract.py',
-    'src/excelalchemy/core/executor.py',
-    'src/excelalchemy/core/rendering.py',
-    'src/excelalchemy/core/schema.py',
-    'src/excelalchemy/core/storage.py',
-    'src/excelalchemy/core/storage_minio.py',
-    'src/excelalchemy/core/storage_protocol.py',
-    'src/excelalchemy/core/table.py',
-    'src/excelalchemy/core/writer.py',
-    'src/excelalchemy/exceptions.py',
-    'src/excelalchemy/core/headers.py',
-    'src/excelalchemy/core/rows.py',
-    'src/excelalchemy/helper/pydantic.py',
-    'src/excelalchemy/i18n/messages.py',
-    'src/excelalchemy/metadata.py',
-    'src/excelalchemy/results.py',
-    'src/excelalchemy/util/convertor.py',
+    'src/excelalchemy/columns.py',
+    'src/excelalchemy/config/__init__.py',
+    'src/excelalchemy/config/exporter.py',
+    'src/excelalchemy/config/importer.py',
+    'src/excelalchemy/config/modes.py',
+    'src/excelalchemy/config/options.py',
+    'src/excelalchemy/diagnostics.py',
+    'src/excelalchemy/errors.py',
+    'src/excelalchemy/messages.py',
+    'src/excelalchemy/policies.py',
+    'src/excelalchemy/primitives/constants.py',
+    'src/excelalchemy/primitives/identity.py',
+    'src/excelalchemy/primitives/payloads.py',
+    'src/excelalchemy/rendering/renderer.py',
+    'src/excelalchemy/rendering/writer.py',
+    'src/excelalchemy/results/__init__.py',
+    'src/excelalchemy/results/import_result.py',
+    'src/excelalchemy/results/issue_maps.py',
+    'src/excelalchemy/results/lifecycle.py',
+    'src/excelalchemy/results/preflight.py',
+    'src/excelalchemy/results/remediation.py',
+    'src/excelalchemy/runtime/executor.py',
+    'src/excelalchemy/runtime/facade.py',
+    'src/excelalchemy/runtime/facade_protocol.py',
+    'src/excelalchemy/runtime/import_session.py',
+    'src/excelalchemy/runtime/preflight.py',
+    'src/excelalchemy/runtime/rows.py',
+    'src/excelalchemy/schema/layout.py',
+    'src/excelalchemy/storage/__init__.py',
+    'src/excelalchemy/storage/base.py',
+    'src/excelalchemy/storage/gateway.py',
+    'src/excelalchemy/storage/minio.py',
     'src/excelalchemy/util/file.py',
+    'src/excelalchemy/field_metadata/__init__.py',
+    'src/excelalchemy/field_metadata/constraints.py',
+    'src/excelalchemy/field_metadata/declaration.py',
+    'src/excelalchemy/field_metadata/field.py',
+    'src/excelalchemy/field_metadata/presentation.py',
+    'src/excelalchemy/field_metadata/runtime.py',
+    'src/excelalchemy/worksheet/__init__.py',
+    'src/excelalchemy/worksheet/header.py',
+    'src/excelalchemy/worksheet/header_parser.py',
+    'src/excelalchemy/worksheet/header_validator.py',
+    'src/excelalchemy/worksheet/table.py',
+    'src/excelalchemy/adapters/pydantic_fields.py',
 ]
 typeCheckingMode = 'basic'
 
@@ -129,12 +144,6 @@ ignore = ['E501', 'RUF001', 'RUF002', 'RUF003']
 
 [tool.ruff.lint.per-file-ignores]
 '**/__init__.py' = ['F401']
-'src/excelalchemy/const.py' = ['RUF100']
-'src/excelalchemy/exc.py' = ['E402', 'RUF100']
-'src/excelalchemy/header_models.py' = ['E402', 'RUF100']
-'src/excelalchemy/identity.py' = ['E402', 'RUF100']
-'src/excelalchemy/types/*.py' = ['E402', 'RUF100']
-'src/excelalchemy/types/**/*.py' = ['E402', 'RUF100']
 
 [tool.ruff.format]
 quote-style = 'preserve'

excelalchemy-3.0.0/src/excelalchemy/README.md

@@ -0,0 +1,59 @@
+# ExcelAlchemy Package Map
+
+This package is being shaped for ExcelAlchemy 3.0. Use concrete responsibility
+modules when editing code; do not add a generic `_internal` package and do not
+restore 2.x compatibility shims.
+
+## Public Entry Points
+
+- `excelalchemy`: package root exports the common public API.
+- `config/`: `ImporterConfig`, `ExporterConfig`, `ImportMode`, and normalized
+  storage options.
+- `columns.py`: `ExcelColumn(...)` and immutable column declarations for
+  `typing.Annotated`.
+- `codecs/`: built-in workbook codecs and codec extension base classes.
+- `field_metadata/`: resolved Excel-facing field metadata used by the runtime.
+- `results/`: import results, issue maps, preflight results, lifecycle events,
+  and API payload helpers.
+- `errors.py`: public exception exports.
+- `storage/`: `ExcelStorage` protocol.
+- `storage/gateway.py`: configured storage resolver and missing-storage
+  fallback.
+- `artifacts.py`: binary/data-URL workbook transport wrapper.
+
+## Implementation Areas
+
+- `adapters/`: framework boundaries, currently Pydantic model extraction and
+  validation error normalization.
+- `schema/`: Excel schema layout extraction and flattened column planning.
+- `worksheet/`: worksheet tables, header records, header parsing, and header validation.
+- `runtime/`: facade, import sessions, row aggregation, execution, and preflight.
+- `rendering/`: workbook rendering and low-level writing.
+- `messages.py`: runtime and workbook-facing message lookup.
+- `policies.py`: named deterministic policies for layout, payload, result,
+  event, and missing-value behavior.
+- `diagnostics.py`: logger names and structured diagnostics helpers.
+
+## Removed 2.x Surfaces
+
+These paths and aliases are intentionally absent in 3.0:
+
+- `excelalchemy.core.*`
+- `excelalchemy.helper.*`
+- `excelalchemy.i18n.*`
+- `excelalchemy._primitives.*`
+- `excelalchemy.const`
+- `excelalchemy.exc`
+- `excelalchemy.identity`
+- `excelalchemy.header_models`
+- `excelalchemy.metadata`
+- `excelalchemy.types.*`
+- `excelalchemy.util.convertor`
+- facade aliases `df`, `header_df`, `cell_errors`, `row_errors`
+- config fields `minio`, `bucket_name`, `url_expires`
+- codec aliases `comment`, `serialize`, `deserialize`, `__validate__`,
+  `model_items`
+- metadata alias `value_type`
+
+Use `storage=...` with an `ExcelStorage` implementation for any backend,
+including `MinioStorageGateway`.

excelalchemy-3.0.0/src/excelalchemy/__init__.py

@@ -0,0 +1,99 @@
+"""Public ExcelAlchemy API."""
+
+__version__ = '3.0.0'
+from excelalchemy.artifacts import ExcelArtifact
+from excelalchemy.codecs.boolean import BooleanCodec
+from excelalchemy.codecs.choice import MultiChoiceCodec, SingleChoiceCodec
+from excelalchemy.codecs.date import DateCodec
+from excelalchemy.codecs.date_range import DateRangeCodec
+from excelalchemy.codecs.email import EmailCodec
+from excelalchemy.codecs.field_codec import CompositeExcelFieldCodec, ExcelFieldCodec, ExcelFieldCodecSpec
+from excelalchemy.codecs.number import NumberCodec
+from excelalchemy.codecs.number_range import NumberRangeCodec
+from excelalchemy.codecs.phone_number import PhoneNumberCodec
+from excelalchemy.codecs.text import TextCodec
+from excelalchemy.codecs.url import UrlCodec
+from excelalchemy.columns import ExcelColumn
+from excelalchemy.config import ExportConfig, ExporterConfig, ImportConfig, ImporterConfig, ImportMode
+from excelalchemy.errors import (
+    ConfigError,
+    ExcelCellError,
+    ExcelRowError,
+    ProgrammaticError,
+    WorksheetNotFoundError,
+)
+from excelalchemy.primitives.constants import CharacterSet, DataRangeOption, DateFormat, Option
+from excelalchemy.primitives.identity import (
+    ColumnIndex,
+    DataUrlStr,
+    Key,
+    Label,
+    OptionId,
+    RowIndex,
+    UniqueKey,
+    UniqueLabel,
+    UrlStr,
+)
+from excelalchemy.results import (
+    CellErrorMap,
+    ImportPreflightResult,
+    ImportPreflightStatus,
+    ImportResult,
+    RowIssueMap,
+    ValidateHeaderResult,
+    ValidateResult,
+    ValidateRowResult,
+)
+from excelalchemy.runtime.facade import ExcelAlchemy
+from excelalchemy.storage import ExcelStorage
+
+__all__ = [
+    'BooleanCodec',
+    'CellErrorMap',
+    'ColumnIndex',
+    'CompositeExcelFieldCodec',
+    'ConfigError',
+    'DataRangeOption',
+    'DataUrlStr',
+    'DateCodec',
+    'DateFormat',
+    'DateRangeCodec',
+    'EmailCodec',
+    'ExcelAlchemy',
+    'ExcelArtifact',
+    'ExcelCellError',
+    'ExcelColumn',
+    'ExcelFieldCodec',
+    'ExcelFieldCodecSpec',
+    'ExcelRowError',
+    'ExcelStorage',
+    'ExportConfig',
+    'ExporterConfig',
+    'ImportConfig',
+    'ImportMode',
+    'ImportPreflightResult',
+    'ImportPreflightStatus',
+    'ImportResult',
+    'ImporterConfig',
+    'Key',
+    'Label',
+    'MultiChoiceCodec',
+    'NumberCodec',
+    'NumberRangeCodec',
+    'Option',
+    'OptionId',
+    'PhoneNumberCodec',
+    'ProgrammaticError',
+    'RowIndex',
+    'RowIssueMap',
+    'SingleChoiceCodec',
+    'TextCodec',
+    'UniqueKey',
+    'UniqueLabel',
+    'UrlCodec',
+    'UrlStr',
+    'ValidateHeaderResult',
+    'ValidateResult',
+    'ValidateRowResult',
+    'WorksheetNotFoundError',
+]

excelalchemy-3.0.0/src/excelalchemy/adapters/__init__.py

@@ -0,0 +1,19 @@
+"""Framework adapter boundaries."""
+
+from excelalchemy.adapters.pydantic import (
+    PydanticFieldAdapter,
+    PydanticModelAdapter,
+    ValidationMessageNormalizationPolicy,
+    extract_pydantic_model,
+    get_model_field_names,
+    instantiate_pydantic_model,
+)
+
+__all__ = [
+    'PydanticFieldAdapter',
+    'PydanticModelAdapter',
+    'ValidationMessageNormalizationPolicy',
+    'extract_pydantic_model',
+    'get_model_field_names',
+    'instantiate_pydantic_model',
+]