[Dependabot]: Update twine requirement from ~=6.2 to ~=7.0

dist/requirements.txt

@@ -1,2 +1,2 @@
 wheel ~= 0.47.0
-twine ~= 6.2
+twine ~= 7.0

doc/Dependency.rst

@@ -23,7 +23,7 @@ pyVHDLModel Package
 +--------------------------------------------------------+-------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
 | **Package**                                            | **Version** | **License**                                                                              | **Dependencies**                                                                                                                |
 +========================================================+=============+==========================================================================================+=================================================================================================================================+
-| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__ | ≥8.15       | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/master/LICENSE.txt>`__ | *None*                                                                                                                          |
+| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__ | ≥8.17       | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/master/LICENSE.txt>`__ | *None*                                                                                                                          |
 +--------------------------------------------------------+-------------+------------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
 
 
@@ -57,7 +57,7 @@ the mandatory dependencies too.
 +---------------------------------------------------------------------+-------------+----------------------------------------------------------------------------------------+----------------------+
 | `Coverage <https://GitHub.com/nedbat/coveragepy>`__                 | ≥7.15       | `Apache License, 2.0 <https://GitHub.com/nedbat/coveragepy/blob/master/LICENSE.txt>`__ | *Not yet evaluated.* |
 +---------------------------------------------------------------------+-------------+----------------------------------------------------------------------------------------+----------------------+
-| `mypy <https://GitHub.com/python/mypy>`__                           | ≥2.1        | `MIT <https://GitHub.com/python/mypy/blob/master/LICENSE>`__                           | *Not yet evaluated.* |
+| `mypy <https://GitHub.com/python/mypy>`__                           | ≥2.3        | `MIT <https://GitHub.com/python/mypy/blob/master/LICENSE>`__                           | *Not yet evaluated.* |
 +---------------------------------------------------------------------+-------------+----------------------------------------------------------------------------------------+----------------------+
 | `typing-extensions <https://GitHub.com/python/typing_extensions>`__ | ≥4.16       | `PSF-2.0 <https://github.com/python/typing_extensions/blob/main/LICENSE>`__            | *Not yet evaluated.* |
 +---------------------------------------------------------------------+-------------+----------------------------------------------------------------------------------------+----------------------+
@@ -89,19 +89,19 @@ the mandatory dependencies too.
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 | **Package**                                                                                     | **Version**  | **License**                                                                                              | **Dependencies**     |
 +=================================================================================================+==============+==========================================================================================================+======================+
-| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__                                          | ≥8.15        | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/main/LICENSE.md>`__                    | *None*               |
+| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__                                          | ≥8.17        | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/main/LICENSE.md>`__                    | *None*               |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 | `Sphinx <https://GitHub.com/sphinx-doc/sphinx>`__                                               | ≥9.1         | `BSD 3-Clause <https://GitHub.com/sphinx-doc/sphinx/blob/master/LICENSE>`__                              | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 | `sphinx_rtd_theme <https://GitHub.com/readthedocs/sphinx_rtd_theme>`__                          | ≥3.1         | `MIT <https://GitHub.com/readthedocs/sphinx_rtd_theme/blob/master/LICENSE>`__                            | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
-| `sphinxcontrib-mermaid <https://GitHub.com/mgaitan/sphinxcontrib-mermaid>`__                    | ≥2.0         | `BSD <https://GitHub.com/mgaitan/sphinxcontrib-mermaid/blob/master/LICENSE.rst>`__                       | *Not yet evaluated.* |
+| `sphinxcontrib-mermaid <https://GitHub.com/mgaitan/sphinxcontrib-mermaid>`__                    | ≥2.1         | `BSD <https://GitHub.com/mgaitan/sphinxcontrib-mermaid/blob/master/LICENSE.rst>`__                       | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 | `autoapi <https://GitHub.com/carlos-jenkins/autoapi>`__                                         | ≥2.0.1       | `Apache License, 2.0 <https://GitHub.com/carlos-jenkins/autoapi/blob/master/LICENSE>`__                  | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 | !! `sphinx_fontawesome <https://GitHub.com/fraoustin/sphinx_fontawesome>`__                     | ≥0.0.6       | `GPL 2.0 <https://GitHub.com/fraoustin/sphinx_fontawesome/blob/master/LICENSE>`__                        | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
-| `sphinx_autodoc_typehints <https://GitHub.com/agronholm/sphinx-autodoc-typehints>`__            | ≥3.12        | `MIT <https://GitHub.com/agronholm/sphinx-autodoc-typehints/blob/master/LICENSE>`__                      | *Not yet evaluated.* |
+| `sphinx_autodoc_typehints <https://GitHub.com/agronholm/sphinx-autodoc-typehints>`__            | ≥3.13        | `MIT <https://GitHub.com/agronholm/sphinx-autodoc-typehints/blob/master/LICENSE>`__                      | *Not yet evaluated.* |
 +-------------------------------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+----------------------+
 
 
