PythonIota 1.7.0__tar.gz → 1.7.1__tar.gz

pythoniota-1.7.1/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include tests *.py

{pythoniota-1.7.0/src/PythonIota.egg-info → pythoniota-1.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.2
 Name: PythonIota
-Version: 1.7.0
+Version: 1.7.1
 Summary: A zero-dependency Python toolkit: Go-style iota enums, sequence generators, a from-scratch regex engine, and an argparse-style CLI parser
 Author: Equinox
 License: MIT
@@ -26,11 +26,19 @@ pip install PythonIota
 
 Requires Python 3.10+.
 
+## 1.7.1 fixes
+
+- Full matching now considers complete alternatives instead of rejecting a
+  valid match after selecting a shorter branch.
+- Ordered enum members now hash consistently with equal numeric values and
+  equal members of other enums, preserving dictionary and set lookups.
+
 **What's inside**
 
 - **Enums** — Go-style `iota`, bit flags, string enums (`pythoniota.IotaEnum`, ...)
 - **Sequences** — lazy, chainable generators (`pythoniota.iota`)
 - **Regex** — a from-scratch NFA (Pike VM) engine, no catastrophic backtracking (`pythoniota.regex`)
+- **CLI** — a from-scratch `argparse`-style argument parser (`pythoniota.cli`)
 
 ---
 
@@ -340,12 +348,13 @@ named.groupdict()                             # {'user': 'user', 'host': 'host'}
 
 Supported: literals, `.`, `* + ?` and their lazy forms `*? +? ??`, alternation
 `|`, groups `(...)` / non-capturing `(?:...)` / named `(?P<name>...)`, lookahead
-`(?=...)` / `(?!...)`, character classes `[...]`, counted repeats `{m,n}`,
-shorthands `\d \w \s` (and `\D \W \S`), word boundaries `\b \B`, and anchors
-`^ $ \A \Z`. Flags: `IGNORECASE`, `MULTILINE`, `DOTALL`, `VERBOSE` (also inline
-`(?imsx)`). API mirrors `re`: `compile`, `match`, `fullmatch`, `search`,
-`findall`, `finditer`, `sub`, `split`, `escape`, with `Match.group` / `groups` /
-`span` / `groupdict`.
+`(?=...)` / `(?!...)`, fixed-width lookbehind `(?<=...)` / `(?<!...)`, conditionals
+`(?(id/name)yes|no)`, character classes `[...]`, counted repeats `{m,n}`,
+shorthands `\d \w \s` (and `\D \W \S`), word boundaries `\b \B`, anchors
+`^ $ \A \Z`, and hex escapes `\xHH` / `\uHHHH`. Flags: `IGNORECASE`, `MULTILINE`,
+`DOTALL`, `VERBOSE` (also inline `(?imsx)`). API mirrors `re`: `compile`, `match`,
+`fullmatch`, `search`, `findall`, `finditer`, `sub`, `subn`, `split`, `escape`,
+with `Match.group` / `groups` / `span` / `groupdict` / `expand`.
 
 ```python
 regex.findall(r"[a-z]+", "AbCdEf", regex.IGNORECASE)   # ['AbCdEf']
@@ -363,6 +372,53 @@ regex.search(r"(a+)+$", "a" * 40 + "!")       # None, instantly
 
 ---
 
+## CLI
+
+A faithful subset of the standard library's `argparse`, built from scratch:
+
+```python
+from pythoniota import cli
+
+p = cli.ArgumentParser(prog="greet", description="say hello")
+p.add_argument("name")
+p.add_argument("-n", "--times", type=int, default=1)
+p.add_argument("-v", "--verbose", action="store_true")
+
+args = p.parse_args(["world", "--times", "3", "-v"])
+args.name, args.times, args.verbose      # ('world', 3, True)
+```
+
+Supported:
+
+- positional & optional arguments, `nargs` (`N` / `?` / `*` / `+`)
+- `type` / `choices` / `default` / `required`
+- actions: `store`, `store_true`, `store_false`, `store_const`, `append`, `count`
+- `--opt=value`, clustered short flags (`-abc`), the `--` end-of-options marker
+- an auto-generated `-h/--help`, and sub-commands via `add_subparsers`
+
+Bad input prints a usage line and raises `SystemExit(2)` — the same contract as
+argparse, so it drops into scripts and tests unchanged. `parse_known_args`
+returns `(namespace, extras)` instead of erroring on unknown tokens.
+
+### Sub-commands
+
+```python
+p = cli.ArgumentParser(prog="git")
+sub = p.add_subparsers(dest="cmd")
+
+add = sub.add_parser("add", help="stage files")
+add.add_argument("path")
+add.add_argument("-f", "--force", action="store_true")
+
+rm = sub.add_parser("rm", help="remove files")
+rm.add_argument("path")
+
+args = p.parse_args(["add", "README.md", "-f"])
+args.cmd, args.path, args.force          # ('add', 'README.md', True)
+```
+
+---
+
 ## License
 
 MIT