Compress-Archive Tests

[ayousuf23]

This is a mega-issue that divides the tests to be added to Compress-Archive. This list is not complete, and more tests will be added over time.

[x] indicates the test has been added to Compress-Archive.Tests.ps1. [ ] indices the test has not yet been added.

All tests will be written in Pester 5. Old tests will be updated.

Parameter set validation tests

• [x] Validate errors from empty or null -Path and -DestinationPath parameters

• [x] Validate errors from non-existent -Path

• [x] Validate errors from non-existent -LiteralPath

• [x] Validate error when duplicate paths are supplied to -Path

• [x] Validate error when duplicate paths are supplied to -LiteralPath

• [x] Validate source path can be at SystemDrive location

• [x] Validate error when -Path contains duplicate paths [Duplicate Paths]

• [x] Validate error when -LiteralPath contains duplicate paths [Duplicate Paths]

• [x] Throws an error when Path and DestinationPath are the same and -Update is specified

• [x] Throws an error when Path and DestinationPath are the same and -Overwrite is specified

• [x] Throws an error when LiteralPath and DestinationPath are the same and -Update is specified

• [x] Throws an error when LiteralPath and DestinationPath are the same and -Overwrite is specified

Can't be tested:

• Throws an error when LiteralPath and DestinationPath are the same (cannot be tested -- others error will be thrown)
• Throws an error when Path and DestinationPath are the same (cannot be tested -- others error will be thrown)

-DestinationPath and -WriteMode Overwrite Tests

• [x] Throws a terminating error when archive file already exists and -Update and -Overwrite parameters are not specified

• [x] Throws a terminating error when archive file exists and -Update is specified but the archive is read-only

• [x] Throws a terminating error when archive already exists as a directory and -Update and -Overwrite parameters are not specified

• [x] Throws a terminating error when DestinationPath is a directory and -Update is specified

• [x] Throws a terminating error when DestinationPath is a folder containing at least 1 item and Overwrite is specified

• [x] Throws a terminating error when archive does not exist and -Update mode is specified

• [x] Overwrites a directory containing no items when -Overwrite is specified

• [x] Overwrites an archive that already exists

  • Ensure all previous contents of the archive are not retained unless passed

• [x] Throws a terminating error when trying to overwrite DestinationPath which is the empty working directory

-Action tests

• [x] Throws a terminating error when an incorrect value is supplied to -Action
• [x] -Action Create works

Not needed:

• -Action Update works (not needed since we have tests for update)
• -Action Overwrite works (not needed since we have tests for overwrite)

Special and Wildcard Characters

• [x] Accepts DestinationPath parameter with wildcard characters that resolves to one path

• [x] Accepts LiteralPath parameter for a directory with wildcard characters in the directory name

• [x] [NEEDED] Accepts DestinationPath parameter with [ but no matching ]

• [x] Accepts LiteralPath parameter for a file with wildcards in the filename

Basic functional tests

• [x] Compresses a single file
• [x] Compresses a non-empty directory
• [x] Compresses an empty directory
• [x] Compresses multiple files
• [x] Compresses multiple files and a single empty directory
• [x] Compresses multiple files and a single non-empty directory
• [x] Compresses multiple files and non-empty directories
• [x] Compresses multiple files, non-empty directories, and an empty directory
• [x] Compresses a directory containing files, non-empty directories, and an empty directory can be compressed"
• [x] Compresses a zero-byte file

Zip-specific tests

• [x] Compresses a file whose last write time is <1980
• [x] Compresses a directory whose last write time is <1980
• [x] Writes a warning when compressing a file whose last write time is before 1980
• [x] Writes a warning when compressing a directory whose last write time is before 1980
• [x] Creates an archive containing files > 4GB
• [x] Creates an archive > 4GB in size

-PassThru parameter

• [x] Returns an object of type System.IO.FileInfo when PassThru is specified
• [x] Does not return an object when PassThru is not specified
• [x] Does not return an object when PassThru is false

-Update parameter

• [x] Does not throw an error when -Update is specified and the archive already exists
• [x] Appends a file to an archive when -WriteMode Update is specified
• [x] Modifies a pre-existing file in an archive when -WriteMode Update is specified
• [x] Adds directory's children when updating a directory in the archive

Notes:

• Ensure pre-existing files and directories are not replaced when updating an archive

-CompressionLevel parameter

• [x] Throws an error when an invalid value is supplied to CompressionLevel"

File permissions, locked files, hidden files, symbolic links, etc.

• [x] Skips archiving a file in use

• [x] Compresses a read-only file

• [x] Compresses a hidden file

• [x] Compresses a hidden directory

• [x] Compresses a directory containing a hidden file and directory

Pipelining

• [x] Creates an archives when paths are passed via pipeline
• [x] Creates an archives when paths are passed to -Path via pipeline by name
• [x] Creates an archives when paths are passed to -LiteralPath via pipeline by name

Archive formats and -Format parameter

• [x] Throws an error when an invalid value is supplied to -Format
• [x] Creates a zip archive when -Format is not specified and the destination path does not have a matching extension
• [x] Emits a warning when DestinationPath does not have an extension that matches the value of -Format
• [x] Emits a warning when DestinationPath does not have an extension that matches any extension for a supported archive format
• [x] Emits a warning when DestinationPath has no extension and -Format is specified
• [x] Emits a warning when DestinationPath has no extension and -Format is not specified
• [x] Does not emit a warning when DestinationPath has an extension that matches the value supplied to -Format
• [x] Does not emit a warning when DestinationPath has a .zip extension and -Format is not specified

Path Structure Preservation Tests

• [x] Creates an archive containing only a file when the path to that file is not relative to the working directory
• [x] Compressing a relative path to a file creates an archive containing that file and its parent directories
• [x] Compressing a relative path containing .. behaves like compressing an absolute path
• [x] Compressing a relative path containing ~ works when the home directory is relative to the working directory
• [x] Compressing a relative path containing wildcard characters preserves the relative directory structure
• [x] Validate -Path can be a relative path
• [x] Validate -LiteralPath can be a relative path
• [x] Validate -DestinatonPath can be a relative path