utils¶
Common utility functions.
These functions may be used in general throughout the OPTIMADE Gateway Python code.
clean_python_types(data, **dump_kwargs)
async
¶
Turn any types into MongoDB-friendly Python types.
Use model_dump()
method for Pydantic models.
Use value
property for Enums.
Turn tuples and sets into lists.
Source code in optimade_gateway/common/utils.py
18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
|
get_resource_attribute(resource, field, default=None, disambiguate=True)
¶
Return a resource's field's value
Get the field value no matter if the resource is a pydantic model or a Python dictionary.
Determine ambiguous field values and return them if desired (disambiguate
).
For example, if
"attributes.base_url"
is requested for a
LinksResource
it can be either a string, a
Link
model or a dictionary resembling the Link
model.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
resource
|
BaseModel | dict[str, Any] | None
|
The resource, from which to get the field value. |
required |
field
|
str
|
The resource field. This can be a dot-separated nested field, e.g.,
|
required |
default
|
Any
|
The default value to return if |
None
|
disambiguate
|
bool
|
Whether or not to "shortcut" a field value.
For example, for |
True
|
Returns:
Type | Description |
---|---|
Any
|
The resource's field's value. |
Source code in optimade_gateway/common/utils.py
56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 |
|