Create request / queue plugin

[calledtoconstruct]

Support:

request [queue name] [remove] value
request (promote | demote) [queue name] value
queue (pop | shuffle)
queue (create | delete | open | close) name [option list name]
option (create list | delete list) name
option (add | remove | disable | enable) name

For the request command, if only one queue exists, then the queue name is optional. The remove keyword is always optional, but items will always be added (see also, duplicate entries below) unless remove is specified.

Outstanding issue: how to handle duplicate entries? Perhaps the queue create command can take an argument indicating whether duplicates are allowed?

[Andrewnetwork]

Some examples of bot usage according to your spec:

request Row your Boat
request promote Row your Boat
request remove Row Your Boat
queue create premium 
request Twinkle Twinkle Little Star          -- Would throw error because we have a named queue? 

Feedback:

• Maybe "remove" should be called "cancel" to be in line with ordinary language.
• Should there always be a default queue? After a named queue is created, does it make sense that using request without a queue name would throw an error?
• I'm not sure what option is for. Seems a little verbose. I think request and queue are the only commands needed... unless I'm misunderstanding what option is for.
• How duplicates are handled seems to be a policy that different people may want different solutions to. You could provide some option which specifies how duplicates are dealt with ( i.e. you could use duplicates as a bumping mechanism, if multiple people submit the same song, it moves the song forward in the queue ), or you could just arbitrarily decide. Depends on how much work you are looking to put into this I suppose.

[calledtoconstruct]

Excellent feedback, thank you!

So, I should clarify option ...

When you use queue create and supply the name of an option-list, then only items from the option list are allowed to be requested. Perhaps another optional setting for a queue would be to allow "donation requests" to be added to the queue regardless of whether they exist on the option list.

So, a queue can have the following "options":
Duplicate: allowed, promoted, not-allowed.
Constrained: none, option-list, option-list except by donation.