[Feature] Repositories - Repositories - Manage repositories on GitHub

.github/dependabot.yml

@@ -5,11 +5,11 @@
 
 version: 2
 updates:
-  - package-ecosystem: "github-actions" # See documentation for possible values
-    directory: "/" # Location of package manifests
+  - package-ecosystem: 'github-actions' # See documentation for possible values
+    directory: '/' # Location of package manifests
     schedule:
-      interval: "weekly"
-  - package-ecosystem: "nuget" # See documentation for possible values
-    directory: "/" # Location of package manifests
+      interval: 'weekly'
+  - package-ecosystem: 'nuget' # See documentation for possible values
+    directory: '/' # Location of package manifests
     schedule:
-      interval: "weekly"
+      interval: 'weekly'

.vscode/settings.json

@@ -29,6 +29,10 @@
         "editor.insertSpaces": true,
         "editor.tabSize": 2
     },
+    "editor.rulers": [
+        0,
+        150
+    ],
     "powershell.codeFormatting.autoCorrectAliases": true,
     "powershell.codeFormatting.newLineAfterCloseBrace": false,
     "powershell.codeFormatting.pipelineIndentationStyle": "IncreaseIndentationForFirstPipeline",

CODE_OF_CONDUCT.md

@@ -17,23 +17,23 @@ diverse, inclusive, and healthy community.
 Examples of behavior that contributes to a positive environment for our
 community include:
 
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
   and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
+- Focusing on what is best not just for us as individuals, but for the
   overall community
 
 Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery, and sexual attention or
+- The use of sexualized language or imagery, and sexual attention or
   advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email
   address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Enforcement Responsibilities
@@ -106,7 +106,7 @@ Violating these terms may lead to a permanent ban.
 ### 4. Permanent Ban
 
 **Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior,  harassment of an
+standards, including sustained inappropriate behavior, harassment of an
 individual, or aggression toward or disparagement of classes of individuals.
 
 **Consequence**: A permanent ban from any sort of public interaction within

README.md

@@ -89,6 +89,7 @@ Press Enter to open github.com in your browser...:
 ```
 
 #### Personal access token
+
 This is the least secure method of authentication, but it is also the simplest. Running the `Connect-GitHubAccount` command
 with the `-AccessToken` parameter will send you to the GitHub website where you can create a new personal access token.
 Give it the access you need and paste it into the terminal.
@@ -100,6 +101,7 @@ Connect-GitHubAccount -AccessToken
 ```
 
 #### System Access Token
+
 The module also detects the presence of a system access token and uses that if it is present.
 This is useful if you are running the module in a CI/CD pipeline or in a scheduled task.
 The function looks for the `GH_TOKEN` and `GITHUB_TOKEN` environment variables (in order).
@@ -110,6 +112,7 @@ Connect-GitHubAccount
 ```
 
 ### Command Exploration
+
 Familiarize yourself with the available cmdlets using the module's comprehensive documentation or inline help.
 
 ```powershell
