Release notes from cova

v0.10.1-beta

2024-09-21T20:58:10Z

Full Changelog: v0.9.1-beta...v0.10.1-beta

This version is primarily enhancements and fixes to features from v0.10.0.

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 for std.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 into DefaultArgConfig in v0.11)
Added excluded_short_opts to the FromConfig f/ Commands to allow for more granular conversion control with Default Arguments.

2024-09-21T19:36:37Z

Full Changelog: v0.9.1-beta...v0.10.0-beta

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 and cmd 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.)

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 and covademo examples.

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)

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.

2024-09-21T19:34:25Z

Full Changelog: v0.9.0-beta...v0.9.1-beta

2024-09-21T19:33:05Z

Full Changelog: v0.8.0-beta...v0.9.0-beta

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.

Changed the get, check, and match methods for analyzing Options & Values to use Argument Groups.
Added new global_ and child_type_ prefixes for certain fields.
Added Allocator parameter requirement for all Callback Functions.

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.

2024-09-21T19:31:16Z

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!

2023-07-09T21:05:47Z

Version 0.7.0

Public Beta Release!