makememe 0.1.1__tar.gz → 0.1.2__tar.gz

{makememe-0.1.1 → makememe-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makememe
-Version: 0.1.1
+Version: 0.1.2
 Summary: A tiny zero-dependency CLI for generating memes via the free memegen.link API. Agent-friendly.
 Project-URL: Homepage, https://pypi.org/project/makememe/
 Project-URL: memegen.link API, https://api.memegen.link
@@ -32,20 +32,33 @@ meme drake "not reading docs" "reading docs" -o out.png
 
 ## Install
 
-Requires Python 3.8+.
+Requires Python 3.8+. Easiest is [uv](https://docs.astral.sh/uv/) (installs
+the `meme` command in its own isolated environment):
 
 ```bash
-pip install makememe
-# or, as an isolated tool:
-uv tool install makememe      # or: pipx install makememe
+uv tool install makememe          # or: pipx install makememe
 ```
 
-Run once without installing:
+Update later with:
+
+```bash
+uv tool upgrade makememe
+```
+
+Run once without installing anything:
 
 ```bash
 uvx --from makememe meme drake "a" "b"
 ```
 
+(If you specifically want pip: `python3 -m pip install makememe`.)
+
+Check the version anytime:
+
+```bash
+meme --version
+```
+
 ## Usage
 
 ```bash
@@ -109,21 +122,19 @@ meme drake "old way" "new way" --json    # generate, capture the path
 
 ### Claude Code skill
 
-A ready-made skill lives in [`skill/meme/`](skill/meme/SKILL.md). Install it so
-Claude Code auto-discovers the tool:
+The package bundles a Claude Code skill. After installing, run one command to
+make Claude Code auto-discover the tool:
 
 ```bash
-# user-level (all projects)
-mkdir -p ~/.claude/skills
-cp -r skill/meme ~/.claude/skills/meme
-
-# or project-level
-mkdir -p .claude/skills
-cp -r skill/meme .claude/skills/meme
+meme --install-skill              # installs into ~/.claude/skills/meme/ (all projects)
+meme --install-skill --project    # or into ./.claude/skills/meme/ (this repo only)
 ```
 
-Then just ask Claude Code things like *"make a drake meme about writing tests"*
-and it will call `meme` for you.
+Restart Claude Code, then just ask things like *"make a drake meme about
+writing tests"* and it will call `meme` for you.
+
+(Other agents like Codex don't use this skill format — they discover everything
+through `meme --help` and `meme --list`, which already works out of the box.)
 
 ## Robustness
 

{makememe-0.1.1 → makememe-0.1.2}/README.md

@@ -13,20 +13,33 @@ meme drake "not reading docs" "reading docs" -o out.png
 
 ## Install
 
-Requires Python 3.8+.
+Requires Python 3.8+. Easiest is [uv](https://docs.astral.sh/uv/) (installs
+the `meme` command in its own isolated environment):
 
 ```bash
-pip install makememe
-# or, as an isolated tool:
-uv tool install makememe      # or: pipx install makememe
+uv tool install makememe          # or: pipx install makememe
 ```
 
-Run once without installing:
+Update later with:
+
+```bash
+uv tool upgrade makememe
+```
+
+Run once without installing anything:
 
 ```bash
 uvx --from makememe meme drake "a" "b"
 ```
 
+(If you specifically want pip: `python3 -m pip install makememe`.)
+
+Check the version anytime:
+
+```bash
+meme --version
+```
+
 ## Usage
 
 ```bash
@@ -90,21 +103,19 @@ meme drake "old way" "new way" --json    # generate, capture the path
 
 ### Claude Code skill
 
-A ready-made skill lives in [`skill/meme/`](skill/meme/SKILL.md). Install it so
-Claude Code auto-discovers the tool:
+The package bundles a Claude Code skill. After installing, run one command to
+make Claude Code auto-discover the tool:
 
 ```bash
-# user-level (all projects)
-mkdir -p ~/.claude/skills
-cp -r skill/meme ~/.claude/skills/meme
-
-# or project-level
-mkdir -p .claude/skills
-cp -r skill/meme .claude/skills/meme
+meme --install-skill              # installs into ~/.claude/skills/meme/ (all projects)
+meme --install-skill --project    # or into ./.claude/skills/meme/ (this repo only)
 ```
 
-Then just ask Claude Code things like *"make a drake meme about writing tests"*
-and it will call `meme` for you.
+Restart Claude Code, then just ask things like *"make a drake meme about
+writing tests"* and it will call `meme` for you.
+
+(Other agents like Codex don't use this skill format — they discover everything
+through `meme --help` and `meme --list`, which already works out of the box.)
 
 ## Robustness
 

{makememe-0.1.1 → makememe-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makememe"
-version = "0.1.1"
+version = "0.1.2"
 description = "A tiny zero-dependency CLI for generating memes via the free memegen.link API. Agent-friendly."
 readme = "README.md"
 requires-python = ">=3.8"

{makememe-0.1.1/skill/meme → makememe-0.1.2/src/memecli}/SKILL.md

@@ -14,8 +14,8 @@ The `meme` command must be installed. Check with `meme --list`. If it's missing,
 install it:
 
 ```bash
-pip install makememe
-# or: uv tool install makememe
+uv tool install makememe
+# or: pipx install makememe
 ```
 
 ## Workflow

{makememe-0.1.1 → makememe-0.1.2}/src/memecli/__init__.py

@@ -1,6 +1,6 @@
 """meme - a tiny zero-dependency CLI over the free memegen.link API."""
 
-from .cli import build_url, download, escape, get_templates, main
+from .cli import build_url, download, escape, get_templates, get_version, main
 
-__version__ = "0.1.1"
+__version__ = get_version()
 __all__ = ["main", "build_url", "escape", "download", "get_templates", "__version__"]

{makememe-0.1.1 → makememe-0.1.2}/src/memecli/cli.py

@@ -29,6 +29,35 @@ import urllib.request
 API = "https://api.memegen.link"
 
 
+def get_version():
+    """Read the installed package version; fall back gracefully from source."""
+    try:
+        from importlib.metadata import version
+        return version("makememe")
+    except Exception:
+        return "0.0.0+source"
+
+
+def install_skill(project=False):
+    """Copy the bundled Claude Code skill into ~/.claude/skills/meme/ (or ./.claude
+    with project=True). Returns the path written."""
+    try:
+        from importlib.resources import files
+        content = files("memecli").joinpath("SKILL.md").read_text(encoding="utf-8")
+    except Exception:
+        # running from a source checkout without installed metadata
+        here = os.path.dirname(os.path.abspath(__file__))
+        with open(os.path.join(here, "SKILL.md"), encoding="utf-8") as f:
+            content = f.read()
+    base = os.getcwd() if project else os.path.expanduser("~")
+    dest_dir = os.path.join(base, ".claude", "skills", "meme")
+    os.makedirs(dest_dir, exist_ok=True)
+    dest = os.path.join(dest_dir, "SKILL.md")
+    with open(dest, "w", encoding="utf-8") as f:
+        f.write(content)
+    return dest
+
+
 # memegen path-segment escaping. Order matters: escape the escape chars first.
 # Confirmed from the API: space->_, _->__, -->--, ?->~q, newline->~n, "->''
 # Others use memegen's documented tilde codes; verify with --print-url if unsure.
@@ -96,6 +125,12 @@ def build_parser():
                "before your lines so it isn't read as a flag:\n"
                "  meme regret --json -- \"-26%\" \"WHY\"",
         formatter_class=argparse.RawDescriptionHelpFormatter)
+    ap.add_argument("--version", action="version",
+                    version=f"%(prog)s {get_version()}")
+    ap.add_argument("--install-skill", action="store_true",
+                    help="install the Claude Code skill into ~/.claude/skills/meme/ and exit")
+    ap.add_argument("--project", action="store_true",
+                    help="with --install-skill: install into ./.claude/skills/ instead of your home dir")
     ap.add_argument("template", nargs="?",
                     help="template id (see --list), or any id when using --bg")
     ap.add_argument("lines", nargs="*", help="text lines, in order")
@@ -119,6 +154,15 @@ def _run(argv=None):
     ap = build_parser()
     args = ap.parse_args(argv)
 
+    if args.install_skill:
+        try:
+            dest = install_skill(project=args.project)
+        except Exception as e:
+            sys.exit(f"could not install skill: {e}")
+        print(dest)
+        print("Skill installed. Restart Claude Code to pick it up.", file=sys.stderr)
+        return
+
     if args.list:
         try:
             list_templates(as_json=args.json)

{makememe-0.1.1 → makememe-0.1.2}/tests/test_cli.py

@@ -5,6 +5,7 @@ No network access required (network paths are covered by --print-url style asser
 """
 
 import io
+import os
 import unittest
 from contextlib import redirect_stderr, redirect_stdout
 
@@ -102,5 +103,29 @@ class TestCrashSafety(unittest.TestCase):
             cli.download = orig
 
 
+class TestNewCommands(unittest.TestCase):
+    def test_version_flag_prints_and_exits(self):
+        buf = io.StringIO()
+        with self.assertRaises(SystemExit) as ctx, redirect_stdout(buf):
+            cli.main(["--version"])
+        self.assertEqual(ctx.exception.code, 0)
+        self.assertIn("meme", buf.getvalue())
+
+    def test_install_skill_writes_file(self):
+        import tempfile
+        with tempfile.TemporaryDirectory() as d:
+            old = os.environ.get("HOME")
+            os.environ["HOME"] = d
+            try:
+                with redirect_stdout(io.StringIO()), redirect_stderr(io.StringIO()):
+                    cli.main(["--install-skill"])
+                dest = os.path.join(d, ".claude", "skills", "meme", "SKILL.md")
+                self.assertTrue(os.path.exists(dest))
+                self.assertIn("name: meme", open(dest).read())
+            finally:
+                if old is not None:
+                    os.environ["HOME"] = old
+
+
 if __name__ == "__main__":
     unittest.main()