Skip to content

Deprecate the --verbose flag #1533

New issue
New issue
Closed
#1558
Closed
Deprecate the --verbose flag#1533
#1558
Labels
enhancementNew feature or requestlogging
Milestone
v1.3.0-beta.1
@Wwwsylvia

Description

@Wwwsylvia
Wwwsylvia
opened on Nov 21, 2024

As per the ORAS diagnose experience proposal, we should mark the --verbose flag as deprecated for oras pull, oras push, oras attach, and oras discover commands.

  • For oras pull, oras push, oras attach commands, we should output the detailed status output by default. As a result, the output with and without --verbose will be identical.
  • For oras discover, we do not change the default output.

oras/docs/proposals/diagnose-experience.md

Lines 72 to 74 in 5280c67

- Deprecate the `--verbose` flag and keep `--debug` flag to avoid ambiguity. It is reasonable to continue using `--debug` to enable the output of `DEBUG` level logs as it is in ORAS. Meanwhile, this change will make the diagnose experience much more straightforward and less breaking since only ORAS `pull/push/attach/discover` commands have verbose output.
- Make the verbose output of commands `pull`, `push`, `attach` as the default (status) output. See examples at the bottom.
- Make the verbose output of command `discover` as a formatted output, controlled by `--format tree-full`.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestlogging

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions