What should the API look like?

[mfisher87]

The current API is, IMO, not very pythonic. Singleton classes are just generally icky. What about a stateful module? One thing singleton classes make easier is resetting state; just blow away the instance and reinstantiate. A stateful module would require a reset method which we constantly update to reset each piece of state the module holds. Maybe a hybrid approach with a module providing functions that use the singleton class under the hood?

[mfisher87]

I think this has been improved in #24 . Is there more work to be done, or does the API look good? I think what we have now is much better, and hides the underlying singleton implementation so we can change that any time we want.

@e5ha @benjaminszeghy would love your thoughts :)