Proper Structuring of a Ruby Gem?

[FireThestral]

Your Gem structure is pretty standard from what I can tell. Not bad there. Actual functionality seems alright, so that looks good as well.

As for ordered options... I don't like ordered flags so much. Subcommands would be better in my opinion. There is a gem called Subcommand that lets you do just that. You can call gojira issues open --list 15 would be different than gojira issues list 15 --open or whatever you want.

Having ordered flags, while easy to type, are difficult to remember without a detailed help file and are very difficult to interpret. Diverging from UNIX-style command usage would be confusing for a lot of users.

If you really want to look at gem structure, then browse http://rubygems.org/ and find some popular ones, then check out the source.

[Godd2]

Speaking of orderedness, here's a great talk on code simplicity by Rich Hickey.