Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koaning/uvtrick
A fun party trick to run Python code from another venv into this one.
https://github.com/koaning/uvtrick
Last synced: 3 days ago
JSON representation
A fun party trick to run Python code from another venv into this one.
- Host: GitHub
- URL: https://github.com/koaning/uvtrick
- Owner: koaning
- License: mit
- Created: 2024-08-29T19:50:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-10-11T10:19:00.000Z (about 1 month ago)
- Last Synced: 2024-11-06T18:01:36.858Z (10 days ago)
- Language: Python
- Homepage:
- Size: 66.4 KB
- Stars: 148
- Watchers: 1
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### uvtrick
> A fun party trick, via `uv` and pickle, to run Python code from another venv ... into this one.
## Quickstart
You can install this tool via:
```
uv pip install uvtrick
```
## Usage
### External scripts
There are a few ways to use this library. The first one is to use the `load` function to point
to a Python script that contains the function you want to use. This function assumes that the
script carries [inline script metadata](https://packaging.python.org/en/latest/specifications/inline-script-metadata/).
```python
from uvtrick import load
# Load the function `add` from the file `some_script.py`
# It runs in another virtualenv, but you get back the response via pickle.
# Be aware of the limitations, please only consider base Python objects.
add = load("some_script.py", "add")
# This result is from the `some_script.py` file, running in another virtualenv
# with `uv`. A pickle in a temporary file is used to communicate the result.
add(1, 2) # 3
```
### From within Python
But you can also take it a step further and use the `Env` class to run a function in a specific environment.
```python
from uvtrick import Env
# For illustration purposes, let's assume that rich is not part of the current environment.
# Also note that all the imports happen inside of this function.
def uses_rich():
from rich import print
from importlib import metadata
version = metadata.version("rich")
print(f"hello from rich=={version}")
# This runs the function `uses_rich` in a new environment with the `rich` package installed.
# Just like the `load` function before, the result is returned via pickle.
Env("rich", python="3.12").run(uses_rich)
```
This approach is pretty useful if you are interested in running the same function in different versions of
a dependency to spot a performance regression. You might be able to do that via something like:
```python
from uvtrick import Env
def uses_rich(a, b):
from rich import print
from importlib import metadata
version = metadata.version("rich")
print(f"hello from rich=={version}")
return a + b
for version in (10, 11, 12, 13):
Env(f"rich=={version}", python="3.12").run(uses_rich, a=1, b=2)
```
Be aware that a lot of pickling is happening under the hood here. This can be a problem if you are trying to pickle large objects
or if your function is returning an object that needs a dependency that is not installed in the environment that is calling `Env`.
Also note that thusfar this entire project is merely the result of a very entertaining recreational programming session.
We might want to gather some community feedback before suggesting production usage.