cloudposse/atmos v1.176.0-rc.0

on GitHub

atmos list custom columns documentation

why

We have multiple places using custom columns in atmos list but are missing documentation

references

Summary by CodeRabbit

• Documentation
  • Added a comprehensive guide on customizing output columns for various atmos list commands, including detailed configuration examples and troubleshooting tips.
  • Introduced new sections with YAML configuration examples for customizing columns in list components, list stacks, list workflows, list metadata, list settings, list values, and list vars commands.
  • Expanded and clarified documentation to help users tailor command output to their needs.

• atmos list vendor command to list all vendor configurations in multiple formats (table, json, yaml, csv, tsv).
• Implements filtering, custom columns.

why

• Provides a way to view and audit all vendor configurations.

Evidence:

references

Summary by CodeRabbit

• New Features

  • Introduced a new CLI command to list vendor configurations with customizable output formats, stack filtering, and delimiter options.
  • Added support for displaying vendor configuration details in table, JSON, CSV, and TSV formats with customizable columns and headers.

• Documentation

  • Added detailed usage documentation with examples for the new vendor listing command.

• Bug Fixes

  • Enhanced error handling and validation during vendor configuration discovery and listing.

• Tests

  • Added comprehensive tests covering vendor listing, filtering, formatting, manifest discovery, and error scenarios.

• Refactor

  • Extended configuration schema and formatting options to support advanced vendor listing features.

Identified issues when considering that the table is "empty"

why

Added full tests for utils and empty table cases
Making sure we validate the places where we are using these utils pkg and block future regressions

references

Summary by CodeRabbit

• Bug Fixes

  • Improved output handling for metadata and settings listings, ensuring results are returned consistently without additional empty output checks or messages.

• Tests

  • Added comprehensive unit tests for utility functions to verify component existence checks and error identification, covering various scenarios and edge cases.

Enabled atmos list vars and atmos list values to correctly display information for nested components (e.g., apis/weather, eks/cluster).

why
previously we assume and extract only the basename of nested components
These changes ensure the full component path is used for both existence checks and data querying.

references

• Closes #1220

Summary by CodeRabbit

• Refactor
  • Added support for a new component type, enabling users to query both Terraform and Helmfile components.
  • Improved component value extraction with enhanced error handling and modular query construction for better reliability.
  • Expanded component existence checks to cover all component types, providing more comprehensive search results.
• Tests
  • Introduced new tests to verify query expression construction across different component types and configurations.