Metadata-Version: 2.4
Name: sandbox-engine-cli
Version: 1.0.0
Summary: A CLI tool to run Python projects in sandboxed environments.
Home-page: https://github.com/VivanRajath/sandbox-engine
Author: Vivan Rajath
Author-email: vivanrajath999@gmail.com
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-python
Dynamic: summary

# sandbox-engine

A fast and secure CLI tool designed to run Python projects in sandboxed environments without mutating your local file structure.

## Features
- **`scan`**: Discovers Python files, entrypoints, and virtual environments
- **`detect`**: Auto-detects frameworks (Flask, FastAPI, Django, Streamlit, Gradio) and code-level imports
- **`run`**: Automatically generates and verifies `requirements.txt` from your imports, sets up a virtual environment, and runs your app on its default port.
- **`run --isolated`**: Creates a temporary `.sandbox` environment, safely installs your dependencies without touching your project directory, and destroys the sandbox gracefully on `Ctrl+C`.

## Installation

```bash
pip install sandbox-engine
```

## Basic Usage

Run inside any Python project directory:

```bash
sandbox-engine scan
sandbox-engine detect
sandbox-engine run
sandbox-engine run --isolated
```
