Metadata-Version: 2.4
Name: batch24-28
Version: 1.2.1
Summary: A multi featured Python terminal
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: psutil
Requires-Dist: watchdog


# batch24-28

A versatile terminal based utility, gaming and productivity suite featuring interactive tracking tools, computational modules, custom terminal art and text games.

---

## Installation

Install directly from PyPI using pip:

```bash
pip install batch24-28
```

---

## Features & Usage Guide

### 1. Welcome Art Banner

Display a clean, structured notification header or welcome banner in your terminal applications.

```python
from batch24_28 import print_hello

print_hello()
```

---

### 2. Productivity Timers Suite

Run live tracking utilities right inside your script. Both tools use carriage returns (`\r`) to overwrite the line dynamically, keeping your terminal workspace completely clean without spamming new lines.

```python
from batch24_28 import run_interactive_timer, start_stopwatch, start_countdown

# Option A: Interactive countdown setup that asks you for the duration
run_interactive_timer()

# Option B: Pass the minutes directly (e.g., a 5-minute timer)
start_countdown(5)

# Option C: Live stopwatch — press Ctrl + C to stop and view total time
start_stopwatch()
```

---

### 3. Advanced Calculator

A fast mathematical calculation utility to compute numerical data dynamically within your workspace scripts.

```python
from batch24_28 import AdvancedCalculator

calc = AdvancedCalculator()
calc.interact()
```

---

### 4. Rock Paper Scissors Game

Launch an interactive text-based Rock, Paper, Scissors mini-game straight from the command prompt.

```python
from batch24_28 import RockPaperScissors

game = RockPaperScissors()
game.play()
```

---

### 5. Terminal Chess Engine

Launch interactive full chess mechanics straight from the command prompt. Perfect for lightweight CLI based entertainment.

```python
from batch24_28 import TerminalChess

game = TerminalChess()
game.play()
```

---

### 6. System Performance Monitor

Keep track of your system health in real-time. This module displays your current CPU and memory usage, using carriage returns (\r) to ensure your terminal stays clean and readable without filling up the screen.

```python
from batch24_28 import start_system_monitor

# Launches a live monitor. Press Ctrl + C to stop.
start_system_monitor()
```

---

### 7. File-Watcher & Automation Engine

Monitor any directory for file system changes in real-time. This utility uses the watchdog library to detect when files are created, modified, or deleted, allowing you to trigger automated tasks.

```python
from batch24_28 import start_file_watcher

# Starts watching the current directory for file modifications
# Press Ctrl + C to stop the watcher
start_file_watcher(path=".")
```
