[htaheri17]

Related issue: #184

This PR adds a way to format file sizes directly from the terminal using Humanize. Previously, running python -m humanize naturalsize 8589934592 produced an error because the package had no command-line entry point. With this change, it prints 8.6 GB.

The CLI supports both humanize naturalsize and python -m humanize naturalsize, along with binary units, GNU formatting, custom number formats, and piped input. Invalid input produces a helpful error message instead of a traceback.

The implementation uses the existing naturalsize function for formatting. I also added CLI tests and updated the README and filesize documentation with examples.

I tested the changes locally on macOS. The test suite finished with 757 passed and 132 skipped. I also checked both command forms manually and confirmed the expected decimal and binary output.

The full aggregate lint check was blocked in the implementation environment by an npm certificate error while installing Prettier.

[codecov]

Codecov Report

❌ Patch coverage is 95.53571% with 5 lines in your changes missing coverage. Please review.
✅ Project coverage is 99.29%. Comparing base (d16e635) to head (f7d06a1).

Files with missing lines	Patch %	Lines
src/humanize/__main__.py	0.00%	3 Missing ⚠️
src/humanize/cli.py	95.65%	2 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #505      +/-   ##
==========================================
- Coverage   99.70%   99.29%   -0.42%     
==========================================
  Files          12       15       +3     
  Lines        1024     1136     +112     
==========================================
+ Hits         1021     1128     +107     
- Misses          3        8       +5     

Flag	Coverage Δ
macos-latest	97.09% <95.53%> (-0.18%)	⬇️
ubuntu-latest	97.09% <95.53%> (-0.18%)	⬇️
windows-latest	92.34% <95.53%> (+0.34%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Muguett-DBY]

One small version-specific input edge: on Python 3.12, humanize naturalsize -1e3 is rejected as an unrecognized argument, although 1e3, -1000, and the underlying naturalsize("-1e3") all work. humanize naturalsize -- -1e3 and piping -1e3 through stdin work as well.

On Python 3.15 the direct form works, so this appears to depend on the Python version's argument parser. Would a test or a note about the -- form be useful for the older supported versions? I checked the PR's Python code with captured streams, not the installed console entry point or the full suite.