Releases: 00JCIV00/cova
Releases · 00JCIV00/cova
v0.10.1-beta
Full Changelog: v0.9.1-beta...v0.10.1-beta
This version is primarily enhancements and fixes to features from v0.10.0.
v0.10.1 (Supports Zig v0.13)
Features
- Zig v0.13 support.
- Improved the Documentation, Examples, & Build Process.
- Added the "cova" Log Scope.
- Added a
reset()
method f/ Commands similar to the one forstd.ArrayList
. - Exposed
indent_fmt
f/ Values. - Added
getAllAs()
to Values to help w/ multi-value analysis. - Created the
UsageHelpConfig
f/ Initialization. (This will be reworked intoDefaultArgConfig
in v0.11) - Added
excluded_short_opts
to theFromConfig
f/ Commands to allow for more granular conversion control with Default Arguments.
Fixes
- Fixed Enum handling f/ Values.
- Fixed Boolean parsing issue f/ Values.
v0.10.0-beta
Full Changelog: v0.9.1-beta...v0.10.0-beta
v0.10.0 (Supports Zig v0.12)
New Features
- Meta Doc Generators for Help Docs, Tab Completion Scripts, and Argument Templates!
- Inheritable Options that can be passed down to all Sub-Commands of a given Command (ex:
cmd --opt
andcmd sub-cmd --opt
would refer to the same--opt
). - New
parent_cmd
field for all Argument Types, allowing for easier bi-directional referencing. - New
examples
field for Commands which is used to show examples in Usage/Help messages and Help Docs. - New Argument Index (
arg_idx
) field for all Argument Types, so you can tell exactly where an Argument was provided in relation to other Arguments regardless of spacing. - New
checkArgGroup()
method for Commands to check if an Argument from the specified Argument Group was used. - Argument Type Configs now have an
optimized()
function that can slim down the Value Union and remove certain features to help reduce binary size. (These optimizations can be enabled individually as well.)
Doc Improvements
- Updated the Docs to use the new Zig Autodocs. They're also now created through CI using a GitHub Workflow.
- Revamped the Guides and moved them to a GitHub Wiki for the Cova repo.
- Simplified the README to be leaner and cleaner. (Always looking for feedback on this)
- Better
basic-app
andcovademo
examples.
Fixes & Optimizations
- Revamped allocation model that closely resembles Zig's Managed Types.
- Better Value parsing.
- Improved Value Union default Types.
- Several updates to stay in line with Zig changes (
no comptime var
,b.path()
, etc)
Breaking
- Several fields from the Argument Types and Configs have been renamed for better consistency.
- Meta Doc Gen has been completely reworked from the very limited version available in v0.9.0.
v0.9.1-beta
Full Changelog: v0.9.0-beta...v0.9.1-beta
v0.9.1
- Revamped the Readme to be more concise and readable.
- Updated for Zig Build API changes.
v0.9.0-beta
What's Changed
Full Changelog: v0.8.0-beta...v0.9.0-beta
v0.9.0
New Features
- Implemented Argument Groups to help organize Arguments for Usage/Help messages and analysis.
- Implemented Aliases for Commands & Options and Value Child Types.
- Added more methods to make analyzing Arguments even easier.
- Added customizable Callback Functions and new Formatting options for Usage/Help messages.
- Implemented Mandatory Options with the new
mandatory
field. - Implemented Option Termination which is configurable under
cova.ParseConfig
. - Revamped the handling of Values with an Enum Child Type to make them seamless to work with.
- Revamped Conversions for fields w/ default values.
- Tested on additional platforms.
- Updated Installation to use the new
zig fetch --save
. - Updated the Docs and Guides with more features and examples.
Breaking
- Changed the
get
,check
, andmatch
methods for analyzing Options & Values to use Argument Groups. - Added new
global_
andchild_type_
prefixes for certain fields. - Added Allocator parameter requirement for all Callback Functions.
Fixes & Optimizations
- Fixed bug with Long Option parsing.
- Fixed bug with Boolean Value parsing.
- Fixed Alignment Issue on ARM devices.
- Fixed bug with
Command.Custom.getVals()
. - Fixed bug with
Command.Custom.to()
parsing. - Fixed Zig removal of
meta.trait
. - Fixed Zig "local variable is never mutated" errors.
- Removed several unnecessary, erroneous uses of
const
and@constCast()
. - Optimized the default size of the
Value.Generic
Union and added customization options allowing for much smaller binaries. - Optimized parts of Argument Initialization/De-initialization.
v0.8.0-beta
What's Changed
Full Changelog: v0.7.0-beta...v0.8.0-beta
- Improved the Argument Analysis experience with the addition of the checkSubCmd() and matchSubCmd() methods in Command!
- Implemented Command conversions from/to Unions and Functions in addition to Structs!
- Revamped Values to be more in line with Commands and Options and also to allow for them to be based on arbitrary Types! (This is the one breaking change that will require older projects to be reworked a little.)
- Added several new Parsing configurations for easier parse-error handling and POSIX compliance.
- Implemented Tokenization of raw argument strings.
- Revised the locations of several configurations to be more predictable.
- Improved the README, API Docs, and Guides so they're easier to follow and navigate through.
- Created a Basic App as a well-documented example of Cova's features in action!
v0.7.0-beta
Version 0.7.0
Public Beta Release!