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

feat(help) Add command descriptions to commander output (#1119) #5033

Merged
merged 6 commits into from
Dec 9, 2017

Conversation

andre-b-fernandes
Copy link
Contributor

@andre-b-fernandes andre-b-fernandes commented Dec 4, 2017

Resolves #1119

Summary

#1119 states when typing help for any command, the output is usage and options, but there is no description about what the command actually does.

This pull request makes use of the setFlags function and the commander.description method to add and print the description of every documented command.

Test plan

yarn run test-only run tests for listing cached packages, removing all packages, removing a specific package by name

@rally25rs
Copy link
Contributor

Thanks for the contribution. Could you merge the latest master branch into your branch please. I think that will make the CI tests pass again.

Also, I noticed some of the help descriptions start with a capital letter and some don't, and some end with a period and some don't. Could you make them the same?

Thanks!

@buildsize
Copy link

buildsize bot commented Dec 9, 2017

This change will increase the build size from 10.26 MB to 10.26 MB, an increase of 6.57 KB (0%)

File name Previous Size New Size Change
yarn-[version].noarch.rpm 886.64 KB 887.3 KB 684 bytes (0%)
yarn-[version].js 3.86 MB 3.86 MB 2.43 KB (0%)
yarn-legacy-[version].js 4.01 MB 4.01 MB 2.44 KB (0%)
yarn-v[version].tar.gz 891.37 KB 892.02 KB 670 bytes (0%)
yarn_[version]all.deb 668.26 KB 668.64 KB 388 bytes (0%)

@excelsior97
Copy link
Contributor

I did that but test-macos-node8 is still failing, any ideas why?

Also changed the help descriptions to be more consistent, aswell as some minor changes to pass the lint test

@rally25rs rally25rs changed the title Help command feat(help) Add command descriptions to commander output (#1119) Dec 9, 2017
Copy link
Contributor

@rally25rs rally25rs left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rerunning the test seems to have fixed it, I think it had just timed out the previous time.
Thanks for the contribution!

@rally25rs rally25rs merged commit 19c8cd5 into yarnpkg:master Dec 9, 2017
agoldis pushed a commit to agoldis/yarn that referenced this pull request Dec 18, 2017
…readdir_files

* upstream/master:
  fix(cli): Write Node4+ error message to stderr (yarnpkg#5094)
  test(jest): Upgrade jest to latest available version (yarnpkg#5018)
  fix(git): Ignores irrelevant output from ls-remote (yarnpkg#5081)
  test(integration): Fix failing react-scripts test due to unexpected
warning (yarnpkg#5076)
  feat(help) Add command descriptions to commander output (yarnpkg#5033)
  ci(circle): Fix cache key setup for proper node_modules sharing
(yarnpkg#5060)
  fixed (yarnpkg#5034)
  fix(fetcher): offline mirror name collision w/ private registries and
scopes (yarnpkg#4822)
  fix(add): Make semver flags compatible with versioned requests (yarnpkg#4999)
  [yarnpkg#5021] Add help comment to --json flag (yarnpkg#5045)
  fix(git): match git dependencies by name instead of whole url
  fix(install): connectionOptions passes in localhost as its host to
prevent popup on MacOsx. (yarnpkg#5006)
  chore(eslint): ignore packages dir (yarnpkg#4963)
agoldis pushed a commit to agoldis/yarn that referenced this pull request Dec 18, 2017
…readdir_files

* upstream/master:
  fix(cli): Write Node4+ error message to stderr (yarnpkg#5094)
  test(jest): Upgrade jest to latest available version (yarnpkg#5018)
  fix(git): Ignores irrelevant output from ls-remote (yarnpkg#5081)
  test(integration): Fix failing react-scripts test due to unexpected
warning (yarnpkg#5076)
  feat(help) Add command descriptions to commander output (yarnpkg#5033)
  ci(circle): Fix cache key setup for proper node_modules sharing
(yarnpkg#5060)
  fixed (yarnpkg#5034)
  fix(fetcher): offline mirror name collision w/ private registries and
scopes (yarnpkg#4822)
  fix(add): Make semver flags compatible with versioned requests (yarnpkg#4999)
  [yarnpkg#5021] Add help comment to --json flag (yarnpkg#5045)
  fix(git): match git dependencies by name instead of whole url
  fix(install): connectionOptions passes in localhost as its host to
prevent popup on MacOsx. (yarnpkg#5006)
  chore(eslint): ignore packages dir (yarnpkg#4963)
agoldis pushed a commit to agoldis/yarn that referenced this pull request Dec 18, 2017
…readdir_files

* upstream/master:
  fix(cli): Write Node4+ error message to stderr (yarnpkg#5094)
  test(jest): Upgrade jest to latest available version (yarnpkg#5018)
  fix(git): Ignores irrelevant output from ls-remote (yarnpkg#5081)
  test(integration): Fix failing react-scripts test due to unexpected
warning (yarnpkg#5076)
  feat(help) Add command descriptions to commander output (yarnpkg#5033)
  ci(circle): Fix cache key setup for proper node_modules sharing
(yarnpkg#5060)
  fixed (yarnpkg#5034)
  fix(fetcher): offline mirror name collision w/ private registries and
scopes (yarnpkg#4822)
  fix(add): Make semver flags compatible with versioned requests (yarnpkg#4999)
  [yarnpkg#5021] Add help comment to --json flag (yarnpkg#5045)
  fix(git): match git dependencies by name instead of whole url
  fix(install): connectionOptions passes in localhost as its host to
prevent popup on MacOsx. (yarnpkg#5006)
  chore(eslint): ignore packages dir (yarnpkg#4963)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants