namzy 0.1.0__tar.gz

namzy-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+.venv/

namzy-0.1.0/.omc/sessions/53d9fa2f-6fc7-4ab8-ac23-dbc85451de77.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "53d9fa2f-6fc7-4ab8-ac23-dbc85451de77",
+  "ended_at": "2026-05-15T13:20:39.777Z",
+  "reason": "prompt_input_exit",
+  "agents_spawned": 4,
+  "agents_completed": 4,
+  "modes_used": []
+}

namzy-0.1.0/CLAUDE.md

@@ -0,0 +1,11 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+### May 15, 2026
+
+| ID | Time | T | Title | Read |
+|----|------|---|-------|------|
+| #7072 | 3:19 PM | 🟣 | Multi-language namzy implementation across TypeScript, Python, C++, and Rust | ~746 |
+</claude-mem-context>

namzy-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: namzy
+Version: 0.1.0
+Summary: Generate fun human-friendly project names
+License: MIT
+Keywords: fun,generator,name,project
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# namzy
+
+Generate fun, human-friendly project names — seeded by time, mangled for personality.
+
+## Install
+
+```bash
+pip install namzy
+# or run without installing:
+uvx namzy
+```
+
+## CLI usage
+
+```bash
+# One name, single word (default)
+namzy
+
+# Multiple names
+namzy --count 5
+
+# Output shapes
+namzy --shape single    # e.g. Tokyuriver
+namzy --shape joined    # e.g. TokyuRiver
+namzy --shape spaced    # e.g. Tokyu River
+
+# Reproducible output
+namzy --seed 42 --count 3
+
+# Fetch words from a public API (falls back to offline on error)
+namzy --online --count 3
+```
+
+## Library usage
+
+```python
+from namzy import generate
+
+# Single word (default)
+name = generate()
+
+# Joined PascalCase
+name = generate(shape="joined")
+
+# Spaced words
+name = generate(shape="spaced")
+
+# Reproducible
+name = generate(seed=42)
+
+# Online mode
+name = generate(online=True)
+```
+
+## Modes
+
+- **Offline** (default): Uses a bundled wordlist of ~40 geographic names and ~40 evocative English nouns. No network required.
+- **Online**: Fetches two words from `random-word-api.herokuapp.com`. Falls back silently to offline on any error.
+
+## Mangling
+
+Names pass through a phonetic mangling pass: `tion→shun`, `ight→ite`, `oo→u`, `ck→kk`, `ph→f`, `ks→x`, trailing `s→z`. One or two substitutions apply randomly per word.
+
+## License
+
+MIT

namzy-0.1.0/README.md

@@ -0,0 +1,66 @@
+# namzy
+
+Generate fun, human-friendly project names — seeded by time, mangled for personality.
+
+## Install
+
+```bash
+pip install namzy
+# or run without installing:
+uvx namzy
+```
+
+## CLI usage
+
+```bash
+# One name, single word (default)
+namzy
+
+# Multiple names
+namzy --count 5
+
+# Output shapes
+namzy --shape single    # e.g. Tokyuriver
+namzy --shape joined    # e.g. TokyuRiver
+namzy --shape spaced    # e.g. Tokyu River
+
+# Reproducible output
+namzy --seed 42 --count 3
+
+# Fetch words from a public API (falls back to offline on error)
+namzy --online --count 3
+```
+
+## Library usage
+
+```python
+from namzy import generate
+
+# Single word (default)
+name = generate()
+
+# Joined PascalCase
+name = generate(shape="joined")
+
+# Spaced words
+name = generate(shape="spaced")
+
+# Reproducible
+name = generate(seed=42)
+
+# Online mode
+name = generate(online=True)
+```
+
+## Modes
+
+- **Offline** (default): Uses a bundled wordlist of ~40 geographic names and ~40 evocative English nouns. No network required.
+- **Online**: Fetches two words from `random-word-api.herokuapp.com`. Falls back silently to offline on any error.
+
+## Mangling
+
+Names pass through a phonetic mangling pass: `tion→shun`, `ight→ite`, `oo→u`, `ck→kk`, `ph→f`, `ks→x`, trailing `s→z`. One or two substitutions apply randomly per word.
+
+## License
+
+MIT

namzy-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "namzy"
+version = "0.1.0"
+description = "Generate fun human-friendly project names"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+keywords = ["name", "generator", "project", "fun"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.scripts]
+namzy = "namzy.cli:main"
+
+[tool.hatch.version]
+path = "src/namzy/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/namzy"]

namzy-0.1.0/src/namzy/CLAUDE.md

@@ -0,0 +1,7 @@
+<claude-mem-context>
+# Recent Activity
+
+<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
+
+*No recent activity*
+</claude-mem-context>

namzy-0.1.0/src/namzy/__init__.py

