overture-schema-codegen 0.1.1.dev0__py3-none-any.whl

overture/schema/codegen/spec_discovery.py

@@ -0,0 +1,66 @@
+"""Bridge discovered models to extracted specs.
+
+`discover_models` yields `(ModelKey, entry)` pairs where each entry is either
+a concrete Pydantic model class, a discriminated-union type alias, or a
+`RootModel`. This module turns one such pair into a spec, splitting by output:
+`extract_model_spec` yields the feature/union `ModelSpec` the pipelines
+generate from, while `extract_alias_spec` documents a `RootModel` as a named
+alias for markdown. It sits at the orchestration tier (alongside `cli`),
+importing downward into extraction and layout.
+"""
+
+from __future__ import annotations
+
+from overture.schema.system.discovery import ModelKey
+
+from .extraction.model_extraction import extract_model
+from .extraction.newtype_extraction import extract_rootmodel_alias
+from .extraction.specs import (
+    ModelSpec,
+    NewTypeSpec,
+    is_model_class,
+    is_rootmodel,
+    is_union_alias,
+    partitions_from_tags,
+)
+from .extraction.union_extraction import extract_union
+from .layout.module_layout import entry_point_class
+
+__all__ = ["extract_alias_spec", "extract_model_spec"]
+
+
+def extract_model_spec(key: ModelKey, entry: object) -> ModelSpec | None:
+    """Extract the feature/union `ModelSpec` for a discovered `(key, entry)`.
+
+    Returns None when `entry` generates no feature or union spec: a
+    non-model, non-union entry, or a `RootModel`. A RootModel serializes as
+    its bare root value and has no record structure, so extracting it as a
+    top-level `RecordSpec` would invent a spurious `root` column;
+    `extract_alias_spec` documents it instead. Wherever a RootModel is used
+    as a field, `analyze_type` unwraps it to that bare shape.
+    """
+    if is_rootmodel(entry):
+        return None
+    partitions = partitions_from_tags(key.tags)
+    if is_model_class(entry):
+        return extract_model(entry, entry_point=key.entry_point, partitions=partitions)
+    if is_union_alias(entry):
+        return extract_union(
+            entry_point_class(key.entry_point),
+            entry,
+            entry_point=key.entry_point,
+            partitions=partitions,
+        )
+    return None
+
+
+def extract_alias_spec(entry: object) -> NewTypeSpec | None:
+    """Extract the markdown alias spec for a `RootModel` entry point.
+
+    A RootModel is a named alias over its bare root value -- like a NewType
+    -- so it documents as a `NewTypeSpec`. Returns None for any other entry;
+    only RootModels contribute a standalone alias page.
+    """
+    if is_rootmodel(entry):
+        return extract_rootmodel_alias(entry)
+    return None

overture_schema_codegen-0.1.1.dev0.dist-info/METADATA

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: overture-schema-codegen
+Version: 0.1.1.dev0
+Summary: Code generator that produces documentation and code from Pydantic models
+License-Expression: MIT
+Requires-Dist: click>=8.1
+Requires-Dist: jinja2>=3.0
+Requires-Dist: overture-schema-cli>=0.1.1
+Requires-Dist: overture-schema-common>=0.1.1
+Requires-Dist: overture-schema-system>=0.1.1
+Requires-Dist: tomli>=2.0 ; python_full_version < '3.11'
+Requires-Dist: typing-extensions>=4.0
+Requires-Python: >=3.10

overture_schema_codegen-0.1.1.dev0.dist-info/RECORD

