v2.1.0

What's Changed

• Code improvements.

• Instance methods .OpenRead() and .OpenWrite() moved from ZipEntryFile to ZipEntryBase.

• Adds support to operate from input Stream. This means you can now:

  • List entries:

    PS ..\PSCompression> $uri = 'https://www.powershellgallery.com/api/v2/package/PSCompression'
    PS ..\PSCompression> Invoke-WebRequest $uri | Get-ZipEntry | Select-Object -First 5
    
    Directory: /
    
    Type                    LastWriteTime  CompressedSize            Size Name
    ----                    -------------  --------------            ---- ----
    Archive            11/6/2024 10:29 PM       227.00  B       785.00  B [Content_Types].xml
    Archive            11/6/2024 10:27 PM       516.00  B         2.50 KB PSCompression.Format.ps1xml
    Archive            11/6/2024 10:29 PM       598.00  B         1.58 KB PSCompression.nuspec
    Archive            11/6/2024 10:27 PM         1.66 KB         5.45 KB PSCompression.psd1
    
    Directory: /_rels/
    
    Type                    LastWriteTime  CompressedSize            Size Name
    ----                    -------------  --------------            ---- ----
    Archive            11/6/2024 10:29 PM       276.00  B       507.00  B .rels

  • Read their content:

    PS ..\PSCompression> $entry = Invoke-WebRequest $uri | Get-ZipEntry -Include *.psd1
    PS ..\PSCompression> $entry | Get-ZipEntryContent -Raw | Invoke-Expression
    
    Name                           Value
    ----                           -----
    FunctionsToExport              {}
    PowerShellVersion              5.1
    GUID                           c63aa90e-ae64-4ae1-b1c8-456e0d13967e
    FormatsToProcess               {PSCompression.Format.ps1xml}
    RootModule                     bin/netstandard2.0/PSCompression.dll
    Author                         Santiago Squarzon
    ModuleVersion                  2.0.10
    CompanyName                    Unknown
    PrivateData                    {[PSData, System.Collections.Hashtable]}
    Description                    Zip and GZip utilities for PowerShell!
    Copyright                      (c) Santiago Squarzon. All rights reserved.
    CmdletsToExport                {Get-ZipEntry, Get-ZipEntryContent, Set-ZipEntryContent, Remove-ZipEntry…}
    VariablesToExport              {}
    AliasesToExport                {gziptofile, gzipfromfile, gziptostring, gzipfromstring…}
    RequiredAssemblies             {System.IO.Compression, System.IO.Compression.FileSystem}

  • Extract them:

    PS ..\PSCompression> $file = $entry | Expand-ZipEntry -PassThru
    PS ..\PSCompression> $file
    
    Mode                 LastWriteTime         Length Name
    ----                 -------------         ------ ----
    -a---           11/6/2024 10:27 PM           5584 PSCompression.psd1
    
    PS ..\PSCompression> Get-Content $file.FullName -TotalCount 3
    #
    # Module manifest for module 'PSCompression'
    #

  Other operations are not supported and will throw an error:

  PS ..\PSCompression> $entry | Remove-ZipEntry
  Remove-ZipEntry: The operation is not supported for entries created from input Stream.

Full Changelog: v2.0.10...v2.1.0

v2.0.10

What's Changed

• Fix EncodingTransformation for Encoding and int instances wrapped in PSObject by @santisq in #37. Same issue as #34 but when Encoding and int instances are wrapped in PSObject:

$utf8 = [System.Text.Encoding]::UTF8 | Write-Output
Get-ZipEntry .\test.zip | Get-ZipEntryContent -Encoding $utf8

# Get-ZipEntryContent: Cannot process argument transformation on parameter 'Encoding'.
#                      Could not convert input 'System.Text.UTF8Encoding+UTF8EncodingSealed' to a valid Encoding object.

$utf8 = [System.Text.Encoding]::UTF8.CodePage | Write-Output
Get-ZipEntry .\test.zip | Get-ZipEntryContent -Encoding $utf8

# Get-ZipEntryContent: Cannot process argument transformation on parameter 'Encoding'.
#                      Could not convert input '65001' to a valid Encoding object.

