使用指导
1. 配置gitee私人令牌
oeGitExt使用之前,需要配置gitee私人令牌,该令牌需具有user_info、projects、pull_requests和issues权限。
bash
oegitext config -token ${access_token}
2. 显示仓库信息
bash
oegitext show proj -h
text
oegitext show proj [-h] [-create] [-p] [-j] [-s {full_name,created,updated,pushd}] [-d {,desc,asc}] [-c COLUMNS]
参数说明:
-h, --help 显示帮助信息
-create 仅显示我创建的工程
-p, --pretty 以pretty格式显示结果
-j, --json 以json格式显示结果
-s, --sort 排序依据: 创建时间(created),更新时间(updated)
-d, --direction 排序方式,升序(asc),降序(desc)
-c, --columns 仅显示指定列
显示我的项目
bash
oegitext show proj
# 以pretty格式显示
oegitext show proj -p
# 仅显示项目的state和url列
oegitext show proj -c state,url
# 以pretty格式显示
oegitext show proj -c state,url -p
显示我创建的项目
bash
oegitext show proj -create
# 以pretty格式显示
oegitext show proj -create -p
# 仅显示项目的state和url列
oegitext show proj -create -c state,url
3. 显示issue
bash
oegitext show issue -h
text
oegitext show issue [-h] [-create] [-p] [-j] [-s {created,updated}] [-d {desc,asc}] [-c COLUMNS]
参数说明:
-h, --help 显示帮助信息
-create 仅显示我创建的issue
-p, --pretty 以pretty格式显示结果
-j, --json 以json格式显示结果
-s, --sort 排序依据: 创建时间(created),更新时间(updated)
-d, --direction 排序方式,升序(asc),降序(desc)
-c, --columns 仅显示指定列
显示我负责的issues
bash
oegitext show issue
# 以pretty格式显示
oegitext show issue -p
# 仅显示state和url列
oegitext show issue -c state,url
显示我创建的issues
bash
oegitext show issue -create
# 以pretty格式显示
oegitext show issue -create -p
# 仅显示state和url列
oegitext show issue -create -c state,url
4. Show pull request
bash
oegitext show pr -h
text
oegitext show pr [-h] [-oe] -name REPO_NAME [-only] [-p] [-j] [-c COLUMNS]
参数说明:
-h, --help 显示帮助信息
-name pr路径,owner/repo
-only 仅显示我创建的PR
-p, --pretty 以pretty格式显示结果
-j, --json 以json格式显示结果
-c, --columns 仅显示指定列
显示仓库的PR
bash
oegitext show pr -name src-openeuler/vscode
# 以pretty格式显示
oegitext show pr -name src-openeuler/vscode -p
# 仅显示其中的state和url列
oegitext show pr -name src-openeuler/vscode -c state,url
5. 显示openEuler仓库信息
bash
oegitext show repo -h
text
oegitext show repo [-h] [-owner {openeuler,src-openeuler}] [-p] [-j] [-c COLUMNS]
参数说明:
-h, --help 显示帮助信息
-owner 仓库所有者(openeuler或者src-openeuler),默认openeuler
-p, --pretty 以pretty格式显示结果
-j, --json 以json格式显示结果
-c, --columns 仅显示指定列
6. fork仓库
bash
oegitext show fork -h
text
oegitext fork [-h] -user USER -repo REPO [-org ORG] [-name NAME] [-path PATH] [-show]
参数说明:
-h, --help 显示帮助信息
-user USER 仓库所属空间地址(企业、组织或个人的地址path)
-repo REPO 仓库路径(path)
-org ORG 组织空间完整地址,不填写默认Fork到用户个人空间地址
-name NAME fork 后仓库名称。默认: 源仓库名称
-path PATH fork 后仓库地址。默认: 源仓库地址
-show 显示requests结果
7. 处理issue
bash
oegitext show issue -h
text
oegitext issue [-h] -cmd {create,update,close,open,get} [-user USER] [-repo REPO] [-title TITLE] [-number NUMBER]
[-body BODY] [-show]
参数说明:
-h, --help 显示帮助信息
-cmd 处理issue命令
-user USER issue所属空间地址(企业、组织或个人的地址path)
-repo REPO 仓库路径(path)
-title TITLE title
-number NUMBER issue number
-body BODY issue body
-show 显示requests结果
获取仓库issue
text
oegitext issue -cmd get -user USER -repo REPO -number NUMBER [-show]
创建issue
text
oegitext issue -cmd create -user USER -repo REPO -title TITLE [-body BODY] [-show]
更新issue
text
oegitext issue -cmd update -user USER -repo REPO -title TITLE -number NUMBER [-body BODY] [-show]
关闭issue
text
oegitext issue -cmd close -user USER -repo REPO -number NUMBER [-show]
打开issue
text
oegitext issue -cmd open -user USER -repo REPO -number NUMBER [-show]
8. 处理PR
bash
oegitext pull -h
text
oegitext pull [-h] -cmd {create,update,close,open,review,test,merge,get} [-user USER] [-repo REPO] [-title TITLE]
[-head HEAD] [-base BASE] [-number NUMBER] [-body BODY] [-state STATE] [-show]
参数说明:
-h, --help 显示帮助信息
-cmd 处理PR命令, create,update,close,open,review,test,merge,get
-user USER PR所属空间地址(企业、组织或个人的地址path)
-repo REPO 仓库路径(path)
-title TITLE title
-head HEAD PR提交的源分支。格式:branch (master) 或者:path_with_namespace:branch (oschina/gitee:master)
-base BASE RP提交目标分支的名称
-number NUMBER number
-body RP内容
-state STATE state
-show 显示requests结果
获取PR信息
text
oegitext pull -cmd get -user USER -repo REPO -number NUMBER [-show]
创建PR
text
oegitext pull -cmd create -user USER -repo REPO -title TITLE -head HEAD -base BASE [-body BODY] [-show]
参数说明:
-head HEAD: Pull Request 提交的源分支。格式:branch (master) 或者:path_with_namespace:branch (oschina/gitee:master)
-base BASE: Pull Request 提交目标分支的名称
更新PR
text
oegitext pull -cmd update -user USER -repo REPO -number NUMBER -body BODY [-show]
关闭PR
text
oegitext pull -cmd close -user USER -repo REPO -number NUMBER [-show]
打开PR
text
oegitext pull -cmd open -user USER -repo REPO -number NUMBER [-show]
review PR
text
oegitext pull -cmd review -user USER -repo REPO -number NUMBER -state {pass,reset} [-show]
参数说明:
-state pass: 强制review通过
reset: 重置review状态
test PR
text
oegitext pull -cmd test -user USER -repo REPO -number NUMBER -state {pass,reset} [-show]
参数说明:
-state pass: 强制测试通过
reset: 重置测试状态
merge PR
text
oegitext pull -cmd merge -user USER -repo REPO -number NUMBER [-show]
文档捉虫