Add ConvertTo-HumanizedByteSize cmdlet

[Copilot]

Exposes the Humanizer ByteSizeExtensions.Humanize API as a PowerShell cmdlet.

Changes

• New cmdlet ConvertTo-HumanizedByteSize in PowerShellHumanizer.psm1

  • Accepts byte values via parameter or pipeline
  • Optional -Format parameter for custom number formatting (e.g., #, 0.00)
  • Automatically selects appropriate units (B, KB, MB, GB, TB)

• Tests added to PowerShellHumanizer.Tests.ps1

  • Basic conversions, decimal values, format parameter, pipeline support

• Documentation added to README.md with usage examples

Usage

# Basic usage
ConvertTo-HumanizedByteSize 1048576
# 1 MB

# Pipeline support
1024, 2048, 3072 | ConvertTo-HumanizedByteSize
# 1 KB
# 2 KB  
# 3 KB

# Custom formatting
ConvertTo-HumanizedByteSize 1536 -Format '#'
# 2 KB

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Add [ByteSizeExtensions]::Humanize Cmdlet</issue_title>
<issue_description>Expose this API in a cmdlet.</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes Add [ByteSizeExtensions]::Humanize Cmdlet #20

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[mattcargile]

Suggest removing that line.

[mattcargile]

This is not necessary if accepting bytes. [ByteSize] has a constructor to auto convert on the Humanize method.