Skip to content

Tag Create Dto

immichpy.client.generated.models.tag_create_dto.TagCreateDto pydantic-model

Bases: BaseModel

TagCreateDto

Show JSON schema:
{
  "description": "TagCreateDto",
  "properties": {
    "color": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Tag color (hex)",
      "title": "Color"
    },
    "name": {
      "description": "Tag name",
      "title": "Name",
      "type": "string"
    },
    "parentId": {
      "anyOf": [
        {
          "format": "uuid",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Parent tag ID",
      "title": "Parentid"
    }
  },
  "required": [
    "name"
  ],
  "title": "TagCreateDto",
  "type": "object"
}

Config:

  • validate_by_name: True
  • validate_by_alias: True
  • validate_assignment: True
  • protected_namespaces: ()

Fields:

Validators:

color pydantic-field

color: Optional[Annotated[str, Field(strict=True)]] = None

Tag color (hex)

name pydantic-field

name: Annotated[str, Field(strict=True)]

Tag name

parent_id pydantic-field

parent_id: Optional[UUID] = None

Parent tag ID

color_validate_regular_expression pydantic-validator

color_validate_regular_expression(value)

Validates the regular expression

Source code in immichpy/client/generated/models/tag_create_dto.py
42
43
44
45
46
47
48
49
50
51
52
53
54
@field_validator("color", mode="before")
def color_validate_regular_expression(cls, value):
    """Validates the regular expression"""
    if value is None:
        return value

    if isinstance(value, str) and not re.match(
        r"^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$", value
    ):
        raise ValueError(
            r"must validate the regular expression /^#?([0-9A-Fa-f]{3}|[0-9A-Fa-f]{4}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/"
        )
    return value

from_dict classmethod

from_dict(obj: Optional[Dict[str, Any]]) -> Optional[Self]

Create an instance of TagCreateDto from a dict

Source code in immichpy/client/generated/models/tag_create_dto.py
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
@classmethod
def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
    """Create an instance of TagCreateDto from a dict"""
    if obj is None:
        return None

    if not isinstance(obj, dict):
        return cls.model_validate(obj)

    _obj = cls.model_validate(
        {
            "color": obj.get("color"),
            "name": obj.get("name"),
            "parentId": obj.get("parentId"),
        }
    )
    return _obj

from_json classmethod

from_json(json_str: str) -> Optional[Self]

Create an instance of TagCreateDto from a JSON string

Source code in immichpy/client/generated/models/tag_create_dto.py
93
94
95
96
@classmethod
def from_json(cls, json_str: str) -> Optional[Self]:
    """Create an instance of TagCreateDto from a JSON string"""
    return cls.from_dict(json.loads(json_str))

name_validate_regular_expression pydantic-validator

name_validate_regular_expression(value)

Validates the regular expression

Source code in immichpy/client/generated/models/tag_create_dto.py
56
57
58
59
60
61
@field_validator("name", mode="before")
def name_validate_regular_expression(cls, value):
    """Validates the regular expression"""
    if isinstance(value, str) and not re.match(r"^[^\/]*$", value):
        raise ValueError(r"must validate the regular expression /^[^\/]*$/")
    return value

parent_id_validate_regular_expression pydantic-validator

parent_id_validate_regular_expression(value)

Validates the regular expression

Source code in immichpy/client/generated/models/tag_create_dto.py
63
64
65
66
67
68
69
70
71
72
73
74
75
76
@field_validator("parent_id", mode="before")
def parent_id_validate_regular_expression(cls, value):
    """Validates the regular expression"""
    if value is None:
        return value

    if isinstance(value, str) and not re.match(
        r"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$",
        value,
    ):
        raise ValueError(
            r"must validate the regular expression /^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12})$/"
        )
    return value

to_dict

to_dict() -> Dict[str, Any]

Return the dictionary representation of the model using alias.

This has the following differences from calling pydantic's self.model_dump(by_alias=True):

  • None is only added to the output dict for nullable fields that were set at model initialization. Other fields with value None are ignored.
Source code in immichpy/client/generated/models/tag_create_dto.py
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
def to_dict(self) -> Dict[str, Any]:
    """Return the dictionary representation of the model using alias.

    This has the following differences from calling pydantic's
    `self.model_dump(by_alias=True)`:

    * `None` is only added to the output dict for nullable fields that
      were set at model initialization. Other fields with value `None`
      are ignored.
    """
    excluded_fields: Set[str] = set([])

    _dict = self.model_dump(
        by_alias=True,
        exclude=excluded_fields,
        exclude_none=True,
    )
    # set to None if color (nullable) is None
    # and model_fields_set contains the field
    if self.color is None and "color" in self.model_fields_set:
        _dict["color"] = None

    # set to None if parent_id (nullable) is None
    # and model_fields_set contains the field
    if self.parent_id is None and "parent_id" in self.model_fields_set:
        _dict["parentId"] = None

    return _dict

to_json

to_json() -> str

Returns the JSON representation of the model using alias

Source code in immichpy/client/generated/models/tag_create_dto.py
89
90
91
def to_json(self) -> str:
    """Returns the JSON representation of the model using alias"""
    return json.dumps(to_jsonable_python(self.to_dict()))

to_str

to_str() -> str

Returns the string representation of the model using alias

Source code in immichpy/client/generated/models/tag_create_dto.py
85
86
87
def to_str(self) -> str:
    """Returns the string representation of the model using alias"""
    return pprint.pformat(self.model_dump(by_alias=True))