v1.0.0-alpha.9

Changelog

• 9a1f297 ci: add action workflow to deploy pages
• 366b328 ci: ensure release runs on v* tags
• ede43e7 ci: organize workflows
• b9bbaa4 ci: prep for alpha.9 release
• 7c2eb20 ci: update versions to prep for release
• f11b6e1 doc: we don't need no stinkin' badges
• 554dde1 feat: add gh pages localization
• cb120e3 feat: enable global flags documentation + examples in specification
• a16eedc feat: implement cobra code generation
• 86475ca fix: github pages navigation + minor polish
• 50d507b fix: landing page example
• 130dd66 fix: pages polish
• eb5b8b4 fix: polish
• d199b6a fix: seo
• 4fadb0a fix: structured data in landing page
• ad9f0bf fix: update npm dependencies
• e77ecdc fix: update pages canonical host to opencli.dev
• 17ef1ef polish: add favicon

Additional Links

• Interactive OpenCLI Spec document editor
• CLI Reference Docs

Warning

Mac users downloading the binary will need to remove the quarantine attribute because OpenCLI does not currently pay $99/yr for an Apple Developer license to sign the binary.

---

Released by GoReleaser.

1.0.0-alpha.8

Warning

Breaking Changes in this release

Major refactor of the project structure and introduction of the live editor/preview capability:

https://opencli-spec.github.io/editor

CLI has currently lost its ability to generate boilerplate code but should be more easily maintained going forward with better separation of concerns between the packages and the CLI.

1.0.0-alpha.7

Features

• Improve specification for config files and environment variables for alternative sources
• Improve support for alternatives sources in urfave/cli code gen

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.6

Misc

• Improve documentation and readme
• Improve CI process

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.5

Features

• Improved support for Yargs CLI builder plate

Fixes

• Documentation updates, project structure

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.3

Features

• Update OpenCLI Specification to support alternative config sources for flags, e.g.:

  alternativeSources:
    - type: "env"
      name: "OCLI_DOCS_FORMAT"
    - type: "file"
      format: "yaml"
      path: "~/.ocli/config.yaml"
      property: "docs.format"

  see cli.ocs.yaml for a full example
• Add support for alternative config sources in code generation (urfave/cli/v3) and docs generation (markdown)

Fixes

• General fixes in code generation and updates to markdown docs generation.

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.2

Features

• Add support for Yargs CLI Framework code generation

Fixes

• General fixes in code generation and updates to markdown docs generation.

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.1

Features

• Add support for describing error codes in the OpenCLI doc

Fixes

• Fix documentation rendering that could skip internal group commands if they were not explicitly listed in the OCS doc
• Generated spec code was not checked into repository which caused errors on go install

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile

1.0.0-alpha.0

Initial Release Candidate 🎉

Features

• Initial spec version 1.0.0-alpha.0
• Spec validation (supports both JSON and YAML)
  • Package support for programmatic validation
  • CLI support
• Documentation generation (Markdown format)
  • Package support for programmatic generation
  • CLI support
• boilerplate generation (urfave/cli v3)
  • Package support for programmatic generation
  • CLI support

Warning

There is no signing capability available for OpenCLI yet (i.e. No paid Apple Developer account).
Therefore, the apple binaries will not be runnable until you allow for an exception within the system settings.
You can always build from source using the supplied Makefile