What’s New in goopt v2

goopt v2 is a major update focused on providing powerful, out-of-the-box solutions for building professional, robust, and user-friendly command-line applications.

New Major Features

A Powerful Validation Engine (Replaces accepted)

The old accepted tag has been deprecated in favor of a completely new validation engine that is more powerful, composable, and easier to use.

  • Directly in Struct Tags: Define complex validation rules right where you define your flag.
  • Composable Logic: Chain built-in validators (email, port, range) or combine them with logical operators (oneof, all, not).
  • Custom Validators: Easily write and integrate your own domain-specific validation logic.
  • Clearer Syntax: The new validators tag uses a more intuitive parenthesis-based syntax (e.g., validators:"minlength(5)").
  • ➡️ Read the Validation Guide

Command Execution Hooks

Manage the entire lifecycle of your commands with pre- and post-execution hooks. This is perfect for handling cross-cutting concerns without cluttering your command logic.

  • Use cases: Authentication checks, database connection management, logging, metrics, and resource cleanup.
  • Flexible scope: Apply hooks globally to all commands or target specific commands.
  • ➡️ Read the Execution Hooks Guide

Advanced Help & Version Systems

The help and version systems are now fully automatic and highly configurable.

  • Auto-Help: --help and -h flags are now provided by default, with an adaptive display style that suits your CLI’s complexity.
  • Interactive Help: Users can now query the help system with commands like myapp --help --search "database".
  • Intelligent Suggestions: Automatic “did you mean?” suggestions for mistyped commands and flags with customizable distance thresholds.
  • Auto-Version: Enable a --version flag with a single line of configuration, with support for dynamic build-time variables.
  • ➡️ See the Help System Guide and Version Support Guide

Architectural Improvements

Enhanced Internationalization (i18n)

The i18n system has been significantly enhanced with new features for true global application support.

  • Layered Bundles: A clearer separation between the default system bundle and your application’s user bundle.
  • Runtime-Switchable Names: New nameKey tag allows translating flag and command names, not just descriptions. Users can interact with your CLI using commands and flags in their native language.
  • Context-Aware Suggestions: The “did you mean?” system intelligently detects whether users are typing in the canonical or translated language and shows suggestions accordingly.
  • JIT Translation Registry: Just-In-Time building of translation mappings optimizes startup time by constructing name-to-flag/command mappings only when needed.
  • Auto-Language Detection: Sophisticated language detection from command-line flags, environment variables, and (optionally) system locale settings.
  • RTL Language Support: Automatic right-to-left layout detection and formatting for languages like Arabic and Hebrew.
  • Locale-Aware Formatting: Numbers and dates are automatically formatted according to the user’s locale (e.g., 1,000 vs 1.000 vs 1’000).
  • Regional Variants: Full support for regional language variants like Swiss German (de-CH) or Canadian French (fr-CA).
  • Smart Error Formatting: Validation errors intelligently format numbers based on format specifiers (%d vs %s).
  • Naming Consistency Warnings: New warning system helps maintain consistent naming conventions across translations and canonical names.
  • Extended Language Support: Easy addition of new languages through locale packages or runtime loading.
  • Improved Tooling: The goopt-i18n-gen tool is more powerful than ever, with a “360° workflow” to automate adding i18n to existing projects.
  • ➡️ Read the i18n Guide

Hierarchical Flag Inheritance

Flag handling is now fully hierarchical and more predictable.

  • Parent-child flag resolution: Flags defined on parent commands are available to all children.
  • Clear precedence rules: Command-specific flags correctly override inherited flags.
  • ➡️ See the Flag Inheritance Guide

API Cleanup

The public API has been modernized and simplified.

  • Deprecated methods from v1 have been removed.
  • Naming has been made more consistent throughout the library.
  • Error handling at initialization is more robust with the introduction of NewArgE.

Breaking Changes

For a complete list of breaking changes and instructions on how to update your code from v1, please see the Migration Guide.