gitcode-cli 0.5.7__py3-none-any.whl → 0.5.14__py3-none-any.whl

gc_cli/__init__.py

@@ -1,11 +1,11 @@
-"""
-GitCode CLI - Command line tool for GitCode.
-
-This package provides a Python wrapper for the gc binary.
-"""
-
-__version__ = "0.5.7"
-__author__ = "GitCode CLI Contributors"
-__all__ = ["__version__", "main"]
-
-from gc_cli.wrapper import main
+"""
+GitCode CLI - Command line tool for GitCode.
+
+This package provides a Python wrapper for the gc binary.
+"""
+
+__version__ = "0.5.14"
+__author__ = "GitCode CLI Contributors"
+__all__ = ["__version__", "main"]
+
+from gc_cli.wrapper import main

gc_cli/__main__.py

@@ -1,9 +1,9 @@
-"""Allow running GitCode CLI with ``python -m gc_cli``."""
-
-import sys
-
-from gc_cli.wrapper import main
-
-
-if __name__ == "__main__":
-    sys.exit(main())
+"""Allow running GitCode CLI with ``python -m gc_cli``."""
+
+import sys
+
+from gc_cli.wrapper import main
+
+
+if __name__ == "__main__":
+    sys.exit(main())

gc_cli/wrapper.py

