🚀 [Feature]: Align classes and functions for Releases

.github/PSModule.yml

@@ -1,3 +1,3 @@
 Test:
   CodeCoverage:
-    PercentTarget: 40
+    PercentTarget: 50

Coverage.md

@@ -5,19 +5,19 @@
 <table>
     <tr>
         <td>Available functions</td>
-        <td>1026</td>
+        <td>1028</td>
     </tr>
     <tr>
         <td>Covered functions</td>
-        <td>221</td>
+        <td>220</td>
     </tr>
     <tr>
         <td>Missing functions</td>
-        <td>805</td>
+        <td>808</td>
     </tr>
     <tr>
         <td>Coverage</td>
-        <td>21.54%</td>
+        <td>21.4%</td>
     </tr>
 </table>
 
@@ -51,6 +51,7 @@
 | `/classrooms/{classroom_id}/assignments`                                                                                  |                    | :x:                |                    |                    |                    |
 | `/codes_of_conduct`                                                                                                       |                    | :x:                |                    |                    |                    |
 | `/codes_of_conduct/{key}`                                                                                                 |                    | :x:                |                    |                    |                    |
+| `/credentials/revoke`                                                                                                     |                    |                    |                    | :x:                |                    |
 | `/emojis`                                                                                                                 |                    | :white_check_mark: |                    |                    |                    |
 | `/enterprises/{enterprise}/code-security/configurations`                                                                  |                    | :x:                |                    | :x:                |                    |
 | `/enterprises/{enterprise}/code-security/configurations/defaults`                                                         |                    | :x:                |                    |                    |                    |
@@ -539,10 +540,10 @@
 | `/repos/{owner}/{repo}/releases`                                                                                          |                    | :white_check_mark: |                    | :white_check_mark: |                    |
 | `/repos/{owner}/{repo}/releases/assets/{asset_id}`                                                                        | :white_check_mark: | :white_check_mark: | :white_check_mark: |                    |                    |
 | `/repos/{owner}/{repo}/releases/generate-notes`                                                                           |                    |                    |                    | :white_check_mark: |                    |
-| `/repos/{owner}/{repo}/releases/latest`                                                                                   |                    | :white_check_mark: |                    |                    |                    |
-| `/repos/{owner}/{repo}/releases/tags/{tag}`                                                                               |                    | :white_check_mark: |                    |                    |                    |
+| `/repos/{owner}/{repo}/releases/latest`                                                                                   |                    | :x:                |                    |                    |                    |
+| `/repos/{owner}/{repo}/releases/tags/{tag}`                                                                               |                    | :x:                |                    |                    |                    |
 | `/repos/{owner}/{repo}/releases/{release_id}`                                                                             | :white_check_mark: | :white_check_mark: | :white_check_mark: |                    |                    |
-| `/repos/{owner}/{repo}/releases/{release_id}/assets`                                                                      |                    | :white_check_mark: |                    | :x:                |                    |
+| `/repos/{owner}/{repo}/releases/{release_id}/assets`                                                                      |                    | :white_check_mark: |                    | :white_check_mark: |                    |
 | `/repos/{owner}/{repo}/releases/{release_id}/reactions`                                                                   |                    | :x:                |                    | :x:                |                    |
 | `/repos/{owner}/{repo}/releases/{release_id}/reactions/{reaction_id}`                                                     | :x:                |                    |                    |                    |                    |
 | `/repos/{owner}/{repo}/rules/branches/{branch}`                                                                           |                    | :x:                |                    |                    |                    |
@@ -698,6 +699,7 @@
 | `/users/{username}/settings/billing/actions`                                                                              |                    | :x:                |                    |                    |                    |
 | `/users/{username}/settings/billing/packages`                                                                             |                    | :x:                |                    |                    |                    |
 | `/users/{username}/settings/billing/shared-storage`                                                                       |                    | :x:                |                    |                    |                    |
+| `/users/{username}/settings/billing/usage`                                                                                |                    | :x:                |                    |                    |                    |
 | `/users/{username}/social_accounts`                                                                                       |                    | :white_check_mark: |                    |                    |                    |
 | `/users/{username}/ssh_signing_keys`                                                                                      |                    | :white_check_mark: |                    |                    |                    |
 | `/users/{username}/starred`                                                                                               |                    | :x:                |                    |                    |                    |

examples/Releases/Releases.ps1

