Skip to content
This repository was archived by the owner on Feb 26, 2024. It is now read-only.

run plugin "help" features.. #1473

Closed
1 task done
rocky opened this issue Nov 27, 2018 · 6 comments
Closed
1 task done

run plugin "help" features.. #1473

rocky opened this issue Nov 27, 2018 · 6 comments
Assignees
Labels

Comments

@rocky
Copy link

rocky commented Nov 27, 2018

It would be nice to be able to get a list of plugins that are installed other than looking at the truffle configuration file.

Is there a preferred way for a plugin to provide help for it? In the example of trufflesuite/trufflesuite.com#1396 I used console.log after looking at config.help, but is that recommended? For the core commands, their help is formatted in a uniform way, right?

@rocky rocky changed the title plugin "help" features.. run plugin "help" features.. Nov 30, 2018
@CruzMolina
Copy link
Contributor

jotting down for posterity (if I'm unable to get to this before going on leave), I think this should be handled in the "runHandler" in truffle-core/lib/run.js. completely agree that we should provide a standard/recommended way for plugin writers to specify in some manner what they would like to display (perhaps using our displayCommandHelp func from our end) when a --help flag is passed. Ideally in the truffle-plugin.json something like...

{
  "commands": {
    "hello": "hello.js"
  },
  "help": {
    usage: "truffle run hello [name]",
    description: "Greets a given user",
    options: [
      {
        option: "name",
        description: "Name of user to greet."
      }
    ]
  }
}

or also potentially allowing a file to specified (which we would parse with certain expected parameters in mind).

Also agree it would be nice to get a list of properly configured/installed plugins, perhaps a --list flag to call with truffle run (truffle run --list)

(Btw, thanks for making all these truffle run issues! 🎉 )

@CruzMolina CruzMolina self-assigned this Dec 12, 2018
@rocky
Copy link
Author

rocky commented Dec 12, 2018

You are very welcome. Thanks for considering this and working on this.

Please keep us (me, and more generally the Mythrili team) apprised of run plugin work. We can and do want to help here. We can help test things.

I am (now) watching release tags, but that can be a little too late to get the most benefit before a release.

@stale
Copy link

stale bot commented Feb 10, 2019

Thank you for raising this issue! It has been automatically marked as stale because it has not had recent activity. It will be closed in 7 days if no further activity occurs. If you would like to keep this issue open, please respond with information about the current state of this problem.

@stale stale bot added the stale label Feb 10, 2019
@eggplantzzz
Copy link
Contributor

I think we wanna keep this open

@stale
Copy link

stale bot commented Feb 21, 2019

Thanks for your response! This issue is no longer considered stale and someone from the Truffle team will try to respond as soon as they can.

@gnidan
Copy link
Contributor

gnidan commented Dec 4, 2019

Looks like this is a duplicate of #1551. Closing for issue maintenance. Thanks!

@gnidan gnidan closed this as completed Dec 4, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

No branches or pull requests

4 participants