Skip to content

Commit

Permalink
MINOR: remove some document fields in model.document serialization
Browse files Browse the repository at this point in the history
* improve storey performances

* add comments
  • Loading branch information
Bimdata-io committed Jan 8, 2025
1 parent 749cec7 commit feb0558
Show file tree
Hide file tree
Showing 17 changed files with 758 additions and 15 deletions.
6 changes: 6 additions & 0 deletions .openapi-generator/FILES
Original file line number Diff line number Diff line change
Expand Up @@ -96,6 +96,8 @@ bimdata_api_client/model/material_list_component_request.py
bimdata_api_client/model/material_option.py
bimdata_api_client/model/material_request.py
bimdata_api_client/model/model.py
bimdata_api_client/model/model_document.py
bimdata_api_client/model/model_document_request.py
bimdata_api_client/model/model_errors.py
bimdata_api_client/model/model_errors_request.py
bimdata_api_client/model/model_files.py
Expand Down Expand Up @@ -345,6 +347,8 @@ docs/MaterialOption.md
docs/MaterialRequest.md
docs/Model.md
docs/ModelApi.md
docs/ModelDocument.md
docs/ModelDocumentRequest.md
docs/ModelErrors.md
docs/ModelErrorsRequest.md
docs/ModelFiles.md
Expand Down Expand Up @@ -597,6 +601,8 @@ test/test_material_option.py
test/test_material_request.py
test/test_model.py
test/test_model_api.py
test/test_model_document.py
test/test_model_document_request.py
test/test_model_errors.py
test/test_model_errors_request.py
test/test_model_files.py
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -583,6 +583,8 @@ Class | Method | HTTP request | Description
- [MaterialOption](docs/MaterialOption.md)
- [MaterialRequest](docs/MaterialRequest.md)
- [Model](docs/Model.md)
- [ModelDocument](docs/ModelDocument.md)
- [ModelDocumentRequest](docs/ModelDocumentRequest.md)
- [ModelErrors](docs/ModelErrors.md)
- [ModelErrorsRequest](docs/ModelErrorsRequest.md)
- [ModelFiles](docs/ModelFiles.md)
Expand Down
2 changes: 1 addition & 1 deletion bimdata_api_client/api/collaboration_api.py
Original file line number Diff line number Diff line change
Expand Up @@ -8815,7 +8815,7 @@ def create_document(
):
"""Create a document # noqa: E501

Create a document. If the document is one of {'OBJ', 'IFC', 'GLTF', 'DXF', 'POINT_CLOUD', 'DWG'}, a model will be created and attached to this document Required scopes: document:write # noqa: E501
Create a document. If the document is one of {'DXF', 'GLTF', 'POINT_CLOUD', 'OBJ', 'DWG', 'IFC'}, a model will be created and attached to this document Required scopes: document:write # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True

Expand Down
4 changes: 2 additions & 2 deletions bimdata_api_client/model/model.py
Original file line number Diff line number Diff line change
Expand Up @@ -31,11 +31,11 @@


def lazy_import():
from bimdata_api_client.model.document import Document
from bimdata_api_client.model.model_document import ModelDocument
from bimdata_api_client.model.model_serializer_without_children import ModelSerializerWithoutChildren
from bimdata_api_client.model.user import User
from bimdata_api_client.model.xkt_file import XktFile
globals()['Document'] = Document
globals()['ModelDocument'] = ModelDocument
globals()['ModelSerializerWithoutChildren'] = ModelSerializerWithoutChildren
globals()['User'] = User
globals()['XktFile'] = XktFile
Expand Down
330 changes: 330 additions & 0 deletions bimdata_api_client/model/model_document.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,330 @@
"""
BIMData API
BIMData API is a tool to interact with your models stored on BIMData’s servers. Through the API, you can manage your projects, the clouds, upload your IFC files and manage them through endpoints. # noqa: E501
The version of the OpenAPI document: v1 (v1)
Contact: [email protected]
Generated by: https://openapi-generator.tech
"""


import re # noqa: F401
import sys # noqa: F401

from bimdata_api_client.model_utils import ( # noqa: F401
ApiTypeError,
ModelComposed,
ModelNormal,
ModelSimple,
cached_property,
change_keys_js_to_python,
convert_js_args_to_python_args,
date,
datetime,
file_type,
none_type,
validate_get_composed_info,
OpenApiModel
)
from bimdata_api_client.exceptions import ApiAttributeError



class ModelDocument(ModelNormal):
"""NOTE: This class is auto generated by OpenAPI Generator.
Ref: https://openapi-generator.tech
Do not edit the class manually.
Attributes:
allowed_values (dict): The key is the tuple path to the attribute
and the for var_name this is (var_name,). The value is a dict
with a capitalized key describing the allowed value and an allowed
value. These dicts store the allowed enum values.
attribute_map (dict): The key is attribute name
and the value is json key in definition.
discriminator_value_class_map (dict): A dict to go from the discriminator
variable value to the discriminator class name.
validations (dict): The key is the tuple path to the attribute
and the for var_name this is (var_name,). The value is a dict
that stores validations for max_length, min_length, max_items,
min_items, exclusive_maximum, inclusive_maximum, exclusive_minimum,
inclusive_minimum, and regex.
additional_properties_type (tuple): A tuple of classes accepted
as additional properties values.
"""

allowed_values = {
('user_permission',): {
'1': 1,
'50': 50,
'100': 100,
},
}

validations = {
('name',): {
'max_length': 512,
},
('file_name',): {
'max_length': 512,
},
}

@cached_property
def additional_properties_type():
"""
This must be a method because a model may have properties that are
of type self, this must run after the class is loaded
"""
return (bool, date, datetime, dict, float, int, list, str, none_type,) # noqa: E501

_nullable = False

@cached_property
def openapi_types():
"""
This must be a method because a model may have properties that are
of type self, this must run after the class is loaded
Returns
openapi_types (dict): The key is attribute name
and the value is attribute type.
"""
return {
'id': (int,), # noqa: E501
'name': (str,), # noqa: E501
'file': (str,), # noqa: E501
'size': (int, none_type,), # noqa: E501
'created_at': (datetime,), # noqa: E501
'updated_at': (datetime,), # noqa: E501
'head_id': (int, none_type,), # noqa: E501
'is_head_version': (bool,), # noqa: E501
'history_count': (int, none_type,), # noqa: E501
'user_permission': (int,), # noqa: E501
'office_preview': (str, none_type,), # noqa: E501
'file_name': (str,), # noqa: E501
'description': (str, none_type,), # noqa: E501
}

@cached_property
def discriminator():
return None


attribute_map = {
'id': 'id', # noqa: E501
'name': 'name', # noqa: E501
'file': 'file', # noqa: E501
'size': 'size', # noqa: E501
'created_at': 'created_at', # noqa: E501
'updated_at': 'updated_at', # noqa: E501
'head_id': 'head_id', # noqa: E501
'is_head_version': 'is_head_version', # noqa: E501
'history_count': 'history_count', # noqa: E501
'user_permission': 'user_permission', # noqa: E501
'office_preview': 'office_preview', # noqa: E501
'file_name': 'file_name', # noqa: E501
'description': 'description', # noqa: E501
}

read_only_vars = {
'id', # noqa: E501
'size', # noqa: E501
'created_at', # noqa: E501
'updated_at', # noqa: E501
'head_id', # noqa: E501
'is_head_version', # noqa: E501
'history_count', # noqa: E501
'user_permission', # noqa: E501
'office_preview', # noqa: E501
}

_composed_schemas = {}

@classmethod
@convert_js_args_to_python_args
def _from_openapi_data(cls, id, name, file, size, created_at, updated_at, head_id, is_head_version, history_count, user_permission, office_preview, *args, **kwargs): # noqa: E501
"""ModelDocument - a model defined in OpenAPI
Args:
id (int):
name (str): Shown name of the file
file (str):
size (int, none_type): Size of the file.
created_at (datetime): Creation date
updated_at (datetime): Date of the last update
head_id (int, none_type): Document id of head version
is_head_version (bool): Document is a head of version or is owned by another document
history_count (int, none_type): Number of previous versions
user_permission (int): Aggregate of group user permissions and folder default permission
office_preview (str, none_type): Office files will be converted as pdf to provide a web preview. Supported extensions are .ppt, .pptx, .odp, .xls, .xlsx, .ods, .doc, .docx, .odt
Keyword Args:
_check_type (bool): if True, values for parameters in openapi_types
will be type checked and a TypeError will be
raised if the wrong type is input.
Defaults to True
_path_to_item (tuple/list): This is a list of keys or values to
drill down to the model in received_data
when deserializing a response
_spec_property_naming (bool): True if the variable names in the input data
are serialized names, as specified in the OpenAPI document.
False if the variable names in the input data
are pythonic names, e.g. snake case (default)
_configuration (Configuration): the instance to use when
deserializing a file_type parameter.
If passed, type conversion is attempted
If omitted no type conversion is done.
_visited_composed_classes (tuple): This stores a tuple of
classes that we have traveled through so that
if we see that class again we will not use its
discriminator again.
When traveling through a discriminator, the
composed schema that is
is traveled through is added to this set.
For example if Animal has a discriminator
petType and we pass in "Dog", and the class Dog
allOf includes Animal, we move through Animal
once using the discriminator, and pick Dog.
Then in Dog, we will make an instance of the
Animal class but this time we won't travel
through its discriminator because we passed in
_visited_composed_classes = (Animal,)
file_name (str): Full name of the file. [optional] # noqa: E501
description (str, none_type): Description of the file. [optional] # noqa: E501
"""

_check_type = kwargs.pop('_check_type', True)
_spec_property_naming = kwargs.pop('_spec_property_naming', False)
_path_to_item = kwargs.pop('_path_to_item', ())
_configuration = kwargs.pop('_configuration', None)
_visited_composed_classes = kwargs.pop('_visited_composed_classes', ())

self = super(OpenApiModel, cls).__new__(cls)

if args:
raise ApiTypeError(
"Invalid positional arguments=%s passed to %s. Remove those invalid positional arguments." % (
args,
self.__class__.__name__,
),
path_to_item=_path_to_item,
valid_classes=(self.__class__,),
)

self._data_store = {}
self._check_type = _check_type
self._spec_property_naming = _spec_property_naming
self._path_to_item = _path_to_item
self._configuration = _configuration
self._visited_composed_classes = _visited_composed_classes + (self.__class__,)

self.id = id
self.name = name
self.file = file
self.size = size
self.created_at = created_at
self.updated_at = updated_at
self.head_id = head_id
self.is_head_version = is_head_version
self.history_count = history_count
self.user_permission = user_permission
self.office_preview = office_preview
for var_name, var_value in kwargs.items():
if var_name not in self.attribute_map and \
self._configuration is not None and \
self._configuration.discard_unknown_keys and \
self.additional_properties_type is None:
# discard variable.
continue
setattr(self, var_name, var_value)
return self

required_properties = set([
'_data_store',
'_check_type',
'_spec_property_naming',
'_path_to_item',
'_configuration',
'_visited_composed_classes',
])

@convert_js_args_to_python_args
def __init__(self, name, file, *args, **kwargs): # noqa: E501
"""ModelDocument - a model defined in OpenAPI
name (str): Shown name of the file
file (str):
Keyword Args:
_check_type (bool): if True, values for parameters in openapi_types
will be type checked and a TypeError will be
raised if the wrong type is input.
Defaults to True
_path_to_item (tuple/list): This is a list of keys or values to
drill down to the model in received_data
when deserializing a response
_spec_property_naming (bool): True if the variable names in the input data
are serialized names, as specified in the OpenAPI document.
False if the variable names in the input data
are pythonic names, e.g. snake case (default)
_configuration (Configuration): the instance to use when
deserializing a file_type parameter.
If passed, type conversion is attempted
If omitted no type conversion is done.
_visited_composed_classes (tuple): This stores a tuple of
classes that we have traveled through so that
if we see that class again we will not use its
discriminator again.
When traveling through a discriminator, the
composed schema that is
is traveled through is added to this set.
For example if Animal has a discriminator
petType and we pass in "Dog", and the class Dog
allOf includes Animal, we move through Animal
once using the discriminator, and pick Dog.
Then in Dog, we will make an instance of the
Animal class but this time we won't travel
through its discriminator because we passed in
_visited_composed_classes = (Animal,)
file_name (str): Full name of the file. [optional] # noqa: E501
description (str, none_type): Description of the file. [optional] # noqa: E501
"""

_check_type = kwargs.pop('_check_type', True)
_spec_property_naming = kwargs.pop('_spec_property_naming', False)
_path_to_item = kwargs.pop('_path_to_item', ())
_configuration = kwargs.pop('_configuration', None)
_visited_composed_classes = kwargs.pop('_visited_composed_classes', ())

if args:
raise ApiTypeError(
"Invalid positional arguments=%s passed to %s. Remove those invalid positional arguments." % (
args,
self.__class__.__name__,
),
path_to_item=_path_to_item,
valid_classes=(self.__class__,),
)

self._data_store = {}
self._check_type = _check_type
self._spec_property_naming = _spec_property_naming
self._path_to_item = _path_to_item
self._configuration = _configuration
self._visited_composed_classes = _visited_composed_classes + (self.__class__,)

self.name = name
self.file = file
for var_name, var_value in kwargs.items():
if var_name not in self.attribute_map and \
self._configuration is not None and \
self._configuration.discard_unknown_keys and \
self.additional_properties_type is None:
# discard variable.
continue
setattr(self, var_name, var_value)
if var_name in self.read_only_vars:
raise ApiAttributeError(f"`{var_name}` is a read-only attribute. Use `from_openapi_data` to instantiate "
f"class with read only attributes.")
Loading

0 comments on commit feb0558

Please sign in to comment.