Comments (2)
The usage section in this case indicates that you can use the topic by specifying a sub command,
USAGE
$ topic-test topic-only COMMAND
I believe this is a valid usage string so I'm not convinced that we should get rid of it but I'm open to hearing arguments about why it should.
Also, the description for the topic can be configured by adding it to the oclif
section of your package.json. For instance,
"oclif": {
"topics": {
"topic-only": {
"description": "This topic has no top-level command"
}
}
}
from core.
Thanks for the help. I wasn't aware of the configuration in package.json. I'm closing this although I still think there is room for improvement. A couple of errors I made in the original description of this:
- I shouldn't have said there "there should be no
USAGE
stanza" stanza under expected behavior. The defaultUSAGE
stanza is describing the sub-commands perfectly. It's only the description that is off. - I should have defined "same-name command". What I mean by this is a topic with no
index.ts
and no<topic-name>.ts
liketopic-only
in the example. - I could have been more clear that I think the current behavior is correct when there is a same-name command. For example, the topic
topic-and-command
produces a good description. I just think the default description for a topic with no same-name command should be different or even left out entirely.
from core.
Related Issues (20)
- topicSeparator space generates wrong message when used alongside usage HOT 1
- Upgrading to a version after 3.20.0 causes issues with hooks HOT 3
- (help): show arg/flag options if user didn't provide any HOT 1
- Command summary displays as topic summary when nested below topic without summary. HOT 1
- Unable to run dev.js outside of the project folder
- BaseCommand Documentation HOT 3
- Native support for .env files HOT 1
- bun with oclif not catching unhandled exceptions HOT 3
- Option to customize "<value>" in docopts help usage strings HOT 4
- Help strips strings from USAGE flags when they match command alias HOT 2
- feat: allow renaming of --json HOT 1
- Single Command CLI symbol display on the help output when the command fails
- ux.table `maxWidth` column option HOT 2
- CliUx.ux.prompt text truncation HOT 3
- Build failure with `exactOptionalPropertyTypes` enabled HOT 5
- [Feature request] Alias a single flag to a set of multiple flags HOT 1
- Getting MaxListenersExceededWarning: Possible EventEmitter memory leak detected. after updating to latest version of oclif HOT 2
- Error bundling @oclif/core into my project HOT 15
- UX tables get displayed along with json output on usage of --json flag HOT 2
- Specify different oclif options for dev and run HOT 6
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from core.