dlubal.api 2.12.11__py3-none-any.whl

dlubal/api/common/connection.py

@@ -0,0 +1,252 @@
+''' Definition file '''
+import os
+import ssl
+import grpc
+
+from pathlib import Path
+from configparser import ConfigParser
+from importlib.metadata import version, PackageNotFoundError
+
+# Enable prompt option for testing purposes
+prompt = False
+
+options = [
+        ('grpc.max_send_message_length', -1),
+        ('grpc.max_receive_message_length', -1),
+    ]
+compression = grpc.Compression.Gzip # https://grpc.io/docs/guides/compression/
+
+class _config():
+    def __init__(self):
+        '''
+        Read config file. It is doesn't exist, create one.
+        '''
+        self.config = ConfigParser()
+        self.config_loc = Path(Path(__file__).parents[1], 'config.ini')
+        # Parse existing file
+        if os.path.isfile(self.config_loc):
+            self.config.read(self.config_loc)
+
+    def _save_to_file(self):
+        '''
+        Save current config file
+        '''
+        with open(self.config_loc, 'w', encoding="utf-8") as config_file:
+            self.config.write(config_file)
+
+    def get_name_of_default(self):
+        '''
+        Return first name of the API key, which was set as default
+        '''
+        all_items = self.config.items('api_keys')
+        all_keys = self.config.options('api_keys')
+        if 'default' in all_keys:
+            default_value = self.config.get('api_keys', 'default')
+            for i in all_items:
+                if i[0] != 'default' and i[1] == default_value:
+                    return i[0]
+        return None
+
+    def _set(self, section, key, value):
+        '''
+        Set value and save config into file
+        '''
+        self.config.set(section, key, value)
+        self._save_to_file()
+
+    def get_value(self, key):
+        '''
+        Get API key from config
+        '''
+        value = None
+        if self.config.has_section('api_keys'):
+            value = self.config.get('api_keys', key, fallback=None)
+        if value and value.startswith(('AK', 'ak')):
+            # Set default
+            self._set('api_keys', 'default', value)
+        return value
+
+    def get_key(self, value):
+        '''
+        Get API key name from config by providing value
+        '''
+        if self.config.has_section('api_keys'):
+            all_items = self.config.items('api_keys')
+            for i in all_items:
+                if i[1] == value and i[0] != 'default':
+                    return i[0]
+        return None
+
+    def set_value(self, key, value):
+        '''
+        Set API key into config
+        '''
+        if self.config.has_section('api_keys'):
+            self._set('api_keys', key, value)
+        else:
+            self.config.add_section('api_keys')
+            self._set('api_keys', key, value)
+        # Set default
+        self._set('api_keys', 'default', value)
+
+    def delete_value(self, section, key):
+        '''
+        Delete API key
+        '''
+        self.config.remove_option(section, key)
+
+
+class _ApiKey():
+    '''
+    API key class to make it easy to manage API keys.
+    '''
+    def __init__(self, key=None , value=None):
+
+        self.key = key
+        self.value = value
+        self.config = _config()
+
+        if self.key and self.value:
+            # Check if API key is saved. If not, save it to config file.
+            if self.config.get_value(self.key) is None:
+                self.config.set_value(self.key, self.value)
+        elif self.key:
+            # Check if API key is saved, get it and put into self.value
+            self.value = self.config.get_value(self.key)
+        elif self.value:
+            # Providing value without key suggests user doesn't want to store it.
+            # Don't even store any default value.
+            # But user should be able to get key if value is known.
+            self.key = self.config.get_key(self.value)
+        else:
+            # Key and value are None
+            # Check if there is any default key set in config
+            self.value = self.config.get_value('default')
+            if self.value:
+                self.key = self.config.get_name_of_default()
+
+    def get(self, key=None):
+        '''
+        Get API key
+        '''
+        if key:
+            self.value = self.config.get_value(key)
+        else:
+            self.value = self.config.get_value('default')
+
+        if self.value is None:
+            raise ValueError("Invalid API key idenficator or missing default value.")
+        return self.value
+
+    def set(self, key, value):
+        '''
+        Set APi key
+        '''
+        self.config.set_value(key, value)
+
+
+class _ClientCallDetails(grpc.ClientCallDetails):
+    '''
+    Client call details class to pass authorization API key
+    '''
+    def __init__(self, call_details, metadata):
+        self.method = call_details.method
+        self.timeout = call_details.timeout
+        self.credentials = call_details.credentials
+        self.metadata = metadata
+
+class AuthInterceptor(grpc.UnaryUnaryClientInterceptor):
+    '''
+    Authorization Unary Interceptor class
+    '''
+    def __init__(self, value):
+        self.api_key = value
+
+    def intercept_call(self, continuation, client_call_details, request_or_iterator):
+        try:
+            client_version = version('dlubal.api')
+        except PackageNotFoundError:
+            # Package not installed, fallback to default version string
+            client_version = "dev"
+
+        call_details = _ClientCallDetails(
+            client_call_details,
+            [
+                ("authorization", f"Bearer {self.api_key}"),
+                ("api-client-info", f"Python | {client_version}"),
+            ]
+        )
+        return continuation(call_details, request_or_iterator)
+
+    def intercept_unary_unary(self, continuation, client_call_details, request):
+        return self.intercept_call(continuation, client_call_details, request)
+
+def check_ssl(_ssl, _ssl_file):
+    '''
+    Check SSL certificate
+    Params:
+        _ssl (bool): False if NOT using SSL auth. True if using SSL certificate.
+        _ssl_file (str):Path to .crt/.pem certificate.
+    '''
+    if _ssl is False:
+        pass
+    elif _ssl is True:
+        if isinstance(_ssl_file, str) and os.path.isfile(_ssl_file) and _ssl_file.endswith(('.crt', '.pem')):
+            # Use provided file
+            pass
+        elif _ssl_file == '':
+            # Use Windows Certification Store
+            pass
+        else:
+            # Provided path is not correct
+            exit()
+
+    return True
+
+def _get_ssl_credentials(_ssl_file) -> grpc.ChannelCredentials:
+    '''
+    Get SSL channel credentials by reading cert. file
+
+    Params:
+    path (str): Path to the SSL (.crt) certificate filepath
+    '''
+    if _ssl_file == '':
+        certs = ssl.create_default_context().get_ca_certs(True)
+        cert_string = ''
+        for cert in certs:
+            cert_string += ssl.DER_cert_to_PEM_cert(cert)
+        return grpc.ssl_channel_credentials(root_certificates=cert_string.encode('utf-8'))
+    else:
+        cert_file = open(_ssl_file, 'rb')
+        return grpc.ssl_channel_credentials(cert_file.read())
+
+def init_channel(API_key, url, port, _ssl, _ssl_file):
+    '''
+    Initialize the gRPC channel with the provided API key.
+
+    Params:
+        API_key (str): Api key
+        url (str): URL number defaults to localhost (127.0.0.1)
+        port (int): Port number defaults to 9000
+        _ssl (bool): True if using SSL
+        _ssl_file (str): Path to SSL cert file
+    '''
+    channel = None
+    try:
+        if _ssl:
+            # Create secure channel
+            channel_credentials = _get_ssl_credentials(_ssl_file)
+            channel = grpc.secure_channel(f"{url}:{port}", channel_credentials, options, compression)
+        else:
+            # Create insecure channel
+            channel = grpc.insecure_channel(f"{url}:{port}", options, compression)
+
+        #  Create gRPC interceptor
+        interceptor = AuthInterceptor(API_key)
+        channel = grpc.intercept_channel(channel, interceptor)
+
+    # All exceptions are handeled at the RFEM.__exit__()
+    except:
+        pass
+
+    return channel

