ml_switcheroo.semantics.paths
=============================

.. py:module:: ml_switcheroo.semantics.paths

.. autoapi-nested-parse::

   Path Resolution Utilities for Semantics.

   Handles locating the 'semantics/' and 'snapshots/' directories
   within the package or source tree.



Attributes
----------

.. autoapisummary::

   ml_switcheroo.semantics.paths.files


Functions
---------

.. autoapisummary::

   ml_switcheroo.semantics.paths.resolve_semantics_dir
   ml_switcheroo.semantics.paths.resolve_snapshots_dir


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

.. py:data:: files
   :value: None


.. py:function:: resolve_semantics_dir() -> pathlib.Path

   Locates the directory containing semantic JSON definitions.

   Prioritizes the local file system (relative to this file) to ensure
   tests and editable installs find the source of truth correctly.
   Falls back to package resources for installed distributions.

   :returns: The absolute path to the 'semantics' directory.
   :rtype: Path


.. py:function:: resolve_snapshots_dir() -> pathlib.Path

   Locates the directory containing framework snapshots and mapping overlays.
   Defaults to the sibling 'snapshots' directory relative to 'semantics'.

   :returns: The absolute path to the 'snapshots' directory.
   :rtype: Path