geniespec 0.1.1.dev2__py3-none-any.whl

geniespec/templates/python/src/{service}/v{version}/api.py.j2

@@ -0,0 +1,68 @@
+{{ autogenerated_notice }}
+# ruff: noqa: ARG001
+{% if target.requires_streaming(api=api) %}
+import collections.abc
+{% endif %}
+import datetime
+
+from core.api.api_request import KibaApiRequest
+from core.api.route import route
+from core.api.route_auth import RouteAuthResolver
+{% if target.requires_redirect(api=api) %}
+from core.exceptions import FoundRedirectException
+{% endif %}
+from core.http.rest_method import RestMethod
+from starlette.routing import BaseRoute
+from starlette.routing import Route
+from . import endpoints
+from .internal import {{ target.internal_class_name(api=api) }}
+def create_routes(internal: {{ target.internal_class_name(api=api) }}, {% if target.requires_auth_resolver(api=api) %}authResolver: RouteAuthResolver{% else %}authResolver: RouteAuthResolver | None = None{% endif %}) -> list[BaseRoute]:
+
+
+{% for operation in api.operations %}
+{% set auth = target.route_auth(operation=operation) %}
+{% set class_name = target.operation_class_name(operation=operation) %}
+{% set result_name = target.identifier(name=operation.responseFields[0].name) if operation.responseFields else 'result' %}
+    @route(requestType=endpoints.{{ class_name }}Request, responseType=endpoints.{{ class_name }}Response{% if target.is_streaming(operation=operation) %}, isStreaming=True{% endif %}{% if auth is not none %}, authResolver=authResolver, auth='{{ auth }}'{% endif %})
+    async def {{ target.operation_name(operation=operation) }}(request: KibaApiRequest[endpoints.{{ class_name }}Request]) -> {% if target.is_streaming(operation=operation) %}collections.abc.AsyncIterator[endpoints.{{ class_name }}Response]{% else %}endpoints.{{ class_name }}Response{% endif %}:
+{% for parameter in target.request_parameters(operation=operation) %}
+{% set param_name = target.identifier(name=parameter.name) %}
+{% if target.requires_parameter_preprocessing(operation=operation, parameter=parameter) %}
+        {{ param_name }} = request.data.{{ param_name }}
+{% if parameter.defaultValue is not none and not target.is_undefined_parameter(operation=operation, parameter=parameter) %}
+        {{ param_name }} = {{ param_name }} if {{ param_name }} is not None else {{ target.literal(value=parameter.defaultValue) }}
+{% endif %}
+{% if parameter.minValue is not none %}
+        {{ param_name }} = max({{ param_name }}, {{ target.literal(value=parameter.minValue) }}){% if parameter.fieldType.isNullable and parameter.defaultValue is none %} if {{ param_name }} is not None else None{% endif +%}
+{% endif %}
+{% if parameter.maxValue is not none %}
+        {{ param_name }} = min({{ param_name }}, {{ target.literal(value=parameter.maxValue) }}){% if parameter.fieldType.isNullable and parameter.defaultValue is none %} if {{ param_name }} is not None else None{% endif +%}
+{% endif %}
+{% endif %}
+{% endfor %}
+{% if target.is_streaming(operation=operation) %}
+        async for item in internal.{{ target.operation_name(operation=operation) }}_v{{ api.version.major }}(
+{% else %}
+        {% if operation.responseFields or target.is_redirect(operation=operation) %}{{ result_name }} = {% endif %}await internal.{{ target.operation_name(operation=operation) }}_v{{ api.version.major }}(
+{% endif %}
+{% for parameter in operation.parameters %}
+            {{ target.identifier(name=parameter.name) }}={{ target.parameter_value(operation=operation, parameter=parameter) }},
+{% endfor %}
+{% if target.is_streaming(operation=operation) %}
+        ):
+            yield endpoints.{{ class_name }}Response({{ result_name }}=item)
+{% else %}
+        )
+{% endif %}
+{% if target.is_redirect(operation=operation) %}
+        raise FoundRedirectException(location={{ result_name }})
+{% elif not target.is_streaming(operation=operation) %}
+        return endpoints.{{ class_name }}Response({% if operation.responseFields %}{{ result_name }}={{ result_name }}{% endif %})
+{% endif %}
+
+{% endfor %}
+    return [
+{% for operation in target.route_ordered_operations(api=api) %}
+        Route(path='{{ target.endpoint(operation=operation) }}', methods=[RestMethod.{{ target.http_method(operation=operation) }}], endpoint={{ target.operation_name(operation=operation) }}),
+{% endfor %}
+    ]

