Metadata-Version: 2.1
Name: prenv
Version: 0.0.2
Summary: Portable reproducible environments for Linux applications
Home-page: https://github.com/joaompinto/prenv
Author: João Pinto
Author-email: lamego.pinto@gmail.com
License: MIT
Description-Content-Type: text/markdown
License-File: LICENSE

# prenv

**p**ortable **r**eproducible **env**ironments for Linux applications

[![PyPi](https://img.shields.io/pypi/v/prenv.svg?style=flat-square)](https://pypi.python.org/pypi/prenv)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/ambv/black)

## What is prenv?

prenv is a tool that allows regular users to deploy applications in a portable and reproducible way.

prenv does not require root privileges to be installed or used.
The focus of prenv is to provide a tool that can be used to run applications in a reproducible way, without the need to install dependencies on the host system.
 > prenv does **NOT** aim to provide full isolation between environemtns and the host, for such kind case please consider using Docker or Podman.

## Which applications can I run with prenv?

Currently you can run applications available to install from the following distributions:

    - [Alpine Linux](https://alpinelinux.org/)
    - [Arch Linux](https://www.archlinux.org/)
    - [Void Linux](https://voidlinux.org/)

## System Requirements

- Linux or WSL2 (Kernel version >=4.18)
- Python 3.8, 3.9, 3.10 or 3.11

## How to install
```sh
pip install prenv
```
## How to use
Create an ephemeral in-memory Alpine instance


### Using Void Linux
```sh
prenv create voidlinux
xbps-install -Su
xbps-install -u xbps
xbps-install -S curl jq
curl -s https://www.githubstatus.com/api/v2/status.json
```


### Using Alpine
```sh
prenv create alpine
apk update
apk add curl jq
curl -s https://www.githubstatus.com/api/v2/status.json
```

### Using Arch Linux
```sh
prenv create archlinux
sed -i "s/#Server/Server/g" /etc/pacman.d/mirrorlist
sed -i '/CheckSpace/d' /etc/pacman.conf
pacman-key --init && pacman-key --populate archlinux
pacman -Sy curl jq
curl -s https://www.githubstatus.com/api/v2/status.json
```
