xsdata.codegen.handlers package¶
Submodules¶
- xsdata.codegen.handlers.attribute_enum_union module
- xsdata.codegen.handlers.attribute_group module
- xsdata.codegen.handlers.attribute_implied module
- xsdata.codegen.handlers.attribute_merge module
- xsdata.codegen.handlers.attribute_mismatch module
- xsdata.codegen.handlers.attribute_substitution module
- xsdata.codegen.handlers.attribute_type module
- xsdata.codegen.handlers.class_extension module
Module contents¶
-
class
xsdata.codegen.handlers.
AttributeGroupHandler
(container)[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Replace attribute groups with the source class attributes.
- Parameters
container (
ContainerInterface
) –
-
container
: ContainerInterface¶
-
process
(target)[source]¶ Iterate over all group attributes and apply handler logic.
Group attributes can refer to attributes or other group attributes, repeat until there is no group attribute left.
- Parameters
target (
Class
) –
-
process_attribute
(target, attr)[source]¶ Find the source class the attribute refers to and copy its attributes to the target class.
- Raises
AnalyzerValueError – if source class is not found.
- Parameters
-
class
xsdata.codegen.handlers.
AttributeTypeHandler
(container, dependencies=<factory>)[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Minimize class attributes complexity by filtering and flattening types.
- Parameters
container (
ContainerInterface
) –dependencies (
Dict
) –
-
container
: ContainerInterface¶
-
dependencies
: Dict¶
-
process
(target)[source]¶ Process the given class attributes and their types.
Ensure all types are unique.
- Parameters
target (
Class
) –
-
process_type
(target, attr, attr_type)[source]¶ Process attribute type, split process for xml schema and user defined types.
Ignore forward references to inner classes.
-
classmethod
process_native_type
(attr, attr_type)[source]¶ Reset attribute type if the attribute has a pattern restriction as they are not yet supported.
-
find_dependency
(target, attr_type)[source]¶ Find dependency for the given attribute.
- Avoid conflicts by search in order:
Non element/complexType
Non abstract
anything
-
process_dependency_type
(target, attr, attr_type)[source]¶ Process user defined attribute types, split process between complex and simple types.
Reset absent attribute types with a warning.
Complex Type: xs:Element and xs:ComplexType Simple stype: the rest
-
classmethod
process_simple_dependency
(source, target, attr, attr_type)[source]¶ Replace the given attribute type with the types of the single field source class.
Ignore enumerations and gracefully handle dump types with no attributes.
-
is_circular_dependency
(source, target, seen)[source]¶ Check if any source dependencies recursively match the target class.
-
class
xsdata.codegen.handlers.
AttributeMergeHandler
[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Merge same type attributes and their restrictions.
-
class
xsdata.codegen.handlers.
AttributeEnumUnionHandler
(container)[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Convert classes with a single attribute derived from xs:union where all types are enumerations to standalone enumeration.
- Parameters
container (
ContainerInterface
) –
-
container
: ContainerInterface¶
-
class
xsdata.codegen.handlers.
ClassExtensionHandler
(container)[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Reduce class extensions by copying or creating new attributes.
- Parameters
container (
ContainerInterface
) –
-
INCLUDES_NONE
= 0¶
-
INCLUDES_SOME
= 1¶
-
INCLUDES_ALL
= 2¶
-
container
: ContainerInterface¶
-
process
(target)[source]¶ Iterate and process the target class’s extensions in reverser order.
The reverse order is necessary in order to maintain the correct attributes ordering during cloning.
- Parameters
target (
Class
) –
-
process_extension
(target, extension)[source]¶ Slit the process of extension into schema data types and user defined types.
-
classmethod
process_native_extension
(target, extension)[source]¶ Native type flatten handler.
In case of enumerations copy the native data type to all enum members, otherwise create a default text value with the extension attributes.
-
classmethod
process_simple_extension
(source, target, ext)[source]¶ Simple flatten extension handler for common classes eg SimpleType, Restriction.
- Steps:
If target is source: drop the extension.
If source is enumeration and target isn’t create default value attribute.
If both source and target are enumerations copy all attributes.
If both source and target are not enumerations copy all attributes.
If target is enumeration: drop the extension.
-
classmethod
process_complex_extension
(source, target, ext)[source]¶ Complex flatten extension handler for primary classes eg ComplexType, Element.
- Drop extension when:
source includes all target attributes
- Copy all attributes when:
source includes some of the target attributes
source has suffix attribute and target has at least one attribute
target has at least one suffix attribute
source is marked as strict type
-
find_dependency
(target, attr_type)[source]¶ Find dependency for the given extension type with priority.
Search priority: xs:SimpleType > xs:ComplexType
-
classmethod
compare_attributes
(source, target)[source]¶ Compare the attributes of the two classes and return whether the source includes all, some or none of the target attributes.
-
class
xsdata.codegen.handlers.
AttributeImpliedHandler
[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Add attributes to classes that are implied from the class other properties.
-
class
xsdata.codegen.handlers.
AttributeMismatchHandler
[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Normalize attributes that can not coexist together in the same class by moving them to an existing inner class or to a new one.
-
class
xsdata.codegen.handlers.
AttributeSubstitutionHandler
(container)[source]¶ Bases:
xsdata.codegen.mixins.HandlerInterface
Apply substitution attributes to the given class recursively.
- Parameters
container (
ContainerInterface
) –
-
container
: ContainerInterface¶
-
substitutions
: Optional[Dict[lxml.etree.QName, List[xsdata.codegen.models.Attr]]] = None¶
-
process
(target)[source]¶ Search and process attributes not derived from xs:enumeration or xs:any.
Build the substitutions map if it’s not initialized yet.
- Parameters
target (
Class
) –
-
process_attribute
(target, attr)[source]¶ Check if the given attribute matches any substitution class in order to clone it’s attributes to the target class.
The cloned attributes are placed below the attribute the are supposed to substitute.