makememe 0.1.4__tar.gz → 0.1.6__tar.gz

{makememe-0.1.4 → makememe-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makememe
-Version: 0.1.4
+Version: 0.1.6
 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
@@ -67,10 +67,12 @@ meme <template> "top line" "bottom line" [-o out.png]
 
 | Flag | Meaning |
 |------|---------|
+| `-t, --template` | template id as a flag (alternative to the positional). Agents should use this so a single permission approval covers every template |
 | `-o, --out` | output file (default: a unique file in a temp folder, so it never writes into your current directory) |
 | `--bg URL` | use a custom background image instead of a template |
 | `--ext` | `png` (default), `jpg`, `webp`, or `gif` |
 | `--style` / `--font` | template style variant / font override |
+| `--open` | open the finished image in your default viewer |
 | `--print-url` | print the image URL, don't download |
 | `--json` | machine-readable output (for scripts/agents) |
 | `--list` | list available template ids |

{makememe-0.1.4 → makememe-0.1.6}/README.md

@@ -48,10 +48,12 @@ meme <template> "top line" "bottom line" [-o out.png]
 
 | Flag | Meaning |
 |------|---------|
+| `-t, --template` | template id as a flag (alternative to the positional). Agents should use this so a single permission approval covers every template |
 | `-o, --out` | output file (default: a unique file in a temp folder, so it never writes into your current directory) |
 | `--bg URL` | use a custom background image instead of a template |
 | `--ext` | `png` (default), `jpg`, `webp`, or `gif` |
 | `--style` / `--font` | template style variant / font override |
+| `--open` | open the finished image in your default viewer |
 | `--print-url` | print the image URL, don't download |
 | `--json` | machine-readable output (for scripts/agents) |
 | `--list` | list available template ids |

{makememe-0.1.4 → makememe-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "makememe"
-version = "0.1.4"
+version = "0.1.6"
 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.4 → makememe-0.1.6}/src/memecli/SKILL.md

@@ -34,11 +34,15 @@ uv tool install makememe
    **Always verify an id with `meme --list --json` before using it** — guessing
    ids (e.g. `buttons`, `twobuttons`) leads to 404s. When unsure, list first.
 
-2. **Generate.** Pass the template id then the caption lines in order. Use
-   `--json` so you can capture the output path reliably:
+2. **Generate.** Pass the template id with `-t` (as a flag, not the leading
+   word) then the caption lines in order. Always use `--json` (reliable output
+   path) and `--open` (opens the finished meme in the user's default viewer).
+
+   Using `-t` matters: every call starts with the same `meme -t ...` prefix, so
+   the user only has to approve the command **once** — not once per template.
 
    ```bash
-   meme drake "writing code by hand" "asking the meme cli" --json
+   meme -t drake "writing code by hand" "asking the meme cli" --json --open
    ```
 
    Output:
@@ -47,7 +51,8 @@ uv tool install makememe
    { "path": "/tmp/makememe/meme-ab12cd.png", "bytes": 12345, "url": "https://api.memegen.link/..." }
    ```
 
-3. **Tell the user the path** (and show the image if the surface supports it).
+3. **Tell the user the path.** The `--open` flag already popped the image open
+   for them; just report where it was saved.
 
 ## Key flags
 
@@ -58,6 +63,8 @@ uv tool install makememe
 - `--bg <image-url>` — use a custom background image instead of a template;
   pass caption lines as usual.
 - `--ext png|jpg|webp|gif` — output format.
+- `--open` — open the finished image in the user's default viewer (use this so
+  they can see the meme).
 - `--print-url` — get the image URL without downloading.
 - `--json` — machine-readable output (always prefer this when scripting).
 
@@ -77,8 +84,8 @@ uv tool install makememe
 ## Examples
 
 ```bash
-meme drake "old way" "new way" -o drake.png --json
-meme same "after I sold" "if I held" "same picture" --json
-meme cmm "tabs are better than spaces" --json
-meme --bg https://example.com/cat.png "_" "DEPLOY ON FRIDAY" --json
+meme -t drake "old way" "new way" --json --open
+meme -t same "after I sold" "if I held" "same picture" --json --open
+meme -t cmm "tabs are better than spaces" --json --open
+meme --bg https://example.com/cat.png "_" "DEPLOY ON FRIDAY" --json --open
 ```

{makememe-0.1.4 → makememe-0.1.6}/src/memecli/cli.py

@@ -22,6 +22,8 @@ Find templates: https://api.memegen.link/templates/  (or `meme --list`)
 import argparse
 import json
 import os
+import shutil
+import subprocess
 import sys
 import tempfile
 import urllib.parse
@@ -30,6 +32,21 @@ import urllib.request
 API = "https://api.memegen.link"
 
 
+def open_file(path):
+    """Open a file with the OS default viewer. Best-effort; never raises."""
+    try:
+        if sys.platform == "darwin":
+            subprocess.run(["open", path], check=False)
+        elif sys.platform.startswith("win"):
+            os.startfile(path)  # noqa: B606  (Windows only)
+        else:
+            opener = shutil.which("xdg-open")
+            if opener:
+                subprocess.run([opener, path], check=False)
+    except Exception:
+        pass
+
+
 def default_output(ext):
     """A unique output path in a grouped temp folder, so we never write into the
     user's project/root dir and never clobber a previous meme."""
@@ -145,6 +162,9 @@ def build_parser():
     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")
+    ap.add_argument("-t", "--template", dest="template_flag",
+                    help="template id as a flag (keeps a constant command prefix, "
+                         "so one permission approval covers every template)")
     ap.add_argument("-o", "--out", default=None,
                     help="output file (default: a temp folder, not your current dir)")
     ap.add_argument("--bg",
@@ -152,6 +172,8 @@ def build_parser():
     ap.add_argument("--ext", default="png", choices=["png", "jpg", "webp", "gif"])
     ap.add_argument("--style", help="template style variant, if any")
     ap.add_argument("--font", help="font name (see /fonts/)")
+    ap.add_argument("--open", action="store_true", dest="open_after",
+                    help="open the saved image in the OS default viewer")
     ap.add_argument("--print-url", action="store_true",
                     help="print the URL and exit, no download")
     ap.add_argument("--json", action="store_true",
@@ -181,16 +203,20 @@ def _run(argv=None):
             sys.exit(f"could not fetch templates: {e}")
         return
 
-    if not args.template and not args.bg:
+    if not args.template and not args.template_flag and not args.bg:
         ap.error("a template id is required (or use --bg for a custom background)")
 
-    # with --bg there is no template positional, so fold it back into the lines
+    # with --bg or -t the template isn't the leading positional, so fold the
+    # positional back into the text lines.
     if args.bg:
-        lines = ([args.template] if args.template else []) + args.lines
         template = "custom"
+        lines = ([args.template] if args.template else []) + args.lines
+    elif args.template_flag:
+        template = args.template_flag
+        lines = ([args.template] if args.template else []) + args.lines
     else:
-        lines = args.lines
         template = args.template
+        lines = args.lines
 
     url = build_url(template, lines, args.ext, args.bg, args.style, args.font)
 
@@ -222,6 +248,9 @@ def _run(argv=None):
             msg += f"\nhint: {hint}"
         sys.exit(msg)
 
+    if args.open_after:
+        open_file(out)
+
     if args.json:
         print(json.dumps({"path": out, "bytes": n, "url": url}))
     else:

{makememe-0.1.4 → makememe-0.1.6}/tests/test_cli.py

@@ -84,6 +84,17 @@ class TestCrashSafety(unittest.TestCase):
             cli.main(["drake", "a", "b", "--print-url"])
         self.assertIn("api.memegen.link/images/drake/a/b.png", buf.getvalue())
 
+    def test_template_flag_matches_positional(self):
+        def url_for(argv):
+            buf = io.StringIO()
+            with redirect_stdout(buf):
+                cli.main(argv)
+            return buf.getvalue().strip()
+        self.assertEqual(
+            url_for(["-t", "drake", "a", "b", "--print-url"]),
+            url_for(["drake", "a", "b", "--print-url"]),
+        )
+
     def test_keyboard_interrupt_becomes_130(self):
         orig = cli.download
         cli.download = lambda *a, **k: (_ for _ in ()).throw(KeyboardInterrupt())