dyn-import-utils 0.3.1

A simple package for dynamic imports

dyn_import_utils

dyn_import_utils is a Python utility for dynamically importing modules and packages from file paths. It simplifies importing code that resides outside the standard Python module search path.

---

Features

• Dynamically import Python modules from arbitrary file paths.
• Load entire packages from directories containing __init__.py.
• Lightweight and easy to integrate into existing projects.
• The input path can be absolute or relative, in case of a relative path, the base path of the calling module is used
• Symbols can be injected from other modules or dictionaries

---

Installation

Install dyn_import_utils via pip:

pip install dyn_import_utils

---

Usage

Lib import

import dyn_import_utils

Importing a Module

Use import_module to load a module dynamically from its file path:

# Dynamically load a module
module = dyn_import_utils.import_module("path/to/module.py")

# Use the module
print(module.some_function())

Importing a Package

Use import_package to load a package dynamically from its directory:

# Dynamically load a package
package = dyn_import_utils.import_package("path/to/package")

# Use the package
print(package.some_function())

Injecting symbols when importing

injected_classes = {"InjectedClass1": InjectedClass1, 
                    "InjectedClass2": InjectedClass2}
module = dyn_import_utils.import_module("path/to/module.py", inject_symbols=injected_classes)

injected_modules = [m1, m2]
module = dyn_import_utils.import_module("path/to/module.py", inject_symbols=injected_modules)

Adding a Directory to sys.path

Temporarily add a directory to the Python module search path:

dyn_import_utils.add_sys_path("path/to/directory")

---

Example

Example Module: hello.py

# hello.py
def greet():
    return "Hello, world!"

Dynamically Loading the Module

import dyn_import_utils

module = dyn_import_utils.import_module("hello.py")
print(module.greet())  # Output: Hello, world!

---

License

dyn_import_utils is released under the MIT License. See the LICENSE file for more details.

---

Links

• PyPI: https://pypi.org/project/dyn_import_utils/