dlubal/api/common/exceptions.py

@@ -0,0 +1,12 @@
+def exception_handler(exception, value, traceback):
+    '''
+    Exception handler
+    '''
+    print('ERROR:')
+    if traceback:
+        print(f'File: {traceback.tb_frame.f_code.co_filename}, line: {traceback.tb_frame.f_lineno}')
+    if value:
+        try:
+            print('Message:', value.details())
+        except:
+            print('Message:', value)

dlubal/api/common/import_export/__init__.py

@@ -0,0 +1,2 @@
+from .export_attributes_pb2 import *
+from .import_attributes_pb2 import *

dlubal/api/common/import_export/export_attributes_pb2.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: dlubal/api/common/import_export/export_attributes.proto
+# Protobuf Python Version: 5.28.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    28,
+    1,
+    '',
+    'dlubal/api/common/import_export/export_attributes.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import any_pb2 as google_dot_protobuf_dot_any__pb2
+from dlubal.api.common import common_pb2 as dlubal_dot_api_dot_common_dot_common__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n7dlubal/api/common/import_export/export_attributes.proto\x12\x1f\x64lubal.api.common.import_export\x1a\x19google/protobuf/any.proto\x1a\x1e\x64lubal/api/common/common.proto\"\x1c\n\x1aPythonGrpcExportAttributes\"\x89\x08\n\x13IfcExportAttributes\x12P\n\x04type\x18\x01 \x01(\x0e\x32\x42.dlubal.api.common.import_export.IfcExportAttributes.IfcExportType\x12\x1b\n\x0eremove_accents\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x1a\n\rmirror_axis_x\x18\x03 \x01(\x08H\x01\x88\x01\x01\x12\x1a\n\rmirror_axis_y\x18\x04 \x01(\x08H\x02\x88\x01\x01\x12\x1a\n\rmirror_axis_z\x18\x05 \x01(\x08H\x03\x88\x01\x01\x12<\n\x12origin_coordinates\x18\x06 \x01(\x0b\x32\x1b.dlubal.api.common.Vector3dH\x04\x88\x01\x01\x12^\n\x18rotation_angles_sequence\x18\x07 \x01(\x0e\x32\x37.dlubal.api.common.import_export.RotationAnglesSequenceH\x05\x88\x01\x01\x12\x39\n\x0frotation_angles\x18\x08 \x01(\x0b\x32\x1b.dlubal.api.common.Vector3dH\x06\x88\x01\x01\x12G\n\raxis_change_x\x18\t \x01(\x0e\x32+.dlubal.api.common.import_export.AxisChangeH\x07\x88\x01\x01\x12G\n\raxis_change_y\x18\n \x01(\x0e\x32+.dlubal.api.common.import_export.AxisChangeH\x08\x88\x01\x01\x12G\n\raxis_change_z\x18\x0b \x01(\x0e\x32+.dlubal.api.common.import_export.AxisChangeH\t\x88\x01\x01\x12/\n\x11objects_to_export\x18\x0c \x03(\x0b\x32\x14.google.protobuf.Any\"\x82\x01\n\rIfcExportType\x12\x1f\n\x1bIFC_EXPORT_TYPE_UNSPECIFIED\x10\x00\x12\"\n\x1eIFC_EXPORT_TYPE_REFERENCE_VIEW\x10\x01\x12,\n(IFC_EXPORT_TYPE_STRUCTURAL_ANALYSIS_VIEW\x10\x02\x42\x11\n\x0f_remove_accentsB\x10\n\x0e_mirror_axis_xB\x10\n\x0e_mirror_axis_yB\x10\n\x0e_mirror_axis_zB\x15\n\x13_origin_coordinatesB\x1b\n\x19_rotation_angles_sequenceB\x12\n\x10_rotation_anglesB\x10\n\x0e_axis_change_xB\x10\n\x0e_axis_change_yB\x10\n\x0e_axis_change_z*\x8e\x02\n\x16RotationAnglesSequence\x12(\n$ROTATION_ANGLES_SEQUENCE_UNSPECIFIED\x10\x00\x12 \n\x1cROTATION_ANGLES_SEQUENCE_XYZ\x10\x01\x12 \n\x1cROTATION_ANGLES_SEQUENCE_XZY\x10\x02\x12 \n\x1cROTATION_ANGLES_SEQUENCE_YXZ\x10\x03\x12 \n\x1cROTATION_ANGLES_SEQUENCE_YZX\x10\x04\x12 \n\x1cROTATION_ANGLES_SEQUENCE_ZXY\x10\x05\x12 \n\x1cROTATION_ANGLES_SEQUENCE_ZYX\x10\x06*b\n\nAxisChange\x12\x1b\n\x17\x41XIS_CHANGE_UNSPECIFIED\x10\x00\x12\x11\n\rAXIS_CHANGE_X\x10\x01\x12\x11\n\rAXIS_CHANGE_Y\x10\x02\x12\x11\n\rAXIS_CHANGE_Z\x10\x03\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'dlubal.api.common.import_export.export_attributes_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_ROTATIONANGLESSEQUENCE']._serialized_start=1218
+  _globals['_ROTATIONANGLESSEQUENCE']._serialized_end=1488
+  _globals['_AXISCHANGE']._serialized_start=1490
+  _globals['_AXISCHANGE']._serialized_end=1588
+  _globals['_PYTHONGRPCEXPORTATTRIBUTES']._serialized_start=151
+  _globals['_PYTHONGRPCEXPORTATTRIBUTES']._serialized_end=179
+  _globals['_IFCEXPORTATTRIBUTES']._serialized_start=182
+  _globals['_IFCEXPORTATTRIBUTES']._serialized_end=1215
+  _globals['_IFCEXPORTATTRIBUTES_IFCEXPORTTYPE']._serialized_start=886
+  _globals['_IFCEXPORTATTRIBUTES_IFCEXPORTTYPE']._serialized_end=1016
+# @@protoc_insertion_point(module_scope)

