leet2local 0.1.0__tar.gz

leet2local-0.1.0/.gitignore

@@ -0,0 +1,29 @@
+# Generated problem directories
+leetcode/
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+env/
+
+# Config (may contain paths; credentials are in keyring, not here)
+.leet2local.toml
+
+# Temp harness files
+/tmp/
+
+# IDE
+.vscode/settings.json
+.idea/
+
+# OS
+.DS_Store
+Thumbs.db

leet2local-0.1.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2024-06-19
+
+### Added
+- `lc fetch <number>` — fetch any LeetCode problem by number; creates a local directory
+  with `question.md`, `solution.<ext>`, `test_cases.json`, and `.meta.json`
+- `lc run <number>` — run solution locally against sample test cases using a Jinja2
+  test harness subprocess; supports Python, JavaScript, C++, and Java
+- `lc submit <number>` — submit solution to LeetCode and poll for full results including
+  runtime percentile, memory percentile, and hidden test count
+- `lc login` — store LeetCode session credentials securely in the OS native keychain
+  (Windows Credential Manager / macOS Keychain / libsecret on Linux)
+- `lc config` — view and update TOML configuration; generate `.vscode/tasks.json`
+- Bundled slug fallback map (3963 entries) for offline problem-number-to-slug resolution
+- Multi-language support: Python 3, JavaScript (Node.js), C++ (g++), Java (JDK)
+- Exponential backoff retry on LeetCode rate-limit responses (HTTP 429)
+- Rate limiter with configurable max retries via `.leet2local.toml`

leet2local-0.1.0/LICENSE

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

leet2local-0.1.0/PKG-INFO