@@ -0,0 +1,58 @@
+# this_file: src/namzy/__init__.py
+"""namzy — fun human-friendly project name generator."""
+
+from __future__ import annotations
+
+import random
+import time
+
+from ._mangle import join_clean, mangle
+from ._wordlist import COMMON, GEO
+
+__version__ = "0.2.0"
+
+__all__ = ["generate"]
+
+_ONLINE_URL_TWO = "https://random-word-api.herokuapp.com/word?number=2&length=6"
+
+
+def _fetch_online() -> list[str] | None:
+    """Fetch two words from a public API. Returns None on any error."""
+    try:
+        import json
+        import urllib.request
+
+        with urllib.request.urlopen(_ONLINE_URL_TWO, timeout=3) as resp:
+            data = json.loads(resp.read().decode())
+            if isinstance(data, list):
+                words = [w for w in data if w.isalpha()]
+                if len(words) >= 2:
+                    return words[:2]
+    except Exception:
+        pass
+    return None
+
+
+def _pick_words(rng: random.Random, online: bool) -> tuple[str, str]:
+    """Return two raw lowercase words."""
+    if online:
+        fetched = _fetch_online()
+        if fetched:
+            return fetched[0].lower(), fetched[1].lower()
+    return rng.choice(GEO).lower(), rng.choice(COMMON).lower()
+
+
+def generate(online: bool = False, seed: int | None = None) -> str:
+    """Generate a fun project name.
+
+    Picks two words, fuses them with junction cleanup, applies consonant
+    rotation, and capitalizes the first letter.
+    """
+    if seed is None:
+        seed = time.time_ns()
+    rng = random.Random(seed)
+
+    a, b = _pick_words(rng, online)
+    fused = join_clean(a, b)
+    rotated = mangle(fused)
+    return rotated[:1].upper() + rotated[1:]

namzy-0.1.0/src/namzy/__main__.py

@@ -0,0 +1,7 @@
+# this_file: src/namzy/__main__.py
+"""Allow running as: python -m namzy"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

namzy-0.1.0/src/namzy/_mangle.py

@@ -0,0 +1,52 @@
+# this_file: src/namzy/_mangle.py
+"""Consonant-rotation mangling and word-junction cleanup."""
+
+from __future__ import annotations
+
+_ROT = {
+    "c": "q",
+    "f": "v",
+    "k": "c",
+    "q": "k",
+    "s": "z",
+    "z": "s",
+    "v": "f",
+    "w": "u",
+}
+
+_VOWELS = frozenset("aeiouy")
+
+
+def _rot_char(ch: str) -> str:
+    low = ch.lower()
+    if low in _ROT:
+        sub = _ROT[low]
+        return sub.upper() if ch.isupper() else sub
+    return ch
+
+
+def mangle(s: str) -> str:
+    """Apply per-letter consonant rotation, case-preserving."""
+    return "".join(_rot_char(c) for c in s)
+
+
+def join_clean(a: str, b: str) -> str:
+    """Fuse two raw lowercase words, smoothing the junction.
+
+    Up to two passes: drop first char of tail if it duplicates the last char
+    of head (case-insensitive), or if both are vowels.
+    """
+    head = a
+    tail = b
+    for _ in range(2):
+        if not head or not tail:
+            break
+        h = head[-1].lower()
+        t = tail[0].lower()
+        if h == t:
+            tail = tail[1:]
+        elif h in _VOWELS and t in _VOWELS:
+            tail = tail[1:]
+        else:
+            break
+    return head + tail

namzy-0.1.0/src/namzy/_wordlist.py

@@ -0,0 +1,18 @@
+# this_file: src/namzy/_wordlist.py
+"""Bundled word lists for offline name generation."""
+
+GEO = (
+    "tokyo", "paris", "oslo", "berlin", "lagos", "lima", "boston", "vienna",
+    "cairo", "kyoto", "delhi", "milan", "rome", "seoul", "dubai", "athens",
+    "nairobi", "bali", "oslo", "havana", "lisbon", "tunis", "bogota", "dakar",
+    "quito", "darwin", "perth", "bruges", "riga", "minsk", "sofia", "vilna",
+    "vaduz", "bern", "accra", "kigali", "abuja", "bamako", "niamey", "lome",
+)
+
+COMMON = (
+    "river", "stone", "ember", "frost", "harbor", "willow", "copper", "marble",
+    "anchor", "lantern", "cedar", "falcon", "drift", "mesa", "grove", "canyon",
+    "basin", "fern", "gale", "haven", "peak", "ridge", "shore", "tide",
+    "vale", "bluff", "brook", "crest", "delta", "flint", "glen", "helm",
+    "inlet", "jetty", "knoll", "loft", "moor", "notch", "orbit", "prism",
+)

namzy-0.1.0/src/namzy/cli.py

@@ -0,0 +1,43 @@
+# this_file: src/namzy/cli.py
+"""CLI entrypoint for namzy."""
+
+from __future__ import annotations
+
+import argparse
+import time
+
+from . import generate
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="namzy",
+        description="Generate fun human-friendly project names.",
+    )
+    parser.add_argument(
+        "--online",
+        action="store_true",
+        default=False,
+        help="Fetch words from a public API (falls back to offline on error)",
+    )
+    parser.add_argument(
+        "--count",
+        type=int,
+        default=1,
+        metavar="N",
+        help="Number of names to generate (default: 1)",
+    )
+    parser.add_argument(
+        "--seed",
+        type=int,
+        default=None,
+        metavar="INT",
+        help="Random seed for reproducible output",
+    )
+
+    args = parser.parse_args()
+
+    base_seed = args.seed if args.seed is not None else time.time_ns()
+
+    for i in range(args.count):
+        print(generate(online=args.online, seed=base_seed + i))