hashname-cli 0.1.0__py3-none-any.whl

hashname_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: hashname-cli
+Version: 0.1.0
+Summary: Generate deterministic human-readable names from any input
+Author-email: Marcus <marcus.builds.things@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/hashname
+Keywords: cli,hash,name,deterministic,human-readable
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Dynamic: license-file
+
+# hashname-cli
+
+Generate deterministic human-readable names from any input — hashes, UUIDs, IPs, commit SHAs, anything.
+
+Same input always produces the same name. Like Docker container names, but for everything.
+
+## Install
+
+```bash
+pip install hashname-cli
+```
+
+## Usage
+
+```bash
+# Basic naming
+hashname name "abc123"              # → keen-spark
+hashname name "192.168.1.1"        # → golden-reef
+
+# More words for uniqueness
+hashname name "abc123" -w 3        # → keen-cosmic-spark
+
+# Capitalize
+hashname name "abc123" -c          # → Keen-Spark
+
+# Custom separator
+hashname name "abc123" -s "_"      # → keen_spark
+
+# Multiple names from one input
+hashname name "server" -n 5
+
+# Batch processing
+hashname batch id1 id2 id3
+echo -e "hash1\nhash2" | hashname batch
+
+# JSON output
+hashname name "abc123" --json
+
+# Verify determinism
+hashname verify "abc123"
+
+# Word list stats
+hashname stats
+```
+
+## Why?
+
+- **Log readability**: Replace `a4995e18227e62fa` with `bold-ember`
+- **Quick identification**: Same hash = same name, every time
+- **No collisions needed**: It's a label, not a UUID
+- **Agent-friendly**: `--json` output, predictable CLI
+
+## For AI Agents
+
+See [SKILL.md](SKILL.md) for agent-optimized documentation.

hashname_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+hashname_cli.py,sha256=2T5OSH12h_5fXm-xU2tb7euKFLA_HjwZqLG9NJlaNzc,6101
+hashname_cli-0.1.0.dist-info/licenses/LICENSE,sha256=9tNBpWq8KGbuJqmeComp40OiNnbvpvsKn1YP26PUtck,1063
+hashname_cli-0.1.0.dist-info/METADATA,sha256=mfvm869g0qnv2oM0qXZWnECryAJE989qKntgEe-3KJA,1857
+hashname_cli-0.1.0.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+hashname_cli-0.1.0.dist-info/entry_points.txt,sha256=vU-4LuEUfhMkZNTqA1-O6vELhAohrv-gqia-gRA932g,47
+hashname_cli-0.1.0.dist-info/top_level.txt,sha256=cOpDkxysuDx639m7OLOBpGjp0iYQ9pf9ub-f_9E8d_0,13
+hashname_cli-0.1.0.dist-info/RECORD,,

hashname_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hashname_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hashname = hashname_cli:main

hashname_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hashname_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hashname_cli

hashname_cli.py

