Metadata-Version: 2.4
Name: py-hub-navigator
Version: 1.0.0
Summary: A terminal-based file navigator with customizable progress animations
Home-page: https://github.com/Unkn0wn-4uth0r/py-hub-navigator
Author: Unk0wn_4uth0r
Author-email: Unk0wn_4uth0r <your.email@example.com>
Project-URL: Homepage, https://github.com/Unkn0wn-4uth0r/py-hub-navigator
Project-URL: Repository, https://github.com/Unkn0wn-4uth0r/py-hub-navigator
Project-URL: Issues, https://github.com/Unkn0wn-4uth0r/py-hub-navigator/issues
Keywords: navigator,file-browser,launcher,tools,scripts
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama>=0.4.3
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Py-Hub-Navigator

A terminal-based file navigator and launcher that lets you browse directories,
execute Python scripts, and view documentation — with customizable progress animations.

## Features
- 🗂️ **Browse Directories** — Navigate file system with intuitive menu
- 🔧 **Execute Scripts** — Run `.py` files directly from any directory
- 📖 **View Documentation** — Display `.md` and `.txt` files in terminal
- ⚙️ **Progress Animations** — Choose your preferred progress style
- 🎨 **Colorful UI** — ANSI colored output for better readability

## Installation
```bash
pip install py-hub-navigator
```

Then run:
```bash
py-hub-navigator
```

## Quick Start
1. Run `py-hub-navigator` from any directory
2. You'll be prompted to choose your preferred progress animation (first run only)
3. Navigate directories, select files, or run scripts using numbered menu options

## Progress Animation Styles
On first run, you'll choose your preferred progress animation style:

### 1. **Progress Bar** (`progress_bar`)
Displays a real-time percentage progress bar with percentage counter:
```
[████████░░] 78% 
```
*Best for: Long-running operations where you want to see completion percentage*

### 2. **Exiting Animation** (`exiting`)
Shows an animated "Exiting..." text with dynamic dots:
```
Exiting.
Exiting..
Exiting...
```
*Best for: Graceful exit messages and shutdown sequences*

### 3. **Dots Animation** (`dots`)
Displays simple expanding dots pattern:
```
.
..
...
```
*Best for: Minimal, clean visual feedback*

## Configuration
Your progress animation preference is stored in `~/.py-hub-navigator/config.json`:

```json
{
  "progress_style": "progress_bar"
}
```

Valid values: `progress_bar`, `exiting`, `dots`

To change your preference, delete the config file and run `py-hub-navigator` again.

## Usage
- Use arrow keys or number selection to navigate
- Press `[00]` or `0` to go back to parent directory
- Select a file to view it or execute it (for `.py` files)
- Current directory path is displayed in the header

## Notes
- Requires Python 3.7+
- Uses `colorama` for cross-platform colored output
- All animations are fast and responsive