@@ -129,7 +129,7 @@ install the mandatory dependencies too.
 +----------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
 | **Package**                                                                | **Version**  | **License**                                                                                              | **Dependencies**                                                                                                                                     |
 +============================================================================+==============+==========================================================================================================+======================================================================================================================================================+
-| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__                     | ≥8.15        | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/main/LICENSE.md>`__                    | *None*                                                                                                                                               |
+| `pyTooling <https://GitHub.com/pyTooling/pyTooling>`__                     | ≥8.17        | `Apache License, 2.0 <https://GitHub.com/pyTooling/pyTooling/blob/main/LICENSE.md>`__                    | *None*                                                                                                                                               |
 +----------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+
 | `wheel <https://GitHub.com/pypa/wheel>`__                                  | ≥0.47        | `MIT <https://github.com/pypa/wheel/blob/main/LICENSE.txt>`__                                            | *Not yet evaluated.*                                                                                                                                 |
 +----------------------------------------------------------------------------+--------------+----------------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+

doc/LanguageModel/InterfaceItems.rst

@@ -10,7 +10,7 @@ Interface items are used in generic, port and parameter declarations.
 
 .. rubric:: Class Hierarchy
 
-.. inheritance-diagram:: pyVHDLModel.SyntaxModel.GenericConstantInterfaceItem pyVHDLModel.SyntaxModel.GenericTypeInterfaceItem pyVHDLModel.SyntaxModel.GenericProcedureInterfaceItem pyVHDLModel.SyntaxModel.GenericFunctionInterfaceItem pyVHDLModel.SyntaxModel.PortSignalInterfaceItem pyVHDLModel.SyntaxModel.ParameterConstantInterfaceItem pyVHDLModel.SyntaxModel.ParameterVariableInterfaceItem pyVHDLModel.SyntaxModel.ParameterSignalInterfaceItem pyVHDLModel.SyntaxModel.ParameterFileInterfaceItem
+.. inheritance-diagram:: pyVHDLModel.SyntaxModel.GenericConstantInterfaceItem pyVHDLModel.SyntaxModel.GenericTypeInterfaceItem pyVHDLModel.SyntaxModel.GenericProcedureInterfaceItem pyVHDLModel.SyntaxModel.GenericFunctionInterfaceItem pyVHDLModel.SyntaxModel.PortSimpleSignalInterfaceItem pyVHDLModel.SyntaxModel.PortViewSignalInterfaceItem pyVHDLModel.SyntaxModel.ParameterConstantInterfaceItem pyVHDLModel.SyntaxModel.ParameterVariableInterfaceItem pyVHDLModel.SyntaxModel.ParameterSimpleSignalInterfaceItem pyVHDLModel.SyntaxModel.ParameterViewSignalInterfaceItem pyVHDLModel.SyntaxModel.ParameterFileInterfaceItem
    :parts: 1
 
 
@@ -136,16 +136,25 @@ Port Interface Item
 PortSignalInterfaceItem
 -----------------------
 
+``PortSignalInterfaceItem`` is now an abstract base-class for :class:`PortSimpleSignalInterfaceItem`
+(``port (p : in bit);``) and :class:`PortViewSignalInterfaceItem` (``port (p : view MyView);``,
+VHDL-2019 mode views) - see below. It is not meant to be instantiated directly.
+
+.. _vhdlmodel-portsimplesignal:
+
+PortSimpleSignalInterfaceItem
+------------------------------
+
 .. todo::
 
    Write documentation.
 
-**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.PortSignalInterfaceItem`:
+**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.PortSimpleSignalInterfaceItem`:
 
 .. code-block:: Python
 
    @export
-   class PortSignalInterfaceItem(Signal, PortInterfaceItem):
+   class PortSimpleSignalInterfaceItem(PortSignalInterfaceItem):
      # inherited from ModelEntity
      @property
      def Parent(self) -> ModelEntity:
@@ -162,11 +171,43 @@ PortSignalInterfaceItem
      @property
      def DefaultExpression(self) -> BaseExpression:
 
-     # inherited from InterfaceItem
+     # inherited from InterfaceItemWithModeMixin
      @property
      def Mode(self) -> Mode:
 
 