@@ -0,0 +1,318 @@
+Metadata-Version: 2.4
+Name: leet2local
+Version: 0.1.0
+Summary: Solve LeetCode problems in your local IDE
+Project-URL: Homepage, https://github.com/dhineshtheprogrammer/leet2local
+Project-URL: Repository, https://github.com/dhineshtheprogrammer/leet2local.git
+Project-URL: Bug Tracker, https://github.com/dhineshtheprogrammer/leet2local/issues
+Project-URL: Changelog, https://github.com/dhineshtheprogrammer/leet2local/blob/main/CHANGELOG.md
+Author-email: Dhinesh <dhineshpro33@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,coding-challenges,competitive-programming,interview-prep,leetcode
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.12
+Requires-Dist: httpx>=0.28
+Requires-Dist: jinja2>=3.1
+Requires-Dist: keyring>=25.0
+Requires-Dist: markdownify>=0.13
+Requires-Dist: pydantic>=2.7
+Requires-Dist: tenacity>=8.3
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer[all]>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Leet2Local
+
+[![PyPI](https://img.shields.io/pypi/v/leet2local)](https://pypi.org/project/leet2local/)
+[![Python](https://img.shields.io/pypi/pyversions/leet2local)](https://pypi.org/project/leet2local/)
+[![CI](https://github.com/dhineshtheprogrammer/leet2local/actions/workflows/ci.yml/badge.svg)](https://github.com/dhineshtheprogrammer/leet2local/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A CLI tool that brings LeetCode problems into your local IDE. Fetch problem descriptions, solve in your editor, run tests locally, and submit directly to LeetCode — all from the terminal.
+
+```
+lc fetch 1 --lang python
+lc run 1
+lc submit 1
+```
+
+---
+
+## Features
+
+- **Fetch any problem** by number — creates a local directory with the description, code stub, and sample test cases
+- **Run locally** — executes your solution against sample test cases without touching LeetCode servers
+- **Submit remotely** — sends your code to LeetCode and polls for full results including hidden test cases, runtime, and memory percentile
+- **Multi-language** — Python, JavaScript, C++, and Java
+- **VS Code integration** — generates `tasks.json` for keyboard-shortcut access to all commands
+- **Secure auth** — session cookies stored in OS native keychain (Windows Credential Manager / macOS Keychain)
+
+---
+
+## Installation
+
+**Requirements:** Python 3.11+
+
+```bash
+pip install leet2local
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/dhineshtheprogrammer/leet2local.git
+cd Leet2Local
+pip install -e .
+```
+
+For development (includes pytest and ruff):
+
+```bash
+pip install -e ".[dev]"
+```
+
+---
+
+## Quick Start
+
+### 1. Log in
+
+Get your session cookies from your browser after logging in to leetcode.com:
+
+1. Open DevTools → Application → Cookies → `leetcode.com`
+2. Copy `LEETCODE_SESSION` and `csrftoken`
+
+```bash
+lc login
+```
+
+### 2. Fetch a problem
+
+```bash
+lc fetch 1              # Two Sum, defaults to Python
+lc fetch 42 --lang cpp  # Trapping Rain Water in C++
+```
+
+This creates:
+
+```
+./leetcode/1-two-sum/
+├── question.md        # Problem description in Markdown
+├── solution.py        # Code stub from LeetCode
+└── test_cases.json    # Sample inputs and expected outputs
+```
+
+### 3. Write your solution
+
+Open `solution.py` in your editor and implement the function.
+
+### 4. Run locally
+
+```bash
+lc run 1
+```
+
+```
+┌─ Test Results ──────────────────────────────────┐
+│ #  │ Status │ Details                           │
+│ 0  │  PASS  │                                   │
+│ 1  │  PASS  │                                   │
+│ 2  │  FAIL  │ got: [] expected: [0, 1]          │
+└────────────────────────────────────────────────-┘
+✗ 1/3 test(s) failed
+```
+
+### 5. Submit to LeetCode
+
+```bash
+lc submit 1
+```
+
+```
+┌─ Accepted ──────────────────────────────────────┐
+│ Runtime: 52 ms (beats 87.3%)                    │
+│ Memory:  16.4 MB (beats 62.1%)                  │
+│ Tests:   54/54                                  │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `lc login` | Store LeetCode session cookies securely |
+| `lc fetch <number> [--lang]` | Fetch problem and create local files |
+| `lc run <number>` | Run solution against sample test cases |
+| `lc submit <number>` | Submit to LeetCode and get full results |
+| `lc config` | Show current configuration |
+| `lc config --set key=value` | Update a config value |
+| `lc config --vscode-init` | Generate `.vscode/tasks.json` |
+
+---
+
+## Language Support
+
+| Language | Flag | Runtime Required |
+|---|---|---|
+| Python 3 | `--lang python` | `python` |
+| JavaScript | `--lang javascript` | `node` |
+| C++ | `--lang cpp` | `g++` |
+| Java | `--lang java` | `javac`, `java` |
+
+Set your default language so you don't need `--lang` on every fetch:
+
+```bash
+lc config --set settings.default_language=javascript
+```
+
+---
+
+## Configuration
+
+On first run, create `.leet2local.toml` in your project root:
+
+```toml
+[settings]
+default_language = "python"   # python | javascript | cpp | java
+problems_dir = "./leetcode"   # where problem directories are created
+run_mode = "local"            # local | remote
+
+[api]
+graphql_endpoint = "https://leetcode.com/graphql"
+request_timeout = 30
+max_retries = 5
+
+[runtime]
+python_cmd = "python"
+node_cmd = "node"
+java_cmd = "java"
+javac_cmd = "javac"
+cpp_compiler = "g++"
+runner_timeout = 10           # seconds per test execution
+
+[display]
+show_difficulty = true
+show_tags = false             # hide tags to avoid spoilers
+syntax_highlight = true
+```
+
+Config is loaded from the nearest `.leet2local.toml` walking up from the current directory, falling back to `~/.config/leet2local/config.toml`.
+
+---
+
+## VS Code Integration
+
+Generate keyboard-shortcut tasks:
+
+```bash
+lc config --vscode-init
+```
+
+This creates `.vscode/tasks.json` with three tasks. Add to your `keybindings.json`:
+
+```json
+[
+  { "key": "ctrl+shift+r", "command": "workbench.action.tasks.runTask", "args": "LC: Run Local" },
+  { "key": "ctrl+shift+s", "command": "workbench.action.tasks.runTask", "args": "LC: Submit" }
+]
+```
+
+---
+
+## How It Works
+
+```
+lc fetch 1
+  └─ GraphQL: questionList (slug resolution)
+  └─ GraphQL: questionData (description, stub, test cases)
+  └─ HTML → Markdown (BeautifulSoup + markdownify)
+  └─ Write question.md, solution.py, test_cases.json
+
+lc run 1
+  └─ Read test_cases.json
+  └─ Render Jinja2 test harness template
+  └─ subprocess → python harness.py
+  └─ Parse LEET_PASS / LEET_FAIL / LEET_ERROR output lines
+
+lc submit 1
+  └─ GraphQL: submitCode mutation → submission_id
+  └─ Poll: checkSubmission every 2s
+  └─ Display Rich result table
+```
+
+---
+
+## Project Structure
+
+```
+Leet2Local/
+├── leet2local/
+│   ├── cli.py              # Typer CLI entry point
+│   ├── auth.py             # Login, keyring credential storage
+│   ├── fetcher.py          # GraphQL client, file creation
+│   ├── runner.py           # Local runner dispatcher
+│   ├── submitter.py        # Remote submission + polling
+│   ├── html_parser.py      # HTML → Markdown conversion
+│   ├── models.py           # Pydantic data models
+│   ├── config.py           # TOML config management
+│   ├── queries.py          # GraphQL query strings
+│   ├── rate_limiter.py     # Tenacity retry decorator
+│   └── runners/
+│       ├── base.py         # Abstract Runner base class
+│       ├── python_runner.py
+│       ├── javascript_runner.py
+│       ├── cpp_runner.py
+│       └── java_runner.py
+├── templates/              # Jinja2 test harness templates
+├── scripts/
+│   └── generate_slug_map.py  # Build slug fallback map
+└── tests/
+```
+
+---
+
+## Limitations
+
+- **Sample test cases only** for local runs — hidden test cases require `lc submit`
+- LeetCode's API is unofficial and undocumented; field names may change
+- C++ and Java require the respective compilers installed and on PATH
+- `lc submit` requires a valid session cookie (obtained via `lc login`)
+
+---
+
+## Development
+
+```bash
+# Run tests
+pytest
+
+# Lint
+ruff check .
+
+# Regenerate slug fallback map (run once, requires internet)
+python scripts/generate_slug_map.py
+```
+
+---
+
+## License
+
+MIT

leet2local-0.1.0/README.md

@@ -0,0 +1,279 @@
+# Leet2Local
+
+[![PyPI](https://img.shields.io/pypi/v/leet2local)](https://pypi.org/project/leet2local/)
+[![Python](https://img.shields.io/pypi/pyversions/leet2local)](https://pypi.org/project/leet2local/)
+[![CI](https://github.com/dhineshtheprogrammer/leet2local/actions/workflows/ci.yml/badge.svg)](https://github.com/dhineshtheprogrammer/leet2local/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A CLI tool that brings LeetCode problems into your local IDE. Fetch problem descriptions, solve in your editor, run tests locally, and submit directly to LeetCode — all from the terminal.
+
+```
+lc fetch 1 --lang python
+lc run 1
+lc submit 1
+```
+
+---
+
+## Features
+
+- **Fetch any problem** by number — creates a local directory with the description, code stub, and sample test cases
+- **Run locally** — executes your solution against sample test cases without touching LeetCode servers
+- **Submit remotely** — sends your code to LeetCode and polls for full results including hidden test cases, runtime, and memory percentile
+- **Multi-language** — Python, JavaScript, C++, and Java
+- **VS Code integration** — generates `tasks.json` for keyboard-shortcut access to all commands
+- **Secure auth** — session cookies stored in OS native keychain (Windows Credential Manager / macOS Keychain)
+
+---
+
+## Installation
+
+**Requirements:** Python 3.11+
+
+```bash
+pip install leet2local
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/dhineshtheprogrammer/leet2local.git
+cd Leet2Local
+pip install -e .
+```
+
+For development (includes pytest and ruff):
+
+```bash
+pip install -e ".[dev]"
+```
+
+---
+
+## Quick Start
+
+### 1. Log in
+
+Get your session cookies from your browser after logging in to leetcode.com:
+
+1. Open DevTools → Application → Cookies → `leetcode.com`
+2. Copy `LEETCODE_SESSION` and `csrftoken`
+
+```bash
+lc login
+```
+
+### 2. Fetch a problem
+
+```bash
+lc fetch 1              # Two Sum, defaults to Python
+lc fetch 42 --lang cpp  # Trapping Rain Water in C++
+```
+
+This creates:
+
+```
+./leetcode/1-two-sum/
+├── question.md        # Problem description in Markdown
+├── solution.py        # Code stub from LeetCode
+└── test_cases.json    # Sample inputs and expected outputs
+```
+
+### 3. Write your solution
+
+Open `solution.py` in your editor and implement the function.
+
+### 4. Run locally
+
+```bash
+lc run 1
+```
+
+```
+┌─ Test Results ──────────────────────────────────┐
+│ #  │ Status │ Details                           │
+│ 0  │  PASS  │                                   │
+│ 1  │  PASS  │                                   │
+│ 2  │  FAIL  │ got: [] expected: [0, 1]          │
+└────────────────────────────────────────────────-┘
+✗ 1/3 test(s) failed
+```
+
+### 5. Submit to LeetCode
+
+```bash
+lc submit 1
+```
+
+```
+┌─ Accepted ──────────────────────────────────────┐
+│ Runtime: 52 ms (beats 87.3%)                    │
+│ Memory:  16.4 MB (beats 62.1%)                  │
+│ Tests:   54/54                                  │
+└─────────────────────────────────────────────────┘
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---|---|
+| `lc login` | Store LeetCode session cookies securely |
+| `lc fetch <number> [--lang]` | Fetch problem and create local files |
+| `lc run <number>` | Run solution against sample test cases |
+| `lc submit <number>` | Submit to LeetCode and get full results |
+| `lc config` | Show current configuration |
+| `lc config --set key=value` | Update a config value |
+| `lc config --vscode-init` | Generate `.vscode/tasks.json` |
+
+---
+
+## Language Support
+
+| Language | Flag | Runtime Required |
+|---|---|---|
+| Python 3 | `--lang python` | `python` |
+| JavaScript | `--lang javascript` | `node` |
+| C++ | `--lang cpp` | `g++` |
+| Java | `--lang java` | `javac`, `java` |
+
+Set your default language so you don't need `--lang` on every fetch:
+
+```bash
+lc config --set settings.default_language=javascript
+```
+
+---
+
+## Configuration
+
+On first run, create `.leet2local.toml` in your project root:
+
+```toml
+[settings]
+default_language = "python"   # python | javascript | cpp | java
+problems_dir = "./leetcode"   # where problem directories are created
+run_mode = "local"            # local | remote
+
+[api]
+graphql_endpoint = "https://leetcode.com/graphql"
+request_timeout = 30
+max_retries = 5
+
+[runtime]
+python_cmd = "python"
+node_cmd = "node"
+java_cmd = "java"
+javac_cmd = "javac"
+cpp_compiler = "g++"
+runner_timeout = 10           # seconds per test execution
+
+[display]
+show_difficulty = true
+show_tags = false             # hide tags to avoid spoilers
+syntax_highlight = true
+```
+
+Config is loaded from the nearest `.leet2local.toml` walking up from the current directory, falling back to `~/.config/leet2local/config.toml`.
+
+---
+
+## VS Code Integration
+
+Generate keyboard-shortcut tasks:
+
+```bash
+lc config --vscode-init
+```
+
+This creates `.vscode/tasks.json` with three tasks. Add to your `keybindings.json`:
+
+```json
+[
+  { "key": "ctrl+shift+r", "command": "workbench.action.tasks.runTask", "args": "LC: Run Local" },
+  { "key": "ctrl+shift+s", "command": "workbench.action.tasks.runTask", "args": "LC: Submit" }
+]
+```
+
+---
+
+## How It Works
+
+```
+lc fetch 1
+  └─ GraphQL: questionList (slug resolution)
+  └─ GraphQL: questionData (description, stub, test cases)
+  └─ HTML → Markdown (BeautifulSoup + markdownify)
+  └─ Write question.md, solution.py, test_cases.json
+
+lc run 1
+  └─ Read test_cases.json
+  └─ Render Jinja2 test harness template
+  └─ subprocess → python harness.py
+  └─ Parse LEET_PASS / LEET_FAIL / LEET_ERROR output lines
+
+lc submit 1
+  └─ GraphQL: submitCode mutation → submission_id
+  └─ Poll: checkSubmission every 2s
+  └─ Display Rich result table
+```
+
+---
+
+## Project Structure
+
+```
+Leet2Local/
+├── leet2local/
+│   ├── cli.py              # Typer CLI entry point
+│   ├── auth.py             # Login, keyring credential storage
+│   ├── fetcher.py          # GraphQL client, file creation
+│   ├── runner.py           # Local runner dispatcher
+│   ├── submitter.py        # Remote submission + polling
+│   ├── html_parser.py      # HTML → Markdown conversion
+│   ├── models.py           # Pydantic data models
+│   ├── config.py           # TOML config management
+│   ├── queries.py          # GraphQL query strings
+│   ├── rate_limiter.py     # Tenacity retry decorator
+│   └── runners/
+│       ├── base.py         # Abstract Runner base class
+│       ├── python_runner.py
+│       ├── javascript_runner.py
+│       ├── cpp_runner.py
+│       └── java_runner.py
+├── templates/              # Jinja2 test harness templates
+├── scripts/
+│   └── generate_slug_map.py  # Build slug fallback map
+└── tests/
+```
+
+---
+
+## Limitations
+
+- **Sample test cases only** for local runs — hidden test cases require `lc submit`
+- LeetCode's API is unofficial and undocumented; field names may change
+- C++ and Java require the respective compilers installed and on PATH
+- `lc submit` requires a valid session cookie (obtained via `lc login`)
+
+---
+
+## Development
+
+```bash
+# Run tests
+pytest
+
+# Lint
+ruff check .
+
+# Regenerate slug fallback map (run once, requires internet)
+python scripts/generate_slug_map.py
+```
+
+---
+
+## License
+
+MIT

leet2local-0.1.0/leet2local/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"