cheatsheet-cli 0.1.0__py3-none-any.whl

cheatsheet/__init__.py

@@ -0,0 +1,137 @@
+"""
+cheatsheet — open, list, and search Will's cheatsheets from the terminal.
+
+Usage:
+    cheatsheet <topic>          Open topic in browser + print URL
+    cheatsheet <topic> --url    Print URL only
+    cheatsheet <topic> --term   Render markdown through bat
+    cheatsheet list             List all cheatsheets
+    cheatsheet search <q>       Fuzzy-search titles
+"""
+
+import json
+import shutil
+import subprocess
+import sys
+import urllib.request
+import webbrowser
+from pathlib import Path
+
+BASE_URL = "https://cheatsheets.khanpikehome.com"
+SHEETS_URL = f"{BASE_URL}/api/sheets.json"
+RAW_URL = f"{BASE_URL}/raw"
+
+
+def fetch_json(url: str):
+    with urllib.request.urlopen(url) as resp:
+        return json.loads(resp.read().decode())
+
+
+def fetch_text(url: str):
+    with urllib.request.urlopen(url) as resp:
+        return resp.read().decode()
+
+
+def get_sheets():
+    data = fetch_json(SHEETS_URL)
+    return data.get("rows", [])
+
+
+def find_sheet(slug: str):
+    """Find a sheet by slug (exact match)."""
+    sheets = get_sheets()
+    for s in sheets:
+        if s["slug"] == slug:
+            return s
+    return None
+
+
+def open_topic(slug: str, print_url: bool = False):
+    url = f"{BASE_URL}/{slug}"
+    if print_url:
+        print(url)
+    else:
+        print(url)
+        webbrowser.open(url)
+
+
+def render_term(slug: str):
+    raw = fetch_text(f"{RAW_URL}/{slug}.md")
+    # Strip YAML frontmatter
+    if raw.startswith("---"):
+        end = raw.find("---", 3)
+        if end != -1:
+            raw = raw[end + 3 :].lstrip()
+    # Pipe through bat if available
+    bat = shutil.which("bat")
+    if bat:
+        proc = subprocess.Popen([bat, "--language", "markdown", "--style", "plain"], stdin=subprocess.PIPE)
+        proc.communicate(raw.encode())
+    else:
+        print(raw)
+
+
+def list_sheets():
+    sheets = get_sheets()
+    for s in sorted(sheets, key=lambda x: x["slug"]):
+        title = s.get("title", "") or ""
+        print(f"{s['slug']:30s}  {title}")
+
+
+def search_sheets(query: str):
+    sheets = get_sheets()
+    q = query.lower()
+    results = []
+    for s in sheets:
+        if q in s["slug"].lower() or q in (s.get("title", "") or "").lower():
+            results.append(s)
+    if not results:
+        print(f"No matches for '{query}'")
+        return
+    for s in results:
+        title = s.get("title", "") or ""
+        print(f"{BASE_URL}/{s['slug']}  ({title})")
+
+
+def main():
+    if len(sys.argv) < 2:
+        print(__doc__.strip())
+        sys.exit(1)
+
+    cmd = sys.argv[1]
+
+    if cmd in ("-h", "--help"):
+        print(__doc__.strip())
+        return
+
+    if cmd == "list":
+        list_sheets()
+        return
+
+    if cmd == "search":
+        if len(sys.argv) < 3:
+            print("Usage: cheatsheet search <query>")
+            sys.exit(1)
+        search_sheets(" ".join(sys.argv[2:]))
+        return
+
+    # Topic commands
+    slug = cmd
+    sheet = find_sheet(slug)
+    if not sheet:
+        print(f"Unknown cheatsheet: {slug}", file=sys.stderr)
+        print("Run 'cheatsheet list' to see available topics.", file=sys.stderr)
+        sys.exit(1)
+
+    flags = set(sys.argv[2:])
+
+    if "--term" in flags:
+        render_term(slug)
+    elif "--url" in flags:
+        open_topic(slug, print_url=True)
+    else:
+        open_topic(slug)
+
+
+if __name__ == "__main__":
+    main()

cheatsheet_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: cheatsheet-cli
+Version: 0.1.0
+Summary: Open, list, and search Will's cheatsheets from the terminal
+Requires-Python: >=3.10

cheatsheet_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+cheatsheet/__init__.py,sha256=gLm2O2dmZ7i7R6DdD8dZDnswzVufhUu_c55bueWn9I0,3311
+cheatsheet_cli-0.1.0.dist-info/METADATA,sha256=_mFAHa37HMSsMoz4afem2JiwTF5-eUrT9LDols9Iw18,151
+cheatsheet_cli-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+cheatsheet_cli-0.1.0.dist-info/entry_points.txt,sha256=m8e1HB8HXSVocdH-ivDTUAhYeNTp-n_X9N210e8-TXg,47
+cheatsheet_cli-0.1.0.dist-info/RECORD,,

cheatsheet_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

cheatsheet_cli-0.1.0.dist-info/entry_points.txt

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