GitHub from the command line with hub
Starting a New Project
Starting a new project is also much easier from hub than via the standard GitHub interface. To create a repository to host a new project, simply run:
$ git init $ git add . $ git commit -m "My New Project" $ hub create $ git push -u origin HEAD
Forking from the Command Line
Hub makes the process of collaboration on GitHub much easier by giving you the ability to create fork repositories with just one command. You can also check the CI status of a particular branch of a project or invoke pull requests, all with a single command.
To clone a repo, as above, you can just run:
$ hub clone octocat/MyNewProjectFork
And then navigate to the clone:
cd MyNewProjectFork
Then it's time to fork the repository. You can enter a single command:
$ hub fork --remote-name origin
And then push the fork to your new remote:
$ git push origin feature
Then you can check the CI status of your new fork, again with a single command:
$ hub ci-status --verbose
Automation and API
Perhaps the most powerful feature of hub, and one that more experienced developers will find extremely useful, is the ability to script GitHub tasks via the command line. You can also list or create issues, pull requests, or GitHub releases in the format of your choice. For instance, to list the URLs of the last 20 pull requests for the develop
branch, you can run:
$ hub pr list --limit 20 --base develop --format='%t [%H] | %U%n'
The functionality of hub is then further increased by the hub api
extension [7], which allows you to make any requests that the GitHub API can handle. Support for the API greatly increases the reach and power of hub, because it means you can work with more advanced tools like GraphQL [8] and open source AIs [9] directly from your terminal.
The syntax for working with hub api
is a little more complex than the examples I've given up until now, but the tool comes with a detailed and frequently updated set of manual pages [10] that can take you through the process of extending your hub install.
« Previous 1 2 3 4 Next »
Buy this article as PDF
(incl. VAT)