:py:mod:`raesl.compile.instantiating.graph_building`
====================================================

.. py:module:: raesl.compile.instantiating.graph_building

.. autoapi-nested-parse::

   Functions for instantiating the component tree.



Module Contents
---------------

Classes
~~~~~~~

.. autoapisummary::

   raesl.compile.instantiating.graph_building.GraphFactory




.. py:class:: GraphFactory(diag_store: raesl.compile.diagnostics.DiagnosticStore, spec: Optional[raesl.compile.ast.specification.Specification] = None)


   Graph factory class.

   Converts a specification into a graph containing a node hierarchy and edges for
   derived dependencies between nodes.

   :param diag_store: Storage for found diagnostics during the process.

   .. attribute:: node_factory

      Factory that parses spec into Node objects.

   .. attribute:: edge_factory

      Factory that derives edges from found Node objects.

   .. py:method:: make_graph(spec: Optional[raesl.compile.ast.specification.Specification] = None) -> Optional[ragraph.graph.Graph]

      Instantiate the tree defined in the specification, and build a graph for it.

      :param spec: Specification object holding parsed ESL data.

      :returns: None if no root is available, else the constructed graph.

      .. note:: Problems may be reported during instantiation and added to self.diag_store.