+.. _vhdlmodel-portviewsignal:
+
+PortViewSignalInterfaceItem
+-----------------------------
+
+.. todo::
+
+   Write documentation.
+
+**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.PortViewSignalInterfaceItem`:
+
+.. code-block:: Python
+
+   @export
+   class PortViewSignalInterfaceItem(PortSignalInterfaceItem):
+     # inherited from ModelEntity
+     @property
+     def Parent(self) -> ModelEntity:
+
+     # inherited from NamedEntity
+     @property
+     def Name(self) -> str:
+
+     # inherited from Object; aliased as ModeViewIndication (a mode view reference occupies the
+     # same structural position as an ordinary subtype indication)
+     @property
+     def Subtype(self) -> Symbol:
+
+     @property
+     def ModeViewIndication(self) -> ModeViewSymbol:
+
+
 
 .. _vhdlmodel-parameters:
 
@@ -252,16 +293,26 @@ ParameterVariableInterfaceItem
 ParameterSignalInterfaceItem
 ----------------------------
 
+``ParameterSignalInterfaceItem`` is now an abstract base-class for
+:class:`ParameterSimpleSignalInterfaceItem` (``procedure p(signal s : in bit);``) and
+:class:`ParameterViewSignalInterfaceItem` (``procedure p(signal s : view MyView);``, VHDL-2019 mode
+views) - see below. It is not meant to be instantiated directly.
+
+.. _vhdlmodel-parametersimplesignal:
+
+ParameterSimpleSignalInterfaceItem
+-----------------------------------
+
 .. todo::
 
    Write documentation.
 
-**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.ParameterSignalInterfaceItem`:
+**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.ParameterSimpleSignalInterfaceItem`:
 
 .. code-block:: Python
 
    @export
-   class ParameterSignalInterfaceItem(Signal, ParameterInterfaceItem):
+   class ParameterSimpleSignalInterfaceItem(ParameterSignalInterfaceItem):
      # inherited from ModelEntity
      @property
      def Parent(self) -> ModelEntity:
@@ -278,11 +329,43 @@ ParameterSignalInterfaceItem
      @property
      def DefaultExpression(self) -> BaseExpression:
 
-     # inherited from InterfaceItem
+     # inherited from InterfaceItemWithModeMixin
      @property
      def Mode(self) -> Mode:
 
 
+.. _vhdlmodel-parameterviewsignal:
+
+ParameterViewSignalInterfaceItem
+-----------------------------------
+
+.. todo::
+
+   Write documentation.
+
+**Condensed definition of class** :class:`~pyVHDLModel.SyntaxModel.ParameterViewSignalInterfaceItem`:
+
+.. code-block:: Python
+
+   @export
+   class ParameterViewSignalInterfaceItem(ParameterSignalInterfaceItem):
+     # inherited from ModelEntity
+     @property
+     def Parent(self) -> ModelEntity:
+
+     # inherited from NamedEntity
+     @property
+     def Name(self) -> str:
+
+     # inherited from Object; aliased as ModeViewIndication (a mode view reference occupies the
+     # same structural position as an ordinary subtype indication)
+     @property
+     def Subtype(self) -> Symbol:
+
+     @property
+     def ModeViewIndication(self) -> ModeViewSymbol:
+
+
 
 .. _vhdlmodel-parameterfile:
 

doc/requirements.txt

@@ -9,9 +9,9 @@ docutils_stubs ~= 0.0.22
 sphinx_rtd_theme ~= 3.1
 
 # Sphinx Extenstions
-sphinxcontrib-mermaid ~= 2.0
+sphinxcontrib-mermaid ~= 2.1
 autoapi >= 2.0.1
 sphinx_design ~= 0.7.0
 sphinx-copybutton >= 0.5.2
-sphinx_autodoc_typehints ~= 3.12
-sphinx_reports ~= 0.11.0
+sphinx_autodoc_typehints ~= 3.13
+sphinx_reports ~= 0.11.1

pyVHDLModel/Association.py

@@ -57,12 +57,24 @@
 class AssociationItem(ModelEntity):
 	"""
 	A base-class for all association items.
+
+	.. seealso::
+
+	   * :class:`Generic association item <pyVHDLModel.Association.GenericAssociationItem>`
+	   * :class:`Port association item <pyVHDLModel.Association.PortAssociationItem>`
+	   * :class:`Parameter association item <pyVHDLModel.Association.ParameterAssociationItem>`
 	"""
 
-	_formal: Nullable[Symbol]
-	_actual: ExpressionUnion
+	_formal: Nullable[Symbol]  #: Reference to the formal part, or ``None`` for a positional association.
+	_actual: ExpressionUnion   #: The actual part of this association.
 
-	def __init__(self, actual: ExpressionUnion, formal: Nullable[Symbol] = None) -> None:
+	def __init__(self, formal: Nullable[Symbol], actual: ExpressionUnion) -> None:
+		"""
+		Initializes an association item.
+
+		:param formal: Reference to the formal part, or ``None`` for a positional association.
+		:param actual: The actual part of this association.
+		"""
 		super().__init__()
 
 		self._formal = formal
@@ -74,13 +86,30 @@ def __init__(self, actual: ExpressionUnion, formal: Nullable[Symbol] = None) ->
 
 	@readonly
 	def Formal(self) -> Nullable[Symbol]:  # TODO: can also be a conversion function !!
+		"""
+		Read-only property to access the formal (:attr:`_formal`).
+
+		:returns: The formal, or ``None`` if not set.
+		"""
 		return self._formal
 
 	@readonly
 	def Actual(self) -> ExpressionUnion:
+		"""
+		Read-only property to access the actual (:attr:`_actual`).
+
+		:returns: The actual.
+		"""
 		return self._actual
 
 	def __str__(self) -> str:
+		"""
+		Formats the association item.
+
+		**Format:** ``formal => actual``, or ``actual`` alone when positional
+
+		:returns: Formatted association item.
+		"""
 		if self._formal is None:
 			return str(self._actual)
 		else: