leetcode-local-cli 0.7.0__py3-none-any.whl

leetcode_local_cli/workspace.py

@@ -0,0 +1,228 @@
+from dataclasses import dataclass
+from enum import Enum
+from pathlib import Path
+import subprocess
+import sys
+
+
+PROJECT_ROOT = Path.cwd()
+SOLUTION_FILE = PROJECT_ROOT / "solution.py"
+
+METADATA_PREFIX = "# @lc "
+START_FLAG = "# @lc submit_begin"
+END_FLAG = "# @lc submit_end"
+
+SOLUTION_FILE_HEADER = """# pyright: reportUnusedImport=false, reportUnusedVariable=false
+# ruff: noqa: F401, F841
+"""
+
+SOLUTION_IMPORTS = """from typing import Any, Dict, List, Optional, Set, Tuple
+from collections import Counter, defaultdict, deque
+from functools import cache, lru_cache
+from itertools import accumulate, combinations, permutations, product
+from bisect import bisect_left, bisect_right, insort
+from heapq import heapify, heappop, heappush
+from math import gcd, inf, isqrt, lcm
+"""
+
+SOLUTION_CASE = """
+def run_cases() -> None:
+    solution = Solution()
+    # Add local assertions here, for example:
+    # assert solution.twoSum([2, 7, 11, 15], 9) == [0, 1]
+    pass
+
+
+if __name__ == "__main__":
+    run_cases()
+"""
+
+
+@dataclass(frozen=True)
+class ProblemMetadata:
+    problem_id: str
+    submit_question_id: str
+    title: str
+    title_slug: str
+
+
+class WorkspaceError(ValueError):
+    pass
+
+
+class SolutionFileStatus(str, Enum):
+    READY = "ready"
+    MISSING = "missing"
+    EMPTY = "empty"
+    READ_ERROR = "read_error"
+    INVALID_SYNTAX = "invalid_syntax"
+    NOT_SUBMITTABLE = "not_submittable"
+
+
+@dataclass(frozen=True)
+class SolutionFileInspection:
+    status: SolutionFileStatus
+    metadata: ProblemMetadata | None = None
+    detail: str = ""
+    syntax_line: int | None = None
+
+
+def _normalize_python_code(python_code: str) -> str:
+    code = python_code.rstrip()
+    if code and code.splitlines()[-1].rstrip().endswith(":"):
+        return f"{code} pass"
+    return code
+
+
+def build_solution_content(python_code: str, metadata: ProblemMetadata) -> str:
+    metadata_content = (
+        f"{METADATA_PREFIX}problem_id: {metadata.problem_id}\n"
+        f"{METADATA_PREFIX}submit_question_id: {metadata.submit_question_id}\n"
+        f"{METADATA_PREFIX}title: {metadata.title}\n"
+        f"{METADATA_PREFIX}title_slug: {metadata.title_slug}\n\n"
+    )
+    return (
+        f"{SOLUTION_FILE_HEADER}"
+        f"{metadata_content}"
+        f"{SOLUTION_IMPORTS}\n\n"
+        f"{START_FLAG}\n"
+        f"{_normalize_python_code(python_code)}\n"
+        f"{END_FLAG}\n\n"
+        f"{SOLUTION_CASE}\n"
+    )
+
+
+def write_solution_file(python_code: str, metadata: ProblemMetadata) -> None:
+    with open(SOLUTION_FILE, "w", encoding="utf-8") as file:
+        file.write(build_solution_content(python_code, metadata))
+    open_path(SOLUTION_FILE)
+
+
+def open_path(path: Path) -> None:
+    if sys.platform == "win32":
+        import os
+
+        os.startfile(path)
+        return
+
+    command = "open" if sys.platform == "darwin" else "xdg-open"
+    try:
+        subprocess.Popen(
+            [command, str(path)],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+    except FileNotFoundError:
+        pass
+
+
+def run_solution_file(
+    path: Path | None = None,
+    *,
+    timeout: float | None = None,
+) -> subprocess.CompletedProcess[str]:
+    solution_file = path or SOLUTION_FILE
+    return subprocess.run(
+        [sys.executable, str(solution_file)],
+        capture_output=True,
+        text=True,
+        cwd=PROJECT_ROOT,
+        timeout=timeout,
+    )
+
+
+def _parse_solution_submission_content(content: str) -> tuple[ProblemMetadata, str]:
+    metadata: dict[str, str] = {}
+    start_flag = end_flag = False
+    submission_lines: list[str] = []
+    for string in content.splitlines(keepends=True):
+        line = string.strip()
+        if line == END_FLAG:
+            end_flag = True
+            break
+        if start_flag:
+            submission_lines.append(string)
+        if line.startswith(METADATA_PREFIX):
+            item = line.removeprefix(METADATA_PREFIX)
+            key, separator, value = item.partition(":")
+            if separator:
+                metadata[key.strip()] = value.strip()
+        if line == START_FLAG:
+            start_flag = True
+
+    if not start_flag or not end_flag:
+        raise WorkspaceError("solution.py 提交区域标记不完整，请先执行 lc solve <题号>")
+
+    submission_code = "".join(submission_lines).strip()
+    if not submission_code:
+        raise WorkspaceError("solution.py 提交区域为空")
+
+    if not all(
+        [
+            metadata.get("problem_id"),
+            metadata.get("submit_question_id"),
+            metadata.get("title"),
+            metadata.get("title_slug"),
+        ]
+    ):
+        raise WorkspaceError(
+            "solution.py 缺少元数据：problem_id、submit_question_id、title、title_slug"
+        )
+
+    return (
+        ProblemMetadata(
+            problem_id=metadata["problem_id"],
+            submit_question_id=metadata["submit_question_id"],
+            title=metadata["title"],
+            title_slug=metadata["title_slug"],
+        ),
+        submission_code,
+    )
+
+
+def parse_solution_submission(
+    path: Path | None = None,
+) -> tuple[ProblemMetadata, str]:
+    solution_file = path or SOLUTION_FILE
+    try:
+        content = solution_file.read_text(encoding="utf-8")
+    except FileNotFoundError as exc:
+        raise WorkspaceError("未找到 solution.py，请先执行 lc solve <题号>") from exc
+    except OSError as exc:
+        raise WorkspaceError("无法读取 solution.py，请检查文件权限") from exc
+    return _parse_solution_submission_content(content)
+
+
+def inspect_solution_file(path: Path | None = None) -> SolutionFileInspection:
+    solution_file = path or SOLUTION_FILE
+    try:
+        content = solution_file.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        return SolutionFileInspection(status=SolutionFileStatus.MISSING)
+    except OSError:
+        return SolutionFileInspection(status=SolutionFileStatus.READ_ERROR)
+
+    if not content.strip():
+        return SolutionFileInspection(status=SolutionFileStatus.EMPTY)
+
+    try:
+        compile(content, str(solution_file), "exec")
+    except SyntaxError as exc:
+        return SolutionFileInspection(
+            status=SolutionFileStatus.INVALID_SYNTAX,
+            detail=exc.msg,
+            syntax_line=exc.lineno,
+        )
+
+    try:
+        metadata, _ = _parse_solution_submission_content(content)
+    except WorkspaceError as exc:
+        return SolutionFileInspection(
+            status=SolutionFileStatus.NOT_SUBMITTABLE,
+            detail=str(exc),
+        )
+
+    return SolutionFileInspection(
+        status=SolutionFileStatus.READY,
+        metadata=metadata,
+    )

leetcode_local_cli-0.7.0.dist-info/METADATA

@@ -0,0 +1,253 @@
+Metadata-Version: 2.4
+Name: leetcode-local-cli
+Version: 0.7.0
+Summary: Local coding workflow CLI for LeetCode CN.
+Keywords: cli,leetcode,leetcode-cn,uv
+Author: Aetherialter
+Author-email: Aetherialter <Aetherialter@outlook.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: browser-cookie3>=0.20.1
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: rich>=15.0.0
+Requires-Dist: typer>=0.25.1
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/Aetherialter/leetcode-local-cli
+Project-URL: Issues, https://github.com/Aetherialter/leetcode-local-cli/issues
+Project-URL: Repository, https://github.com/Aetherialter/leetcode-local-cli
+Description-Content-Type: text/markdown
+
+# 力扣中文站本地化刷题 CLI 工具
+
+一个面向 LeetCode 中文站的轻量本地刷题 CLI。它复用浏览器登录态，在线获取题目，在当前工作目录生成单文件 `solution.py`，并支持本地测试和远程提交。
+
+当前版本：`v0.7.0`
+
+## 核心能力
+
+- 读取 Chrome 中的 `leetcode.cn` Cookie，复用登录态。
+- 在线获取题目详情和题目索引。
+- 使用当前工作目录的 `solution.py` 作为唯一主要工作区。
+- `lc solve <题号>` 生成可编辑的 Python 解题模板。
+- 生成模板后会按当前系统尝试打开 `solution.py`。
+- `lc test` 运行 `solution.py` 中的 `run_cases()`。
+- `lc doctor` 一次检查 Session 文件、站点连通性、Cookie 登录态和本地解题文件。
+- `lc submit` 提交 marker 区域代码到 LeetCode 中文站，并轮询判题结果。
+- 生成模板时写入 `problem_id` 和 `submit_question_id`，避免展示题号和 LeetCode 内部提交 ID 混用。
+- 生成模板时加入 Pyright/Ruff 文件级配置，减少刷题工作区的未使用导入、未使用变量和 star import 相关提示。
+- 使用统一的客户端错误结果类型区分网络、HTTP、JSON、接口结构和登录态错误。
+
+## 环境要求
+
+- Windows / Linux / macOS
+- Python 3.12+
+- [uv](https://docs.astral.sh/uv/)
+- 已在浏览器中登录 LeetCode 中文站
+
+## 安装
+
+Linux / macOS 一键安装：
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.7.0/scripts/install.sh | sh
+```
+
+Windows PowerShell 一键安装：
+
+```powershell
+powershell -ExecutionPolicy ByPass -Command "irm https://raw.githubusercontent.com/Aetherialter/leetcode-local-cli/v0.7.0/scripts/install.ps1 | iex"
+```
+
+安装器会在缺少 uv 时通过 uv 官方 HTTPS 安装器完成引导，然后使用 `uv tool install` 安装 `leetcode-local-cli`，并执行 `lc --version` 验证结果。安装过程不使用 `sudo`，也不会保存 PyPI 或 GitHub 凭据。
+
+已经安装 uv 时，也可以直接安装：
+
+```shell
+uv tool install leetcode-local-cli
+```
+
+升级或卸载：
+
+```shell
+uv tool upgrade leetcode-local-cli
+uv tool uninstall leetcode-local-cli
+```
+
+如果安装完成后当前终端仍找不到 `lc`，请重新打开终端，或执行 `uv tool update-shell` 后重载 shell 配置。
+
+## 基本工作流
+
+```shell
+lc login
+lc doctor
+lc status
+lc get 1
+lc solve 1
+lc test
+lc submit
+```
+
+常用命令：
+
+| 命令 | 作用 |
+| --- | --- |
+| `lc login` | 读取或手动录入 LeetCode 中文站 Cookie |
+| `lc status` | 检查当前登录态 |
+| `lc profile` | 展示账号和刷题统计 |
+| `lc show --limit 20 --skip 0` | 分页展示题目索引，`limit` 单次最大为 100 |
+| `lc get <题号>` | 在线展示题目详情 |
+| `lc solve <题号>` | 覆盖生成当前目录的 `solution.py` |
+| `lc test` | 运行本地 `solution.py` |
+| `lc doctor` | 诊断 Session、网络、Cookie 和 `solution.py` |
+| `lc submit` | 提交当前 `solution.py` 的提交区域代码 |
+
+## solution.py 规则
+
+`lc solve` 会覆盖当前目录的 `solution.py`。切换题目前请自行保存当前解法。
+
+生成文件会包含题目元信息和提交区域：
+
+```python
+# pyright: reportUnusedImport=false, reportUnusedVariable=false
+# ruff: noqa: F401, F841
+# @lc problem_id: 1
+# @lc submit_question_id: 1
+# @lc title: Two Sum
+# @lc title_slug: two-sum
+
+# @lc submit_begin
+class Solution:
+    def twoSum(self, nums: List[int], target: int) -> List[int]: pass
+# @lc submit_end
+```
+
+`lc submit` 只提交：
+
+```text
+# @lc submit_begin
+...
+# @lc submit_end
+```
+
+之间的代码。
+
+## 当前限制
+
+- 当前仅支持 LeetCode 中文站。
+- 当前仅自动读取 Chrome Cookie。
+- `lc solve` 生成模板后会尝试打开 `solution.py`；Windows 使用系统默认打开方式，macOS 使用 `open`，Linux 使用 `xdg-open`。
+- 当前远程提交仅支持 Python3。
+- 当前只维护 CLI 启动目录中的单个 `solution.py`，不会生成每题独立目录。
+- 当前不保存完整题面到本地，也不引入本地数据库。
+- `lc solve` 会强制覆盖 `solution.py`。
+- `lc show` 的 `limit` 必须为正整数且不超过 100，`skip` 必须为非负整数。
+- `lc test` 默认隐藏 Python traceback，只展示本地测试通过或失败。
+- 如果 `run_cases()` 中没有断言，`lc test` 显示通过是当前轻量化设计允许的行为。
+- 树、链表等题型中，LeetCode 模板里的 `TreeNode` / `ListNode` 定义默认保持注释状态；如需本地构造用例，请自行取消注释并编写测试数据。
+- `lc doctor` 会向 LeetCode 中文站发送一次登录态查询，并在本地运行语法有效的 `solution.py`；本地运行超过 10 秒会判定失败。
+
+## 安全说明
+
+登录态会保存到：
+
+```text
+.leetcode_local_cli/session.json
+```
+
+该文件可能包含敏感 Cookie 信息，已在 `.gitignore` 中忽略。v0.7 首次读取登录态时会把旧版 `.aether_lc/session.json` 自动迁移到新目录；迁移过程不会输出 Cookie 值。发布前请确认仓库根目录的 `solution.py` 为空，避免把个人解法提交到公开仓库。
+
+## 登录态说明
+
+`leetcode-local-cli` 会把浏览器 Cookie 的本地副本保存到 CLI 启动目录下的 `.leetcode_local_cli/session.json`。本地保存的 Cookie 不会延长 LeetCode 登录态有效期；实际是否有效以 LeetCode 服务端验证为准。v0.8 的 `lc init` 会进一步将用户登录态与工作区分离。
+
+如果浏览器 Cookie 刷新，或旧 Cookie 被服务端判定失效，CLI 可能在 `lc status`、`lc profile` 或 `lc submit` 时提示重新执行：
+
+```shell
+lc login
+```
+
+`lc show` 和 `lc get` 访问公开题目数据，可能在登录态失效时仍然可用。遇到登录态、网络或本地解题文件问题时，可以执行：
+
+```shell
+lc doctor
+```
+
+诊断输出只包含用户名、Cookie 缺失项等安全元数据，不会展示 Cookie 值。
+
+## 开发与验证
+
+```shell
+uv run ruff format src tests scripts
+uv run ruff check src tests scripts pyproject.toml
+uv run pyright src tests scripts
+uv run pytest
+uv build --no-sources
+```
+
+发布前常用手动检查：
+
+```shell
+uv run lc --help
+uv run lc --version
+uv run lc doctor
+uv run lc get 2196
+uv run lc solve 1
+uv run lc test
+uv run ruff check solution.py
+```
+
+维护者发布流程见 [RELEASING.md](https://github.com/Aetherialter/leetcode-local-cli/blob/main/RELEASING.md)。标签触发的发布工作流会在 Linux、macOS 和 Windows 上验收安装器，分别验证 wheel 与源码包，通过 PyPI Trusted Publisher 上传发行包，并创建 GitHub Release。
+
+## 项目结构
+
+```text
+src/leetcode_local_cli/
+  auth.py       Cookie 读取与本地 session
+  client.py     LeetCode 中文站 HTTP 客户端
+  cli.py        Typer 命令入口
+  doctor.py     本地环境、网络与登录态诊断
+  problem.py    题号解析与题目数据标准化
+  service.py    应用层流程编排
+  ui.py         Rich 终端输出
+  version.py    已安装发行版版本读取
+  workspace.py  solution.py 生成、解析与运行
+scripts/
+  install.sh    Linux/macOS 一键安装器
+  install.ps1   Windows PowerShell 一键安装器
+  smoke_test.py wheel 与源码包发布验收
+.github/workflows/
+  release.yml   跨平台验证、PyPI 发布与 GitHub Release
+tests/
+  test_auth.py
+  test_cli.py
+  test_client.py
+  test_doctor.py
+  test_install_scripts.py
+  test_problem.py
+  test_service.py
+  test_ui.py
+  test_workspace.py
+```
+
+## 版本路线
+
+- `v0.5.x`: 远程提交上线后的 bugfix patch 线。
+- `v0.5.4`: 修复 GraphQL `data: null` 导致 traceback，并精简 README。
+- `v0.5.5`: 引入客户端错误结果类型，收敛 service 层错误处理并补充边界测试。
+- `v0.5.6`: 收束 `lc show` 参数校验，避免非法分页参数触发远端接口异常提示。
+- `v0.5.7`: 修复非 Windows 环境导入 `os.startfile` 导致 CLI 无法启动的问题。
+- `v0.6.0`: 新增 `lc doctor`，完善客户端边界校验、本地文件诊断、错误提示和提交目标展示。
+- `v0.7.0`: uv 全局工具安装、跨平台引导脚本和 PyPI Trusted Publisher 发布流程。
+- `v0.8`: `lc init` 与正式工作区管理。
+- `v0.9`: 轻量缓存。
+- `v0.10`: 样例提取原型。
+- `v1.0`: 稳定轻量 CLI。
+
+## License
+
+本项目使用 [MIT License](LICENSE) 开源。

leetcode_local_cli-0.7.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+leetcode_local_cli/__init__.py,sha256=B3XJFwkbcjwQG_1sXnTjOw5wJ1zRKgwm-PjLjlkZnaw,43
+leetcode_local_cli/__main__.py,sha256=yQP0sf-rkTO-3MOotv4blvukvNGwbJFz10hQhMsxcJM,28
+leetcode_local_cli/auth.py,sha256=qBQEu6SQJjOGbRtsMhzMAxb7cc3Z_j8H7QGdDRgNzkw,6431
+leetcode_local_cli/cli.py,sha256=9o5Bki56j1AAWVGuSmU1dRofkDO4vDGSuNvXMzDn5VU,6375
+leetcode_local_cli/client.py,sha256=IBkK5v2Y4dXpRHrtijN-e1Unv5m9PvZqNKUG5GCixO4,11323
+leetcode_local_cli/doctor.py,sha256=2MW87MtYxkkr4AzbMcebRPJjb5P4FM8YbH8in6mXUnw,10354
+leetcode_local_cli/problem.py,sha256=tcjPKNzg2LT9qZtx5tf1VCcOn_GDnRokItYx2QvwuCU,4524
+leetcode_local_cli/service.py,sha256=YLp3FDO3Pe68PrxUIZOFqqZ5XrWfW1mYrtyoHCggO98,9424
+leetcode_local_cli/ui.py,sha256=kzFZc-G2UpZWqkLfFth3kfptXQKi_MDT-0WxIjxUZyc,7723
+leetcode_local_cli/version.py,sha256=lot83NuspSD8aadUsElYtf2-G7GbsfY3nQv5dycP2U0,284
+leetcode_local_cli/workspace.py,sha256=zFJ2nR5oeX6GVTwo48BTJIKuY9_SB5s2mf-etREYO8Q,6636
+leetcode_local_cli-0.7.0.dist-info/licenses/LICENSE,sha256=062CGAxo62KjC8aN9OAU7nTfizRZQnLzl8jgDVuUos0,1069
+leetcode_local_cli-0.7.0.dist-info/WHEEL,sha256=CoDSoyhtC_eO_tlxRYzsTraPv1fPJRXFx91k6ISeAvA,81
+leetcode_local_cli-0.7.0.dist-info/entry_points.txt,sha256=DrlxdzFemHi1_pUunmxb3TSrsKt1q0JkWYGY4sPODX4,51
+leetcode_local_cli-0.7.0.dist-info/METADATA,sha256=t42rKBtsvjpJP9Lkg34txszESij9o7D_I4j1nT_kemU,9301
+leetcode_local_cli-0.7.0.dist-info/RECORD,,

leetcode_local_cli-0.7.0.dist-info/WHEEL

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

leetcode_local_cli-0.7.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+lc = leetcode_local_cli.cli:run
+

leetcode_local_cli-0.7.0.dist-info/licenses/LICENSE

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