Gitpub

A small program to create remote git repositories from the command line.

Note: Environment variables can also be passed directly via CLI parameters, therefore setting said variables are always optional.

Note: API Versions in this README are based on the last time the CLI changed.

Usage:

``` Git Publish 0.4.1 Logan Saso A small program to create remote git repositories from the command line.

USAGE: gitpub [FLAGS] [OPTIONS]

FLAGS: -h, --help Prints help information --setremote Sets the remote of the local dir after successful creation. --sshremote_format Attempts to convert the git remote url into ssh format. If it fails (the provider doesn't support ssh format), the remote isn't set. -V, --version Prints version information

OPTIONS: --endpoint Sets a custom endpoint to POST to, useful if you want a private instance and know the api matches one gitpub supports. --remote_name Designates a custom name for setting remote. Defaults to origin.

SUBCOMMANDS: bitbucket Create a repo on bitbucket. github Create a repo on github. gitlab Create a repo on gitlab. help Prints this message or the help of the given subcommand(s) ```

Github Setup

1. Create a personal access token with repo scope from https://github.com/settings/tokens
2. Set the environment variable GITHUB_REPO_TOKEN to the generated personal access token.

Note: If you want to create org repositories the token also requires org scope.

Github

``` gitpub-github 0.4.1 Create a repo on github.

USAGE: gitpub github [FLAGS] [OPTIONS] --name --token

FLAGS: -i, --disableissues Disables issues for this repo. Defaults to false. --merge Enables or disables merging with a merge commit. Defaults to false. --disableprojects Disables projects for this repo. Defaults to false. --rebase Enables or disables rebase-merging for this repo. Defaults to false. --squash Enables or disables squash-merging for this repo. Defaults to false. -w, --disablewiki Disables wikis for this repo. Defaults to false. -h, --help Prints help information --org Creates the repo under an organization. Requires you have CREATE REPO permissions in that org. -p, --private Sets the repository to private. Required 'repo' scope on your personal access token. -r, --initializewith_readme Creates an initial commit with empty README.md. Defaults to false. --team ID of the team that has access to this repo. Only valid when using --org -V, --version Prints version information

OPTIONS: -d, --description A short description of the repository. --gitignore Language template: ex 'Rust'. View more templates at https://github.com/github/gitignore/ --homepage A URL with more information about the repository. --license License template: ex 'mit' or 'mpl-2.0'. View more at https://choosealicense.com/ -n, --name The name of the new repository. -t, --token A personal access token. Alternatively read from GITHUBREPOTOKEN env variable. [env: GITHUBREPOTOKEN=]

```

Gitlab Setup

1. Create a personal access token with api scope from https://gitlab.com/profile/personalaccesstokens
2. Set the environment variable GITLAB_REPO_TOKEN to the generated personal access token.

Note: Optionally set the GITLAB_USERNAME environment variable to enable printing a link to the repo.

Gitlab

``` gitpub-gitlab 0.4.1 Create a repo on gitlab.

USAGE: gitpub gitlab [FLAGS] [OPTIONS] --name --path --token

FLAGS: --disablecontainerregistry Disables container registry for this repo. -i, --disableissues Disables issues for this repo. --disablejobs Disables jobs for this repo. --disablemerge Disables merging with a merge commit. --disablesharedrunners Disables shared runners for this repo. --disablesnippets Disables snippets for this repo. -w, --disablewiki Disables wikis for this repo. --discussionresolutionrequired Requires discussions are resolved before a merge. -h, --help Prints help information -r, --initializewithreadme Create a blank README for the project. --largefilesupport Enables git large file support. --mergerequestlinkoncommit Print the merge request link when committing to the repository. --mirror Enables pull mirroring in a project. --mirrortriggersbuilds Enables builds on pull mirroring. --pipelinesuccessrequired Requires pipelines to succeed before a merge. --publicbuilds Lets jobs be viewed by non-project members. --requestaccessenabled Allow users to request member access. -V, --version Prints version information

OPTIONS: --approvalsbeforemerge Number of approvals required before a merge. --ciconfigpath Path to CI config file. --defaultbranch Set default branch. Defaults to master. -d, --description A short description of the repository. --importurl Supply a URL to import a repo from. --mergemethod Sets the merge method. [possible values: merge, rebasemerge, ff] -n, --name The name of the new repository. --namespaceid Namespace for the new project (defaults to the current user’s namespace) --path The path for the new repo. Generated based on name if not provided (generated lowercased with dashes). --repositorystorage An advanced parameter to designate which shard the repo is on, available only to admins. --taglist ... A list of tags for a repo. Takes up to four params. --tag_list first second third tag -t, --token A personal access token. Alternatively read from GITLABREPOTOKEN env variable. [env: GITLABREPO_TOKEN=] --visibility The visibility of the project [possible values: public, internal, private] ```

BitBucket Setup

1. Create an app password with repo scope from https://bitbucket.org/account/user//app-passwords
2. Set the environment variable BITBUCKET_REPO_TOKEN to the generated personal access token.
3. Set the environment variable BITBUCKET_USERNAME to your bitbucket username.

Bitbucket

``` gitpub-bitbucket 0.4.3 Create a repo on bitbucket.

USAGE: gitpub bitbucket [FLAGS] [OPTIONS] --name --token --username

FLAGS: -i, --disableissues Disables issues for this repo. Defaults to false. -w, --disablewiki Disables wikis for this repo. Defaults to false. -h, --help Prints help information -p, --private Sets the repository to private. -V, --version Prints version information

OPTIONS: -d, --description A short description of the repository. --forkpolicy Changes the allowed forking method for this repo. [possible values: allowforks, nopublicforks, noforks] --language Give bitbucket a hint about the programming language. -n, --name The name of the new repository. --scm Control underlying source control method. [possible values: git, hg] -t, --token A personal access token. Alternatively read from BITBUCKETREPOTOKEN env variable. [env: BITBUCKETREPOTOKEN=] --username Your bitbucket username. Alternatively read from BITBUCKETUSERNAME env variable. [env: BITBUCKET_USERNAME=] ```