@@ -1,102 +1,102 @@
-"""
-Wrapper module for GitCode CLI binary.
-
-This module provides a Python entry point that calls the appropriate
-pre-compiled binary based on the current platform.
-"""
-
-import os
-import platform
-import subprocess
-import sys
-from pathlib import Path
-
-COMMAND_NAME_ENV = "GITCODE_CLI_COMMAND_NAME"
-
-
-def get_binary_name() -> str:
-    """Get the binary name for the current platform."""
-    system = platform.system().lower()
-    machine = platform.machine().lower()
-
-    # Map machine architecture
-    arch_map = {
-        "x86_64": "amd64",
-        "amd64": "amd64",
-        "aarch64": "arm64",
-        "arm64": "arm64",
-    }
-    arch = arch_map.get(machine, "amd64")
-
-    # Map system to binary name
-    if system == "linux":
-        return f"gc-linux-{arch}"
-    elif system == "darwin":
-        return f"gc-darwin-{arch}"
-    elif system == "windows":
-        return "gc-windows-amd64.exe"
-    else:
-        raise RuntimeError(f"Unsupported platform: {system} {machine}")
-
-
-def get_binary_path() -> Path:
-    """Get the path to the binary for the current platform."""
-    package_dir = Path(__file__).parent
-    binary_name = get_binary_name()
-    binary_path = package_dir / "bin" / binary_name
-
-    if not binary_path.exists():
-        raise FileNotFoundError(
-            f"Binary not found for your platform: {binary_path}\n"
-            f"Supported platforms: linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64"
-        )
-
-    return binary_path
-
-
-def get_command_name() -> str:
-    """Get the command name that should appear in CLI output."""
-    command = Path(sys.argv[0]).stem.lower()
-    if command in {"gc", "gitcode"}:
-        return command
-    if platform.system() == "Windows":
-        return "gitcode"
-    return "gc"
-
-
-def ensure_executable(binary_path: Path) -> None:
-    """Ensure packaged binaries are executable on POSIX platforms."""
-    if platform.system() == "Windows":
-        return
-    if not os.access(binary_path, os.X_OK):
-        binary_path.chmod(0o755)
-
-
-def main() -> int:
-    """Main entry point for the GitCode CLI command."""
-    try:
-        binary_path = get_binary_path()
-
-        ensure_executable(binary_path)
-        env = os.environ.copy()
-        env.setdefault(COMMAND_NAME_ENV, get_command_name())
-
-        # Run the binary with all arguments
-        result = subprocess.run(
-            [str(binary_path)] + sys.argv[1:],
-            cwd=os.getcwd(),
-            env=env,
-        )
-
-        return result.returncode
-
-    except FileNotFoundError as e:
-        print(f"Error: {e}", file=sys.stderr)
-        return 1
-    except Exception as e:
-        print(f"Error running GitCode CLI: {e}", file=sys.stderr)
-        return 1
-
-
-if __name__ == "__main__":
-    sys.exit(main())
+"""
+Wrapper module for GitCode CLI binary.
+
+This module provides a Python entry point that calls the appropriate
+pre-compiled binary based on the current platform.
+"""
+
+import os
+import platform
+import subprocess
+import sys
+from pathlib import Path
+
+COMMAND_NAME_ENV = "GITCODE_CLI_COMMAND_NAME"
+
+
+def get_binary_name() -> str:
+    """Get the binary name for the current platform."""
+    system = platform.system().lower()
+    machine = platform.machine().lower()
+
+    # Map machine architecture
+    arch_map = {
+        "x86_64": "amd64",
+        "amd64": "amd64",
+        "aarch64": "arm64",
+        "arm64": "arm64",
+    }
+    arch = arch_map.get(machine, "amd64")
+
+    # Map system to binary name
+    if system == "linux":
+        return f"gc-linux-{arch}"
+    elif system == "darwin":
+        return f"gc-darwin-{arch}"
+    elif system == "windows":
+        return "gc-windows-amd64.exe"
+    else:
+        raise RuntimeError(f"Unsupported platform: {system} {machine}")
+
+
+def get_binary_path() -> Path:
+    """Get the path to the binary for the current platform."""
+    package_dir = Path(__file__).parent
+    binary_name = get_binary_name()
+    binary_path = package_dir / "bin" / binary_name
+
+    if not binary_path.exists():
+        raise FileNotFoundError(
+            f"Binary not found for your platform: {binary_path}\n"
+            f"Supported platforms: linux-amd64, linux-arm64, darwin-amd64, darwin-arm64, windows-amd64"
+        )
+
+    return binary_path
+
+
+def get_command_name() -> str:
+    """Get the command name that should appear in CLI output."""
+    command = Path(sys.argv[0]).stem.lower()
+    if command in {"gc", "gitcode"}:
+        return command
+    if platform.system() == "Windows":
+        return "gitcode"
+    return "gc"
+
+
+def ensure_executable(binary_path: Path) -> None:
+    """Ensure packaged binaries are executable on POSIX platforms."""
+    if platform.system() == "Windows":
+        return
+    if not os.access(binary_path, os.X_OK):
+        binary_path.chmod(0o755)
+
+
+def main() -> int:
+    """Main entry point for the GitCode CLI command."""
+    try:
+        binary_path = get_binary_path()
+
+        ensure_executable(binary_path)
+        env = os.environ.copy()
+        env.setdefault(COMMAND_NAME_ENV, get_command_name())
+
+        # Run the binary with all arguments
+        result = subprocess.run(
+            [str(binary_path)] + sys.argv[1:],
+            cwd=os.getcwd(),
+            env=env,
+        )
+
+        return result.returncode
+
+    except FileNotFoundError as e:
+        print(f"Error: {e}", file=sys.stderr)
+        return 1
+    except Exception as e:
+        print(f"Error running GitCode CLI: {e}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

{gitcode_cli-0.5.7.dist-info → gitcode_cli-0.5.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitcode-cli
-Version: 0.5.7
+Version: 0.5.14
 Summary: GitCode CLI - Command line tool for GitCode
 Author-email: GitCode CLI Contributors <support@gitcode.com>
 Maintainer-email: GitCode CLI Contributors <support@gitcode.com>
@@ -33,7 +33,7 @@ Dynamic: license-file
 
 [![Go Version](https://img.shields.io/badge/Go-1.22+-00ADD8?style=flat&logo=go)](https://golang.org)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Release](https://img.shields.io/badge/Release-v0.5.7-blue)](https://gitcode.com/gitcode-cli/cli/releases)
+[![Release](https://img.shields.io/badge/Release-v0.5.9-blue)](https://gitcode.com/gitcode-cli/cli/releases)
 
 GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验。
 
@@ -55,6 +55,7 @@ GitCode 命令行工具，为 GitCode 用户提供便捷的命令行操作体验
 - [回归说明](./docs/REGRESSION.md)
 - [打包说明](./docs/PACKAGING.md)
 - [AI 操作指南（外部项目）](./docs/AI-GUIDE.md)
+- [应用案例库](./Example/index.md)
 - [开发规范](./spec/README.md)
 - [真相源矩阵](./spec/governance/source-of-truth-matrix.md)
 - [AI 本地开发流程](./spec/workflows/ai-local-development-workflow.md)
@@ -98,10 +99,10 @@ export PATH="$HOME/.local/bin:$PATH"
 
 ```bash
 # 从 Releases 下载 .deb 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.7/gc_0.5.7_amd64.deb
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc_0.5.9_amd64.deb
 
 # 安装
-sudo dpkg -i gc_0.5.7_amd64.deb
+sudo dpkg -i gc_0.5.9_amd64.deb
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -110,10 +111,10 @@ DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
 
 ```bash
 # 从 Releases 下载 .rpm 包
-wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.7/gc-0.5.7-1.x86_64.rpm
+wget https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gc-0.5.9-1.x86_64.rpm
 
 # 安装
-sudo rpm -i gc-0.5.7-1.x86_64.rpm
+sudo rpm -i gc-0.5.9-1.x86_64.rpm
 ```
 
 DEB/RPM packages install both `gc` and `gitcode`; on Linux they are equivalent.
@@ -129,7 +130,7 @@ source .venv/bin/activate  # Linux/macOS
 # .venv\Scripts\activate   # Windows
 
 # 安装（一行命令）
-pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.7/gitcode_cli-0.5.7-py3-none-any.whl
+pip install https://gitcode.com/gitcode-cli/cli/releases/download/v0.5.9/gitcode_cli-0.5.9-py3-none-any.whl
 
 # Windows PowerShell 中推荐使用 gitcode，避免 gc 被内置 Get-Content 别名覆盖
 gitcode version
@@ -139,6 +140,12 @@ gitcode version
 - wheel 会同时安装 `gc` 和 `gitcode` 两个命令入口，功能相同。
 - DEB/RPM 包也会同时安装 `gc` 和 `gitcode`；Linux 上二者功能相同。
 - Windows PowerShell 预置 `gc` 作为 `Get-Content` 别名；如果 `gc version` 被解析为读取文件，请改用 `gitcode version`、`gc.exe version` 或 `python -m gc_cli version`。
+- Windows PowerShell 中通过 `--body-file -` / `--comment-file -` 管道传入中文或其他非 ASCII 正文时，推荐使用 UTF-8 文件；如果必须直接管道，先设置 `$OutputEncoding = [System.Text.UTF8Encoding]::new($false)`。CLI 会拦截疑似已被 PowerShell 损坏成 `???` 的输入并提示正确用法。
+
+```powershell
+Set-Content -Path body.md -Value "中文正文" -Encoding UTF8
+gitcode issue create -R owner/repo --title "标题" --body-file body.md
+```
 
 ### PyPI（备选）
 
@@ -155,31 +162,27 @@ pip install gitcode-cli
 gitcode version
 ```
 
-### 预编译二进制文件
+### Linux 二进制文件
 
-从 Release Assets 直接下载对应平台的二进制文件：
+从 Release Assets 直接下载 Linux 二进制文件：
 
 | 平台 | 文件 |
 |------|------|
-| Linux x64 | `gc_<version>_linux_amd64.tar.gz` |
-| Linux ARM64 | `gc_<version>_linux_arm64.tar.gz` |
-| macOS Intel | `gc_<version>_darwin_amd64.tar.gz` |
-| macOS Apple Silicon | `gc_<version>_darwin_arm64.tar.gz` |
-| Windows x64 | `gc_<version>_windows_amd64.zip` |
+| Linux x64 | `gc_linux_amd64` |
+| Linux ARM64 | `gc_linux_arm64` |
 
 下载地址: https://gitcode.com/gitcode-cli/cli/releases
 
-解压后将二进制文件放到 PATH 目录：
+下载后赋予可执行权限，并放到 PATH 目录：
 
 ```bash
-# Linux/macOS
-tar -xzf gc_*.tar.gz
-mv gc ~/.local/bin/
-
-# Windows
-# 解压 zip 文件后，将 gc.exe 放到 PATH 目录
+chmod +x gc_linux_amd64
+mv gc_linux_amd64 ~/.local/bin/gc
+gc version
 ```
 
+Windows 和 macOS 用户建议使用上方 wheel 包；wheel 内置 Linux、macOS 和 Windows 二进制，并同时提供 `gc` 与 `gitcode` 两个命令入口。
+
 ### 规划中的安装方式
 
 以下安装方式正在开发中：
@@ -251,6 +254,8 @@ gc auth status
 # 结构化输出
 gc issue list -R owner/repo --json
 gc issue list -R owner/repo --format json
+gc repo log -R owner/repo --file README.md --branch main --json
+gc pr list -R owner/repo --paginate --per-page 100 --json
 
 # 常规文本与表格
 gc issue list -R owner/repo --format simple
@@ -262,6 +267,9 @@ gc issue list -R owner/repo --time-format relative
 
 # 自定义模板输出
 gc issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"}}{{end}}'
+
+# typed command 尚未覆盖的 API，可用 gc api 读取原始响应
+gc api repos/owner/repo
 ```
 
 `issue view` 和 `pr view` 的文本详情展示也会保持稳定布局，而 `--json` 仍然是面向机器调用的首选入口。
@@ -274,6 +282,9 @@ gc issue list -R owner/repo --template '{{range .}}#{{.Number}} {{.Title}}{{"\n"
 # 查看仓库
 gc repo view
 
+# 查看文件提交历史
+gc repo log -R owner/repo --file README.md --branch main
+
 # 创建 Issue
 gc issue create --title "Bug report" --body "Description"
 
@@ -283,6 +294,12 @@ gc issue list --state open
 # 创建 PR
 gc pr create --title "New feature" --base main
 
+# 按提交信息反查 PR
+gc pr list -R owner/repo --commit-message "fix login"
+
+# 调用 GitCode API 原始响应
+gc api repos/owner/repo
+
 # 查看认证状态
 gc auth status
 ```

gitcode_cli-0.5.14.dist-info/RECORD

@@ -0,0 +1,15 @@
+gc_cli/__init__.py,sha256=s7CqTQr3874eS2b3sL_YArG_1x1xr1VlpbJkc1T1wSQ,243
+gc_cli/__main__.py,sha256=fqZ9iOh0ac8K_B9WmHydaxokzIivd5QBPJoNqgXnugo,154
+gc_cli/wrapper.py,sha256=vq6JZIs7nZx_FugIljMjpNb0nxTiC0lQqfZ7Dhz6aMw,2744
+gc_cli/bin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gc_cli/bin/gc-darwin-amd64,sha256=DcQYJRQ4OamMiAO8wD3qzN8SkOEam0rdp3lk4zZwYAw,8579248
+gc_cli/bin/gc-darwin-arm64,sha256=OAjdRq-LAm8HQHcK2Y5yJwPH8qsGf-_ARjfshx5v7YU,8249954
+gc_cli/bin/gc-linux-amd64,sha256=tF5Hro4iOKRHmJRxS7WYOCebvEY3XLbbe5Cbw2ShoUw,8355992
+gc_cli/bin/gc-linux-arm64,sha256=JZ2XTQFP6Rrpt9nXa99X1FT0fjNG2mp8EDK9pckpUik,8061080
+gc_cli/bin/gc-windows-amd64.exe,sha256=_0RR_-ej27PBlsjcKds22y41nqXt1Deg1N7n8aGLmOQ,8647680
+gitcode_cli-0.5.14.dist-info/licenses/LICENSE,sha256=WsjkQaj0PPK_TKVoHDok218rd8JZdj1GIJ5TrrZD6jE,1253
+gitcode_cli-0.5.14.dist-info/METADATA,sha256=Xc1CNG3wfJhS3UeeDKJfB41J4J2GH6BK1f1fuiQBxq8,10799
+gitcode_cli-0.5.14.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+gitcode_cli-0.5.14.dist-info/entry_points.txt,sha256=DresfT5jkpwU3fPn8n0MTao1m5QZi3XEulKFbQ8BYYY,73
+gitcode_cli-0.5.14.dist-info/top_level.txt,sha256=2fSmR3kQ-XhdgFQdVvWmZcEyERJKVZVxOhk7tna1Sus,7
+gitcode_cli-0.5.14.dist-info/RECORD,,

{gitcode_cli-0.5.7.dist-info → gitcode_cli-0.5.14.dist-info}/licenses/LICENSE

@@ -1,28 +1,28 @@
-MIT License
-
-Copyright (c) 2026 gitcode-cli contributors
-
-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.
-
----
-
-This project is inspired by and references the GitHub CLI (https://github.com/cli/cli),
-which is also licensed under the MIT License.
-
+MIT License
+
+Copyright (c) 2026 gitcode-cli contributors
+
+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.
+
+---
+
+This project is inspired by and references the GitHub CLI (https://github.com/cli/cli),
+which is also licensed under the MIT License.
+
 Copyright (c) 2019 GitHub, Inc.

gitcode_cli-0.5.7.dist-info/RECORD

@@ -1,15 +0,0 @@
-gc_cli/__init__.py,sha256=Yi08ftr-OFw-AKkpunO7GnQYUFvOxEi_PcmNk6Y66bg,253
-gc_cli/__main__.py,sha256=4IoaQc5w_ZsLDqiDifrGjllM76LLLUM2CSz2ifmwMmY,163
-gc_cli/wrapper.py,sha256=-nQsDyCvTunhgK24tuJ_tjqJJ1ErRs0hPfdHmUh1JDM,2846
-gc_cli/bin/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gc_cli/bin/gc-darwin-amd64,sha256=86OynZA78i5oU1JpuFXfWZ_Enk5pFDTLGsQh0TuWqyQ,8368128
-gc_cli/bin/gc-darwin-arm64,sha256=NjBFW2RdQ5bMLezc-DNU2IfHI22ugMXdI652HtTvaZA,8033042
-gc_cli/bin/gc-linux-amd64,sha256=Y3rU80teEZgaecIui-IcrGEIWoM75Q1eWNicwQ3bU3o,8147096
-gc_cli/bin/gc-linux-arm64,sha256=OEhpygfb8UyME5tZm8-jf04eVZ6wA0TOcqlw9D5VDwM,7864472
-gc_cli/bin/gc-windows-amd64.exe,sha256=WUpXhetlzOYzogGMc5veR9oFTvimO-ebA3V5DJVFHkg,8434688
-gitcode_cli-0.5.7.dist-info/licenses/LICENSE,sha256=23d4Rfrm1CLX092oLjzs2UTYcy5Sp-dpaji0IAHIsiE,1280
-gitcode_cli-0.5.7.dist-info/METADATA,sha256=SCdrHbhohqekVplE9qjoEpTgKowN0XPzRb69C9jnQLA,9918
-gitcode_cli-0.5.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-gitcode_cli-0.5.7.dist-info/entry_points.txt,sha256=DresfT5jkpwU3fPn8n0MTao1m5QZi3XEulKFbQ8BYYY,73
-gitcode_cli-0.5.7.dist-info/top_level.txt,sha256=2fSmR3kQ-XhdgFQdVvWmZcEyERJKVZVxOhk7tna1Sus,7
-gitcode_cli-0.5.7.dist-info/RECORD,,