Metadata-Version: 2.4
Name: tn-venv-gui
Version: 0.1.0
Summary: A graphical GUI frontend built upon the tn-venv virtual environment manager.
Author: Tokenoodle-Everything Organization
License: Tokenoodle-Everything License
Project-URL: Homepage, https://github.com/tokenoodle-everything/tn-venv-gui
Keywords: tn-venv,venv,virtualenv,gui,tkinter
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: X11 Applications
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: License.txt
Requires-Dist: tn-venv>=0.2.0
Dynamic: license-file

# tn-venv-gui

A graphical frontend for [tn-venv](https://github.com/tokenoodle-everything/tn-venv),
the batteries-included `virtualenv` alternative. Built with Tkinter so it runs anywhere
Python's standard library does — no extra GUI dependencies required.

<!-- ![tn-venv-gui screenshot placeholder](docs/screenshot.png) -->

## Features

- Pick the destination folder and Python interpreter from a dropdown
  (auto-populated through `tn_venv.discovery.discover`).
- Toggle the most useful `tn-venv` flags without remembering the CLI:
  `--clear`, `--upgrade`, `--system-site-packages`, `--upgrade-pip`,
  `--offline`, `--symlinks` / `--copies`, custom prompt, and a list of
  preinstalled packages or requirements files.
- Real-time, color-coded log panel that streams `tn-venv`'s output as
  the environment is created.
- Background worker so the UI stays responsive while `pip install` runs.
- Saves your last-used settings to `~/.tn_venv_gui.json` so you can pick
  up where you left off.

## Installation

The GUI requires Python ≥ 3.9 and the `tn-venv` package (≥ 0.2.0).

```bash
# from a clone of this repository
pip install -e .

# or directly from PyPI / your index once published
pip install tn-venv-gui
```

## Usage

After installation a `tn-venv-gui` console script is available:

```bash
tn-venv-gui
```

Or, without installing:

```bash
python -m tn_venv_gui
```

## Project layout

```
tn_venv_gui/
├── __init__.py        # exposes launch() and TnVenvGUI
├── __main__.py        # python -m tn_venv_gui entry point
├── app.py             # Tk root window, widgets, event wiring
├── workers.py         # background thread running tn_venv
├── python_list.py     # enumerates Python interpreters via tn_venv.discovery
└── version.py         # package version
```

## License

Tokenoodle-Everything License v1.0 (see `License.txt`). This is *not*
an OSI-approved open source license and forbids commercial use without
permission.

