🩹 [Patch]: Add context, cleanup parameters and param handling

Coverage.md

@@ -9,15 +9,15 @@
     </tr>
     <tr>
         <td>Covered functions</td>
-        <td>153</td>
+        <td>155</td>
     </tr>
     <tr>
         <td>Missing functions</td>
-        <td>832</td>
+        <td>830</td>
     </tr>
     <tr>
         <td>Coverage</td>
-        <td>15.53%</td>
+        <td>15.74%</td>
     </tr>
 </table>
 
@@ -30,8 +30,8 @@
 | `/advisories/{ghsa_id}`                                                                                                   |                    | :x:                |                    |                    |                    |
 | `/app`                                                                                                                    |                    | :white_check_mark: |                    |                    |                    |
 | `/app-manifests/{code}/conversions`                                                                                       |                    |                    |                    | :x:                |                    |
-| `/app/hook/config`                                                                                                        |                    | :x:                | :x:                |                    |                    |
-| `/app/hook/deliveries`                                                                                                    |                    | :x:                |                    |                    |                    |
+| `/app/hook/config`                                                                                                        |                    | :white_check_mark: | :x:                |                    |                    |
+| `/app/hook/deliveries`                                                                                                    |                    | :white_check_mark: |                    |                    |                    |
 | `/app/hook/deliveries/{delivery_id}`                                                                                      |                    | :x:                |                    |                    |                    |
 | `/app/hook/deliveries/{delivery_id}/attempts`                                                                             |                    |                    |                    | :x:                |                    |
 | `/app/installation-requests`                                                                                              |                    | :x:                |                    |                    |                    |

scripts/Set-CoverageReport.ps1

