GitHub Labels Manager DuckStudio
winget install --id=DuckStudio.GitHubLabelsManager -e Tools that automatically help you copy repo labels, get repo labels, and empty existing labels.
GitHub Labels Manager (GLM) is a tool designed to automate tasks related to GitHub repository labels. It helps users efficiently manage labels by providing functionalities such as exporting labels to a JSON file, clearing existing labels, importing new labels from a JSON file, and copying labels between repositories.
Key Features:
- Export all labels of a repository to a JSON file.
- Clear existing labels in a repository.
- Import new labels from a specified JSON file.
- Copy labels from one repository to another.
Audience & Benefit:
Ideal for developers and teams managing multiple GitHub repositories. This tool streamlines the process of label management, enabling users to automate repetitive tasks, save time, and maintain consistency across projects.
README
GitHub Labels Manager (GLM)
Enjoy your day and let automation do it for you. :)
项目简介
GLM提供了以下几种功能:
- 获取某个仓库的所有标签，并存在指定目录的
labels.json中 - 清空某个仓库的标签 (需要有repo权限的token)
- 依据指定的 json 文件设置某个仓库的标签 (先清空指定仓库的标签后再设置，需要有repo权限的token)
- 复制某个仓库的标签到另一个仓库 (先清空指定仓库的标签后再设置，需要有repo权限的token)
关于图标
目前的图标仅作临时使用，后续如有正式设计将会替换。
吐槽动态
> [!TIP] > 如果你想设计新图标可以将你的设计发至，感谢您对本项目的支持！
使用前配置
Python
请确保你的设备上有Python环境。
运行以下命令检查Python版本：
python --version
你可能会看到类似这样的输出：
C:\Users\user_name>python --version
Python 3.12.0
安装所需库
cd到项目目录后运行如下命令:
# 创建虚拟环境
python -m venv .venv
# 激活虚拟环境
& ".venv\Scripts\Activate.ps1"
# 安装所需库
pip install -r requirements.txt
# TIP: 镜像源 -i https://pypi.tuna.tsinghua.edu.cn/simple
> [!TIP] > 使用winget获取的不需要弄。
Token
你需要一个GitHub Token才可以运行部分功能。
> [!TIP] > 官方文档 → 管理个人访问令牌 - GitHub 文档
请按照以下步骤设置GitHub Token。
-
登录 GitHub：
打开 GitHub 并登录到您的账户。 -
进入设置页面：
点击右上角的个人头像，然后选择“Settings”（设置）。 -
导航到Token设置：
在左侧菜单中，点击“Developer settings”（开发者设置）。
然后再在左侧菜单上，找到并点击展开“Personal access tokens”（个人账户Tokens）。
选择“Personal access tokens”下的“Tokens (classic)”（Tokens（典型））。 -
新建Token：
在右上角展开“Generate new token”（生成新的Token）。
选择“Generate new token (classic)”（生成新的Token（典型））。 -
填写Token信息：
按着表格填就好。
Note → Token的名字，随便取，中文也行。
Expiration → Token存在的时间，可以选“No expiration”（不会过期）。
Select scopes → Token的作用域，这里需要选repo。 -
生成Token：
点击最下面的绿色按钮（“Generate token”（生成Token））生成Token。 -
复制生成的Token：
请注意，在此之后你将无法再次获取这个Token，请妥善保管Token，不要上传到公共仓库中。 -
设置glm中的GitHub Token：
运行glm config --token。
> [!TIP]
> 自1.6版本起，你可以使用glm config --token remove移除设置的Token。
> 更新Token的命令和设置Token时的一样。
如何获取
使用winget获取
运行以下命令:
winget install DuckStudio.GitHubLabelsManager
> [!TIP] > 设支持的版本号为n，则 $1.1 \leqslant n \leqslant 1.8$
如何使用
运行以下命令以获取帮助:
glm --help # winget获取的/使用安装程序的
python glm.py --help # python源码的
获取子命令的帮助:
glm --help # winget获取的/使用安装程序的
python glm.py --help # python源码的