dlubal/api/common/import_export/export_attributes_pb2.pyi

@@ -0,0 +1,77 @@
+from google.protobuf import any_pb2 as _any_pb2
+from dlubal.api.common import common_pb2 as _common_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Iterable as _Iterable, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class RotationAnglesSequence(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    ROTATION_ANGLES_SEQUENCE_UNSPECIFIED: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_XYZ: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_XZY: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_YXZ: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_YZX: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_ZXY: _ClassVar[RotationAnglesSequence]
+    ROTATION_ANGLES_SEQUENCE_ZYX: _ClassVar[RotationAnglesSequence]
+
+class AxisChange(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    AXIS_CHANGE_UNSPECIFIED: _ClassVar[AxisChange]
+    AXIS_CHANGE_X: _ClassVar[AxisChange]
+    AXIS_CHANGE_Y: _ClassVar[AxisChange]
+    AXIS_CHANGE_Z: _ClassVar[AxisChange]
+ROTATION_ANGLES_SEQUENCE_UNSPECIFIED: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_XYZ: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_XZY: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_YXZ: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_YZX: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_ZXY: RotationAnglesSequence
+ROTATION_ANGLES_SEQUENCE_ZYX: RotationAnglesSequence
+AXIS_CHANGE_UNSPECIFIED: AxisChange
+AXIS_CHANGE_X: AxisChange
+AXIS_CHANGE_Y: AxisChange
+AXIS_CHANGE_Z: AxisChange
+
+class PythonGrpcExportAttributes(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class IfcExportAttributes(_message.Message):
+    __slots__ = ("type", "remove_accents", "mirror_axis_x", "mirror_axis_y", "mirror_axis_z", "origin_coordinates", "rotation_angles_sequence", "rotation_angles", "axis_change_x", "axis_change_y", "axis_change_z", "objects_to_export")
+    class IfcExportType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+        __slots__ = ()
+        IFC_EXPORT_TYPE_UNSPECIFIED: _ClassVar[IfcExportAttributes.IfcExportType]
+        IFC_EXPORT_TYPE_REFERENCE_VIEW: _ClassVar[IfcExportAttributes.IfcExportType]
+        IFC_EXPORT_TYPE_STRUCTURAL_ANALYSIS_VIEW: _ClassVar[IfcExportAttributes.IfcExportType]
+    IFC_EXPORT_TYPE_UNSPECIFIED: IfcExportAttributes.IfcExportType
+    IFC_EXPORT_TYPE_REFERENCE_VIEW: IfcExportAttributes.IfcExportType
+    IFC_EXPORT_TYPE_STRUCTURAL_ANALYSIS_VIEW: IfcExportAttributes.IfcExportType
+    TYPE_FIELD_NUMBER: _ClassVar[int]
+    REMOVE_ACCENTS_FIELD_NUMBER: _ClassVar[int]
+    MIRROR_AXIS_X_FIELD_NUMBER: _ClassVar[int]
+    MIRROR_AXIS_Y_FIELD_NUMBER: _ClassVar[int]
+    MIRROR_AXIS_Z_FIELD_NUMBER: _ClassVar[int]
+    ORIGIN_COORDINATES_FIELD_NUMBER: _ClassVar[int]
+    ROTATION_ANGLES_SEQUENCE_FIELD_NUMBER: _ClassVar[int]
+    ROTATION_ANGLES_FIELD_NUMBER: _ClassVar[int]
+    AXIS_CHANGE_X_FIELD_NUMBER: _ClassVar[int]
+    AXIS_CHANGE_Y_FIELD_NUMBER: _ClassVar[int]
+    AXIS_CHANGE_Z_FIELD_NUMBER: _ClassVar[int]
+    OBJECTS_TO_EXPORT_FIELD_NUMBER: _ClassVar[int]
+    type: IfcExportAttributes.IfcExportType
+    remove_accents: bool
+    mirror_axis_x: bool
+    mirror_axis_y: bool
+    mirror_axis_z: bool
+    origin_coordinates: _common_pb2.Vector3d
+    rotation_angles_sequence: RotationAnglesSequence
+    rotation_angles: _common_pb2.Vector3d
+    axis_change_x: AxisChange
+    axis_change_y: AxisChange
+    axis_change_z: AxisChange
+    objects_to_export: _containers.RepeatedCompositeFieldContainer[_any_pb2.Any]
+    def __init__(self, type: _Optional[_Union[IfcExportAttributes.IfcExportType, str]] = ..., remove_accents: bool = ..., mirror_axis_x: bool = ..., mirror_axis_y: bool = ..., mirror_axis_z: bool = ..., origin_coordinates: _Optional[_Union[_common_pb2.Vector3d, _Mapping]] = ..., rotation_angles_sequence: _Optional[_Union[RotationAnglesSequence, str]] = ..., rotation_angles: _Optional[_Union[_common_pb2.Vector3d, _Mapping]] = ..., axis_change_x: _Optional[_Union[AxisChange, str]] = ..., axis_change_y: _Optional[_Union[AxisChange, str]] = ..., axis_change_z: _Optional[_Union[AxisChange, str]] = ..., objects_to_export: _Optional[_Iterable[_Union[_any_pb2.Any, _Mapping]]] = ...) -> None: ...

dlubal/api/common/import_export/import_attributes_pb2.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: dlubal/api/common/import_export/import_attributes.proto
+# Protobuf Python Version: 5.28.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    28,
+    1,
+    '',
+    'dlubal/api/common/import_export/import_attributes.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n7dlubal/api/common/import_export/import_attributes.proto\x12\x1f\x64lubal.api.common.import_export\"\x15\n\x13IfcImportAttributes\"\x1a\n\x18RsectionImportAttributes\"\x15\n\x13XmlImportAttributesb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'dlubal.api.common.import_export.import_attributes_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_IFCIMPORTATTRIBUTES']._serialized_start=92
+  _globals['_IFCIMPORTATTRIBUTES']._serialized_end=113
+  _globals['_RSECTIONIMPORTATTRIBUTES']._serialized_start=115
+  _globals['_RSECTIONIMPORTATTRIBUTES']._serialized_end=141
+  _globals['_XMLIMPORTATTRIBUTES']._serialized_start=143
+  _globals['_XMLIMPORTATTRIBUTES']._serialized_end=164
+# @@protoc_insertion_point(module_scope)

dlubal/api/common/import_export/import_attributes_pb2.pyi

@@ -0,0 +1,17 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class IfcImportAttributes(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class RsectionImportAttributes(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...
+
+class XmlImportAttributes(_message.Message):
+    __slots__ = ()
+    def __init__(self) -> None: ...

dlubal/api/common/model_id_pb2.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: dlubal/api/common/model_id.proto
+# Protobuf Python Version: 5.28.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    28,
+    1,
+    '',
+    'dlubal/api/common/model_id.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n dlubal/api/common/model_id.proto\x12\x11\x64lubal.api.common\"\x17\n\x07ModelId\x12\x0c\n\x04guid\x18\x01 \x01(\t\"-\n\x0fOptionalModelId\x12\x11\n\x04guid\x18\x01 \x01(\tH\x00\x88\x01\x01\x42\x07\n\x05_guidb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'dlubal.api.common.model_id_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+  _globals['_MODELID']._serialized_start=55
+  _globals['_MODELID']._serialized_end=78
+  _globals['_OPTIONALMODELID']._serialized_start=80
+  _globals['_OPTIONALMODELID']._serialized_end=125
+# @@protoc_insertion_point(module_scope)

dlubal/api/common/model_id_pb2.pyi

@@ -0,0 +1,17 @@
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Optional as _Optional
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class ModelId(_message.Message):
+    __slots__ = ("guid",)
+    GUID_FIELD_NUMBER: _ClassVar[int]
+    guid: str
+    def __init__(self, guid: _Optional[str] = ...) -> None: ...
+
+class OptionalModelId(_message.Message):
+    __slots__ = ("guid",)
+    GUID_FIELD_NUMBER: _ClassVar[int]
+    guid: str
+    def __init__(self, guid: _Optional[str] = ...) -> None: ...

dlubal/api/common/options_pb2.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: dlubal/api/common/options.proto
+# Protobuf Python Version: 5.28.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    28,
+    1,
+    '',
+    'dlubal/api/common/options.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import descriptor_pb2 as google_dot_protobuf_dot_descriptor__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1f\x64lubal/api/common/options.proto\x12\x11\x64lubal.api.common\x1a google/protobuf/descriptor.proto:4\n\tread_only\x12\x1d.google.protobuf.FieldOptions\x18\x88\' \x01(\x08\x88\x01\x01\x62\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'dlubal.api.common.options_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  DESCRIPTOR._loaded_options = None
+# @@protoc_insertion_point(module_scope)

dlubal/api/common/options_pb2.pyi

@@ -0,0 +1,7 @@
+from google.protobuf import descriptor_pb2 as _descriptor_pb2
+from google.protobuf import descriptor as _descriptor
+from typing import ClassVar as _ClassVar
+
+DESCRIPTOR: _descriptor.FileDescriptor
+READ_ONLY_FIELD_NUMBER: _ClassVar[int]
+read_only: _descriptor.FieldDescriptor