Skip to content

Commit

Permalink
Merge pull request #29 from santisq/28-update-readme-tables-to-be-ali…
Browse files Browse the repository at this point in the history
…gned

Closes #28
  • Loading branch information
santisq committed Jun 24, 2024
2 parents e03266d + 4c2b945 commit da47e4c
Show file tree
Hide file tree
Showing 10 changed files with 147 additions and 91 deletions.
155 changes: 139 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,25 +17,148 @@ PSCompression is a PowerShell Module that provides Zip and Gzip utilities for co

### Zip Cmdlets

| Cmdlet | Description |
| --- | --- |
| [`Get-ZipEntry`](docs/en-US/Get-ZipEntry.md) | Lists entries from specified Zip paths. It has built-in functionalities to filter entries and is the main entry point for the ZipEntry cmdlets in this module. |
| [`Expand-ZipEntry`](docs/en-US/Expand-ZipEntry.md) | Expands Zip Archive Entries outputted by the [`Get-ZipEntry`](docs/en-US/Get-ZipEntry.md) command to a destination directory. |
| [`Get-ZipEntryContent`](docs/en-US/Get-ZipEntryContent.md) | Gets the content of one or more `ZipEntryFile` instances. |
| [`New-ZipEntry`](docs/en-US/New-ZipEntry.md) | Create one or more Zip Archive Entries from specified paths. |
| [`Remove-ZipEntry`](docs/en-US/Remove-ZipEntry.md) | Remove Zip Archive Entries from one or more Zip Archives. |
| [`Rename-ZipEntry`](docs/en-US/Rename-ZipEntry.md) | Rename Zip Archive Entries from one or more Zip Archives. |
| [`Set-ZipEntryContent`](docs/en-US/Set-ZipEntryContent.md) | Sets or appends content to a Zip Archive Entry. |
| [`Compress-ZipArchive`](docs/en-US/Compress-ZipArchive.md) | Creates a compressed, or zipped, archive file from one or more specified files or directories. It aims to overcome a few [`Compress-Archive`](docs/en-US/https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.archive/compress-archive?view=powershell-7.2) limitations while keeping similar capabilities. |
<div class="zipcmdlets">
<table>
<tr>
<th>Cmdlet</th>
<th>Description</th>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Get-ZipEntry`](docs/en-US/Get-ZipEntry.md)

</td>
<td>Lists entries from specified zip archives. This cmdlet is the main entry point for the ZipEntry cmdlets in this module.</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Expand-ZipEntry`](docs/en-US/Expand-ZipEntry.md)

</td>
<td>

Expands zip entries outputted by the [`Get-ZipEntry`](docs/en-US/Get-ZipEntry.md) command to a
destination directory.

</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Get-ZipEntryContent`](docs/en-US/Get-ZipEntryContent.md)

</td>
<td>

Gets the content of one or more zip entries.

</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`New-ZipEntry`](docs/en-US/New-ZipEntry.md)

</td>
<td>Creates zip entries from specified path or paths.</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Remove-ZipEntry`](docs/en-US/Remove-ZipEntry.md)

</td>
<td>Removes zip entries from one or more zip archives.</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Rename-ZipEntry`](docs/en-US/Rename-ZipEntry.md)

</td>
<td>Renames zip entries from one or more zip archives.</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Set-ZipEntryContent`](docs/en-US/Set-ZipEntryContent.md)

</td>
<td>Sets or appends content to a zip entry.</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Compress-ZipArchive`](docs/en-US/Compress-ZipArchive.md)

</td>
<td>

Similar capabilities as
[`Compress-Archive`](docs/en-US/https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.archive/compress-archive?view=powershell-7.2)
and overcomes a few issues with the built-in cmdlet (2 GB limit and more).

</td>
</tr>
</table>
</div>

### Gzip Cmdlets

| Cmdlet | Description |
| --- | --- |
| [`Compress-GzipArchive`](docs/en-US/Compress-GzipArchive.md) | Can compress one or more specified file paths into a single Gzip file. |
| [`ConvertFrom-GzipString`](docs/en-US/ConvertFrom-GzipString.md) | Expands Base64 encoded Gzip compressed input strings. |
| [`ConvertTo-GzipString`](docs/en-US/ConvertTo-GzipString.md) | Can compress input strings into Base64 encoded Gzip strings or raw bytes. |
| [`Expand-GzipArchive`](docs/en-US/Expand-GzipArchive.md) | Expand Gzip compressed files to a destination path or to the [success stream](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_output_streams?view=powershell-7.3#success-stream). |
<div class="gzipcmdlets">
<table>
<tr>
<th>Cmdlet</th>
<th>Description</th>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`Compress-GzipArchive`](docs/en-US/Compress-GzipArchive.md)

</td>
<td>
Can compress one or more specified file paths into a Gzip file.
</td>
</tr>
<tr>
<td colspan="1" width="230" height="60">

[`ConvertFrom-GzipString`](docs/en-US/ConvertFrom-GzipString.md)

</td>
<td>
Expands Gzip Base64 input strings.
</td>
</tr>

<tr>
<td colspan="1" width="230" height="60">

[`ConvertTo-GzipString`](docs/en-US/ConvertTo-GzipString.md)

</td>
<td>
Can compress input strings into Gzip Base64 strings or raw bytes.
</td>
</tr>

<tr>
<td colspan="1" width="230" height="60">

[`Expand-GzipArchive`](docs/en-US/Expand-GzipArchive.md)

</td>
<td>

Expands Gzip compressed files to a destination path or to the [success stream](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_output_streams?view=powershell-7.3#success-stream).

</td>
</tr>
</table>
</div>

## Documentation

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/ConvertFrom-GzipString.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Expands Base64 Gzip compressed input strings.
Expands Gzip Base64 compressed input strings.

## SYNTAX

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/Expand-ZipEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Expand-ZipEntry

## DESCRIPTION

The `Expand-ZipEntry` cmdlet can expand Zip Archive Entries outputted by the [`Get-ZipEntry`](./Get-ZipEntry.md) command to a destination directory. Expanded entries maintain their original folder structure based on their relative path.
The `Expand-ZipEntry` cmdlet can expand zip entries outputted by the [`Get-ZipEntry`](./Get-ZipEntry.md) command to a destination directory. Expanded entries maintain their original folder structure based on their relative path.

## EXAMPLES

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/Get-ZipEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Lists Zip Archive Entries from one or more specified Zip Archive paths.
Lists zip entries from one or more specified Zip Archives.

## SYNTAX

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/Get-ZipEntryContent.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Gets the content of a Zip Archive Entry.
Gets the content of a zip entry.

## SYNTAX

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/New-ZipEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Creates Zip Archive Entries from one or more specified entry relative paths.
Creates zip entries from one or more specified entry relative paths.

## SYNTAX

Expand Down
67 changes: 0 additions & 67 deletions docs/en-US/PSCompression.md

This file was deleted.

2 changes: 1 addition & 1 deletion docs/en-US/Remove-ZipEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Removes Zip Archive Entries from one or more Zip Archives.
Removes zip entries from one or more zip archives.

## SYNTAX

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/Rename-ZipEntry.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Renames Zip Archive Entries from one or more Zip Archives.
Renames zip entries from one or more zip archives.

## SYNTAX

Expand Down
2 changes: 1 addition & 1 deletion docs/en-US/Set-ZipEntryContent.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ schema: 2.0.0

## SYNOPSIS

Writes or appends content to an existing Zip Archive Entry.
Sets or appends content to an existing zip entry.

## SYNTAX

Expand Down

0 comments on commit da47e4c

Please sign in to comment.