Metadata-Version: 2.4
Name: macha
Version: 1.0.0
Summary: Bangalore slang CLI tool — like ros2 or ollama, but in Kannada style 🤙
Author: Vivodh K Haveri
License: MIT
Project-URL: Homepage, https://github.com/vivodhkhaveri/macha
Project-URL: Issues, https://github.com/vivodhkhaveri/macha/issues
Keywords: cli,bangalore,kannada,slang,terminal,macha,command-line
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: full
Requires-Dist: psutil>=5.9; extra == "full"
Dynamic: license-file

# macha 🤙

**Bangalore slang CLI tool** — like `ros2` or `ollama`, but in Kannada/Bangalore style.

Type `macha yen` and you're in.

```
pip install macha
```

---

## What is this?

`macha` is a command-line tool where every command is a Bangalore slang phrase. Instead of boring terminal commands, you get:

```bash
macha what ra          # Show PC info (CPU, RAM, OS, etc.)
macha put one hello.py # Run a script
macha yelli ide *.py   # Find files
macha internet ide     # Check internet connectivity
```

---

## All Commands

| Command | Slang Meaning | What It Does |
|---|---|---|
| `macha yen` | "what?" | Show all commands |
| `macha what ra` | "what's up?" | Full PC/system info |
| `macha put one <file>` | "run it!" | Run scripts & commands |
| `macha helu <msg>` | "say it!" | Print a styled message |
| `macha nodu <file>` | "look at it" | Show file contents with line numbers |
| `macha enu ide [path]` | "what's there?" | List directory contents |
| `macha yelli ide <pattern>` | "where is it?" | Find files by name pattern |
| `macha yeshtu <path>` | "how much?" | Show file/folder size |
| `macha new maadu <name.ext>` | "make a new one" | Scaffold a new file |
| `macha copy maadu <src> <dst>` | "make a copy" | Copy files/folders |
| `macha kalisu <path>` | "remove it" | Delete with confirmation (type `haan`) |
| `macha open maadu <path>` | "open it" | Open in default app / Explorer |
| `macha compress maadu <path>` | "zip it" | Zip files/folders |
| `macha internet ide` | "is there net?" | Check connectivity + latency |
| `macha ip nodu` | "look at IP" | Show local IP & network info |
| `macha process nodu` | "look at processes" | List running processes |
| `macha timer haku <dur>` | "set timer" | Countdown timer (`30s`, `5m`, `1h`) |
| `macha swalpa wait <N>` | "wait a little" | Pause for N seconds |
| `macha yaav` | "which one?" | Show version |

Run `macha <command> --help` for details on any command.

---

## For Full System Info

Some commands (like `what ra` and `process nodu`) show extra details if `psutil` is installed:

```bash
pip install macha[full]
```

---

## Add Your Own Commands

Drop a `.py` file in `macha/commands/`. Underscores become spaces in the command name:

```python
# macha/commands/guru_nodu.py  →  "macha guru nodu"

DESCRIPTION = "Show something guru-level"

def run(args):
    print(f"Guru macha, here you go: {args}")
```

No registration needed — it auto-discovers new commands instantly.

---

## Slang Glossary

| Word | Meaning |
|---|---|
| macha | bro / dude |
| yen | what |
| ra | particle (like "yo") |
| nodu | look / see |
| ide | is there / exists |
| maadu | do it / make it |
| helu | say / tell |
| kalisu | remove / send away |
| yelli | where |
| yeshtu | how much |
| swalpa | a little |
| haku | put / set |
| yaav | which |
| haan | yes |
| aiyo | oh no! |
| aitu | finished / done |

---

## License

MIT — do whatever you want with it, macha. 🤙
