I understand how the app dispatches to the correct command via the command_map dispatch table but where is the dispatch table for the command's subcommands?

In package My::Queue:

in My::Queue::Command::Property:

How does the app know that subcommands list and set get dispatched to My::Queue::Command::Property::List and My::Queue::Command::Property::Set?
Does the app just look for a class that inherits from My::Queue::Command::Property with a name that matches /[Ss]et/ or /[Ll]ist/ ?

Thanks in advance for your help!

Sorry for being so dense but how does it know that the words used for the commands ('list' and 'set') map to the correct subcommand class.
In other words, if I create the command line app to run like:

bash$ examples/queue --qin=/tmp/qfile --qout=/tmp/qfile property foo

And I create a class that inherits from My::Queue::Command::Property called My::Queue::Command::Property::Bar that I want to be used for the subcommand 'foo'.

How does the app know that 'foo' maps to 'My::Queue::Command::Property::Bar' without a subcommand dispatch table?

Thanks again for your help. Your framework is very elegant and well thought out.

I did not want a subcommand of foo called bar. It seems from your example that if I want a 'property' subcommand called 'foo' I *MUST* have a Class call 'Foo' that inherits from the Property class.
If I want a 'property' subcommand called 'bar' I *MUST" have a class called 'Bar' that inherits from the 'Property' class.
If I want a 'foo' subcommand called 'blarg' I must have a class called 'Blarg' that inherits from the Foo class.

In other words, I can create a Command called 'requeue' that can map to any class that is a subcommand of CLI::Framework::Command (i.e. My::Queue::Command::Baz), via the command_map() method by adding the following to the return list

If I wanted to create a subcommand of 'requeue' called 'random', I *Must* create a class called 'Random' that is a subclass of 'My::Queue::Command::Baz'. The command line would look like:

There seems to be no way for me to name the class anything but 'Random' if I want the correct class to be instantiated when I call the 'random' subcommand of 'requeue'.

The class name for the 'list' subcommand of the 'property' command must be called List.
The class name for the 'set' subcommand of the 'property' command must be called Set.
Otherwise, how does the Property class know which subclass to call since both List and Set are subclasses of Property. How is 'set' mapped to 'Set' and 'list' mapped to List?

Again, my apologies if I have not made myself clear and/or not groking your explanations. Thank you for your patience.

I can use subcommand_alias() to give a subcommand whatever alias I choose.
The name of the subcommand has to match the name of the class that inherits from My::Queue::Command::Property

I am not looking for a way to name a command anything I want. I am looking to understand how the subcommand dispatching works.
Let me try and give a concrete example using examples/queue:

first, I delete the subcommand_alias() method from My::Queue::Command::Property
next, I create a class called My::Queue::Command::Property::Gist that inherits from My::Queue::Command::Property (it's run() method just returns "GOT HERE!\n")
Right now, without me defining any subcommand dispatch table, I have a subcommand on the commandline called 'gist'. It must be called 'gist'

If I change the class name to My::Queue::Command::Property::gist
it still works with the 'gist' sub-command.

So, my question are, how does the subcommand dispatching work?

How does CLI know that 'gist' maps to 'My::Queue::Command::Property::[Gg]ist'?

What if I create 2 subcommands classes that inherit from My::Queue::Command::Property:
My::Queue::Command::Property::Gist
My::OtherModule:Property::Gist

Which one gets mapped to the 'gist' subcommand?

What is becoming obvious, if I want to have a subcommand of 'property' called 'gist' (without subcommand aliases), I must have a subcommand class named Gg]ist that inherits from My::Queue::Command::Property.
If I want to use an existing class named 'MyGist' for the 'gist' subcommand, I would need to make it inherit from the property class, and use 'gist' as the subcommand alias on the command line:

Is this correct?