How can you create a plugin with subcommands?

[mtkennerly]

I haven't quite managed to figure this out from the Poetry or Cleo docs. I'd like to update my plugin to allow usage like this:

poetry dynamic-versioning apply --foo
poetry dynamic-versioning enable --bar

Is this supported? Any help would be appreciated.

[edgarrmondragon]

This issue led me to this example.

It's a bit old but hopefully the API hasn't changed too much.

[mtkennerly]

I wasn't able to make that example work, unfortunately, but thank you for the suggestion.

I did have the idea to check how Poetry's own subcommands work, and I noticed this:

poetry/src/poetry/console/commands/debug/info.py

Lines 8 to 9 in 6e94298

	class DebugInfoCommand(Command):
	name = "debug info"

So for a Poetry plugin, that looks like this:

class DynamicVersioningEnableCommand(Command):
    name = "dynamic-versioning enable"

# ...

        application.command_loader.register_factory(
            "dynamic-versioning enable", lambda: DynamicVersioningEnableCommand(application)
        )

And it works!

$ poetry list
[...]
Available commands:
[...]
  config                     Manages configuration settings.
  dynamic-versioning         Apply the dynamic version to all relevant files and leave the changes in-place. This allows you to activate the plugin behavior on demand and inspect the result.
  export                     Exports the lock file to alternative formats.
[...]

 dynamic-versioning
  dynamic-versioning enable  Update pyproject.toml to enable dynamic versioning.

[...]

The only downside (in my opinion) is that poetry dynamic-versioning --help doesn't mention the subcommand.