@@ -0,0 +1,60 @@
+# Get all the releases for a specific repository
+Get-GitHubRelease -Owner PSModule -Repository GitHub
+
+# Get the latest release for a specific repository
+Get-GitHubRelease -Owner PSModule -Repository GitHub
+
+# Get all the releases for all repos in the organization
+'PSModule' | Get-GitHubOrganization | Get-GitHubRepository | Get-GitHubRelease
+
+# Get the latest releases for all repos in the organization
+'PSModule' | Get-GitHubOrganization | Get-GitHubRepository | ForEach-Object -ThrottleLimit ([Environment]::ProcessorCount) -Parallel {
+    do {
+        Import-Module -Name GitHub
+    } until ($? -eq $true)
+    $_ | Get-GitHubRelease
+}
+
+'PSModule' | Get-GitHubOrganization | Get-GitHubRepository | Get-GitHubRelease -Latest
+Get-GitHubUser | Get-GitHubRepository | Get-GitHubRelease -Latest
+
+# Create a new release for a specific repository
+$repoName = 'mytest'
+
+$repo = Get-GitHubUser | Get-GitHubRepository -Name $repoName
+$repo | Get-GitHubRelease
+$repo | New-GitHubRelease -Tag 'v1.0' -Latest
+$repo | New-GitHubRelease -Tag 'v1.1' -Latest -Name 'test'
+$repo | New-GitHubRelease -Tag 'v1.2' -Latest -Name 'test' -Notes 'Release notes'
+$repo | New-GitHubRelease -Tag 'v1.3' -Latest -Name 'test' -GenerateReleaseNotes
+$repo | Get-GitHubRelease -Tag 'v1.3' | Format-List
+$repo | Get-GitHubRelease -Tag 'v1.3' | Update-GithubRelease -Notes 'Release notes1'
+$repo | Update-GitHubRelease -Tag 'v1.3' -Name 'test123' -Debug
+
+$repo | New-GitHubRelease -Tag 'v1.3.2' -Latest -GenerateReleaseNotes -Debug
+$repo | Get-GitHubRelease -Tag 'v1.3.1' | Format-List
+$repo | Set-GitHubRelease -Tag 'v1.3.1' -Latest -GenerateReleaseNotes -Debug
+$repo | Set-GitHubRelease -Tag 'v1.3.1' -Latest -GenerateReleaseNotes -Notes 'Release notes'
+$repo | Get-GitHubRelease -Tag 'v1.3.1' | Format-List
+Get-GitHubReleaseAsset -Owner MariusStorhaug -Repository mytest -ReleaseID
+
+$repo | Set-GitHubRelease -Tag 'v1.5' -Latest -Name 'test' -Notes 'Release notes' | Select-Object *
+$repo | Get-GitHubRelease -Tag 'v1.4' | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2' -Draft | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2' -Draft -Prerelease | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2' -Prerelease | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2' -Latest | Select-Object Tag, Name, Latest, Prerelease, Draft
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2' | Select-Object Tag, Name, Latest, Prerelease, Draft
+
+$repo | Get-GitHubRelease -Tag 'v1.4' | Select-Object *
+
+$repo | Set-GitHubRelease -Tag 'v1.4' -Name 'test2'
+
+
+New-GitHubReleaseNote -Owner PSModule -Repository GitHub -Tag 'v0.22.0' -Target 'main' -PreviousTag 'v0.20.0' | Format-List
+
+$repo | Get-GitHubRelease | Remove-GitHubRelease
+
+
+$repo | Remove-GitHubRepository -Confirm:$false

src/classes/public/Releases/GitHubRelease.ps1

@@ -0,0 +1,93 @@
+class GitHubRelease : GitHubNode {
+    # Name of the release, can be null
+    # Example: "v0.22.1"
+    [string] $Name
+
+    # The repository where the environment is.
+    [string] $Repository
+
+    # The owner of the environment.
+    [string] $Owner
+
+    # The name of the tag
+    # Example: "v0.22.1"
+    [string] $Tag
+
+    # Release notes or changelog, can be null
+    # Example: "## What's Changed\n### Other Changes\n* Fix: Enhance repository deletion feedback and fix typo..."
+    [string] $Notes
+
+    # Specifies the commitish value that determines where the Git tag is created from
+    # Example: "main"
+    [string] $Target
+
+    # True if the release is the latest release on the repo.
+    # Example: true
+    [bool] $IsLatest
+
+    # True to create a draft (unpublished) release, false to create a published one
+    # Example: false
+    [bool] $IsDraft
+
+    # Whether to identify the release as a prerelease or a full release
+    # Example: false
+    [bool] $IsPrerelease
+
+    # GitHub URL for the release
+    # Example: "https://github.com/PSModule/GitHub/releases/tag/v0.22.1"
+    [string] $Url
+
+    # User who authored the release
+    [GitHubUser] $Author
+
+    # Timestamp when the release was created
+    # Example: "2025-04-11T09:03:38Z"
+    [System.Nullable[datetime]] $CreatedAt
+
+    # Timestamp when the release was published
+    # Example: "2025-04-11T13:41:34Z"
+    [System.Nullable[datetime]] $PublishedAt
+
+    # Timestamp when the release was updated
+    # Example: "2025-04-11T13:41:34Z"
+    [System.Nullable[datetime]] $UpdatedAt
+
+    GitHubRelease() {}
+
+    GitHubRelease([PSCustomObject] $Object, [string] $Owner, [string] $Repository, [System.Nullable[bool]] $Latest) {
+        if ($null -ne $Object.node_id) {
+            $this.ID = $Object.id
+            $this.NodeID = $Object.node_id
+            $this.Tag = $Object.tag_name
+            $this.Name = $Object.name
+            $this.Notes = $Object.body
+            $this.IsLatest = $Latest
+            $this.IsDraft = $Object.draft
+            $this.IsPrerelease = $Object.prerelease
+            $this.Url = $Object.html_url
+            $this.Owner = $Owner
+            $this.Repository = $Repository
+            $this.Target = $Object.target_commitish
+            $this.CreatedAt = $Object.created_at
+            $this.PublishedAt = $Object.published_at
+            $this.Author = [GitHubUser]::new($Object.author)
+        } else {
+            $this.ID = $Object.databaseId
+            $this.NodeID = $Object.id
+            $this.Tag = $Object.tagName
+            $this.Name = $Object.name
+            $this.Notes = $Object.description
+            $this.IsLatest = $Object.isLatest
+            $this.IsDraft = $Object.isDraft
+            $this.IsPrerelease = $Object.isPrerelease
+            $this.Url = $Object.url
+            $this.Owner = $Owner
+            $this.Repository = $Repository
+            # $this.Target = $Object.target_commitish
+            $this.CreatedAt = $Object.createdAt
+            $this.PublishedAt = $Object.publishedAt
+            $this.UpdatedAt = $Object.updatedAt
+            $this.Author = [GitHubUser]::new($Object.author)
+        }
+    }
+}

src/classes/public/Releases/GitHubReleaseAsset.ps1

@@ -0,0 +1,70 @@
+class GitHubReleaseAsset : GitHubNode {
+    # Description: URL for downloading the asset
+    # Example: "https://github.com/PSModule/GitHub/releases/download/v0.22.1/asset.zip"
+    [string] $Url
+
+    # Description: The file name of the asset
+    # Example: "Team Environment"
+    [string] $Name
+
+    # Description: Label for the asset, can be null
+    # Example: null
+    [string] $Label
+
+    # Description: State of the release asset (e.g., uploaded, open)
+    # Example: "uploaded"
+    [string] $State
+
+    # Description: MIME type of the asset
+    # Example: "application/zip"
+    [string] $ContentType
+
+    # Description: Size of the asset in bytes
+    # Example: 1024
+    [int] $Size
+
+    # Description: Number of times the asset was downloaded
+    # Example: 100
+    [int] $Downloads
+
+    # Description: Timestamp when the asset was created
+    # Example: "2025-04-11T09:03:38Z"
+    [System.Nullable[datetime]] $CreatedAt
+
+    # Description: Timestamp when the asset was last updated
+    # Example: "2025-04-11T09:03:38Z"
+    [System.Nullable[datetime]] $UpdatedAt
+
+    # Description: User who uploaded the asset, can be null
+    # Example: GitHubUser object or null
+    [GitHubUser] $UploadedBy
+
+    GitHubReleaseAsset() {}
+
+    GitHubReleaseAsset([PSCustomObject]$Object) {
+        if ($null -ne $Object.node_id) {
+            $this.ID = $Object.id
+            $this.NodeID = $Object.node_id
+            $this.Url = $Object.browser_download_url
+            $this.Name = $Object.name
+            $this.Label = $Object.label
+            $this.State = $Object.state
+            $this.ContentType = $Object.content_type
+            $this.Size = $Object.size
+            $this.Downloads = $Object.download_count
+            $this.CreatedAt = [datetime]::Parse($Object.created_at)
+            $this.UpdatedAt = [datetime]::Parse($Object.updated_at)
+            $this.UploadedBy = [GitHubUser]::new($Object.uploader)
+        } else {
+            $this.NodeID = $Object.id
+            $this.Url = $Object.downloadUrl
+            $this.Name = $Object.name
+            $this.ContentType = $Object.contentType
+            $this.Size = $Object.size
+            $this.Downloads = $Object.downloadCount
+            $this.CreatedAt = [datetime]::Parse($Object.createdAt)
+            $this.UpdatedAt = [datetime]::Parse($Object.updatedAt)
+            $this.UploadedBy = [GitHubUser]::new($Object.uploadedBy)
+        }
+    }
+}