@@ -144,25 +147,31 @@ For a detailed understanding of the framework, [read more about PSModule here](h
 ## References
 
 ### Official GitHub Resources:
+
 - [REST API Description](https://github.com/github/rest-api-description)
 - [GitHub CLI Manual](https://cli.github.com/manual/)
 - [GitHub Platform Samples](https://github.com/github/platform-samples)
 
 ### General Web References:
+
 - [Generic HTTP Status Codes (MDN)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status)
 
 ### Tools Planned for Development:
+
 - [Azure AutoRest (OpenAPI Specification Code Generator)](https://github.com/Azure/autorest)
 
 ### Inspiration Behind the Project:
+
 - [Microsoft's PowerShellForGitHub](https://github.com/microsoft/PowerShellForGitHub)
 - [PSGitHub by pcgeek86](https://github.com/pcgeek86/PSGitHub)
 - [PSSodium by TylerLeonhardt](https://github.com/TylerLeonhardt/PSSodium)
 - [libsodium NuGet Package](https://www.nuget.org/packages/Sodium.Core/)
 
 ### Authentication and Login:
+
 - [PowerShell for GitHub on GitHub Marketplace](https://github.com/apps/powershell-for-github)
 - [Building a CLI with a GitHub App](https://docs.github.com/en/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app)
 
 ### Module Configuration and Environment:
+
 - [GH Environment for GitHub CLI](https://cli.github.com/manual/gh_help_environment)

src/GitHub/GitHub.psd1

@@ -1,15 +1,13 @@
 @{
-    # Author of this module
-    Author      = 'Marius Storhaug'
-
     # Version number of this module
     ModuleVersion = '0.3.0'
 
     # Description of the functionality provided by this module
     Description   = 'GitHub PowerShell Module'
 
-    # Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.
-    PrivateData = @{
+    # Private data to pass to the module specified in RootModule/ModuleToProcess.
+    # This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+    PrivateData   = @{
 
         PSData = @{
 

src/GitHub/attributes.txt

@@ -0,0 +1 @@
+[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains long links.')]

src/GitHub/data/Auth.psd1

@@ -1,8 +1,8 @@
 @{
-    GitHubApp = @{
+    GitHubApp                     = @{
         ClientID = 'Iv1.f26b61bc99e69405' # $script:Auth.GitHubApp.ClientID
     }
-    OAuthApp  = @{
+    OAuthApp                      = @{
         ClientID = '7204ae9b0580f2cb8288' # $script:Auth.OAuthApp.ClientID
     }
     AccessTokenGracePeriodInHours = 4

src/GitHub/private/Auth/DeviceFlow/Invoke-GitHubDeviceFlowLogin.ps1

@@ -18,6 +18,7 @@
         https://docs.github.com/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps#device-flow
     #>
     [OutputType([void])]
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingWriteHost', '', Justification = 'Is the CLI part of the module.')]
     [CmdletBinding()]
     param(
         # The Client ID of the GitHub App.

src/GitHub/private/Auth/DeviceFlow/Test-GitHubAccessTokenRefreshRequired.ps1

@@ -11,12 +11,13 @@
 
         This will test if the GitHub access token should be refreshed.
     #>
+    [OutputType([bool])]
     [CmdletBinding()]
     param()
 
     $tokenType = Get-GitHubConfig -Name 'AccessTokenType' -ErrorAction SilentlyContinue
     if ($tokenType -ne 'ghu_*') {
-        Write-Verbose "The access token is not a user token. No need to refresh."
+        Write-Verbose 'The access token is not a user token. No need to refresh.'
         return $false
     }
 

src/GitHub/private/Config/Initialize-SecretVault.ps1

@@ -4,21 +4,21 @@
 
 function Initialize-SecretVault {
     <#
-    .SYNOPSIS
-    Initialize a secret vault.
+        .SYNOPSIS
+        Initialize a secret vault.
 
-    .DESCRIPTION
-    Initialize a secret vault. If the vault does not exist, it will be created.
+        .DESCRIPTION
+        Initialize a secret vault. If the vault does not exist, it will be created.
 
-    .EXAMPLE
-    Initialize-SecretVault -Name 'SecretStore' -Type 'Microsoft.PowerShell.SecretStore'
+        .EXAMPLE
+        Initialize-SecretVault -Name 'SecretStore' -Type 'Microsoft.PowerShell.SecretStore'
 
-    Initializes a secret vault named 'SecretStore' using the 'Microsoft.PowerShell.SecretStore' module.
+        Initializes a secret vault named 'SecretStore' using the 'Microsoft.PowerShell.SecretStore' module.
 
-    .NOTES
-    For more information about secret vaults, see https://learn.microsoft.com/en-us/powershell/utility-modules/secretmanagement/overview?view=ps-modules
+        .NOTES
+        For more information about secret vaults, see
+        https://learn.microsoft.com/en-us/powershell/utility-modules/secretmanagement/overview?view=ps-modules
     #>
-
     [OutputType([void])]
     [CmdletBinding()]
     param (

src/GitHub/private/Config/Reset-GitHubConfig.ps1

@@ -18,7 +18,7 @@
     #>
     [Alias('Reset-GHConfig')]
     [OutputType([void])]
-    [CmdletBinding()]
+    [CmdletBinding(SupportsShouldProcess)]
     param(
         # Reset the GitHub configuration for a specific scope.
         [Parameter()]
@@ -58,5 +58,7 @@
             }
         }
     }
-    Set-GitHubConfig @Settings
+    if ($PSCmdlet.ShouldProcess('Module config', 'Reset')) {
+        Set-GitHubConfig @Settings
+    }
 }

src/GitHub/private/Gitignore/Get-GitHubGitignoreByName.ps1

@@ -0,0 +1,38 @@
+filter Get-GitHubGitignoreByName {
+    <#
+        .SYNOPSIS
+        Get a gitignore template
+
+        .DESCRIPTION
+        The API also allows fetching the source of a single template.
+        Use the raw [media type](https://docs.github.com/rest/overview/media-types/) to get the raw contents.
+
+        .EXAMPLE
+        Get-GitHubGitignoreList
+
+        Get all gitignore templates
+
+        .NOTES
+        https://docs.github.com/rest/gitignore/gitignore#get-a-gitignore-template
+
+    #>
+    [CmdletBinding()]
+    param (
+        [Parameter()]
+        [ValidateNotNullOrEmpty()]
+        [string] $Name
+    )
+
+    Process {
+        $inputObject = @{
+            APIEndpoint = "/gitignore/templates/$Name"
+            Accept      = 'application/vnd.github.raw+json'
+            Method      = 'GET'
+        }
+
+        Invoke-GitHubAPI @inputObject | ForEach-Object {
+            Write-Output $_.Response
+        }
+
+    }
+}

src/GitHub/private/Gitignore/Get-GitHubGitignoreList.ps1

@@ -0,0 +1,32 @@
+filter Get-GitHubGitignoreList {
+    <#
+        .SYNOPSIS
+        Get all gitignore templates
+
+        .DESCRIPTION
+        List all templates available to pass as an option when
+        [creating a repository](https://docs.github.com/rest/repos/repos#create-a-repository-for-the-authenticated-user).
+
+        .EXAMPLE
+        Get-GitHubGitignoreList
+
+        Get all gitignore templates
+
+        .NOTES
+        https://docs.github.com/rest/gitignore/gitignore#get-all-gitignore-templates
+
+    #>
+    [OutputType([string[]])]
+    [CmdletBinding()]
+    param ()
+
+    $inputObject = @{
+        APIEndpoint = '/gitignore/templates'
+        Method      = 'GET'
+    }
+
+    Invoke-GitHubAPI @inputObject | ForEach-Object {
+        Write-Output $_.Response
+    }
+
+}

src/GitHub/private/License/Get-GitHubLicenseByName.ps1

@@ -0,0 +1,41 @@
+filter Get-GitHubLicenseByName {
+    <#
+        .SYNOPSIS
+        Get a license
+
+        .DESCRIPTION
+        Gets information about a specific license.
+        For more information, see "[Licensing a repository ](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository)."
+
+        .EXAMPLE
+        Get-GitHubGitignoreList
+
+        Get all gitignore templates
+
+        .NOTES
+        https://docs.github.com/rest/licenses/licenses#get-a-license
+
+    #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains a long link.')]
+    [CmdletBinding()]
+    param (
+        # The license keyword, license name, or license SPDX ID. For example, mit or mpl-2.0.
+        [Parameter()]
+        [ValidateNotNullOrEmpty()]
+        [Alias('license')]
+        [string] $Name
+    )
+
+    Process {
+        $inputObject = @{
+            APIEndpoint = "/licenses/$Name"
+            Accept      = 'application/vnd.github+json'
+            Method      = 'GET'
+        }
+
+        Invoke-GitHubAPI @inputObject | ForEach-Object {
+            Write-Output $_.Response
+        }
+
+    }
+}

src/GitHub/private/License/Get-GitHubLicenseList.ps1

@@ -0,0 +1,33 @@
+filter Get-GitHubLicenseList {
+    <#
+        .SYNOPSIS
+        Get all commonly used licenses
+
+        .DESCRIPTION
+        Lists the most commonly used licenses on GitHub.
+        For more information, see "[Licensing a repository ](https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository)."
+
+        .EXAMPLE
+        Get-GitHubLicenseList
+
+        Get all commonly used licenses.
+
+        .NOTES
+        https://docs.github.com/rest/licenses/licenses#get-all-commonly-used-licenses
+
+    #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains a long link.')]
+    [OutputType([string[]])]
+    [CmdletBinding()]
+    param ()
+
+    $inputObject = @{
+        APIEndpoint = '/licenses'
+        Method      = 'GET'
+    }
+
+    Invoke-GitHubAPI @inputObject | ForEach-Object {
+        Write-Output $_.Response
+    }
+
+}