import-parent 0.0.1__tar.gz

import_parent-0.0.1/PKG-INFO

@@ -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/import_parent.egg-info/PKG-INFO

@@ -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/import_parent.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+pyproject.toml
+readme.md
+src.py
+import_parent.egg-info/PKG-INFO
+import_parent.egg-info/SOURCES.txt
+import_parent.egg-info/dependency_links.txt
+import_parent.egg-info/top_level.txt

import_parent-0.0.1/import_parent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

import_parent-0.0.1/import_parent.egg-info/top_level.txt

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

import_parent-0.0.1/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "import_parent"
+version = "0.0.1"
+authors = [
+  { name="Michael Boerman", email="michaelboerman@hey.com" },
+]
+description = "Python package that allows a user to easily import local functions from parent folders."
+readme = "readme.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/michaelboerman/import_parent"
+Issues = "https://github.com/michaelboerman/import_parent/issues"

import_parent-0.0.1/readme.md

@@ -0,0 +1,16 @@
+# 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/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

import_parent-0.0.1/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