@@ -0,0 +1,157 @@
+"""hashname-cli - Generate deterministic human-readable names from any input."""
+
+import hashlib
+import json
+import sys
+
+import click
+
+__version__ = "0.1.0"
+
+ADJECTIVES = [
+    "ancient", "bold", "calm", "dark", "eager", "fierce", "gentle", "happy",
+    "icy", "jolly", "keen", "lively", "mellow", "noble", "odd", "proud",
+    "quiet", "rapid", "sharp", "tall", "unique", "vivid", "warm", "young",
+    "zesty", "bright", "clever", "daring", "elegant", "fancy", "golden",
+    "hollow", "iron", "jade", "kind", "lucky", "mighty", "neat", "orange",
+    "pale", "quick", "red", "silver", "tidy", "ultra", "vast", "wild",
+    "xenial", "yellow", "zen", "arctic", "blazing", "cosmic", "deep",
+    "electric", "frozen", "grand", "hidden", "infinite", "jeweled", "kinetic",
+    "lunar", "misty", "neon", "opaque", "phantom", "quartz", "rustic",
+    "sonic", "turbo", "umbral", "velvet", "wired", "crystal", "digital",
+    "ember", "fading", "glowing", "hazy", "ivory", "jumbo", "krypton",
+    "liquid", "marble", "nimble", "obsidian", "pixel", "quantum", "royal",
+    "steel", "toxic", "urban", "violet", "woven", "xerox", "yonder", "zero",
+    "atomic", "binary", "chrome", "dusty", "epic", "flint", "granite",
+    "hyper", "indigo", "jungle", "karma", "lemon", "molten", "nova",
+    "onyx", "prism", "quill", "rogue", "scarlet", "terra", "ultra",
+    "vortex", "whisper", "xenon", "yew", "zinc",
+]
+
+NOUNS = [
+    "alpha", "bear", "cloud", "dawn", "echo", "flame", "ghost", "hawk",
+    "iris", "jade", "kite", "lion", "moon", "nest", "oak", "pine",
+    "quail", "river", "stone", "tiger", "unity", "vine", "wolf", "xenon",
+    "yarn", "zephyr", "arrow", "blade", "comet", "dusk", "ember", "frost",
+    "grove", "haze", "isle", "jewel", "knot", "leaf", "mist", "north",
+    "orbit", "pearl", "quest", "reef", "spark", "trail", "umber", "vale",
+    "wave", "pixel", "yak", "zen", "anchor", "brook", "crest", "delta",
+    "eagle", "flare", "glyph", "horn", "icon", "jazz", "kelp", "lark",
+    "marsh", "nova", "opal", "plume", "quartz", "raven", "sage", "thorn",
+    "urchin", "vault", "wren", "axis", "byte", "crane", "drift", "fern",
+    "grain", "helm", "igloo", "jinx", "karma", "lotus", "mesa", "nexus",
+    "ore", "pulse", "ridge", "shard", "torch", "union", "vigor", "wisp",
+    "flux", "yew", "zone", "apex", "blaze", "cliff", "dome", "edge",
+    "forge", "gale", "husk", "ink", "jet", "keel", "lance", "maze",
+    "null", "oxide", "pike", "quad", "rust", "scope", "tide", "urge",
+    "vibe", "warp", "xray", "yoke", "zip",
+]
+
+def _hash_bytes(text: str) -> bytes:
+    return hashlib.sha256(text.encode("utf-8")).digest()
+
+
+def generate_name(text: str, words: int = 2, sep: str = "-", capitalize: bool = False) -> str:
+    h = _hash_bytes(text)
+    parts = []
+    for i in range(words - 1):
+        idx = int.from_bytes(h[i*2:i*2+2], "big") % len(ADJECTIVES)
+        parts.append(ADJECTIVES[idx])
+    noun_idx = int.from_bytes(h[(words-1)*2:(words-1)*2+2], "big") % len(NOUNS)
+    parts.append(NOUNS[noun_idx])
+    if capitalize:
+        parts = [p.capitalize() for p in parts]
+    return sep.join(parts)
+
+
+def _output(data: dict, as_json: bool):
+    if as_json:
+        click.echo(json.dumps(data))
+    else:
+        click.echo(data.get("name", data.get("output", "")))
+
+
+@click.group()
+@click.version_option(__version__)
+def cli():
+    """Generate deterministic human-readable names from any input."""
+    pass
+
+
+@cli.command()
+@click.argument("text")
+@click.option("-w", "--words", default=2, help="Number of words (default: 2)")
+@click.option("-s", "--sep", default="-", help="Separator (default: -)")
+@click.option("-c", "--capitalize", is_flag=True, help="Capitalize words")
+@click.option("-n", "--count", default=1, help="Generate N names (varies suffix)")
+@click.option("--json", "as_json", is_flag=True, help="JSON output")
+def name(text, words, sep, capitalize, count, as_json):
+    """Generate a name from input text."""
+    if count == 1:
+        n = generate_name(text, words, sep, capitalize)
+        _output({"input": text, "name": n}, as_json)
+    else:
+        names = []
+        for i in range(count):
+            input_val = f"{text}:{i}" if i > 0 else text
+            names.append(generate_name(input_val, words, sep, capitalize))
+        if as_json:
+            click.echo(json.dumps({"input": text, "count": count, "names": names}))
+        else:
+            for n in names:
+                click.echo(n)
+
+
+@cli.command()
+@click.argument("texts", nargs=-1)
+@click.option("-w", "--words", default=2, help="Number of words")
+@click.option("-s", "--sep", default="-", help="Separator")
+@click.option("-c", "--capitalize", is_flag=True, help="Capitalize words")
+@click.option("--json", "as_json", is_flag=True, help="JSON output")
+def batch(texts, words, sep, capitalize, as_json):
+    """Generate names for multiple inputs."""
+    if not texts:
+        # Read from stdin
+        texts = [line.strip() for line in sys.stdin if line.strip()]
+    results = []
+    for t in texts:
+        n = generate_name(t, words, sep, capitalize)
+        results.append({"input": t, "name": n})
+    if as_json:
+        click.echo(json.dumps(results))
+    else:
+        for r in results:
+            click.echo(f"{r['input']}\t{r['name']}")
+
+
+@cli.command()
+@click.argument("text")
+@click.option("-w", "--words", default=2, help="Number of words")
+@click.option("-s", "--sep", default="-", help="Separator")
+def verify(text, words, sep):
+    """Verify determinism — run twice, same result."""
+    a = generate_name(text, words, sep)
+    b = generate_name(text, words, sep)
+    if a == b:
+        click.echo(f"✓ Deterministic: {a}")
+    else:
+        click.echo(f"✗ MISMATCH: {a} != {b}", err=True)
+        sys.exit(1)
+
+
+@cli.command()
+def stats():
+    """Show word list sizes and possible combinations."""
+    adj = len(ADJECTIVES)
+    noun = len(NOUNS)
+    click.echo(f"Adjectives: {adj}")
+    click.echo(f"Nouns:      {noun}")
+    click.echo(f"2-word combos: {adj * noun:,}")
+    click.echo(f"3-word combos: {adj * adj * noun:,}")
+
+
+def main():
+    cli()
+
+if __name__ == "__main__":
+    main()