@@ -8,7 +8,7 @@ function Find-APIMethod {
         .SYNOPSIS
         Find API methods in a directory
     #>
-    param (
+    param(
         [Parameter(Mandatory)]
         [string] $SearchDirectory,
 

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

@@ -1,4 +1,4 @@
-filter Get-GitHubGitignoreByName {
+filter Get-GitHubGitignoreByName {
     <#
         .SYNOPSIS
         Get a gitignore template
@@ -17,14 +17,18 @@ filter Get-GitHubGitignoreByName {
 
     #>
     [CmdletBinding()]
-    param (
+    param(
+        [Parameter(Mandatory)]
+        [string] $Name,
+
+        # The context to run the command in.
         [Parameter()]
-        [ValidateNotNullOrEmpty()]
-        [string] $Name
+        [string] $Context
     )
 
     process {
         $inputObject = @{
+            Context     = $Context
             APIEndpoint = "/gitignore/templates/$Name"
             Accept      = 'application/vnd.github.raw+json'
             Method      = 'GET'

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

@@ -1,4 +1,4 @@
-filter Get-GitHubGitignoreList {
+filter Get-GitHubGitignoreList {
     <#
         .SYNOPSIS
         Get all gitignore templates
@@ -18,15 +18,19 @@ filter Get-GitHubGitignoreList {
     #>
     [OutputType([string[]])]
     [CmdletBinding()]
-    param ()
+    param(
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
+    )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = '/gitignore/templates'
         Method      = 'GET'
     }
 
     Invoke-GitHubAPI @inputObject | ForEach-Object {
         Write-Output $_.Response
     }
-
 }

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

@@ -1,4 +1,4 @@
-filter Get-GitHubLicenseByName {
+filter Get-GitHubLicenseByName {
     <#
         .SYNOPSIS
         Get a license
@@ -18,16 +18,20 @@ filter Get-GitHubLicenseByName {
     #>
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains a long link.')]
     [CmdletBinding()]
-    param (
+    param(
         # The license keyword, license name, or license SPDX ID. For example, mit or mpl-2.0.
-        [Parameter()]
-        [ValidateNotNullOrEmpty()]
+        [Parameter(Mandatory)]
         [Alias('license')]
-        [string] $Name
+        [string] $Name,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     process {
         $inputObject = @{
+            Context     = $Context
             APIEndpoint = "/licenses/$Name"
             Accept      = 'application/vnd.github+json'
             Method      = 'GET'
@@ -36,6 +40,5 @@ filter Get-GitHubLicenseByName {
         Invoke-GitHubAPI @inputObject | ForEach-Object {
             Write-Output $_.Response
         }
-
     }
 }

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

@@ -1,4 +1,4 @@
-filter Get-GitHubLicenseList {
+filter Get-GitHubLicenseList {
     <#
         .SYNOPSIS
         Get all commonly used licenses
@@ -19,9 +19,14 @@ filter Get-GitHubLicenseList {
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains a long link.')]
     [OutputType([string[]])]
     [CmdletBinding()]
-    param ()
+    param(
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
+    )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = '/licenses'
         Method      = 'GET'
     }

src/functions/private/License/Get-GitHubRepositoryLicense.ps1

@@ -1,4 +1,4 @@
-filter Get-GitHubRepositoryLicense {
+filter Get-GitHubRepositoryLicense {
     <#
         .SYNOPSIS
         Get the license for a repository
@@ -19,17 +19,22 @@ filter Get-GitHubRepositoryLicense {
 
     #>
     [CmdletBinding()]
-    param (
+    param(
         # The account owner of the repository. The name is not case sensitive.
-        [Parameter()]
-        [string] $Owner = (Get-GitHubContextSetting -Name Owner),
+        [Parameter(Mandatory)]
+        [string] $Owner,
 
         # The name of the repository without the .git extension. The name is not case sensitive.
+        [Parameter(Mandatory)]
+        [string] $Repo,
+
+        # The context to run the command in.
         [Parameter()]
-        [string] $Repo = (Get-GitHubContextSetting -Name Repo)
+        [string] $Context
     )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/repos/$Owner/$Repo/license"
         Accept      = 'application/vnd.github+json'
         Method      = 'GET'

src/functions/private/Organization/Blocking/Block-GitHubUserByOrganization.ps1

@@ -18,7 +18,7 @@
     #>
     [OutputType([bool])]
     [CmdletBinding()]
-    param (
+    param(
         # The organization name. The name is not case sensitive.
         [Parameter(
             Mandatory,
@@ -36,11 +36,15 @@
             ValueFromPipeline,
             ValueFromPipelineByPropertyName
         )]
-        [Alias('login')]
-        [string] $Username
+        [string] $Username,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/orgs/$OrganizationName/blocks/$Username"
         Method      = 'PUT'
     }

src/functions/private/Organization/Blocking/Get-GitHubBlockedUserByOrganization.ps1

@@ -16,7 +16,7 @@
     #>
     [OutputType([pscustomobject])]
     [CmdletBinding()]
-    param (
+    param(
         # The organization name. The name is not case sensitive.
         [Parameter(Mandatory)]
         [Alias('org')]
@@ -27,14 +27,19 @@
         # The number of results per page (max 100).
         [Parameter()]
         [ValidateRange(1, 100)]
-        [int] $PerPage = 30
+        [int] $PerPage = 30,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $body = @{
         per_page = $PerPage
     }
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/orgs/$OrganizationName/blocks"
         Method      = 'GET'
         Body        = $body

src/functions/private/Organization/Blocking/Test-GitHubBlockedUserByOrganization.ps1

@@ -18,7 +18,7 @@
     #>
     [OutputType([bool])]
     [CmdletBinding()]
-    param (
+    param(
         # The organization name. The name is not case sensitive.
         [Parameter(
             Mandatory,
@@ -35,10 +35,15 @@
             Mandatory,
             ValueFromPipelineByPropertyName
         )]
-        [string] $Username
+        [string] $Username,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/orgs/$OrganizationName/blocks/$Username"
         Method      = 'GET'
     }

src/functions/private/Organization/Blocking/Unblock-GitHubUserByOrganization.ps1

@@ -17,7 +17,7 @@
     #>
     [OutputType([bool])]
     [CmdletBinding()]
-    param (
+    param(
         # The organization name. The name is not case sensitive.
         [Parameter(
             Mandatory,
@@ -36,10 +36,15 @@
             ValueFromPipelineByPropertyName
         )]
         [Alias('login')]
-        [string] $Username
+        [string] $Username,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/orgs/$OrganizationName/blocks/$Username"
         Method      = 'DELETE'
     }

src/functions/private/Organization/Get-GitHubAllOrganization.ps1

@@ -21,15 +21,19 @@
     [OutputType([pscustomobject])]
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidLongLines', '', Justification = 'Contains a long link.')]
     [CmdletBinding()]
-    param (
+    param(
         # A organization ID. Only return organizations with an ID greater than this ID.
         [Parameter()]
         [int] $Since = 0,
 
         # The number of results per page (max 100).
         [Parameter()]
         [ValidateRange(1, 100)]
-        [int] $PerPage = 30
+        [int] $PerPage = 30,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $body = @{
@@ -38,6 +42,7 @@
     }
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = '/organizations'
         Method      = 'GET'
         Body        = $body

src/functions/private/Organization/Get-GitHubMyOrganization.ps1

@@ -24,18 +24,23 @@
     #>
     [OutputType([pscustomobject])]
     [CmdletBinding()]
-    param (
+    param(
         # The number of results per page (max 100).
         [Parameter()]
         [ValidateRange(1, 100)]
-        [int] $PerPage = 30
+        [int] $PerPage = 30,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
     $body = @{
         per_page = $PerPage
     }
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = '/user/orgs'
         Method      = 'GET'
         Body        = $body

src/functions/private/Organization/Get-GitHubOrganizationByName.ps1

@@ -24,7 +24,7 @@
     #>
     [OutputType([pscustomobject])]
     [CmdletBinding()]
-    param (
+    param(
         # The organization name. The name is not case sensitive.
         [Parameter(
             Mandatory,
@@ -34,11 +34,16 @@
         [Alias('login')]
         [Alias('org')]
         [Alias('owner')]
-        [string] $OrganizationName
+        [string] $OrganizationName,
+
+        # The context to run the command in.
+        [Parameter()]
+        [string] $Context
     )
 
 
     $inputObject = @{
+        Context     = $Context
         APIEndpoint = "/orgs/$OrganizationName"
         Method      = 'GET'
     }