命令方式创建远程代码仓库

• https://docs.github.com/rest/reference/repos#create-a-repository-for-the-authenticated-user
• https://docs.github.com/en/developers/apps/scopes-for-oauth-apps
• https://github.com/settings/tokens
• https://docs.github.com/
• Next.js 入门教程[TypeScript] https://github.com/jimboyeah/Next.js-Tutorials
  
  Next.js 服务端渲染教程

将本地代码 push 到 github 远程代码仓库之前，总是通过在线新建 github 代码仓库的操作是比较麻烦的。

借助 Github API，可以利用命令创建远程代码仓库，十分便捷。

首先需要申请并获取自己的 API Token，用于鉴权，OAuth scope requirements。

• public_repo scope or repo scope to create a public repository
• repo scope to create a private repository

通过 API Token 可以在 OAuth 应用中安全访问需要授权的 API 资源，以下可以检测什么类型的 OAuth 作用域是可用的：

$ curl -H "Authorization: token YOUR_OAUTH-TOKEN" https://api.github.com/users/codertocat -I
HTTP/1.1 200 OK
X-OAuth-Scopes: repo, user
X-Accepted-OAuth-Scopes: user

对于远程创建仓库，检查其中已经授权的 API 列表 X-OAuth-Scopes 和 X-Accepted-OAuth-Scopes 两项。

勾选 repo 支持仓库的完全控制，具体参考 Scopes for OAuth Apps：

• repo:status Access commit status
• repo_deployment Access deployment status
• public_repo Access public repositories
• repo:invite Access repository invitations
• security_events Read and write security events

然后在本机使用脚本简化远程创建仓库的过程，在 Windows 系统上可以使用以下脚本：

@ECHO off
SETLOCAL
set user=yyyyyy
set token=xxxxx
set repo=%1
GOTO :RUN

:ERR
    echo Error occurs %errorlevel% !
    GOTO :END
:RUN

IF "%repo%" == "" (
    echo Script [%0] need a repository name for github!
    echo Example: %0 demo-repository
    GOTO :END
)
IF "%repo%" == "user" (
    curl -u %user%:%token% https://api.github.com/user
    GOTO :END
)

IF "%repo%" == "demo" (
    curl -H "Authorization: token %token%" https://api.github.com/repos/%user%/%repo%
    GOTO :END
)

IF "%repo%" == "test" (
    curl -H "Authorization: token %token%" https://api.github.com/users/codertocat -I
    rem curl -v -H "Authorization: %token% TOKEN" https://api.github.com/repos/octodocs
    GOTO :END
)

IF not "%repo%" == "" (
    echo Script [%0] ready to create an new repository [%repo%] for github! 
    curl -u '%user%:%token%' -H "Authorization: token %token%" https://api.github.com/user/repos -d "{\"name\":\"%repo%\"}"
    rem curl -u '%user%:%token%' -H "Accept: application/vnd.github.v3+json" https://api.github.com/user/repos -d "{\"name\":\"%repo%\"}"
    if not %errorlevel% == 0 (
        GOTO :ERR
    )
    git remote add origin git@github.com:%user%/%repo%.git
    echo Done with:
    echo https://github.com/%user%/%repo%.git
)
:END

ENDLOCAL

如 bash 的配置文件中加入下述函数定义：

github-create() 
{if [ $1 ]
then
    repo_name=$1
else
    repo_name=`basename $(pwd)`
    echo "set Repo name to ${repo_name}"
fi 
curl -u 'username:api_token' https://api.github.com/user/repos -d '{"name":"'$repo_name'"}'
git remote add origin git@github.com:username/$repo_name.git
}

注意，需要使用自己的 username 与 api_token 覆盖上述函数中相应的值。

创建代码仓库只需输入命令：

github-create repo_name

如果没有指定仓库名称 repo_name，会自动将当前路径的文件夹名称设置为代码仓库的名称。然后，就可以将本地代码仓库 push 到远程代码仓库：

git push -u origin master