py-hub-navigator 1.0.0

A terminal-based file navigator with customizable progress animations

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

pip install py-hub-navigator

Then run:

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:

{
  "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