Skip to main content

A lightweight argument manager for Python CLI tools

Project description

ArgMan

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

ArgMan example code

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
  • Config file support (JSON) via load_config()
  • Export parsed args via dump_args()

Documentation

Usage examples and API reference: docs/


Installation

You can install ArgMan directly from PyPi:

pip install argman

Running Tests

python -m unittest discover tests

Roadmap

v0.1 — Core Functionality

  • Complete

v0.2 — Extended Features

  • arg_list, --no-flag, --arg=value, -- support
  • Custom error messages
  • config files(load_config, dump_args)
  • subcommands

v0.3 — Docs & Publish

  • Docs ready
  • Publish to PyPI

v0.4 — Validation & Customization

  • Validators, formatters, dependencies, custom handlers

License

LGPL-3.0 © 2025

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

argman-0.2.2.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

argman-0.2.2-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

Details for the file argman-0.2.2.tar.gz.

File metadata

  • Download URL: argman-0.2.2.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for argman-0.2.2.tar.gz
Algorithm Hash digest
SHA256 c3dbd887dd73a758e968e4f63ca44cd844de8bdeefe55122f54042cd45721752
MD5 072630c368378c251bcddb4157aecf2c
BLAKE2b-256 66a7b08fb427f253886f4df4735ddbec45edbbe1ad07e345f92a2cb815c51153

See more details on using hashes here.

File details

Details for the file argman-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: argman-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 11.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for argman-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 61c79d73d320c445b7db9896e378dab519c0d341bb8350dbf4b609ab43a72bf2
MD5 20b74b54fcbaa9dea0d8ff6237d8c734
BLAKE2b-256 83c8c39247043da5334d3a658364b29282895b5cbf8468f2e2e831142bed4eb6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page