euromod_linking.env
===================

.. py:module:: euromod_linking.env

.. autoapi-nested-parse::

   Configure the euromod connector source + DLL path before it is imported.

   Opt-in. If ``EUROMOD_CONNECTOR_SRC`` points at a newer connector build (one that
   ships the ``Statistics`` module), that directory is prepended to ``sys.path`` so
   ``import euromod`` resolves to it instead of the installed package. The connector
   locates its .NET DLLs (including ``EM_Statistics.dll``) from the ``EUROMOD_PATH``
   environment variable — set both in ``.env``; nothing is hard-coded here.

   Call :func:`configure` before the first ``import euromod`` (model_session does
   this at import time).



Functions
---------

.. autoapisummary::

   euromod_linking.env.configure
   euromod_linking.env.harden_dotnet_console


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

.. py:function:: configure() -> None

   Idempotently prepend ``EUROMOD_CONNECTOR_SRC`` to ``sys.path`` if valid.


.. py:function:: harden_dotnet_console() -> None

   Detach the .NET Console from the process's console handle.

   The EUROMOD engine prints progress and *also* prints every warning to the
   Windows console (EM_Common.Communicator.ReportError -> Console.WriteLine).
   In processes without a valid console handle — services, detached/background
   launches — that write throws ``IOException: The handle is invalid`` and
   turns a harmless engine warning into a failed simulation.

   Redirecting Console.Out/Error to TextWriter.Null removes the fragile
   channel; nothing is lost: warnings are still delivered through the
   connector's structured result (``simulation.errors``), which
   run_simulation surfaces as ``euromod_warnings``/``euromod_errors``.

   Call after ``import euromod`` (CLR loaded); idempotent, best-effort.
   Set ``EUROMOD_KEEP_CONSOLE=1`` to skip (e.g. when watching engine progress
   interactively).