reyk 0.0.1__tar.gz

reyk-0.0.1/.gitignore

@@ -0,0 +1,36 @@
+# Byte-compiled
+__pycache__/
+
+# Distribution / packaging
+build/
+dist/
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+coverage/
+coverage.lcov
+
+# Environments
+.venv/
+
+# PyPI configuration file
+.pypirc
+
+# Tests
+tests/blackbox/locked_files_pending_deletion/
+tests/blackbox/specific_libraries/test_libs
+tests/blackbox/specific_libraries/vendor.lock
+
+# Docs
+.vercel

reyk-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reyk's authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

reyk-0.0.1/Makefile

@@ -0,0 +1,46 @@
+# Can be installed on Windows with GNUWin32 or Chocolatey
+
+specific_libraries_test := tests/blackbox/specific_libraries
+specific_libraries_test_libs := $(specific_libraries_test)/test_libs
+
+uv:
+	@uv -V || echo 'uv is not installed. Install via: https://docs.astral.sh/uv/getting-started/installation/'
+
+install-hooks: uv
+	uv run pre-commit install --install-hooks
+
+install: uv
+	uv sync --frozen --all-groups --all-extras --all-packages
+
+install-test-libs: $(specific_libraries_test_libs)
+
+$(specific_libraries_test_libs):
+	CLI_PATH="$$(pwd)/reyk-cli"; \
+	cd $(specific_libraries_test); \
+	uvx "$$CLI_PATH" sync
+
+test-library: install install-test-libs
+	uv run coverage run $(COVERAGE_FLAGS) -m pytest -vv tests/
+
+test-library-memray: install install-test-libs
+	uv run pytest -v tests/ --memray
+
+test-cli: install install-test-libs
+	uv run coverage run $(COVERAGE_FLAGS) -m pytest -vv reyk-cli/tests/
+
+# The --append flag is needed to combine the coverage data from both test-library and test-cli
+test: install install-test-libs
+	mkdir -p coverage
+	rm -f coverage/.coverage.*
+	"$(MAKE)" COVERAGE_FLAGS=--append test-library
+	"$(MAKE)" COVERAGE_FLAGS=--append test-cli
+
+testcov: test
+	uv run coverage report
+	@echo "building coverage lcov"
+	uv run coverage lcov
+	@echo "building coverage html"
+	uv run coverage html
+
+update-dependencies: uv
+	uv lock --upgrade

