NOTE: The first alpha release is available for evaluation. Please watch this page for further updates as we work towards our first official release in the second quarter of 2023.
The Tanzu CLI is based on a plugin architecture. This architecture enables teams to build, own, and release their own piece of functionality as well as enable external partners to integrate with the system.
The Tanzu Plugin Runtime is a library that provides functionality and helper methods to develop Tanzu CLI plugins.
Developers begin plugin development by using the builder plugin to bootstrap
a new plugin project. The code generated in the project relies on the runtime
to provide some functionality common to all plugins. For more information about
the development process, see the Tanzu CLI Plugin Development guide
This Tanzu Plugin Runtime broadly consists of:
- CLI UX Component library
- Configuration library
- Plugin integration
- Command helpers
- Test helpers
This package implements reusable CLI user interface components, including:
- output writers (table, listtable, json, yaml, spinner)
- prompt
- selector
- question
For more details go to Component Library
This package implements helper functions to read, write and update various Tanzu CLI configuration objects like Contexts, DiscoverySources, CLI Features and environment settings.
For more details about the design and APIs go to Configuration Library
This package implements helper functions for new plugin creation. This is one of the main packages that each and every plugin will need to import to integrate with the Tanzu CLI. For more information about the development process, see the Tanzu CLI Plugin Development guide
This package implements command specific helper functions like command deprecation, etc.
This package implements helper functions to develop test plugins and Cross-version Configuration Library APIs compatibility testing
Besides unit and integration tests, the runtime APIs are also being tested in the presence of other versions runtime client code as part of cross-version API compatibility testing. These tests are important in ensuring interoperability among runtime clients (and hence different generations of CLI plugins)
Cross Version API Compatibility testing ensures that Configuration Library APIs of different Tanzu Plugin Runtime versions work as expected as long as those Tanzu Plugin Runtime versions are supported.
Cross Version API Compatibility testing simulates the interaction of Configuration library APIs provided by different versions of plugin runtimes to ensure that they can interoperate with one another.
For more details go to Cross-version API Compatibility
Thanks for taking the time to join our community and start contributing! We welcome pull requests. Feel free to dig through the issues and jump in.
- Check out the contribution guidelines to learn more about how to contribute.
- Check out the document here about the project's support process.