i|&SrSSKJr SSKrSSKJr SSKJrJrJrJ r SSK J r SSK J r JrJr SS KJr SS KJr SS jrSS jrSS jr\"S\ S9rSSSjjrSSjrSSjrg)z.Strategies for customizing subclass behaviors.) annotationsN)collect)AnyCallableTypeVarUnion) BaseConverter)AttributeOverridemake_dict_structure_fnmake_dict_unstructure_fn)already_generating) subclassesc[R"U5=(d UnUS0n[U5Hn[U5HnSX$'M M [ U5$N)typing get_originr_make_subclasses_treelist)cl cls_originseensclsscls \/var/www/html/ai-image-ml/venv/lib/python3.13/site-packages/cattrs/strategies/_subclasses.pyrrsS""2&,"J :D*%)#.DDJ/& :c[R"U5=(d Un[[U55n[U5n[ X4-5$)z?Whether the given class has subclasses from `given_subclasses`.)rrsetrbool)rgiven_subclassesractualgivens r_has_subclassesr#s>""2&,"J J' (F  !E  rc[[U55n[[U5[U5-5n[U5S:a [U$S$)Nr )tuplerrlenr)rgiven_subclasses_treeactual_subclass_tree class_trees r_get_union_typer*#sI !6r!:;s/037L3MMNJ #J1 45 >$>rC)boundc[5 UbU/UQ7nO[[U55nUc [XXT5 g[ XX45 g)a Configure the converter so that the attrs/dataclass `cl` is un/structured as if it was a union of itself and all its subclasses that are defined at the time when this strategy is applied. :param cl: A base `attrs` or `dataclass` class. :param converter: The `Converter` on which this strategy is applied. Do note that the strategy does not work for a :class:`cattrs.BaseConverter`. :param subclasses: A tuple of sublcasses whose ancestor is `cl`. If left as `None`, subclasses are detected using recursively the `__subclasses__` method of `cl` and its descendents. :param union_strategy: A callable of two arguments passed by position (`subclass_union`, `converter`) that defines the union strategy to use to disambiguate the subclasses union. If `None` (the default), the automatic unique field disambiguation is used which means that every single subclass participating in the union must have an attribute name that does not exist in any other sibling class. :param overrides: a mapping of `cl` attribute names to overrides (instantiated with :func:`cattrs.gen.override`) to customize un/structuring. .. versionadded:: 23.1.0 .. versionchanged:: 24.1.0 When overrides are not provided, hooks for individual classes are retrieved from the converter instead of generated with no overrides, using converter defaults. .. versionchanged:: 25.2.0 Slotted dataclasses work on Python 3.14 via :func:`cattrs.subclasses.subclasses`, which filters out duplicate classes caused by slotting. N)rr%r*_include_subclasses_without_union_strategy'_include_subclasses_with_union_strategy)r converterrunion_strategy overridesparent_subclass_trees rinclude_subclassesr4,sRH I "0Z0$%:2%>?2 /  0 ^ rcdUHn[X5nU4SjnUb[X40UD6n[X40UD6nO"URU5nUR U5nUc X4SSjjnOUR XCS9n UUUU 4SSjjnUUU4SSjjn UR XX5 URXZ5 M g)NcXL$rcls_cls r cls_is_cl=_include_subclasses_without_union_strategy..cls_is_clq : rcU"X5$rr7)val_r: _base_hooks r struct_hook?_include_subclasses_without_union_strategy..struct_hook}s !#++r)r2cLU"U5nXcLaU"X5$URX5$)z If val is disambiguated to the class `cl`, use its base hook. If val is disambiguated to a subclass, dispatch on its exact runtime type. ) structure)r?r@_cr:rA_dis_fndis_cls rrBrCs,!=%c//||C00rcbURULaU"U5$URXRS9$)z If val is an instance of the class `cl`, use the hook. If val is an instance of a subclass, dispatch on its exact runtime type. )unstructure_as) __class__ unstructure)r?rFr:rAs r unstruct_hookA_include_subclasses_without_union_strategy..unstruct_hooks/}}#!#&>>#mm>D Dr)r?dictreturnr)r?zparent_subclass_tree[0]rPrO)r*r r get_structure_hookget_unstructure_hook _get_dis_funcregister_structure_hook_funcregister_unstructure_hook_func) rr0r3r2subclass_unionr;base_struct_hookbase_unstruct_hookrBdis_fnrMs rr.r.`s#)B!   5bQyQ !9"!U9!U (;;B? !*!?!?!C   !.0 ,,,^,QF +  1 1 1*) E( E  E" ..yF00JC#rc lUVs/sHn[XA5(dMUPM nnU(dg0n0nUHsn[U5U1- [lUb[ X@40UD6n[ X@40UD6n O UR USS9nURUSS9n [5[lXU'XU'Mu [Un UR5HupKU4Sjn URX5 M UR5HupKU4Sjn URX5 M U"X5 UR U 5nURU 5n UHnU4Sjn URX5 [UV s/sHRn [[R"U 5=(d U [R"U5=(d U5(dMPU PMT sn 5n[!U5S:dM[UnU"X5 URU5n X4S SjjnURU U5 M gs snf![5[lf=fs sn f) aB This function is tricky because we're dealing with what is essentially a circular reference. We need to generate a structure hook for a class that is both: * specific for that particular class and its own fields * but should handle specific functions for all its descendants too Hence the dance with registering below. NF) cache_resultcXL$rr7r8s rr;:_include_subclasses_with_union_strategy..cls_is_clr=rcXL$rr7r8s rr;r]r=rcXL$rr7r8s rr;r]r=rcU"X5$rr7)payloadr@_u_ss rsh3_include_subclasses_with_union_strategy..shs '&r)rbrOrPr)r#rr working_setr r rRrQritemsrUrTr% issubclassrrr&)r0 union_classesr1r2rparent_classesoriginal_unstruct_hooksoriginal_struct_hooksrMrB final_unionhookr;crures rr/r/s."$1W=ROB4Vb=NW   *-]);rd)B& 3$ 8 T) T 4RPiP ) > >rPU > V '::2E:R -0U  *&3#$/b!!( &K+113!  00A 4*//1!  ..y? 2;*22;?M..{;K "  00J' &Af//27a9J9J29N9TRTU&   z?Q j!A 1 (#66q9K() '  2 29b A-]X(.1U  *D s#HHr|s4" 00&UU,#  ?  C}% +/5959 1  1 1 (1 3 1 3 1  1 hHKHK+HK3 HKVUBUB#UB,UB3 UBr