geniespec/templates/python/src/{service}/v{version}/endpoints.py.j2

@@ -0,0 +1,38 @@
+{{ autogenerated_notice }}
+import collections.abc
+import datetime
+{% if target.requires_optional_field_default(api=api) %}
+import typing
+{% endif %}
+
+{% if target.operations_require_json(api=api) %}
+import pydantic
+{% endif %}
+{% if target.requires_optional_field_default(api=api) %}
+from pydantic import BaseModel, Field
+{% else %}
+from pydantic import BaseModel
+{% endif %}
+{% if target.requires_undefined(api=api) %}
+from core.util.typing_util import UNDEFINED, UpdateValue
+{% endif %}
+
+from . import resources
+
+{% for operation in api.operations %}
+
+class {{ target.operation_class_name(operation=operation) }}Request(BaseModel):
+{% for parameter in target.request_parameters(operation=operation) %}
+    {{ target.identifier(name=parameter.name) }}: {% if target.is_undefined_parameter(operation=operation, parameter=parameter) %}UpdateValue[{{ target.type(renderableType=parameter.fieldType, apiVersion=api.version) }}] = UNDEFINED{% else %}{{ target.type(renderableType=parameter.fieldType, apiVersion=api.version) }}{% if not parameter.isRequired %}{% if parameter.fieldType.isNullable %} = None{% else %} = Field(default=typing.cast({{ target.type(renderableType=parameter.fieldType, apiVersion=api.version) }}, None)){% endif %}{% endif %}{% endif +%}
+{% else %}
+    pass
+{% endfor %}
+
+class {{ target.operation_class_name(operation=operation) }}Response(BaseModel):
+{% if operation.responseFields and operation.responseFields | length > 0 %}
+    {{ target.identifier(name=operation.responseFields[0].name) }}: {{ target.type(renderableType=operation.responseFields[0].fieldType, apiVersion=api.version) }}
+{% else %}
+    pass
+{% endif %}
+
+{% endfor %}

geniespec/templates/python/src/{service}/v{version}/exceptions.py.j2

@@ -0,0 +1,68 @@
+{{ autogenerated_notice }}
+from __future__ import annotations
+import collections.abc
+import typing
+{% if target.exceptions_require_json(api=api) %}
+import pydantic
+{% endif %}
+from core import exceptions
+from core.util.typing_util import Json
+from . import resources
+
+
+class KibaExceptionTypedDict(typing.TypedDict):
+    message: str
+    statusCode: int
+    exceptionType: str
+
+{% for exception in api.exceptions %}
+
+class {{ target.pascal_name(name=exception.name) }}FieldsDict(typing.TypedDict):
+{% for field in exception.fields %}
+    {{ target.identifier(name=field.name) }}: {{ target.type(renderableType=field.fieldType, apiVersion=api.version) }}{% if not field.isRequired %} = None{% endif %}
+{% else %}
+    pass
+{% endfor %}
+
+
+class {{ target.pascal_name(name=exception.name) }}TypedDict(KibaExceptionTypedDict):
+    fields: {{ target.pascal_name(name=exception.name) }}FieldsDict
+
+
+class {{ target.exception_class_name(exception=exception, apiVersion=api.version) }}(exceptions.KibaException):
+
+    def __init__(
+        self,
+{% for field in exception.fields %}{% if field.isRequired %}
+        {{ target.identifier(name=field.name) }}: {{ target.type(renderableType=field.fieldType, apiVersion=api.version) }},
+{% endif %}{% endfor %}
+{% for field in exception.fields %}{% if not field.isRequired %}
+        {{ target.identifier(name=field.name) }}: {{ target.type(renderableType=field.fieldType, apiVersion=api.version) }} = None,
+{% endif %}{% endfor %}
+        message: str | None = None,
+    ) -> None:
+        super().__init__(message=message, statusCode={{ exception.statusCode }})
+{% for field in exception.fields %}
+        self.{{ target.identifier(name=field.name) }} = {{ target.identifier(name=field.name) }}
+{% endfor %}
+
+    def to_dict(self) -> dict[str, Json]:
+        return {
+            **super().to_dict(),
+            'fields': {
+{% for field in exception.fields %}
+                '{{ target.identifier(name=field.name) }}': self.{{ target.identifier(name=field.name) }},
+{% endfor %}
+            },
+        }
+
+    @classmethod
+    def from_dict(cls, exceptionDict: {{ target.pascal_name(name=exception.name) }}TypedDict) -> {{ target.exception_class_name(exception=exception, apiVersion=api.version) }}:  # type: ignore
+        return cls(
+             message=exceptionDict['message'],
+{% for field in exception.fields %}
+             {{ target.identifier(name=field.name) }}=exceptionDict['fields']['{{ target.identifier(name=field.name) }}'],
+{% endfor %}
+        )
+
+{% endfor %}

geniespec/templates/python/src/{service}/v{version}/internal.py.j2

@@ -0,0 +1,30 @@
+{{ autogenerated_notice }}
+import abc
+import datetime
+import collections.abc
+
+{% if target.operations_require_json(api=api) %}
+import pydantic
+
+{% endif %}
+from . import resources
+{% if target.requires_undefined(api=api) %}
+from core.util.typing_util import UNDEFINED, UpdateValue
+{% endif %}
+
+
+class {{ target.internal_class_name(api=api) }}(abc.ABC):
+{% if api.operations|length == 0 %}
+    pass
+{% endif %}
+{% for operation in api.operations %}
+
+    @abc.abstractmethod
+    {% if not target.is_streaming(operation=operation) %}async {% endif %}def {{ target.operation_name(operation=operation) }}_v{{ api.version.major }}(
+        self,
+{% for parameter in operation.parameters %}
+        {{ target.identifier(name=parameter.name) }}: {% if target.is_undefined_parameter(operation=operation, parameter=parameter) %}UpdateValue[{{ target.parameter_type(renderableParameter=parameter, apiVersion=api.version) }}]{% else %}{{ target.parameter_type(renderableParameter=parameter, apiVersion=api.version) }}{% endif %}{% if target.is_undefined_parameter(operation=operation, parameter=parameter) %} = UNDEFINED{% elif parameter.defaultValue is not none %} = {{ target.literal(value=parameter.defaultValue) }}{% endif %},
+{% endfor %}
+    ) -> {{ target.return_type(operation=operation, apiVersion=api.version) }}:
+        ...
+{% endfor %}

geniespec/templates/python/src/{service}/v{version}/resources.py.j2

@@ -0,0 +1,22 @@
+{{ autogenerated_notice }}
+from __future__ import annotations
+
+import collections.abc
+import datetime
+
+{% if target.resources_require_json(api=api) %}
+import pydantic
+{% endif %}
+from pydantic import BaseModel
+
+{% for resource in api.resources %}
+
+class {{ target.resource_class_name(resource=resource, apiVersion=api.version) }}(BaseModel):
+{% if resource.attributes|length == 0 %}
+    pass
+{% endif %}
+{% for attribute in resource.attributes %}
+    {{ target.identifier(name=attribute.name) }}: {{ target.type(renderableType=attribute.fieldType, apiVersion=api.version, isLocalReference=True) }}
+{% endfor %}
+
+{% endfor %}

geniespec/types.py

@@ -0,0 +1,147 @@
+from __future__ import annotations
+
+from typing import ClassVar
+
+import pydantic
+from pydantic import BaseModel
+
+
+class PrimitiveTypes:
+    LONG_INTEGER = 'LongInteger'
+    INTEGER = 'Integer'
+    FLOAT = 'Float'
+    DOUBLE = 'Double'
+    STRING = 'String'
+    BOOLEAN = 'Boolean'
+    DATETIME = 'Datetime'
+    DATE = 'Date'
+    JSON = 'Json'
+    ALL: ClassVar[list[str]] = [LONG_INTEGER, INTEGER, FLOAT, DOUBLE, STRING, BOOLEAN, DATETIME, DATE, JSON]
+
+
+class FieldSources:
+    REQUEST = 'request'
+    QUERY_PARAMETERS = 'query-parameters'
+
+
+class ResponseTypes:
+    JSON = 'json'
+    STREAM = 'stream'
+    REDIRECT = 'redirect'
+
+
+class ComplexTypes:
+    MAPPING = 'Mapping'
+    ALL: ClassVar[list[str]] = [MAPPING]
+
+
+class Attribute(BaseModel):
+    name: str
+    fieldType: str = pydantic.Field(alias='type')
+    listValueTypes: list[str] = []
+    mappingKeyType: str | None = None
+    mappingValueTypes: list[str] = []
+    isPrimary: bool = False
+    isUnique: bool = False
+    shouldDisableGetEndpoint: bool = False
+    isUnfilterable: bool = False
+    isUpdatable: bool = False
+    isNullable: bool = False
+    isDeprecated: bool = False
+    isSettable: bool = False
+    isAccessibleIndependently: bool = False
+    defaultValue: str | int | float | bool | None = None
+
+
+class ResponseField(BaseModel):
+    name: str
+    fieldType: str = pydantic.Field(alias='type')
+    listValueTypes: list[str] = []
+    mappingKeyType: str | None = None
+    mappingValueTypes: list[str] = []
+    isNullable: bool = False
+    isList: bool = False
+
+
+class RequestField(BaseModel):
+    name: str
+    fieldType: str = pydantic.Field(alias='type')
+    listValueTypes: list[str] = []
+    mappingKeyType: str | None = None
+    mappingValueTypes: list[str] = []
+    isRequired: bool = False
+    isDeprecated: bool = False
+    defaultValue: str | int | float | bool | None = None
+    maxValue: str | int | float | None = None
+    minValue: str | int | float | None = None
+    source: str = FieldSources.REQUEST
+
+
+class BaseTransition(BaseModel):
+    action: str
+    method: str | None = None
+    responseField: ResponseField | None = None
+    requestFields: list[RequestField] = []
+    authentication: str | None = None
+    responseType: str = ResponseTypes.JSON
+
+
+class Transition(BaseTransition):
+    operatesOn: str | None = None
+    isIndirectAction: bool = False
+
+
+class RootTransition(BaseTransition):
+    pass
+
+
+class Resource(BaseModel):
+    singleName: str
+    collectionName: str
+    parentResource: str | None = None
+    attributes: list[Attribute] = []
+    transitions: list[Transition] = []
+    accessibleFrom: list[str] = []
+
+    @property
+    def primaryAttribute(self) -> Attribute | None:  # noqa: N802
+        return next(iter([attribute for attribute in self.attributes if attribute.isPrimary]), None)
+
+
+class ExceptionField(BaseModel):
+    name: str
+    fieldType: str = pydantic.Field(alias='type')
+    listValueTypes: list[str] = []
+    isRequired: bool = False
+    isNullable: bool = False
+    defaultValue: str | int | float | bool | None = None
+
+
+class ApiException(BaseModel):
+    name: str
+    message: str | None = None
+    extends: str | None = None
+    statusCode: int | None = None
+    fields: list[ExceptionField] = []
+
+
+class Version(BaseModel):
+    major: str
+    minor: str
+    patch: str
+
+
+class KibaApi(BaseModel):
+    version: str
+    serviceName: str
+    pythonClientPackageName: str
+    typescriptClientPackageName: str
+    resources: list[Resource] = []
+    transitions: list[RootTransition] = []
+    exceptions: list[ApiException] = []
+    defaultAuthentication: str | None = None
+
+    @property
+    def versionObject(self) -> Version:  # noqa: N802
+        parts = self.version.split('.')
+        return Version(major=parts[0], minor=parts[1], patch=parts[2])

geniespec-0.1.1.dev2.dist-info/METADATA

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: geniespec
+Version: 0.1.1.dev2
+Summary: Generate API code from an api.yaml spec
+License-Expression: MIT
+Requires-Dist: jinja2>=3.1.6
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: jsonschema>=4.26.0
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: kiba-core>=0.5.3.dev81,<0.5.4
+Requires-Python: >=3.13, <4
+Project-URL: repository, https://github.com/kibalabs/genie
+Description-Content-Type: text/markdown
+
+# Genie
+
+Genie (`geniespec` on PyPI) generates API code from an `api.yaml` spec. The output is a package you install, not code you commit.
+
+```
+uvx geniespec build --spec api.yaml [--output .genie]
+uvx geniespec watch --spec api.yaml [--output .genie]
+```
+
+- `build` writes `<output>/python`: a project with `pyproject.toml` and `src/<service>_api/v<major>/` (`api`, `endpoints`, `resources`, `internal`, `exceptions`). Only changed files are rewritten and files it no longer generates are removed.
+- `watch` rebuilds whenever the spec changes. If the spec is invalid it logs the error and keeps the previous output.
+- Consumers depend on the output as an editable path dependency, e.g. `my-service-api = { path = ".genie/python", editable = true }` in `[tool.uv.sources]`, and import it as `my_service_api.v1`.
+- Generated code needs `kiba-core` (`core.api`, `core.util.typing_util`), `pydantic` and `starlette` from the consumer.
+
+# Development
+
+```
+make install
+make lint-check type-check test
+```
+
+Merges to `main` publish a dev version to PyPI. To release, bump `version` in `pyproject.toml` in a PR, then run the Release workflow on `main` (Actions → Release → Run workflow). It tags `vX.Y.Z` and the Publish workflow publishes it. Only the release workflow can push version tags.
+
+# Things that need work
+
+## Typing of params and fields in general
+
+Enum and OneOf not supported yet
+
+I think we need to create an object for Type. what would it look like?
+
+
+```
+class BaseFieldType:
+    isNullable: bool
+
+
+class RawFieldType(BaseFieldType):
+    name: str
+
+
+class ClassFieldType(BaseFieldType):
+    fieldType: RawFieldType
+
+
+class ListFieldType:(BaseFieldType)
+    fieldType: RawFieldType
+    isNullable: bool
+
+
+class MappingFieldType(BaseFieldType):
+    keyFieldType: RawFieldType
+    valueFieldType: RawFieldType
+
+
+class OneOfFieldType(BaseFieldType):
+    fieldTypes: list[RawFieldType]
+
+
+class EnumFieldType(BaseFieldType):
+    values: list[str]
+
+```

