README.md

TLS - Temporary Linux(Alpine) Shell/System

🚀 TLS provides a convenient way to start a temporary Alpine Linux shell/system using Python.

Testing

If you just want to test TLS without installing it you can do that with the following command:

source <(curl -sSL https://raw.githubusercontent.com/Noriskky/TLS/main/scripts/tls.sh)

NOTE: THIS will not install the script!
This script only writes to /var/tmp so the changes will not be permanent, and it's using a temporary VENV.

Installation

You can install TLS via Pip:

pip install Temp-Linux-Shell

Usage

Once installed, you can start a temporary Alpine Linux shell by running the tls command.

Options

• -h or --help: Display the help message.
• -d: Specify a custom directory.
• -hn or --hostname: Specify a custom hostname.
• -c or --command: Specify a command to be executed at the start. After the completion of the command, the session closes.

Support

There is currently only Support for Linux because it is using Chroot it's planned to migrate to Docker or something else.

How to contribute

Hey if you want to contribute to this Project you are welcome to do that for testing you can use Temp-Linux-Shell/test.py with the following command

make clean
make install
make run

or you can do:

make all

It will install tls in a Python venv you may have to install some packages manually into the Venv.

Compile from Source

Building

If you want to compile and install it from source you can build it with the following command:

make clean
make build

The output will be in ./dist it can be installed with:

pip install dist/tls-<version>.tar.gz

Replace <version> with the current defined in setup.py.

Installing & Building

make clean
make install

This installs in the Venv.