Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use shorter commands by default #667

Closed
shizhMSFT opened this issue Nov 1, 2022 · 4 comments · Fixed by #670 or #677
Closed

Use shorter commands by default #667

shizhMSFT opened this issue Nov 1, 2022 · 4 comments · Fixed by #670 or #677
Assignees
Labels
enhancement New feature or request
Milestone

Comments

@shizhMSFT
Copy link
Contributor

Human beings are lazy to type. It is better to default to shorter command names

  • repository --> repo
  • list --> ls
  • show-tags --> tag

Basically, the alias and command names should be swapped.

@shizhMSFT shizhMSFT added this to the v0.16.0 milestone Nov 1, 2022
@shizhMSFT shizhMSFT added the enhancement New feature or request label Nov 1, 2022
@FeynmanZhou
Copy link
Member

Human beings are lazy to type. It is better to default to shorter command names

  • repository --> repo
  • list --> ls
  • show-tags --> tag

Basically, the alias and command names should be swapped.

I think show-tags should be tags.

@FeynmanZhou FeynmanZhou moved this to Todo in ORAS-Planning Nov 1, 2022
@shizhMSFT
Copy link
Contributor Author

I think show-tags should be tags.

Yes, it's tags. My typo.

@shizhMSFT
Copy link
Contributor Author

Since list becomes unix style ls, it is better to rename delete to rm

  • oras manifest delete --> oras manifest rm
  • oras blob delete --> oras manifest rm

Since we rename delete to rm, it is better to rename --yes to --force to be consistent with the unix command rm.

Additionally, since oras manifest fetch has an alias get, we should also have an alias get-config for fetch-config.

@shizhMSFT
Copy link
Contributor Author

shizhMSFT commented Nov 7, 2022

According to Remove -vs- Delete,

Remove and Delete are defined quite similarly, but the main difference between them is that delete means erase (i.e. rendered nonexistent or nonrecoverable), while remove denotes take away and set aside (but kept in existence).

manifest / blob delete are indeed delete. Hence, we should keep the delete for the correct wording and uses rm just for alias.

shizhMSFT pushed a commit that referenced this issue Nov 7, 2022
…rce` (#677)

Resolves #667

Signed-off-by: Billy Zha <jinzha1@microsoft.com>
TerryHowe pushed a commit to TerryHowe/oras that referenced this issue Feb 2, 2023
Resolves: oras-project#667

Signed-off-by: Billy Zha <jinzha1@microsoft.com>
TerryHowe pushed a commit to TerryHowe/oras that referenced this issue Feb 2, 2023
…rce` (oras-project#677)

Resolves oras-project#667

Signed-off-by: Billy Zha <jinzha1@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
No open projects
Status: Done
3 participants