geniespec 0.1.1.dev2__py3-none-any.whl

geniespec/api_schema.yaml

@@ -0,0 +1,318 @@
+$schema: 'http://json-schema.org/draft-07/schema#'
+$id: kibaRestApiSchema
+type: object
+additionalProperties: false
+required:
+  - version
+  - serviceName
+  - pythonClientPackageName
+  - typescriptClientPackageName
+properties:
+  version:
+    type: string
+    pattern: '^([0-9]|[1-9][0-9]*)\.([0-9]|[1-9][0-9]*)\.([0-9]|[1-9][0-9]*)$'
+  serviceName:
+    type: string
+    pattern: '^[a-z][a-z-]*$'
+  pythonClientPackageName:
+    type: string
+    pattern: '^[a-z][-a-z]*$'
+  typescriptClientPackageName:
+    type: string
+    pattern: '[@/-a-z]*$'
+  transitions:
+    type: array
+    items:
+      $ref: '#/definitions/RootTransition'
+  resources:
+    type: array
+    items:
+      $ref: '#/definitions/Resource'
+  exceptions:
+    type: array
+    items:
+      $ref: '#/definitions/Exception'
+  imports:
+    type: array
+    items:
+      type: string
+  defaultAuthentication:
+    type:
+      - "null"
+      - string
+    pattern: '^[a-z][a-z0-9-]*$'
+definitions:
+  Attribute:
+    type: object
+    additionalProperties: false
+    required:
+      - name
+      - type
+    properties:
+      name:
+        type: string
+        pattern: '^[a-z][A-Za-z0-9-]*$'
+      type:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      listValueTypes:
+        type: array
+        minItems: 1
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      isPrimary:
+        type: boolean
+      isUnique:
+        type: boolean
+      shouldDisableGetEndpoint:
+        type: boolean
+      isUnfilterable:
+        type: boolean
+      isUpdatable:
+        type: boolean
+      isNullable:
+        type: boolean
+      isDeprecated:
+        type: boolean
+      defaultValue:
+        type:
+          - string
+          - number
+          - boolean
+          - 'null'
+      isSettable:
+        type: boolean
+      isAccessibleIndependently:
+        type: boolean
+      mappingKeyType:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      mappingValueTypes:
+        type: array
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+  Resource:
+    type: object
+    additionalProperties: false
+    required:
+      - singleName
+      - collectionName
+    properties:
+      singleName:
+        type: string
+        pattern: '^[A-Z][A-Za-z-]*$'
+      collectionName:
+        type: string
+        pattern: '^[A-Z][A-Za-z-]*$'
+      parentResource:
+        type: string
+        pattern: '^[A-Z][A-Za-z-]*$'
+      attributes:
+        type: array
+        items:
+          $ref: '#/definitions/Attribute'
+      transitions:
+        type: array
+        items:
+          $ref: '#/definitions/Transition'
+      accessibleFrom:
+        type: array
+        items:
+          type: string
+  BaseTransition:
+    type: object
+    additionalProperties: false
+    required:
+      - action
+    properties:
+      action:
+        type: string
+        pattern: '^[A-Z][A-Z-]*$'
+      method:
+        type: string
+        enum:
+          - GET
+          - POST
+      requestFields:
+        type: array
+        items:
+          $ref: '#/definitions/RequestField'
+      responseField:
+        $ref: '#/definitions/ResponseField'
+      authentication:
+        type:
+          - "null"
+          - string
+        pattern: '^[a-z][a-z0-9-]*$'
+      responseType:
+        type: string
+        enum:
+          - json
+          - stream
+          - redirect
+  Transition:
+    type: object
+    additionalProperties: false
+    required:
+      - action
+    properties:
+      action:
+        type: string
+        pattern: '^[A-Z][A-Z-]*$'
+      method:
+        type: string
+        enum:
+          - GET
+          - POST
+      requestFields:
+        type: array
+        items:
+          $ref: '#/definitions/RequestField'
+      responseField:
+        $ref: '#/definitions/ResponseField'
+      authentication:
+        type:
+          - "null"
+          - string
+        pattern: '^[a-z][a-z0-9-]*$'
+      responseType:
+        type: string
+        enum:
+          - json
+          - stream
+          - redirect
+      operatesOn:
+        type: string
+        enum:
+          - individual
+          - collection
+      isIndirectAction:
+        type: boolean
+  RootTransition:
+    type: object
+    allOf:
+      - $ref: '#/definitions/BaseTransition'
+  RequestField:
+    type: object
+    additionalProperties: false
+    required:
+      - name
+      - type
+    properties:
+      name:
+        type: string
+        pattern: '^[a-z][A-Za-z0-9-]*$'
+      type:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      listValueTypes:
+        type: array
+        minItems: 1
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      mappingKeyType:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      mappingValueTypes:
+        type: array
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      isRequired:
+        type: boolean
+      defaultValue:
+        type:
+          - string
+          - number
+          - boolean
+          - 'null'
+      isDeprecated:
+        type: boolean
+      maxValue:
+        type:
+          - string
+          - number
+      minValue:
+        type:
+          - string
+          - number
+      source:
+        type: string
+        enum:
+          - request
+          - query-parameters
+  ResponseField:
+    type: object
+    additionalProperties: false
+    required:
+      - name
+      - type
+    properties:
+      name:
+        type: string
+        pattern: '^[a-z][A-Za-z-]*$'
+      type:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      listValueTypes:
+        type: array
+        minItems: 1
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      mappingKeyType:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      mappingValueTypes:
+        type: array
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      isNullable:
+        type: boolean
+      isList:
+        type: boolean
+  Exception:
+    type: object
+    additionalProperties: false
+    required:
+      - name
+    properties:
+      name:
+        type: string
+        pattern: '^[A-Z][A-Za-z-]*Exception$'
+      message:
+        type: string
+      extends:
+        type: string
+        pattern: '^([a-z-]+.exceptions.[A-Za-z-]*)|([A-Za-z-]*)'
+      statusCode:
+        type: integer
+      fields:
+        type: array
+        items:
+          $ref: '#/definitions/ExceptionField'
+  ExceptionField:
+    type: object
+    additionalProperties: false
+    required:
+      - name
+      - type
+    properties:
+      name:
+        type: string
+        pattern: '^[a-z][A-Za-z-]*$'
+      type:
+        type: string
+        pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      listValueTypes:
+        type: array
+        minItems: 1
+        items:
+          type: string
+          pattern: '^[A-Z][A-Za-z-\[\]_, ]*$'
+      isRequired:
+        type: boolean

geniespec/cli.py

@@ -0,0 +1,85 @@
+import argparse
+import pathlib
+import tempfile
+import time
+
+import yaml  # type: ignore[import-untyped]
+from core import logging
+
+from geniespec.genie import Renderer
+from geniespec.genie import SyntacticApiValidator
+from geniespec.types import KibaApi
+
+WATCH_INTERVAL_SECONDS = 0.5
+
+
+def _sync_directory(sourceDirectoryPath: pathlib.Path, targetDirectoryPath: pathlib.Path) -> list[pathlib.Path]:
+    changedPaths: list[pathlib.Path] = []
+    sourceRelativePaths = {path.relative_to(sourceDirectoryPath) for path in sourceDirectoryPath.rglob('*') if path.is_file()}
+    for relativePath in sorted(sourceRelativePaths):
+        content = (sourceDirectoryPath / relativePath).read_bytes()
+        targetPath = targetDirectoryPath / relativePath
+        if targetPath.is_file() and targetPath.read_bytes() == content:
+            continue
+        targetPath.parent.mkdir(parents=True, exist_ok=True)
+        temporaryPath = targetPath.with_name(f'.{targetPath.name}.tmp')
+        temporaryPath.write_bytes(content)
+        temporaryPath.replace(targetPath)
+        changedPaths.append(targetPath)
+    stalePaths = [path for path in targetDirectoryPath.rglob('*') if path.is_file() and '__pycache__' not in path.parts and path.relative_to(targetDirectoryPath) not in sourceRelativePaths]
+    for stalePath in stalePaths:
+        stalePath.unlink()
+    return changedPaths + stalePaths
+
+
+def build(specPath: pathlib.Path, outputDirectoryPath: pathlib.Path) -> list[pathlib.Path]:
+    with open(specPath) as specFile:
+        apiYaml = yaml.safe_load(specFile)
+    SyntacticApiValidator().validate(apiYaml)
+    api = KibaApi(**apiYaml)
+    with tempfile.TemporaryDirectory() as renderDirectory:
+        Renderer().render_directory(api=api, outputDirectoryPath=renderDirectory)
+        return _sync_directory(sourceDirectoryPath=pathlib.Path(renderDirectory), targetDirectoryPath=outputDirectoryPath / 'python')
+
+
+def _build_and_log(specPath: pathlib.Path, outputDirectoryPath: pathlib.Path) -> None:
+    changedPaths = build(specPath=specPath, outputDirectoryPath=outputDirectoryPath)
+    logging.info(f'geniespec: built {specPath} into {outputDirectoryPath} ({len(changedPaths)} files changed)')
+
+
+def watch(specPath: pathlib.Path, outputDirectoryPath: pathlib.Path) -> None:
+    lastModifiedTime: int | None = None
+    while True:
+        try:
+            modifiedTime: int | None = specPath.stat().st_mtime_ns
+        except FileNotFoundError:
+            modifiedTime = lastModifiedTime
+        if modifiedTime != lastModifiedTime:
+            lastModifiedTime = modifiedTime
+            try:
+                _build_and_log(specPath=specPath, outputDirectoryPath=outputDirectoryPath)
+            except Exception as exception:  # noqa: BLE001
+                logging.error(f'geniespec: failed to build {specPath}, keeping the previous output: {exception}')
+        time.sleep(WATCH_INTERVAL_SECONDS)
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog='geniespec')
+    subparsers = parser.add_subparsers(dest='command', required=True)
+    for command in ('build', 'watch'):
+        subparser = subparsers.add_parser(command)
+        subparser.add_argument('--spec', type=pathlib.Path, required=True)
+        subparser.add_argument('--output', type=pathlib.Path, default=pathlib.Path('.genie'))
+    args = parser.parse_args()
+    logging.basicConfig(level=logging.INFO)
+    if args.command == 'build':
+        _build_and_log(specPath=args.spec, outputDirectoryPath=args.output)
+        return
+    try:
+        watch(specPath=args.spec, outputDirectoryPath=args.output)
+    except KeyboardInterrupt:
+        return
+
+
+if __name__ == '__main__':
+    main()