reyk-0.0.1/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: reyk
+Version: 0.0.1
+Summary: Run conflicting Python dependencies in one process — with vendored isolation.
+Project-URL: Homepage, https://reyk.dev
+Project-URL: Source, https://github.com/eyalohn/reyk
+Author-email: Eyal Ohn <eyal.ohn@gmail.com>, Ofek Ashery <ofek.ashery@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: conflicting dependencies,dependency isolation,python import system,vendoring,virtual environment
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Reyk
+
+[![Tests](https://github.com/eyalohn/reyk/actions/workflows/test.yml/badge.svg)](https://github.com/eyalohn/reyk/actions/workflows/test.yml)
+[![Coverage](https://coverage-badge.samuelcolvin.workers.dev/eyalohn/reyk.svg)](https://coverage-badge.samuelcolvin.workers.dev/redirect/eyalohn/reyk)
+[![Latest Version](https://img.shields.io/pypi/v/reyk.svg)](https://pypi.python.org/pypi/reyk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/reyk.svg)](https://pypi.python.org/pypi/reyk/)
+[![llms.txt](https://img.shields.io/badge/llms.txt-green)](https://reyk.dev/llms-full.txt)
+
+Run conflicting Python dependencies in one process — with vendored isolation.
+
+[Reyk](https://reyk.dev) lets you **vendor Python dependencies into your project and isolate them by design**, without changing how you write imports. We leverage Python's import system internals to achieve transparent dependency isolation.
+
+## Features
+
+- **Zero Configuration**: Enable isolation with a single function call
+- **Dependency Isolation**: Avoid conflicts by shipping libraries with your package
+- **Version Flexibility**: Run multiple versions of the same library in one process
+- **Transparent Imports**: Keep your public imports unchanged (`import requests` still works)
+- **Lightweight**: Minimal overhead with a tiny import hook
+
+# Installation
+
+You can install Reyk from PyPI:
+
+```bash
+uv add reyk
+```
+
+Enable isolation from your package's `__init__.py`:
+
+```python
+from reyk.isolator import isolate_package
+
+isolate_package()
+```
+
+Then, vendor your dependencies with Reyk's CLI:
+
+```bash
+uvx reyk-cli add requests==2.25.1
+```
+
+**That's it!** Inside `your_package`, `import requests` resolves to `your_package.libs.requests`. Outside `your_package`, `import requests` continues to resolve to the global installation.
+
+## Documentation
+
+For detailed documentation, examples, and API reference, visit the documentation site at https://reyk.dev.
+
+## Limitations
+
+- Multi-threaded applications are not supported.

reyk-0.0.1/README.md

@@ -0,0 +1,51 @@
+# Reyk
+
+[![Tests](https://github.com/eyalohn/reyk/actions/workflows/test.yml/badge.svg)](https://github.com/eyalohn/reyk/actions/workflows/test.yml)
+[![Coverage](https://coverage-badge.samuelcolvin.workers.dev/eyalohn/reyk.svg)](https://coverage-badge.samuelcolvin.workers.dev/redirect/eyalohn/reyk)
+[![Latest Version](https://img.shields.io/pypi/v/reyk.svg)](https://pypi.python.org/pypi/reyk/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/reyk.svg)](https://pypi.python.org/pypi/reyk/)
+[![llms.txt](https://img.shields.io/badge/llms.txt-green)](https://reyk.dev/llms-full.txt)
+
+Run conflicting Python dependencies in one process — with vendored isolation.
+
+[Reyk](https://reyk.dev) lets you **vendor Python dependencies into your project and isolate them by design**, without changing how you write imports. We leverage Python's import system internals to achieve transparent dependency isolation.
+
+## Features
+
+- **Zero Configuration**: Enable isolation with a single function call
+- **Dependency Isolation**: Avoid conflicts by shipping libraries with your package
+- **Version Flexibility**: Run multiple versions of the same library in one process
+- **Transparent Imports**: Keep your public imports unchanged (`import requests` still works)
+- **Lightweight**: Minimal overhead with a tiny import hook
+
+# Installation
+
+You can install Reyk from PyPI:
+
+```bash
+uv add reyk
+```
+
+Enable isolation from your package's `__init__.py`:
+
+```python
+from reyk.isolator import isolate_package
+
+isolate_package()
+```
+
+Then, vendor your dependencies with Reyk's CLI:
+
+```bash
+uvx reyk-cli add requests==2.25.1
+```
+
+**That's it!** Inside `your_package`, `import requests` resolves to `your_package.libs.requests`. Outside `your_package`, `import requests` continues to resolve to the global installation.
+
+## Documentation
+
+For detailed documentation, examples, and API reference, visit the documentation site at https://reyk.dev.
+
+## Limitations
+
+- Multi-threaded applications are not supported.

reyk-0.0.1/pyproject.toml

@@ -0,0 +1,129 @@
+[project]
+name = "reyk"
+description = "Run conflicting Python dependencies in one process — with vendored isolation."
+authors = [
+    { name = 'Eyal Ohn', email = 'eyal.ohn@gmail.com' },
+    { name = 'Ofek Ashery', email = 'ofek.ashery@gmail.com' },
+]
+readme = "README.md"
+license = 'MIT'
+license-files = ['LICENSE']
+keywords = [
+    "vendoring",
+    "dependency isolation",
+    "conflicting dependencies",
+    "virtual environment",
+    "python import system",
+]
+classifiers = [
+    'Development Status :: 4 - Beta',
+    'Programming Language :: Python',
+    'Programming Language :: Python :: Implementation :: CPython',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.9',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
+    'Intended Audience :: Developers',
+    'Operating System :: OS Independent',
+]
+requires-python = ">=3.9"
+dependencies = []
+dynamic = ["version"]
+
+[project.urls]
+Homepage = "https://reyk.dev"
+Source = "https://github.com/eyalohn/reyk"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = ["coverage[toml]>=7.10.7", "pre-commit>=4.3.0", "pytest>=8.4.2"]
+testing-extra = [
+    "pytest-memray>=1.8.0; platform_python_implementation == 'CPython' and platform_system != 'Windows'",
+]
+
+[tool.hatch.version]
+path = "reyk/version.py"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/README.md",
+    "/Makefile",
+    "/reyk",
+    "/tests",
+]
+
+[tool.uv.workspace]
+members = ["reyk-cli"]
+
+[tool.ruff]
+line-length = 120
+exclude = ["test_libs"]
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "W293",
+    "D101",
+    "D102",
+    "D103",
+    "D104",
+    "D105",
+    "D100",
+    "T201",
+    "I001",
+    "INP001",
+    "EM102",
+    "TRY003",
+    "S101",
+    "FA102",
+    "UP036",
+    "EM101",
+    "G004",
+    "D107",
+    "FA100",
+    "COM812",
+    "TC006",
+    "SIM118",
+    "D205",
+    "D212",
+    "D401",
+    "D400",
+    "D415",
+    "UP040",
+    "D203",
+    "TC003",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/test_*.py" = ["SLF001", "PLC0415", "F401"]
+"tests/**/conftest.py" = ["SLF001", "PLC0415", "F401"]
+"tests/blackbox/distributions_finder.py" = ["SLF001", "PLC0415", "F401"]
+"reyk/vendor_importer.py" = ["A002"]
+
+[tool.pyright]
+include = ["reyk", "tests"]
+exclude = ["tests/blackbox/specific_libraries/test_libs", ".venv"]
+venvPath = "."
+venv = ".venv"
+
+[tool.codespell]
+skip = ".git,env*,uv.lock,**/package-lock.json,./tests/blackbox/specific_libraries/test_libs,node_modules,htmlcov"
+ignore-words-list = ["reyk"]
+
+[tool.coverage.run]
+source = ["reyk", "reyk-cli/src"]
+relative_files = true
+branch = true
+data_file = "coverage/.coverage"
+
+[tool.coverage.lcov]
+output = "coverage/coverage.lcov"
+
+[tool.coverage.html]
+directory = "coverage/htmlcov/coverage.lcov"

reyk-0.0.1/reyk/caller_finder.py

@@ -0,0 +1,52 @@
+import logging
+import sys
+from collections.abc import Iterator
+from dataclasses import dataclass
+from pathlib import Path
+
+from reyk.stdlib_finder import is_part_of_stdlib
+
+LOGGER = logging.getLogger(__name__)
+MY_PACKAGE_NAME = __package__
+
+
+class NoCallerOutsideLibFoundError(RuntimeError): ...
+
+
+@dataclass
+class StackFrame:
+    filename: Path
+    module_name: str
+
+
+def get_caller_frame_outside_reyk() -> StackFrame:
+    for frame in _iterate_over_stack():
+        if is_part_of_stdlib(frame.module_name):
+            continue
+
+        if frame.module_name == MY_PACKAGE_NAME or frame.module_name.startswith(f"{MY_PACKAGE_NAME}."):
+            # This function
+            continue
+
+        return frame
+
+    raise NoCallerOutsideLibFoundError("Failed to find caller outside builtin")
+
+
+def _iterate_over_stack() -> Iterator[StackFrame]:
+    current_frame = sys._getframe(1)  # noqa: SLF001
+    while current_frame is not None:
+        yield StackFrame(
+            filename=Path(current_frame.f_code.co_filename),
+            module_name=current_frame.f_globals["__name__"],
+        )
+        current_frame = current_frame.f_back
+
+
+def is_caller_part_of_library(library_name: str) -> bool:
+    try:
+        caller_frame = get_caller_frame_outside_reyk()
+    except NoCallerOutsideLibFoundError:
+        return False
+    caller_module_name = caller_frame.module_name
+    return (caller_module_name == library_name) or (caller_module_name.startswith(f"{library_name}."))

reyk-0.0.1/reyk/isolator.py

@@ -0,0 +1,46 @@
+import builtins
+import importlib
+import logging
+from pathlib import Path
+from typing import Optional, cast
+
+from reyk.caller_finder import get_caller_frame_outside_reyk
+from reyk.vendor_importer import BuiltinsImporter, VendorImporter
+
+LOGGER = logging.getLogger(__name__)
+
+
+def isolate_package(package_path: Optional[Path] = None, vendorized_libs_directory_import_path: str = "libs") -> None:
+    vendor_importer = create_vendor_importer(package_path, vendorized_libs_directory_import_path)
+    LOGGER.debug(f"Isolating library: {vendor_importer.package_name} ({vendorized_libs_directory_import_path=})")
+    vendor_importer.install()
+
+
+def create_vendor_importer(
+    package_path: Optional[Path] = None,
+    vendorized_libs_directory_import_path: str = "libs",
+) -> VendorImporter:
+    """
+    Isolates a package dependencies - everything imported from the specified package_path
+    will prefer to import libraries inside the specified vendorized_libs_directory_import_path
+    instead of the default PYTHONPATH/site-packages.
+    The package_path can be unspecified/None to default to the caller's parent package.
+    vendorized_libs_directory_import_path should be the path to import the dependencies
+    from the package.
+    For example if the dependencies are in 'libs' it should be 'libs' as well as we need to perform:
+    `import libs` but if it's a subdirectory like 'my/libs' it should be 'my.libs' for
+    `import my.libs`.
+    """
+    if package_path is None:
+        package_path = get_caller_frame_outside_reyk().filename.parent
+
+    package_name = package_path.name
+    vendorized_libs_path = package_path / vendorized_libs_directory_import_path
+    return VendorImporter(
+        package_name,
+        vendorized_libs_directory_import_path,
+        vendorized_libs_path,
+        # Cast as for some reason the definition of __import__ thinks fromlist is not nullable
+        cast(BuiltinsImporter, builtins.__import__),
+        importlib.import_module,
+    )

reyk-0.0.1/reyk/stdlib_finder.py

@@ -0,0 +1,28 @@
+import os
+import sys
+from pathlib import Path
+from functools import cache
+from collections.abc import Iterator
+
+
+@cache
+def list_stdlib_modules() -> list[str]:
+    return list(_list_stdlib_modules_iter())
+
+
+def _list_stdlib_modules_iter() -> Iterator[str]:
+    standard_lib_dir = Path(os.__file__).parent
+    for std_lib_file in standard_lib_dir.iterdir():
+        if _is_package(std_lib_file) or (std_lib_file.suffix == ".py"):
+            yield std_lib_file.stem
+
+    yield from sys.builtin_module_names
+
+
+def _is_package(path: Path) -> bool:
+    return path.is_dir() and (path / "__init__.py").exists()
+
+
+def is_part_of_stdlib(module_name: str) -> bool:
+    library_name, _, _ = module_name.partition(".")
+    return library_name in list_stdlib_modules()