catime 0.2.0__py3-none-any.whl

catime/__init__.py

@@ -0,0 +1,3 @@
+"""catime - AI-generated hourly cat images."""
+
+__version__ = "0.2.0"

catime/cli.py

@@ -0,0 +1,127 @@
+"""CLI entry point for catime - view AI-generated hourly cats."""
+
+import argparse
+import json
+import re
+import sys
+from datetime import datetime, timezone, timedelta
+from pathlib import Path
+
+import httpx
+
+CATLIST_URL = "https://raw.githubusercontent.com/{repo}/main/catlist.json"
+DEFAULT_REPO = "yazelin/catime"
+
+
+def fetch_catlist(repo: str) -> list[dict]:
+    url = CATLIST_URL.format(repo=repo)
+    resp = httpx.get(url, follow_redirects=True)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def load_local_catlist() -> list[dict]:
+    p = Path(__file__).resolve().parent.parent.parent / "catlist.json"
+    if p.exists():
+        return json.loads(p.read_text())
+    return []
+
+
+def print_cat(cat: dict, index: int | None = None):
+    """Print a single cat entry."""
+    num = cat.get("number") or index
+    status = cat.get("status", "success")
+    if status == "failed":
+        print(f"Cat #{num or '?':>4}  [FAILED]  {cat['timestamp']}  error: {cat.get('error', '?')}")
+    else:
+        print(f"Cat #{num:>4}  {cat['timestamp']}  model: {cat.get('model', '?')}")
+        print(f"  URL: {cat['url']}")
+
+
+def filter_by_query(cats: list[dict], query: str) -> list[dict]:
+    """Filter cats by time query: date, date+hour, today, yesterday."""
+    now = datetime.now(timezone.utc)
+
+    if query == "today":
+        target_date = now.strftime("%Y-%m-%d")
+        return [c for c in cats if c["timestamp"].startswith(target_date)]
+
+    if query == "yesterday":
+        target_date = (now - timedelta(days=1)).strftime("%Y-%m-%d")
+        return [c for c in cats if c["timestamp"].startswith(target_date)]
+
+    # date+hour: 2026-01-30T05 or 2026-01-30 05
+    m = re.match(r"^(\d{4}-\d{2}-\d{2})[T ](\d{1,2})$", query)
+    if m:
+        date_str, hour_str = m.group(1), m.group(2).zfill(2)
+        prefix = f"{date_str} {hour_str}:"
+        return [c for c in cats if c["timestamp"].startswith(prefix)]
+
+    # date only: 2026-01-30
+    if re.match(r"^\d{4}-\d{2}-\d{2}$", query):
+        return [c for c in cats if c["timestamp"].startswith(query)]
+
+    return []
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="catime",
+        description="View AI-generated hourly cat images",
+    )
+    parser.add_argument(
+        "query", nargs="?",
+        help="Cat number (e.g. 42), date (2026-01-30), date+hour (2026-01-30T05), 'today', or 'yesterday'.",
+    )
+    parser.add_argument("--repo", default=DEFAULT_REPO, help="GitHub repo owner/name")
+    parser.add_argument("--local", action="store_true", help="Use local catlist.json")
+    parser.add_argument("--list", action="store_true", help="List all cats")
+    args = parser.parse_args()
+
+    try:
+        cats = load_local_catlist() if args.local else fetch_catlist(args.repo)
+    except Exception as e:
+        print(f"Error loading cat list: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    if not cats:
+        print("No cats yet! Check back in an hour.")
+        return
+
+    if args.list:
+        for i, cat in enumerate(cats, 1):
+            print_cat(cat, i)
+        return
+
+    if args.query is None:
+        print(f"Total cats: {len(cats)}")
+        print(f"Latest: #{len(cats):04d}  {cats[-1]['timestamp']}")
+        print()
+        print("Usage:")
+        print("  catime 42              View cat #42")
+        print("  catime today           List today's cats")
+        print("  catime yesterday       List yesterday's cats")
+        print("  catime 2026-01-30      List all cats from a date")
+        print("  catime 2026-01-30T05   View the cat from a specific hour")
+        print("  catime --list          List all cats")
+        return
+
+    # Try as number first
+    if args.query.isdigit():
+        idx = int(args.query) - 1
+        if idx < 0 or idx >= len(cats):
+            print(f"Cat #{args.query} not found. Available: 1-{len(cats)}", file=sys.stderr)
+            sys.exit(1)
+        print_cat(cats[idx], int(args.query))
+        return
+
+    # Try as time query
+    matched = filter_by_query(cats, args.query)
+    if not matched:
+        print(f"No cats found for '{args.query}'.", file=sys.stderr)
+        sys.exit(1)
+
+    print(f"Found {len(matched)} cat(s) for '{args.query}':\n")
+    for cat in matched:
+        print_cat(cat)
+        print()

catime-0.2.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: catime
+Version: 0.2.0
+Summary: AI-generated hourly cat images - a new cat every hour!
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Description-Content-Type: text/markdown
+
+# catime
+
+AI-generated hourly cat images. A new cat every hour!
+
+## Usage
+
+```bash
+uvx catime              # Show total cat count
+uvx catime 42           # View cat #42
+uvx catime today        # List today's cats
+uvx catime yesterday    # List yesterday's cats
+uvx catime 2026-01-30   # List all cats from a date
+uvx catime 2026-01-30T05  # View the cat from a specific hour
+uvx catime --list       # List all cats
+```

catime-0.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+catime/__init__.py,sha256=f37KsktucfUui7NyCuEJRZT_WMFOIcUFCWao5y9wsyM,70
+catime/cli.py,sha256=dDMYM6UvXQlDldni2rfQ70CsjUwIaQGPZj6Egcd4t8M,4243
+catime-0.2.0.dist-info/METADATA,sha256=bfR_tARqCSml9MpfEOnZZnBUz1bMgGF3OTPSsX88GV8,665
+catime-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+catime-0.2.0.dist-info/entry_points.txt,sha256=oPgi6h026vMo9YyEOH3wuNtD3A28e-s1ChJs-KWWGXw,43
+catime-0.2.0.dist-info/licenses/LICENSE,sha256=p_h5YRMaNCwMqGXX5KDrk49_NWGpzAJ2d6IhKa67B0E,1064
+catime-0.2.0.dist-info/RECORD,,

catime-0.2.0.dist-info/WHEEL

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

catime-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+catime = catime.cli:main

catime-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yazelin
+
+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.