Viscalyx.GitHub

0.2.0

Common commands that adds or improves functionality in various scenarios.

Minimum PowerShell version

5.1

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name Viscalyx.GitHub

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name Viscalyx.GitHub

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

JohanLjunggren

Copyright

Package Details

Author(s)

Viscalyx

Functions

Get-GitHubRelease Get-GitHubReleaseAsset Save-GitHubReleaseAsset

Dependencies

This module has no dependencies.

Release Notes

## [0.2.0] - 2025-10-04

### Added

- Initial release of the Viscalyx.GitHub PowerShell module.
- New command `Get-GitHubRelease` to retrieve releases from a GitHub repository
with options to filter by latest, prerelease, and draft statuses.
- New command `Get-GitHubReleaseAsset` to retrieve metadata information
about assets from GitHub repository releases.
- New command `Save-GitHubReleaseAsset` to download GitHub release assets with
asset filtering, SHA256 hash validation, retry logic, and progress indication.
- Private function `Convert-SecureStringAsPlainText` to safely handle secure
string conversions for GitHub authentication tokens.
- Private function `Invoke-UrlDownload` to handle file downloads with proper
error handling, user agent configuration, and verbose logging.
- Added pipeline input support to `Get-GitHubReleaseAsset` allowing release
objects from `Get-GitHubRelease` to be piped directly into the command.
- Added additional example to `Get-GitHubReleaseAsset` documentation showing
how to use the pipeline functionality for efficient workflow.
- Added integration tests for the new pipeline functionality.
- Added unit and integration tests for `Save-GitHubReleaseAsset` and
`Invoke-UrlDownload` with comprehensive coverage of download scenarios.
- Added localized strings and documentation for new download functionality.

### Changed

- Refactored `Get-GitHubReleaseAsset` to use parameter sets for better
distinction between direct repository queries and pipeline input scenarios.
- Enhanced `Get-GitHubReleaseAsset` with begin/process/end blocks for proper
pipeline handling of multiple release objects.
- Bump action Stale to v10.
- Bump action Checkout to v5.
- Enhanced `Save-GitHubReleaseAsset` with path validation, `SupportsShouldProcess`
for `-WhatIf` and `-Confirm`, `-Force` parameter, and improved error reporting.
- Enhanced `Invoke-UrlDownload` with `-Force` parameter, automatic directory
creation, file overwrite protection, and improved error handling.

### Fixed

- Fixed README badges.
- Fixed error message formatting in `Get-GitHubReleaseAsset` for asset name
validation errors.
- Prefixed all command invocations in integration tests with `Viscalyx.GitHub\`
to avoid accidentally invoking commands from other modules.

FileList

Version History

Version	Downloads	Last updated
0.2.0 (current version)	5	10/4/2025
0.2.0-previe...	3	10/4/2025
0.2.0-previe...	3	10/2/2025
0.1.0-previe...	5	5/13/2025
0.1.0-previe...	4	5/11/2025