geniespec-0.1.1.dev2.dist-info/RECORD

@@ -0,0 +1,20 @@
+geniespec/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+geniespec/api_schema.yaml,sha256=7W6bPNsIVN1XLOv0XXKAy3XfyYPYZNpbkREURVFWFXM,6942
+geniespec/cli.py,sha256=KXlDkaO9irBC0lgJrRzgvTJX92soALiJEe2V13epf4E,3664
+geniespec/genie.py,sha256=QTI4__Q7P1nSnoMDdX7HO_RUeVccBCZv-cR14OAVuhg,36985
+geniespec/languages.py,sha256=l_kiIIIiE1nZJfVtX7GX4D8T4iM-9usKqVC-ld02jAM,24793
+geniespec/renderable_types.py,sha256=4AMN-ufAcYG07-ARdzSK1UOM6oC2Xp_cIx1-EfBco4w,7952
+geniespec/templates/python/pyproject.toml.j2,sha256=4qagRCkHxMCZHnz80vArjPWd1IrJQrIEoNtV74xbZMA,183
+geniespec/templates/python/src/{service}/__init__.py.j2,sha256=jfbq5glXrgTEjpXn2jLDIsOkVzsVVvNL1cjWToomAdI,27
+geniespec/templates/python/src/{service}/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+geniespec/templates/python/src/{service}/v{version}/__init__.py.j2,sha256=jfbq5glXrgTEjpXn2jLDIsOkVzsVVvNL1cjWToomAdI,27
+geniespec/templates/python/src/{service}/v{version}/api.py.j2,sha256=e72zeooHm6KUurqIUdlmvSx-I6RlpbJ0ngvTjlOBXJQ,4170
+geniespec/templates/python/src/{service}/v{version}/endpoints.py.j2,sha256=6TCEQ4IUiM_tLntg_FjUXb1pIYZIEz_wHnjCyIi72Ug,1662
+geniespec/templates/python/src/{service}/v{version}/exceptions.py.j2,sha256=Ck-9Cxbg8EkxW6CTpM_TqMpPCVcCpZGjun8uKXcgsjc,2518
+geniespec/templates/python/src/{service}/v{version}/internal.py.j2,sha256=IElSKLhhjWerJhKoCovleaG78k8ZJVsW_XUTmNEwesQ,1337
+geniespec/templates/python/src/{service}/v{version}/resources.py.j2,sha256=oyWlUVyQq1mWIRho3usY9jaA9k5Qn_YDiv1OT2GR948,625
+geniespec/types.py,sha256=mAgtltn5VepXFH12TtDgiHhEbiBG_c8ULaUmi7dUlvk,3783
+geniespec-0.1.1.dev2.dist-info/WHEEL,sha256=cmC5s21ojypbVslldL7IJq3hjZH-tINy4rziKePFsG0,81
+geniespec-0.1.1.dev2.dist-info/entry_points.txt,sha256=C3eQvtORVZ6rXgCW8RyeI-abdYPtqn6CCbjoDuOfX0M,50
+geniespec-0.1.1.dev2.dist-info/METADATA,sha256=mN4OzRpNQ9CXvRjyfki_QZxp3JFltLDnO46QqiJvFuI,2390
+geniespec-0.1.1.dev2.dist-info/RECORD,,

geniespec-0.1.1.dev2.dist-info/WHEEL

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

geniespec-0.1.1.dev2.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+geniespec = geniespec.cli:main
+