import-parent 0.0.1__py3-none-any.whl

import_parent-0.0.1.dist-info/METADATA

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: import_parent
+Version: 0.0.1
+Summary: Python package that allows a user to easily import local functions from parent folders.
+Author-email: Michael Boerman <michaelboerman@hey.com>
+Project-URL: Homepage, https://github.com/michaelboerman/import_parent
+Project-URL: Issues, https://github.com/michaelboerman/import_parent/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# import-parent
+
+A small utility for importing Python modules using paths relative to the
+calling script — without modifying your project structure.
+
+Inspired by R's `here()`.
+
+---
+
+## Installation
+
+`pip install import-parent`
+
+## Usage
+
+`from import_parent import import_parent`

import_parent-0.0.1.dist-info/RECORD

@@ -0,0 +1,5 @@
+src.py,sha256=iQyUkuXY1FXlxDWoOIAy4KMPpP2lvihtXOZhXBowEVg,1457
+import_parent-0.0.1.dist-info/METADATA,sha256=H2EUPfoXmNrN5QfHy2hpo94k_NUmKwt6J28A_eHtqvc,848
+import_parent-0.0.1.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+import_parent-0.0.1.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+import_parent-0.0.1.dist-info/RECORD,,

import_parent-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

import_parent-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src.py

@@ -0,0 +1,58 @@
+import os
+import sys
+import inspect
+from typing import Union
+
+
+def _get_caller_dir(stack_level: int = 2) -> str:
+    frame = inspect.stack()[stack_level]
+    caller_file = frame.filename
+    return os.path.dirname(os.path.abspath(caller_file))
+
+
+def _count_levels(path: str) -> int:
+    parts = [p for p in path.replace("\\", "/").split("/") if p]
+    levels = sum(1 for p in parts if p == "..")
+
+    if levels == 0:
+        raise ValueError("Path must contain at least one '..'")
+
+    return levels
+
+
+def import_parent(path: Union[str, int] = "..") -> str:
+    """
+    Add a parent directory (relative to the caller) to sys.path.
+
+    Parameters
+    ----------
+    path : str or int
+        '../..' style path or an integer number of levels.
+
+    Returns
+    -------
+    str
+        The directory added to sys.path
+    """
+    if isinstance(path, int):
+        if path <= 0:
+            raise ValueError("Integer path must be > 0")
+        levels_up = path
+    elif isinstance(path, str):
+        levels_up = _count_levels(path)
+    else:
+        raise TypeError("path must be a string or int")
+
+    caller_dir = _get_caller_dir()
+
+    target_dir = caller_dir
+    for _ in range(levels_up):
+        target_dir = os.path.dirname(target_dir)
+
+    if not os.path.isdir(target_dir):
+        raise FileNotFoundError(f"Resolved path does not exist: {target_dir}")
+
+    if target_dir not in sys.path:
+        sys.path.insert(0, target_dir)
+
+    return target_dir