Skip to content

microsoft/PowerShellForGitHub

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

670f39c · Dec 4, 2018
Dec 4, 2018
Nov 13, 2018
Dec 1, 2018
Nov 13, 2018
Nov 16, 2018
Nov 13, 2018
Nov 19, 2018
Nov 30, 2018
Nov 19, 2018
Nov 30, 2018
Nov 30, 2018
Nov 30, 2018
Nov 30, 2018
Dec 4, 2018
Nov 30, 2018
Nov 19, 2018
Nov 19, 2018
Nov 30, 2018
Nov 19, 2018
Nov 19, 2018
Nov 19, 2018
Nov 30, 2018
Nov 30, 2018
Jul 26, 2016
Nov 14, 2018
Dec 4, 2018
Nov 30, 2018
Dec 1, 2018
Nov 19, 2018
Dec 4, 2018
Nov 13, 2018

Repository files navigation

PowerShellForGitHub PowerShell Module

Build status

Table of Contents


Overview

This is a PowerShell module that provides command-line interaction and automation for for the GitHub v3 API.


Current API Support

At present, this module can:

Development is ongoing, with the goal to add broad support for the entire API set. Review examples to see how the module can be used to accomplish some of these tasks.


Installation

You can get latest release of the PowerShellForGitHub on the PowerShell Gallery

Install-Module -Name PowerShellForGitHub

Configuration

To avoid severe API rate limiting by GitHub, you should configure the module with your own personal access token.

  1. Create a new API token by going to https://github.com/settings/tokens/new (provide a description and check any appropriate scopes)
  2. Call Set-GitHubAuthentication, enter anything as the username (the username is ignored but required by the dialog that pops up), and paste in the API token as the password. That will be securely cached to disk and will persist across all future PowerShell sessions. If you ever wish to clear it in the future, just call Clear-GitHubAuthentication).

A number of additional configuration options exist with this module, and they can be configured for just the current session or to persist across all future sessions with Set-GitHubConfiguration. For a full explanation of all possible configurations, run the following:

Get-Help Set-GitHubConfiguration -ShowWindow

For example, if you tend to work on the same repository, you can save yourself a lot of typing by configuring the default OwnerName and/or RepositoryName that you work with. You can always override these values by expicitly providing a value for the paramater in an individual command, but for the common scenario, you'd have less typing to do.

Set-GitHubConfiguration -DefaultOwnerName PowerShell
Set-GitHubConfiguration -DefaultRepositoryName PowerShellForGitHub

Be warned that there are some commands where you may want to only ever supply the OwnerName (like if you're calling Get-GitHubRepository and want to see all the repositories owned by a particular user, as opposed to getting a single, specific repository). In cases like that, you'll need to explicitly pass in $null as the relevant parameter value as a temporary override for your default if you've set a default for one (or both) of these values.

There are more great configuration options available. Just review the help for that command for the most up-to-date list!


Usage

Example command:

$issues = Get-GitHubIssue -Uri 'https://github.com/PowerShell/PowerShellForGitHub'

For more example commands, please refer to USAGE.


Developing and Contributing

Please see the Contribution Guide for information on how to develop and contribute.

If you have any problems, please consult GitHub Issues to see if has already been discussed.

If you do not see your problem captured, please file feedback.


Legal and Licensing

PowerShellForGitHub is licensed under the MIT license.


Governance

Governance policy for this project is described here.


Code of Conduct

For more info, see CODE_OF_CONDUCT


Privacy Policy

For more information, refer to Microsoft's Privacy Policy.