[joseluisq]

This PR introduces the first major version 1.0.0.

Changelog

Breaking change

Although changes are expected to be minor, existing code needs to be updated.

• Golang 1.23 is required as a minimum.
• API is changed.
  • App type is decoupled from the Handler logic, resulting in a new Handler type.
  • Some structs are renamed like Flag types, Flag values, Cmds and helpers.

Refactorings

• Restructured modules (files and directories).
• Improved Tests and code coverage CI, as well as refactored a few APIs. The library requires Golang 1.23 or later.

Improvements

• Strict UTF-8 for arguments and alphanumeric ASCII for flags and commands.
• POSIX-compliant support is partially supported (see the limitations).
• Support for flags termination via -- to provide further positional arguments (tail args).
• Same repeated flag arguments use the last value provided.
• Option to restrict the maximum argument length and the maximum number of arguments provided.

Fixes

• Inconsistent use of aliases for special version and help) flags like --v or --h.

For the usage of the new API, please check out the examples to adjust existing apps accordingly.
the ./examples directory.

For more details, see the v1.0.0 milestone and the full changelog v0.1.0...v1.0.0.

[semanticdiff-com]

Review changes with  

Changed Files

File	Status
handler/handler.go	13% smaller
README.md	Unsupported file format
app/app.go	0% smaller
app/app_context.go	0% smaller
handler/handler_test.go	0% smaller

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.45%. Comparing base (5a2012d) to head (aff545a).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #12      +/-   ##
==========================================
+ Coverage   98.41%   98.45%   +0.03%     
==========================================
  Files           8        8              
  Lines         819      840      +21     
==========================================
+ Hits          806      827      +21     
  Misses         11       11              
  Partials        2        2              

Flag	Coverage Δ
unittests	98.45% <100.00%> (+0.03%)	⬆️

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

☔ View full report in Codecov by Sentry.
📢 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.