Metadata-Version: 2.4
Name: argman
Version: 0.2.0
Summary: A lightweight argument manager for Python CLI tools
Author-email: Seyed Mohammad Javad Taghipoor <smjavadt.1379@gmail.com>
License: LGPL-3.0-or-later
Project-URL: Homepage, https://github.com/smjt2000/argman
Keywords: cli,argparse,arguments,parser
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ArgMan

A lightweight, zero-dependency argument parser for Python CLI tools — simple, testable, and intuitive.

---

## Features

- Short (`-v`) and long (`--verbose`) flags
- Type-safe parsing: `int`, `float`, `str`, `bool`, `list`
- Default values and boolean toggles
- Repeated arguments with `arg_list`
- Positional arguments
- Automatic `--no-flag` for booleans
- `--arg=value` and `--` terminator support
- Clean help and error messages

---

## Documentation

Usage examples and API reference: [docs/](docs/)

---

## Running Tests

```bash
python -m unittest discover tests
```

## Roadmap

v0.1 — Core Functionality

- [x] Complete

v0.2 — Extended Features

- [x] arg_list, --no-flag, --arg=value, -- support
- [ ] Custom error messages, config files, subcommands

v0.3 — Docs & Publish

- [x] Docs ready
- [ ] Publish to PyPI

v0.4 — Validation & Customization

- [ ] Validators, formatters, dependencies, custom handlers

## License

LGPL-3.0 © 2025