@@ -0,0 +1,61 @@
+overture/schema/codegen/__init__.py,sha256=OTcZrypy__DDDKAzA5H6ifRbUgofOZDP3zuvTV4ZYVA,58
+overture/schema/codegen/cli.py,sha256=CBC7sHhflqu9s8reRzQmXoSJ87dj2G60K1YxI5gN5v4,7282
+overture/schema/codegen/extraction/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture/schema/codegen/extraction/docstring.py,sha256=ZqLITnoOl3j6tibyZ1k69OT3rja6ykOKEzKF46Cvxpg,1438
+overture/schema/codegen/extraction/enum_extraction.py,sha256=CAKo0AYvPgVAtOiE2d4cy29zzzpGJMGYF7atpoHezbY,1145
+overture/schema/codegen/extraction/examples.py,sha256=gg5h1Nan-5M6Uj6mAS6vELER_Z9knhuc7S6mQgQkFyc,12117
+overture/schema/codegen/extraction/field.py,sha256=wrp1ZfxqXiRrJ0ANLzjvHzBLd0KszUHHoqgxQFBN4Uo,4765
+overture/schema/codegen/extraction/field_constraints.py,sha256=605KlCY_aLshk2loFfS5mz-M3u2e9oJzBzU56XtKAQE,7015
+overture/schema/codegen/extraction/field_walk.py,sha256=VqhQV3DtHh7YBWU8AgYkQ-fFB8svGH74VWIDuWvMRJ0,8710
+overture/schema/codegen/extraction/length_constraints.py,sha256=Z1QmaK78TMqYdzrU1222UfAR4maxTrIjtTbtJdhtVQk,1463
+overture/schema/codegen/extraction/literal_alternatives.py,sha256=6gEXJlbV8jWOnzJotfBbimJXdR9zQ8Yz6j7swSUh-wY,1038
+overture/schema/codegen/extraction/model_constraints.py,sha256=jc1Y_8VGjCBGb59O5IB9jx9d6LqTHK8iMzTUpvoXm_k,9250
+overture/schema/codegen/extraction/model_extraction.py,sha256=TEW5pRQrqQc-wIcRLMbss4jV5SpRmndTNckvxxXAKYo,8474
+overture/schema/codegen/extraction/newtype_extraction.py,sha256=tYp4KO---24PhkzR3Bx5AcJ3wMBvvCRkfM_bVCeEw_U,2793
+overture/schema/codegen/extraction/numeric_extraction.py,sha256=07cbS0J6iKWBadOcsTcag_gjNkrH5paJ-_yHXQ5h65o,2353
+overture/schema/codegen/extraction/pydantic_extraction.py,sha256=IcVJhudq6fCDji9Z5PzZ4H4ye41AkmXzYhva_rLq_N8,1088
+overture/schema/codegen/extraction/specs.py,sha256=6IZOFHLYB_UfIZL20u2yjnP7QX2juEpekr10dVKQvYg,9041
+overture/schema/codegen/extraction/type_analyzer.py,sha256=Rf6tgxITZewGXrSOMxnVRHEt3oF73BcF0gLCSuJzlNE,27210
+overture/schema/codegen/extraction/type_registry.py,sha256=lewqdzb9gNMvCE_3F8LurKp9slbbpkdSnZTPQ6SkMCk,4813
+overture/schema/codegen/extraction/union_extraction.py,sha256=IVuSaCi9gp_MKJrcFglpKPG4e3ocg3A5nDcGbdrLnac,10107
+overture/schema/codegen/layout/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture/schema/codegen/layout/module_layout.py,sha256=y95L3jDtIpMp-LIWmoJndLahW5KpxKXS_yIC0NkvzM0,3939
+overture/schema/codegen/layout/type_collection.py,sha256=oNeYYEeNyADYyv1EmdPAB-RAUtrlsCK3FpCGr6LHMgc,4603
+overture/schema/codegen/markdown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture/schema/codegen/markdown/link_computation.py,sha256=dJi5KMXE_XIMo4fvEjeQ-xgXl1nUUuiUfqrKeyoDs30,2405
+overture/schema/codegen/markdown/path_assignment.py,sha256=ag35ErlpANIN8J99o63tIQsi3nThc8o-X6G5VJ2ydUE,3804
+overture/schema/codegen/markdown/pipeline.py,sha256=PRGtMY8i9v1NfT7QW4tA5CQztqxVaOrVQe6YPDqLBAI,6611
+overture/schema/codegen/markdown/renderer.py,sha256=hTosab2LiMx9pISOwh6wK2z69wUOPeeb1qvaDA3DntI,20442
+overture/schema/codegen/markdown/reverse_references.py,sha256=mZpBtH9gVV-7ALp0Rf_v90sufQThWKTkZMB4tj2baiQ,5872
+overture/schema/codegen/markdown/templates/_used_by.md.jinja2,sha256=vXrfGooK-Wt7sN1e-CEwOp-1iNM9JvYfuhDa7iDDW14,186
+overture/schema/codegen/markdown/templates/enum.md.jinja2,sha256=e3omybgyMjh91fcAQYi531hZLE-XvhLl9yC5rlOOExc,278
+overture/schema/codegen/markdown/templates/feature.md.jinja2,sha256=Z1Eul2ZjVgEzROufnLAlS2R65LAouRqvgfRfEK8tkcQ,944
+overture/schema/codegen/markdown/templates/geometric.md.jinja2,sha256=r-pGKMLzmDBsO_jcDXYz-bca2uClz5CQt8GcCQzAIWY,419
+overture/schema/codegen/markdown/templates/newtype.md.jinja2,sha256=bOwA3DRNpWNRXenv70mMJ1Opu6gPjIoN829QtazfwbI,369
+overture/schema/codegen/markdown/templates/numeric.md.jinja2,sha256=y5de8WDMLVjKWEuRvKtlRjY5cr7Uy6cZ7IkZ3wNR53c,646
+overture/schema/codegen/markdown/templates/pydantic_type.md.jinja2,sha256=9XQjs5OzGV6anffWZLD7q2D3w7eF7jxTbxhKuwbCdgA,209
+overture/schema/codegen/markdown/type_format.py,sha256=0PgSp66k2HrPX8bbdbTjande_lcj6QT8G9GMmOb3WGQ,14309
+overture/schema/codegen/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+overture/schema/codegen/pyspark/__init__.py,sha256=xEiYueRMlf49YJJcBs1vtWdNchyv8HDzrCIG7dGFZYs,74
+overture/schema/codegen/pyspark/_primitive_fill.py,sha256=AygbBOZGkjCBpYWwAacoB5V4JsZrVCcNwlKoIOuWnXI,814
+overture/schema/codegen/pyspark/_render_common.py,sha256=JwoI2hmiOz1GOlgeyZyl_TaMb2QapbDyZPaaIC8bIrI,17920
+overture/schema/codegen/pyspark/check_builder.py,sha256=1z-u_D9UrgTIo7hir7t5FOSL3Tb7n5sNtnRH25dK2_k,38363
+overture/schema/codegen/pyspark/check_ir.py,sha256=kThtGCwqN2upZskCHAmYtFAIQo0u29Qb3H9WNnsBCD8,8459
+overture/schema/codegen/pyspark/constraint_dispatch.py,sha256=WtG6XzwAeGjvvBG6i8EtYpI_ewXhCBHiS46Hcz1YQGs,28597
+overture/schema/codegen/pyspark/pipeline.py,sha256=gmZHFtAQceqHfAf3VBW1--jyljMhBqAx6uiESyWJaD4,7226
+overture/schema/codegen/pyspark/renderer.py,sha256=kjdGzIOWSbtuN_wyV-UIpuHvEwwo0oTrDYjJ0T2wdfQ,30201
+overture/schema/codegen/pyspark/schema_builder.py,sha256=aRThzAXpxPkHhbn2iQ2opIwp0kStQI4XgoqJANHbm50,6586
+overture/schema/codegen/pyspark/templates/_check_function.py.jinja2,sha256=bKvhewfX-T23ggWWJKAYjGUrZShTx8KNs_vX9BFIHxM,316
+overture/schema/codegen/pyspark/templates/model_module.py.jinja2,sha256=5p1xLfdm3kKON3Ow7nyFMCtb1z0u-FdF4trOCuGVL4I,1962
+overture/schema/codegen/pyspark/templates/test_module.py.jinja2,sha256=ST3E_qkZH1kkiGg2PujIB3Stc2U7peL7Ai0bzJ7y97U,3852
+overture/schema/codegen/pyspark/test_data/__init__.py,sha256=-kADuoPLDav7mEWvmtkuENmJaC-59tL626qU8G4O9Z0,378
+overture/schema/codegen/pyspark/test_data/base_row.py,sha256=b6Xitha4c5kCYY11VHA4ugti8jXXyto8YTQNvhbxW_k,31810
+overture/schema/codegen/pyspark/test_data/constraint_values.py,sha256=JTe4YIdQuUBQ-rH3o4lYqGj59Nb-22X4k22hqKTa0dY,7696
+overture/schema/codegen/pyspark/test_data/invalid_value.py,sha256=UbhWDGk8JMDr7FaROg3S_WZmFQ8pqlPojmz4KpdKZcM,4165
+overture/schema/codegen/pyspark/test_data/scaffold.py,sha256=zpU6dd4CS61m5dfOejhPsxeluGtA1L0-a1gbwDiCNx0,15314
+overture/schema/codegen/pyspark/test_renderer.py,sha256=XKD4-7h3jxSU9qLyAU9Me_UL_b1OFaKRbUV1I_Zv-Vc,28412
+overture/schema/codegen/spec_discovery.py,sha256=7kW8AHh7W1RLPSOzIhCng-BQ2BIjopAupBbeBLaPvYA,2548
+overture_schema_codegen-0.1.1.dev0.dist-info/WHEEL,sha256=Lkz__M3n3EKWmzMwHnFILNW2SHO43bOxmbqnBjwb--4,80
+overture_schema_codegen-0.1.1.dev0.dist-info/entry_points.txt,sha256=CvJI-Tq_UhjwIqq8COr4w4LwN29ds11wLGJj8tamlJs,71
+overture_schema_codegen-0.1.1.dev0.dist-info/METADATA,sha256=5t8B4BnmPbrxL9fXdrA2bLA2gVhun_4p0GgdO5jTS08,482
+overture_schema_codegen-0.1.1.dev0.dist-info/RECORD,,

overture_schema_codegen-0.1.1.dev0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.12.6
+Root-Is-Purelib: true
+Tag: py3-none-any

overture_schema_codegen-0.1.1.dev0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+overture-codegen = overture.schema.codegen.cli:main
+