voidint / star Goto Github PK

• 将本地的star列表推送到远端指定仓库下进行持久化。若远端仓库在此期间产生了修改，则拒绝此命令执行。
• push命令支持附带-f, --force选项，此选项支持强制将本地star列表推送到远程仓库并持久化。

• 数据源一: 从远端拉取到的当前用户下的star列表。
• 数据源二: 从远端指定仓库下拉取到的star列表及其tags。
• 合并数据源一和数据源二，并装入本地内存。
• 拉取远端指定仓库下最新的git commit hash。

• 从环境变量STAR_GITHUB_TOKEN、STAR_GITEE_TOKEN中读取AccessToken。
• 若Token非空，则执行star login github后无需再次输入用户名和密码。
• 登录到交互式环境后，Token值被保存在内存中。

列出指定层级的tag

tag [tagname]

添加tag

tag add <tagname>

tagname允许以类似container/docker的方式添加带层级的tag，其中第一级tag为container，第二级别tag为docker。同级别的tag名称不允许重复。

移除tag

tag rm <tagname>

tag名规则同tag add。移除仅对最末级tag生效，如tag rm container/docker仅会移除docker这层级的tag。

重命名tag

tag rename <tagname>

重命名仅对最末级tag生效。

输出帮助信息

• 拉取当前用户在github的star列表，并将star列表以特定格式写入特定仓库下的特定文件中进行持久化。
• 若目标仓库的目标文件中已经包含了内容，则一律覆盖。
• 该命令属于高危操作，需二次确认。

• use [github/gitee]将上下文环境切换到目标插件环境下。
• 若目标插件非当前插件，需重新输入用户名和密码。
• 上下文环境切换完毕后，在终端输出Plugin changed。

• star login等价于star login github
• 优先从环境变量STAR_GITHUB_TOKEN中读取用于GitHub认证的Token，尝试使用该Token拉取用户信息。
• 若当前环境变量STAR_GITHUB_TOKEN值为空，则要求用户输入GitHub的用户名、密码等信息。

• 提供全局选项log-file，默认值为$TempDir/star.log

生成gbb.json

{
    "version": "0.5.0",
    "tool": "go install -v -ldflags '-s -w'",
    "importpath": "github.com/voidint/star/build",
    "variables": [
        {
            "variable": "Build",
            "value": "{{.Date}}"
        },
        {
            "variable": "GitCommitHash",
            "value": "{{.GitCommit}}"
        }
    ]
}

• 样式一: [voidint@github] $
• 样式二: star@github>
• 样式三: star>

• 退出交互式命令环境。

显示当前上下文环境的插件信息

• 列出本地获取到的star列表。

• STAR_GITHUB_TOKEN: 操作个人GitHub资源所需的Access Token。
• STAR_GITEE_TOKEN: 操作个人Gitee资源所需的私人令牌。
• STAR_REPO: 存储标星仓库列表数据的仓库名。默认值awesome-star。
• STAR_BRANCH: 存储标星仓库列表数据仓库的分支名。默认值master。