gwkokab.utils.path
==================

.. py:module:: gwkokab.utils.path


Functions
---------

.. autoapisummary::

   gwkokab.utils.path.normalize_path


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

.. py:function:: normalize_path(raw_path: str | os.PathLike) -> pathlib.Path

   Expands environment variables and tildes, returning a resolved Path object.

   :param raw_path: The string path (e.g., "$HOME/data" or "~/docs").
   :type raw_path: str | os.PathLike

   :returns:     A fully resolved pathlib.Path object.
   :rtype: Path

   .. rubric:: Example

   >>> normalize_path("$HOME/documents/data.csv")
   PosixPath('/home/user/documents/data.csv')

   >>> normalize_path(Path("~/Desktop/test.txt"))
   PosixPath('/home/user/Desktop/test.txt')