Full Changelog: v2.0.9...v2.0.10

v2.0.9

What's Changed

• Fix EncodingTransformation when passing a string wrapped in PSObject by @santisq in #35.

$utf8 = Write-Output utf8
Get-ZipEntry .\test.zip | Get-ZipEntryContent -Encoding $utf8

# Get-ZipEntryContent: Cannot process argument transformation on parameter 'Encoding'.
#                      Could not convert input 'utf8' to a valid Encoding object.

Full Changelog: v2.0.8...v2.0.9

v2.0.8

What's Changed

• New-ZipEntry - Use file's .FullName if no -EntryPath is provided by @santisq in #33:
  • Makes -EntryPath no longer Mandatory on File ParameterSet. When no -EntryPath is specified the cmdlet will use the -SourcePath in it's normalized form.
  • Added Pester tests and updated docs to reflect this change.
  • Updated all docs Syntax section to properly reflect Mandatory parameters.

Full Changelog: v2.0.7...v2.0.8

v2.0.7

What's Changed

• Updates build process by @santisq in #27

• Updates to README and Documentation by @santisq in #29

• Adds -Exclude Parameter to Compress-ZipArchive by @santisq in #31. This parameter allows to exclude items from source. For example, if you wanted to compress the path folder excluding any file having the .xyz extension and any folder named test (including all its child items), you could do:

  Compress-ZipArchive .\path -Destination myPath.zip -Exclude *.xyz, *\test\*

Full Changelog: v2.0.6...v2.0.7

v2.0.6

What's Changed

• Fixed parameter names in Compress-ZipArchive documentation by @martincostello in #25
• Update to CI pipeline to use codecov-action@v4
• Fixed coverlet support for Linux runner tests

New Contributors

• @martincostello made their first contribution in #25

Full Changelog: v2.0.5...v2.0.6

v2.0.5

What's changed

• Fixed a bug with CompressionRatio Property added in v2.0.4 showing zip file entries with 0 Length in InvariantCulture Format.

Full Changelog: v2.0.4...v2.0.5

v2.0.4

What's Changed

• Added command Rename-ZipEntry by @santisq in #22.
• Fixed a bug that would prevent using the cmdlets in a remote PSSession or in a different Runspace or with a PSDrive, details in #21.
  Thanks @mattcargile for submitting the issue.

Breaking Changes

• ZipEntryBase Type:

  • Renamed Property EntryName to Name.
  • Renamed Property EntryRelativePath to RelativePath.
  • Renamed Property EntryType to Type.
  • Renamed Method RemoveEntry() to Remove().

• ZipEntryFile Type:

  • Added Property Extension.
  • Added Property BaseName.
  • Added Property CompressionRatio.

• ZipEntryDirectory Type:

  • .Name Property now reflects the directory entries name instead of an empty string.

• NormalizePath Method:

  • Moved from [PSCompression.ZipEntryExtensions]::NormalizePath to [PSCompression.Extensions.PathExtensions]::NormalizePath.

• Get-ZipEntry command:

  • Renamed Parameter -EntryType to -Type.

Full Changelog: v2.0.3...v2.0.4

v2.0.3

What's Changed

• No changes to the Module's functionality, this is a very small update to seal all classes that should not be opened following recommendations on dotnet/runtime#49944.

Full Changelog: v2.0.2...v2.0.3

v2.0.2

What's Changed

All PowerShell functions are now binary cmdlets. There are a few bug fixes and lots of code improvements. The cmdlet's functionality remains the same with a few parameter renaming:

• ConvertTo-GzipString: #9
• ConvertFrom-GzipString: #11
• Expand-GzipArchive: #14
  • Renamed -DestinationPath to -Destination and alias added to maintain compatibility.
  • Added parameter -Update.
  • Added parameter -Force.
• Compress-GzipArchive: #15
  • Renamed -DestinationPath to -Destination and alias added to maintain compatibility.
• Compress-ZipArchive: #17
  • Renamed -DestinationPath to -Destination and alias added to maintain compatibility.

Full Changelog: v2.0.1...v2.0.2