applyr 0.1.0__py3-none-any.whl

applyr/__init__.py

@@ -0,0 +1,3 @@
+"""applyr — CLI job application tracker designed for AI coding agents."""
+
+__version__ = "0.1.0"

applyr/cli.py

@@ -0,0 +1,245 @@
+"""CLI entry point — argparse setup, command routing, error handling."""
+
+import sys
+
+from applyr import __version__
+from applyr.commands import (
+    cmd_add,
+    cmd_delete,
+    cmd_export,
+    cmd_followups,
+    cmd_gaps,
+    cmd_init,
+    cmd_list,
+    cmd_pipeline,
+    cmd_search,
+    cmd_show,
+    cmd_stats,
+    cmd_summary,
+    cmd_trends,
+    cmd_update,
+)
+from applyr.cv import cmd_cv_generate, cmd_cv_pdf
+from applyr.db import init_db, VALID_STATUSES
+
+USAGE = f"""\
+applyr v{__version__} — CLI job application tracker for AI coding agents
+
+Usage: applyr <command> [options]
+
+Commands:
+  init                          Set up ~/.applyr/ (config, database, templates)
+  add '<json>'                  Register a new job offer
+  list [--status S] [--sort F]  List offers (default: last 50)
+  pipeline [--min-score N]      View offers grouped by status
+  show <id>                     Show full offer details
+  update <id> <status> [opts]   Update offer status
+  delete <id>                   Delete an offer
+  search <keyword> [--status S] Search by company/title/notes/tech_stack
+  stats                         Conversion funnel and metrics
+  gaps [--limit N]              Skill gap analysis
+  followups                     Pending/overdue follow-ups
+  trends [--period week|month]  Application trends over time
+  summary [--json]              Weekly summary (LLM-optimized)
+  export [--format csv|json]    Export all data
+  version                       Show version
+  help                          Show this help
+
+Statuses: {' | '.join(VALID_STATUSES)}
+
+Docs: https://github.com/DeibyGS/applyr
+"""
+
+
+def _safe_int(value: str, label: str = "ID") -> int | None:
+    """Parse string to int, print error and return None on failure."""
+    try:
+        return int(value)
+    except ValueError:
+        print(f"Error: {label} must be an integer, got: {value}")
+        return None
+
+
+def _get_flag(args: list[str], flag: str) -> str | None:
+    """Get the value after a flag like --status, or None if not present."""
+    if flag not in args:
+        return None
+    idx = args.index(flag)
+    if idx + 1 >= len(args):
+        print(f"Error: {flag} requires a value")
+        return None
+    return args[idx + 1]
+
+
+def _has_flag(args: list[str], flag: str) -> bool:
+    """Check if a flag is present."""
+    return flag in args
+
+
+def main():
+    args = sys.argv[1:]
+
+    if not args or args[0] in ("help", "--help", "-h"):
+        print(USAGE)
+        return
+
+    cmd = args[0]
+
+    if cmd in ("version", "--version", "-v"):
+        print(f"applyr v{__version__}")
+        return
+
+    # Commands that need DB initialized
+    if cmd != "init":
+        init_db()
+
+    if cmd == "init":
+        cmd_init()
+
+    elif cmd == "add":
+        if len(args) < 2:
+            print("Usage: applyr add '<json>'")
+            print("  Required: title")
+            print("  Optional: company, summary, date_received, date_applied,")
+            print("            compatibility_pct, status, canal, work_mode,")
+            print("            location, salary_min, salary_max, seniority_level,")
+            print("            role_category, tech_stack, cover_letter, job_url,")
+            print("            contact_name, contact_role, topics, notes")
+            return
+        cmd_add(args[1])
+
+    elif cmd == "list":
+        status = _get_flag(args, "--status")
+        sort_by = _get_flag(args, "--sort") or "date_applied"
+        limit = None
+        if _has_flag(args, "--all"):
+            limit = -1
+        elif _get_flag(args, "--limit") is not None:
+            limit = _safe_int(_get_flag(args, "--limit"), "--limit")
+            if limit is None:
+                return
+        cmd_list(status_filter=status, sort_by=sort_by, limit=limit)
+
+    elif cmd == "pipeline":
+        min_score = 0
+        raw = _get_flag(args, "--min-score")
+        if raw is not None:
+            min_score = _safe_int(raw, "--min-score")
+            if min_score is None:
+                return
+        cmd_pipeline(min_score=min_score)
+
+    elif cmd == "show":
+        if len(args) < 2:
+            print("Usage: applyr show <id>")
+            return
+        offer_id = _safe_int(args[1])
+        if offer_id is not None:
+            cmd_show(offer_id)
+
+    elif cmd == "update":
+        if len(args) < 3:
+            print("Usage: applyr update <id> <status> [--notes '...'] [--canal '...']")
+            print(f"  Statuses: {', '.join(VALID_STATUSES)}")
+            return
+        offer_id = _safe_int(args[1])
+        if offer_id is None:
+            return
+        status = args[2]
+        notes = _get_flag(args, "--notes")
+        canal = _get_flag(args, "--canal")
+        cmd_update(offer_id, status, notes, canal)
+
+    elif cmd == "delete":
+        if len(args) < 2:
+            print("Usage: applyr delete <id>")
+            return
+        offer_id = _safe_int(args[1])
+        if offer_id is not None:
+            cmd_delete(offer_id)
+
+    elif cmd == "search":
+        if len(args) < 2:
+            print("Usage: applyr search <keyword> [--status S]")
+            return
+        status = _get_flag(args, "--status")
+        # Collect keyword (everything between cmd and flags)
+        keyword_parts = []
+        i = 1
+        while i < len(args):
+            if args[i].startswith("--"):
+                i += 2  # skip flag and its value
+                continue
+            keyword_parts.append(args[i])
+            i += 1
+        keyword = " ".join(keyword_parts)
+        cmd_search(keyword, status_filter=status)
+
+    elif cmd == "stats":
+        cmd_stats()
+
+    elif cmd == "gaps":
+        limit = 10
+        raw = _get_flag(args, "--limit")
+        if raw is not None:
+            limit = _safe_int(raw, "--limit")
+            if limit is None:
+                return
+        cmd_gaps(limit=limit)
+
+    elif cmd == "followups":
+        cmd_followups()
+
+    elif cmd == "trends":
+        period = _get_flag(args, "--period") or "week"
+        if period not in ("week", "month"):
+            print(f"Error: period must be 'week' or 'month', got: {period}")
+            return
+        cmd_trends(period=period)
+
+    elif cmd == "summary":
+        as_json = _has_flag(args, "--json")
+        cmd_summary(as_json=as_json)
+
+    elif cmd == "export":
+        fmt = _get_flag(args, "--format") or "csv"
+        if fmt not in ("csv", "json"):
+            print(f"Error: format must be 'csv' or 'json', got: {fmt}")
+            return
+        filepath = _get_flag(args, "--file")
+        cmd_export(fmt=fmt, filepath=filepath)
+
+    elif cmd == "cv":
+        if len(args) < 2:
+            print("Usage:")
+            print("  applyr cv generate <id> [--template ats]  Generate CV for offer")
+            print("  applyr cv pdf <html-file> [--output f.pdf] HTML to PDF via Chrome")
+            return
+        subcmd = args[1]
+        if subcmd == "generate":
+            if len(args) < 3:
+                print("Usage: applyr cv generate <id> [--template ats]")
+                return
+            offer_id = _safe_int(args[2])
+            if offer_id is None:
+                return
+            template = _get_flag(args, "--template") or "ats"
+            cmd_cv_generate(offer_id, template=template)
+        elif subcmd == "pdf":
+            if len(args) < 3:
+                print("Usage: applyr cv pdf <html-file> [--output file.pdf]")
+                return
+            html_file = args[2]
+            output = _get_flag(args, "--output")
+            cmd_cv_pdf(html_file, output=output)
+        else:
+            print(f"Unknown cv subcommand: '{subcmd}'")
+            print("  Available: generate, pdf")
+
+    else:
+        print(f"Unknown command: '{cmd}'")
+        print(f"Run 'applyr help' to see available commands.")
+
+
+if __name__ == "__main__":
+    main()