Important: Twython 1.0, what's changed, and why I need sleep.
Ryan McGrath
Just wanted to throw out a heads up... I sat down to look into a few
issues with installation procedures and Twython tonight, and ended up
re-packaging the entire thing. I went ahead and released a 1.0
version; OAuth support and support for the Streaming API aren't things
I'm gonna count as targets for this release.
One big change in this release, is how Twython is structured - I
wanted things separated out based on what part of the API they
correspond to, but I didn't wanna go and change the entire Twython
API. What I settled on is this:
twython.core = Your basic Twython file that you know and love, no
differences here, sans how you import it.
twython.twyauth = Where all OAuth-based functionality will end up
living.
twython.streaming = Where all Streaming-based functionality will live.
The 1.0 release has no functionality changes, it's all simply
namespacing changes at this point. If you choose to upgrade to 1.0,
the only change you'll have to make to keep existing code working is
your import statement. Something like...
import twython -> (becomes) -> import twython.core as twython
Alternatively, if that feels dirty to you, just replace your
twython.setup() calls with twython.core.setup().
I've gone ahead and updated the examples in the Repo, and I'll hit the
examples on the Wiki before I go to bed. If anyone's interested, the
following is areas where Twython could use some help:
1) Documentation - we've got great internal docs, but some public-
facing doc love would be great, even if it's just updating the Github
wiki.
2) Testing - Twython currently has no test support, and I literally
just fly by the seat of my pants when doing releases. This is totally
not cool, I just don't have the time to hit this right now. If anybody
is interested in helping out here, please, be my guest.
3) OAuth - I think it goes without saying that this is a much
requested feature, and one I just haven't had the time to tackle. If
anybody has any thoughts on implementation, I'd be very interested in
hearing them.
4) Streaming API Support - Pretty self explanatory; since this was (is
still?) fairly private on Twitter's side, it's not been given much
priority.
That all said... I'm very happy to see so many people using Twython
and enjoying it. Please, if you happen to try out the 1.0 release,
throw me comments, bugs, whatever! I can't guarantee the quickest
response, but a response will be given none the less. ;)
- Ryan