grindx 0.1.0__tar.gz

grindx-0.1.0/LICENSE

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

grindx-0.1.0/PKG-INFO

@@ -0,0 +1,169 @@
+Metadata-Version: 2.4
+Name: grindx
+Version: 0.1.0
+Summary: Distraction-free DSA practice in your terminal
+Author: xghostient
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/xghostient/grindx
+Project-URL: Repository, https://github.com/xghostient/grindx
+Keywords: dsa,leetcode,terminal,tui,practice
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Topic :: Education
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=1.0.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.21.0
+Requires-Dist: tree-sitter-go>=0.21.0
+Dynamic: license-file
+
+# grindx
+
+Distraction-free DSA practice in your terminal. Zero network footprint.
+
+![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+## Why grindx?
+
+- **Zero network calls** — everything runs locally, no tracking (optional AI review)
+- **Terminal-native** — practice DSA without leaving your terminal or opening a browser
+- **Multiple sheets** — Striver A2Z (316), Blind 75, NeetCode 150, Grind 75 built-in
+- **Python & Go** — switch languages on the fly with `Ctrl+L`
+- **Progress tracking** — solved/in-progress/not-started states, streaks, best times
+- **Bookmarks & filters** — filter by difficulty (Easy/Medium/Hard) or bookmarked problems
+
+## Install
+
+```bash
+pip install grindx
+```
+
+Or with [pipx](https://pipx.pypa.io/) (recommended for CLI tools):
+
+```bash
+pipx install grindx
+```
+
+Or run from source:
+
+```bash
+git clone https://github.com/xghostient/grindx.git
+cd grindx
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+grindx
+```
+
+## Usage
+
+```bash
+grindx            # CLI entry point
+python -m grindx  # or as a module
+```
+
+### Navigation
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate topics / problems |
+| `←` `→` | Switch between topic and problem panes |
+| `Enter` | Select topic or open problem |
+| `Esc` | Go back |
+| `q` | Quit |
+
+### Filters
+
+| Key | Filter |
+|-----|--------|
+| `a` | All problems |
+| `e` | Easy |
+| `m` | Medium |
+| `h` | Hard |
+| `b` | Bookmarked |
+| `s` | Stats dashboard |
+
+### Solve Screen
+
+| Key | Action |
+|-----|--------|
+| `Ctrl+S` | Save code |
+| `Ctrl+D` | Toggle solved |
+| `Ctrl+E` | AI review |
+| `Ctrl+L` | Switch Python / Go |
+| `Ctrl+B` | Toggle bookmark |
+| `Ctrl+T` | Pause / resume timer |
+| `Ctrl+R` | Reset timer |
+| `Ctrl+Shift+C` | Copy selection to clipboard |
+| `Ctrl+Shift+V` | Paste from clipboard |
+| `Alt+↑` / `Alt+↓` | Move line up / down |
+| `Alt+Shift+↓` | Duplicate line |
+| `Esc` | Save & go back |
+
+## Features
+
+**Split-pane editor** — problem description on the left, code editor with syntax highlighting on the right.
+
+**Auto-timer** — starts when you open a problem, tracks your best solve time.
+
+**Three-state tracking** — each problem shows as not started (○), in progress (◐), or solved (✓).
+
+**Stats dashboard** — overall progress, per-difficulty breakdown, per-topic progress bars, current streak, and top 10 best times.
+
+**Sheet-agnostic** — built-in sheets live inside the package (`grindx/sheets/`). Format:
+
+```json
+{
+  "Topic Name": ["problem-name-1", "problem-name-2"],
+  "Another Topic": ["problem-name-3"]
+}
+```
+
+**Progress safety** — automatic backups with corruption recovery. Progress, solutions, and backups are stored in `~/.grindx/` so they persist across installs and upgrades.
+
+## AI Review (optional)
+
+Press `Ctrl+E` on the solve screen to get AI-powered feedback on your solution — correctness, edge cases, complexity analysis, and a pass/fail verdict.
+
+### Setup
+
+Set two environment variables:
+
+```bash
+export GRINDX_AI_PROVIDER=groq              # or ollama, anthropic, openai
+export GRINDX_AI_MODEL=llama-3.3-70b-versatile  # optional, sensible defaults per provider
+export GRINDX_AI_KEY=gsk_...                # not needed for ollama
+export GRINDX_AI_URL=https://custom.api/v1  # optional, auto-detected per provider
+```
+
+Or create `~/.grindx.toml`:
+
+```toml
+[ai]
+provider = "groq"
+model = "llama-3.3-70b-versatile"
+api_key = "gsk_..."
+```
+
+### Supported Providers
+
+| Provider | API Key | Default Model | Notes |
+|----------|---------|---------------|-------|
+| `ollama` | No | llama3 | Local, free, no network |
+| `groq` | Yes | llama-3.3-70b-versatile | Fast, free tier available |
+| `anthropic` | Yes | claude-sonnet-4-20250514 | Claude |
+| `openai` | Yes | gpt-4o | GPT |
+
+Any OpenAI-compatible API works — set provider to `openai` and add `base_url`.
+
+## Built with
+
+- [Textual](https://github.com/Textualize/textual) — TUI framework
+- [tree-sitter](https://tree-sitter.github.io/) — syntax highlighting
+
+## License
+
+MIT

grindx-0.1.0/README.md

@@ -0,0 +1,147 @@
+# grindx
+
+Distraction-free DSA practice in your terminal. Zero network footprint.
+
+![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
+![License: MIT](https://img.shields.io/badge/license-MIT-green)
+
+## Why grindx?
+
+- **Zero network calls** — everything runs locally, no tracking (optional AI review)
+- **Terminal-native** — practice DSA without leaving your terminal or opening a browser
+- **Multiple sheets** — Striver A2Z (316), Blind 75, NeetCode 150, Grind 75 built-in
+- **Python & Go** — switch languages on the fly with `Ctrl+L`
+- **Progress tracking** — solved/in-progress/not-started states, streaks, best times
+- **Bookmarks & filters** — filter by difficulty (Easy/Medium/Hard) or bookmarked problems
+
+## Install
+
+```bash
+pip install grindx
+```
+
+Or with [pipx](https://pipx.pypa.io/) (recommended for CLI tools):
+
+```bash
+pipx install grindx
+```
+
+Or run from source:
+
+```bash
+git clone https://github.com/xghostient/grindx.git
+cd grindx
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e .
+grindx
+```
+
+## Usage
+
+```bash
+grindx            # CLI entry point
+python -m grindx  # or as a module
+```
+
+### Navigation
+
+| Key | Action |
+|-----|--------|
+| `↑` `↓` | Navigate topics / problems |
+| `←` `→` | Switch between topic and problem panes |
+| `Enter` | Select topic or open problem |
+| `Esc` | Go back |
+| `q` | Quit |
+
+### Filters
+
+| Key | Filter |
+|-----|--------|
+| `a` | All problems |
+| `e` | Easy |
+| `m` | Medium |
+| `h` | Hard |
+| `b` | Bookmarked |
+| `s` | Stats dashboard |
+
+### Solve Screen
+
+| Key | Action |
+|-----|--------|
+| `Ctrl+S` | Save code |
+| `Ctrl+D` | Toggle solved |
+| `Ctrl+E` | AI review |
+| `Ctrl+L` | Switch Python / Go |
+| `Ctrl+B` | Toggle bookmark |
+| `Ctrl+T` | Pause / resume timer |
+| `Ctrl+R` | Reset timer |
+| `Ctrl+Shift+C` | Copy selection to clipboard |
+| `Ctrl+Shift+V` | Paste from clipboard |
+| `Alt+↑` / `Alt+↓` | Move line up / down |
+| `Alt+Shift+↓` | Duplicate line |
+| `Esc` | Save & go back |
+
+## Features
+
+**Split-pane editor** — problem description on the left, code editor with syntax highlighting on the right.
+
+**Auto-timer** — starts when you open a problem, tracks your best solve time.
+
+**Three-state tracking** — each problem shows as not started (○), in progress (◐), or solved (✓).
+
+**Stats dashboard** — overall progress, per-difficulty breakdown, per-topic progress bars, current streak, and top 10 best times.
+
+**Sheet-agnostic** — built-in sheets live inside the package (`grindx/sheets/`). Format:
+
+```json
+{
+  "Topic Name": ["problem-name-1", "problem-name-2"],
+  "Another Topic": ["problem-name-3"]
+}
+```
+
+**Progress safety** — automatic backups with corruption recovery. Progress, solutions, and backups are stored in `~/.grindx/` so they persist across installs and upgrades.
+
+## AI Review (optional)
+
+Press `Ctrl+E` on the solve screen to get AI-powered feedback on your solution — correctness, edge cases, complexity analysis, and a pass/fail verdict.
+
+### Setup
+
+Set two environment variables:
+
+```bash
+export GRINDX_AI_PROVIDER=groq              # or ollama, anthropic, openai
+export GRINDX_AI_MODEL=llama-3.3-70b-versatile  # optional, sensible defaults per provider
+export GRINDX_AI_KEY=gsk_...                # not needed for ollama
+export GRINDX_AI_URL=https://custom.api/v1  # optional, auto-detected per provider
+```
+
+Or create `~/.grindx.toml`:
+
+```toml
+[ai]
+provider = "groq"
+model = "llama-3.3-70b-versatile"
+api_key = "gsk_..."
+```
+
+### Supported Providers
+
+| Provider | API Key | Default Model | Notes |
+|----------|---------|---------------|-------|
+| `ollama` | No | llama3 | Local, free, no network |
+| `groq` | Yes | llama-3.3-70b-versatile | Fast, free tier available |
+| `anthropic` | Yes | claude-sonnet-4-20250514 | Claude |
+| `openai` | Yes | gpt-4o | GPT |
+
+Any OpenAI-compatible API works — set provider to `openai` and add `base_url`.
+
+## Built with
+
+- [Textual](https://github.com/Textualize/textual) — TUI framework
+- [tree-sitter](https://tree-sitter.github.io/) — syntax highlighting
+
+## License
+
+MIT

grindx-0.1.0/grindx/__init__.py

@@ -0,0 +1,3 @@
+"""grindx — Distraction-free DSA practice in your terminal."""
+
+__version__ = "0.1.0"

grindx-0.1.0/grindx/__main__.py

@@ -0,0 +1,3 @@
+from grindx.app import main
+
+main()

grindx-0.1.0/grindx/ai.py

@@ -0,0 +1,360 @@
+"""AI evaluation for solutions — supports Anthropic, OpenAI, Groq, Ollama."""
+
+import json
+import os
+import urllib.request
+import urllib.error
+from pathlib import Path
+
+from . import __version__
+
+CONFIG_PATH = Path.home() / ".grindx.toml"
+
+_PROVIDER_DEFAULTS = {
+    "ollama": ("http://localhost:11434", "llama3"),
+    "anthropic": ("https://api.anthropic.com", "claude-sonnet-4-20250514"),
+    "openai": ("https://api.openai.com", "gpt-4o"),
+    "groq": ("https://api.groq.com/openai", "llama-3.3-70b-versatile"),
+}
+
+_USER_AGENT = f"grindx/{__version__}"
+
+
+def load_ai_config() -> dict:
+    """Load AI config from ~/.grindx.toml, then override with env vars."""
+    config = {"provider": "", "model": "", "api_key": "", "base_url": ""}
+
+    if CONFIG_PATH.exists():
+        _load_toml(config)
+
+    env_map = {
+        "GRINDX_AI_PROVIDER": "provider",
+        "GRINDX_AI_MODEL": "model",
+        "GRINDX_AI_KEY": "api_key",
+        "GRINDX_AI_URL": "base_url",
+    }
+    for env_key, cfg_key in env_map.items():
+        val = os.environ.get(env_key)
+        if val:
+            config[cfg_key] = val
+
+    p = config["provider"].lower()
+    if p in _PROVIDER_DEFAULTS:
+        default_url, default_model = _PROVIDER_DEFAULTS[p]
+        if not config["base_url"]:
+            config["base_url"] = default_url
+        if not config["model"]:
+            config["model"] = default_model
+
+    return config
+
+
+def _load_toml(config: dict):
+    """Load config from TOML file (tomllib or simple fallback)."""
+    try:
+        import tomllib
+        with open(CONFIG_PATH, "rb") as f:
+            data = tomllib.load(f)
+        ai = data.get("ai", {})
+        for k in config:
+            if k in ai:
+                config[k] = ai[k]
+    except ImportError:
+        _parse_toml_simple(config)
+
+
+def _parse_toml_simple(config: dict):
+    """Minimal parser for flat [ai] section."""
+    in_ai = False
+    with open(CONFIG_PATH) as f:
+        for line in f:
+            line = line.strip()
+            if line == "[ai]":
+                in_ai = True
+                continue
+            if line.startswith("["):
+                in_ai = False
+                continue
+            if in_ai and "=" in line:
+                key, _, val = line.partition("=")
+                key = key.strip()
+                val = val.strip().strip('"').strip("'")
+                if key in config:
+                    config[key] = val
+
+
+def _build_prompt(problem: dict, code: str, lang: str) -> str:
+    examples = ""
+    for i, ex in enumerate(problem.get("examples", []), 1):
+        examples += f"\nExample {i}:\n  Input: {ex['input']}\n  Output: {ex['output']}"
+
+    return f"""You are a rigorous DSA solution evaluator. This is a well-known competitive programming problem. Evaluate the solution strictly.
+
+**Problem:** {problem['name']}
+**Difficulty:** {problem.get('difficulty', '?')}
+**Description:** {problem.get('description', 'N/A')}
+**Constraints:** {problem.get('constraints', 'N/A')}
+{examples}
+
+**Language:** {lang}
+**Solution:**
+```
+{code}
+```
+
+You MUST respond in exactly this format with these exact headers. Do not skip any section.
+
+## Verdict
+PASS, FAIL, or PARTIAL. One word, then one-line reason.
+
+## Failing Test Cases
+If FAIL or PARTIAL, list 2-3 concrete test cases where this solution produces wrong output. Format each as:
+- Input: `...`
+- Expected: `...`
+- Actual (from this code): `...`
+- Why: one-line explanation
+
+If PASS, write "None — solution handles all cases correctly."
+
+## Complexity Analysis
+| | This Solution | Optimal |
+|---|---|---|
+| Time | O(?) | O(?) |
+| Space | O(?) | O(?) |
+
+This is a classic well-known problem. You know the optimal complexity — state it confidently.
+If this solution is suboptimal, say so clearly.
+
+## Correctness Notes
+
+### What your code does
+Walk through the submitted solution step by step. Explain the approach/algorithm the user is attempting. Be specific — reference line numbers.
+
+### What the expected approach is
+Explain the correct/optimal algorithm for this well-known problem. How should it work?
+
+### Where it diverges
+If the code is wrong or suboptimal, list each issue as:
+- **Line X**: `<the code on that line>` — what it does wrong and what it should do instead.
+
+If the code is correct, say "Your implementation is correct." and note any minor style improvements (but don't nitpick).
+
+---HINTS---
+
+## Hints
+Adapt hints based on what the user has written:
+
+**If the solution is empty/template (no real code):**
+Give generic progressive hints like LeetCode, guiding toward the right approach:
+1. What pattern/technique applies to this problem?
+2. What data structure would help?
+3. Key insight to crack it.
+
+**If the solution has real code but is wrong/partial:**
+Acknowledge what the user got RIGHT first, then build on their existing approach:
+1. "Your [specific part] is correct. Now think about..."
+2. "You're using [their approach]. The issue is at [specific point]..."
+3. "To fix this, consider what happens when [edge case]..."
+
+**If PASS but suboptimal:**
+"Your solution works. To optimize: think about [technique] to reduce from O(x) to O(y)."
+
+**If PASS and optimal:**
+"Your solution is optimal. No hints needed."
+
+NEVER give the full solution. Guide, don't solve.
+
+Keep everything concise. No fluff."""
+
+
+def evaluate(problem: dict, code: str, lang: str) -> str:
+    """Send solution to AI for evaluation. Blocking call."""
+    config = load_ai_config()
+
+    if not config["provider"]:
+        return _no_config_msg()
+
+    prompt = _build_prompt(problem, code, lang)
+    provider = config["provider"].lower()
+
+    if provider == "anthropic":
+        return _call_anthropic(config, prompt)
+    elif provider in ("openai", "ollama", "groq"):
+        return _call_openai_compat(config, prompt)
+    else:
+        return (
+            f"# Unknown provider: `{config['provider']}`\n\n"
+            f"Supported: `ollama`, `anthropic`, `openai`, `groq`\n\n"
+            f"Any OpenAI-compatible API works — set provider to `openai` "
+            f"and configure `base_url`."
+        )
+
+
+def _call_anthropic(config: dict, prompt: str) -> str:
+    if not config["api_key"]:
+        return _missing_key_msg("anthropic", "GRINDX_AI_KEY")
+
+    url = f"{config['base_url'].rstrip('/')}/v1/messages"
+    body = json.dumps({
+        "model": config["model"],
+        "max_tokens": 1500,
+        "messages": [{"role": "user", "content": prompt}],
+    }).encode()
+
+    req = urllib.request.Request(url, data=body, headers={
+        "Content-Type": "application/json",
+        "User-Agent": _USER_AGENT,
+        "x-api-key": config["api_key"],
+        "anthropic-version": "2023-06-01",
+    })
+
+    return _do_request(req, extractor=lambda d: d["content"][0]["text"])
+
+
+def _call_openai_compat(config: dict, prompt: str) -> str:
+    """Works for OpenAI, Groq, Ollama, and any OpenAI-compatible API."""
+    provider = config["provider"].lower()
+    if provider != "ollama" and not config["api_key"]:
+        return _missing_key_msg(provider, "GRINDX_AI_KEY")
+
+    base = config["base_url"].rstrip("/")
+    url = f"{base}/v1/chat/completions"
+
+    body = json.dumps({
+        "model": config["model"],
+        "messages": [{"role": "user", "content": prompt}],
+        "max_tokens": 1500,
+    }).encode()
+
+    headers = {
+        "Content-Type": "application/json",
+        "User-Agent": _USER_AGENT,
+    }
+    if config["api_key"]:
+        headers["Authorization"] = f"Bearer {config['api_key']}"
+
+    req = urllib.request.Request(url, data=body, headers=headers)
+
+    return _do_request(
+        req,
+        extractor=lambda d: d["choices"][0]["message"]["content"],
+        timeout=120 if provider == "ollama" else 60,
+    )
+
+
+def _do_request(req, extractor, timeout=60) -> str:
+    """Execute HTTP request with user-friendly error handling."""
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            data = json.loads(resp.read())
+        return extractor(data)
+    except urllib.error.HTTPError as e:
+        return _format_http_error(e)
+    except urllib.error.URLError as e:
+        reason = str(e.reason)
+        if "refused" in reason.lower():
+            return (
+                "# Connection Refused\n\n"
+                "Could not connect to the AI provider.\n\n"
+                "- **Ollama**: Make sure it's running (`ollama serve`)\n"
+                f"- **Cloud API**: Check your `base_url` setting\n"
+                f"- URL tried: `{req.full_url}`"
+            )
+        return f"# Connection Error\n\n{reason}"
+    except TimeoutError:
+        return (
+            "# Request Timed Out\n\n"
+            "The AI provider took too long to respond. "
+            "Try again or use a faster model."
+        )
+    except Exception as e:
+        return f"# Unexpected Error\n\n`{type(e).__name__}`: {e}"
+
+
+def _format_http_error(e: urllib.error.HTTPError) -> str:
+    """Parse HTTP error into a helpful message."""
+    raw = ""
+    try:
+        raw = e.read().decode()
+    except Exception:
+        pass
+
+    # Try to extract message from JSON error body
+    detail = ""
+    try:
+        err_data = json.loads(raw)
+        # OpenAI/Groq format
+        if "error" in err_data:
+            err_obj = err_data["error"]
+            if isinstance(err_obj, dict):
+                detail = err_obj.get("message", "")
+            else:
+                detail = str(err_obj)
+        # Anthropic format
+        elif "message" in err_data:
+            detail = err_data["message"]
+    except (json.JSONDecodeError, KeyError):
+        detail = raw[:500] if raw else ""
+
+    hints = {
+        401: "Invalid or missing API key. Check your `api_key` setting.",
+        403: "Access denied. Your API key may lack permissions, or the provider is blocking the request.",
+        404: "Endpoint not found. Check your `base_url` and `model` settings.",
+        429: "Rate limited. Wait a moment and try again.",
+        500: "Server error on the provider side. Try again later.",
+        503: "Service unavailable. The provider may be overloaded.",
+    }
+
+    hint = hints.get(e.code, "")
+    lines = [f"# API Error ({e.code})"]
+    if detail:
+        lines.append(f"\n{detail}")
+    if hint:
+        lines.append(f"\n**Hint:** {hint}")
+
+    return "\n".join(lines)
+
+
+def _missing_key_msg(provider: str, env_var: str) -> str:
+    return (
+        f"# API Key Required\n\n"
+        f"Provider `{provider}` needs an API key.\n\n"
+        f"Set it via:\n"
+        f"- **Config file** `~/.grindx.toml`:\n"
+        f"  ```\n  [ai]\n  api_key = \"your-key-here\"\n  ```\n\n"
+        f"- **Environment variable**:\n"
+        f"  ```\n  export {env_var}=your-key-here\n  ```"
+    )
+
+
+def _no_config_msg() -> str:
+    return """# No AI Provider Configured
+
+Set up AI evaluation with **one environment variable** or a config file.
+
+## Quick Start (env vars)
+
+```
+export GRINDX_AI_PROVIDER=groq
+export GRINDX_AI_KEY=gsk_...
+```
+
+## Or config file (`~/.grindx.toml`)
+
+```toml
+[ai]
+provider = "groq"
+model = "llama-3.3-70b-versatile"
+api_key = "gsk_..."
+```
+
+## Supported Providers
+
+| Provider | Needs API Key | Default Model |
+|----------|--------------|---------------|
+| `ollama` | No (local) | llama3 |
+| `groq` | Yes | llama-3.3-70b-versatile |
+| `anthropic` | Yes | claude-sonnet-4-20250514 |
+| `openai` | Yes | gpt-4o |
+
+Any OpenAI-compatible API works — set provider to `openai` and add `base_url`."""