pyVHDLModel.Base

This module contains parts of an abstract document language model for VHDL.

Base-classes for the VHDL language model.

Variables

ExpressionUnion

Classes

Direction: An enumeration representing a direction in a range (to or downto).
Mode: A Mode is an enumeration. It represents the direction of data exchange (in, out, …) for objects in
ModelEntity: ModelEntity is the base-class for all classes in the VHDL language model, except for mixin classes (see multiple
NamedEntityMixin: A NamedEntityMixin is a mixin class for all VHDL entities that have identifiers.
MultipleNamedEntityMixin: A MultipleNamedEntityMixin is a mixin class for all VHDL entities that declare multiple instances at once by
LabeledEntityMixin: A LabeledEntityMixin is a mixin class for all VHDL entities that can have labels.
DocumentedEntityMixin: A DocumentedEntityMixin is a mixin class for all VHDL entities that can have an associated documentation.
ConditionalMixin: A BaseConditional is a mixin-class for all statements with a condition.
BranchMixin: A BaseBranch is a mixin-class for all statements with branches.
ConditionalBranchMixin: A BaseBranch is a mixin-class for all branch statements with a condition.
IfBranchMixin: A BaseIfBranch is a mixin-class for all if-branches.
ElsifBranchMixin: A BaseElsifBranch is a mixin-class for all elsif-branches.
ElseBranchMixin: A BaseElseBranch is a mixin-class for all else-branches.
ReportStatementMixin: A MixinReportStatement is a mixin-class for all report and assert statements.
AssertStatementMixin: A MixinAssertStatement is a mixin-class for all assert statements.
BaseChoice: A Choice is a base-class for all choices.
BaseCase: A Case is a base-class for all cases.
Range: ModelEntity is the base-class for all classes in the VHDL language model, except for mixin classes (see multiple
WaveformElement: ModelEntity is the base-class for all classes in the VHDL language model, except for mixin classes (see multiple

Variables

pyVHDLModel.Base.ExpressionUnion

typing.Union[ForwardRef('BaseExpression'), ForwardRef('QualifiedExpression'), ForwardRef('FunctionCall'), ForwardRef('TypeConversion'), ForwardRef('Literal')]

alias of BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal

Classes

class pyVHDLModel.Base.Direction(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)[source]

An enumeration representing a direction in a range (to or downto).

Inheritance

To = 0: Ascending direction

DownTo = 1: Descending direction

__str__()[source]

Formats the direction to to or downto.

Returns:: Formatted direction.

class pyVHDLModel.Base.Mode(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)[source]

A Mode is an enumeration. It represents the direction of data exchange (in, out, …) for objects in generic, port or parameter lists.

In case no mode is defined, Default is used, so the mode is inferred from context.

Inheritance

Default = 0: Mode not defined, thus it’s context dependent.

In = 1: Input

Out = 2: Output

InOut = 3: Bi-directional

Buffer = 4: Buffered output

Linkage = 5: undocumented

__str__()[source]

Formats the direction.

Returns:: Formatted direction.

class pyVHDLModel.Base.ModelEntity[source]

ModelEntity is the base-class for all classes in the VHDL language model, except for mixin classes (see multiple inheritance) and enumerations.

Each entity in this model has a reference to its parent entity. Therefore, a protected variable _parent is available and a readonly property Parent.

Inheritance

__init__()[source]: Initializes a VHDL model entity.

_parent: ModelEntity: Reference to a parent entity in the model.

property Parent: ModelEntity

Returns a reference to the parent entity.

Returns:: Parent entity.

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.NamedEntityMixin(identifier)[source]

A NamedEntityMixin is a mixin class for all VHDL entities that have identifiers.

Protected variables _identifier and _normalizedIdentifier are available to derived classes as well as two readonly properties Identifier and NormalizedIdentifier for public access.

Inheritance

Parameters:: identifier (str)

__init__(identifier)[source]

Initializes a named entity.

Parameters:: identifier (str) – Identifier (name) of the model entity.

_identifier: str: The identifier of a model entity.

_normalizedIdentifier: str: The normalized (lower case) identifier of a model entity.

property Identifier: str

Returns a model entity’s identifier (name).

Returns:: Name of a model entity.

property NormalizedIdentifier: str

Returns a model entity’s normalized identifier (lower case name).

Returns:: Normalized name of a model entity.

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.MultipleNamedEntityMixin(identifiers)[source]

A MultipleNamedEntityMixin is a mixin class for all VHDL entities that declare multiple instances at once by defining multiple identifiers.

Protected variables _identifiers and _normalizedIdentifiers are available to derived classes as well as two readonly properties Identifiers and NormalizedIdentifiers for public access.

Inheritance

Parameters:: identifiers (Iterable[str])

__init__(identifiers)[source]

Initializes a multiple-named entity.

Parameters:: identifiers (Iterable[str]) – Sequence of identifiers (names) of the model entity.

_identifiers: Tuple[str]: A list of identifiers.

_normalizedIdentifiers: Tuple[str]: A list of normalized (lower case) identifiers.

property Identifiers: Tuple[str]

Returns a model entity’s tuple of identifiers (names).

Returns:: Tuple of identifiers.

property NormalizedIdentifiers: Tuple[str]

Returns a model entity’s tuple of normalized identifiers (lower case names).

Returns:: Tuple of normalized identifiers.

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.LabeledEntityMixin(label)[source]

A LabeledEntityMixin is a mixin class for all VHDL entities that can have labels.

protected variables _label and _normalizedLabel are available to derived classes as well as two readonly properties Label and NormalizedLabel for public access.

Inheritance

Parameters:: label (str | None)

__init__(label)[source]

Initializes a labeled entity.

Parameters:: label (Optional[str]) – Label of the model entity.

_label: Optional[str]: The label of a model entity.

_normalizedLabel: Optional[str]: The normalized (lower case) label of a model entity.

property Label: str | None

Returns a model entity’s label.

Returns:: Label of a model entity.

property NormalizedLabel: str | None

Returns a model entity’s normalized (lower case) label.

Returns:: Normalized label of a model entity.

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.DocumentedEntityMixin(documentation)[source]

A DocumentedEntityMixin is a mixin class for all VHDL entities that can have an associated documentation.

A protected variable _documentation is available to derived classes as well as a readonly property Documentation for public access.

Inheritance

Parameters:: documentation (str | None)

__init__(documentation)[source]

Initializes a documented entity.

Parameters:: documentation (Optional[str]) – Documentation of a model entity.

_documentation: Optional[str]: The associated documentation of a model entity.

property Documentation: str | None

Returns a model entity’s associated documentation.

Returns:: Associated documentation of a model entity.

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.ConditionalMixin(condition=None)[source]

A BaseConditional is a mixin-class for all statements with a condition.

Inheritance

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

__init__(condition=None)[source]

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.BranchMixin[source]

A BaseBranch is a mixin-class for all statements with branches.

Inheritance

__init__()[source]

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.ConditionalBranchMixin(condition)[source]

A BaseBranch is a mixin-class for all branch statements with a condition.

Inheritance

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

__init__(condition)[source]

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.IfBranchMixin(condition)[source]

A BaseIfBranch is a mixin-class for all if-branches.

Inheritance

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

__init__(condition)

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class pyVHDLModel.Base.ElsifBranchMixin(condition)[source]

A BaseElsifBranch is a mixin-class for all elsif-branches.

Inheritance

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

__init__(condition)

Parameters:: condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class pyVHDLModel.Base.ElseBranchMixin[source]

A BaseElseBranch is a mixin-class for all else-branches.

Inheritance

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

__init__()

class pyVHDLModel.Base.ReportStatementMixin(message=None, severity=None)[source]

A MixinReportStatement is a mixin-class for all report and assert statements.

Inheritance

Parameters:

message (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
severity (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

__init__(message=None, severity=None)[source]

Parameters:

message (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
severity (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.AssertStatementMixin(condition, message=None, severity=None)[source]

A MixinAssertStatement is a mixin-class for all assert statements.

Inheritance

Parameters:

condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
message (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
severity (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

__init__(condition, message=None, severity=None)[source]

Parameters:

condition (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
message (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
severity (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

class pyVHDLModel.Base.BaseChoice[source]

A Choice is a base-class for all choices.

Inheritance

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

property Parent: ModelEntity

Returns a reference to the parent entity.

Returns:: Parent entity.

__init__(): Initializes a VHDL model entity.

_parent: ModelEntity: Reference to a parent entity in the model.

class pyVHDLModel.Base.BaseCase[source]

A Case is a base-class for all cases.

Inheritance

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

property Parent: ModelEntity

Returns a reference to the parent entity.

Returns:: Parent entity.

__init__(): Initializes a VHDL model entity.

_parent: ModelEntity: Reference to a parent entity in the model.

class pyVHDLModel.Base.Range(leftBound, rightBound, direction)[source]

Inheritance

Parameters:

leftBound (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
rightBound (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
direction (Direction)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

property Parent: ModelEntity

Returns a reference to the parent entity.

Returns:: Parent entity.

__init__(leftBound, rightBound, direction)[source]

Initializes a VHDL model entity.

Parameters:

leftBound (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
rightBound (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
direction (Direction)

_parent: ModelEntity: Reference to a parent entity in the model.

__str__()[source]

Return str(self).

Return type:: str

class pyVHDLModel.Base.WaveformElement(expression, after=None)[source]

Inheritance

Parameters:

expression (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
after (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)

class property HasClassAttributes: bool

Check if class has Attributes.

Returns:: True, if the class has Attributes.

class property HasMethodAttributes: bool

Check if class has any method with Attributes.

Returns:: True, if the class has any method with Attributes.

property Parent: ModelEntity

Returns a reference to the parent entity.

Returns:: Parent entity.

_parent: ModelEntity: Reference to a parent entity in the model.

__init__(expression, after=None)[source]

Initializes a VHDL model entity.

Parameters:

expression (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)
after (BaseExpression | QualifiedExpression | FunctionCall | TypeConversion | Literal)