DevStation

版本:25.03

使用指导

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]