I'm still not convinced. If you look at the API reference under Conch: http://twistedmatrix.com/documents/current/api/twisted.conch.telnet.html And the API refrerence under Protocols: http://twistedmatrix.com/documents/current/api/twisted.protocols.telnet.Teln... There's a HUGE difference in the amount of documentation available. Just learning this stuff for the first time, I need as much documentation as I can get... all the examples, and all the API docs, seem to be in twisted.protocols.telnet. And of course I'd much rather use something that's at version 2.2 than something that's at version 0.6. If conch is still unstable and hasn't hit 1.0, why is the old interface deprecated? It seems silly to deprecate the old interface if the new one, being unstable, might change and require being deprecated again. I'm sorry, I just don't understand. (FYI, I did download the entire tarball, but I only installed the "core" because I figured that that was all I needed. I didn't anticipate that "correct" telnet interface had moved because, again, this isn't documented in the API reference, which I looked at before installing.) You say that Conch is better... how is it better? Is twisted.protocol.telnet going away in the near future? What the heck should I be using? Other than the deprecated warning, I'm inclined to use the "old" twisted.protocols.telnet interface which at least has examples and documented functions. Thanks again for your help. It looks like I found your toolset in the midst of some huge confusing rewrite or something. :) Just my luck. On 3/19/06, Christopher Armstrong <radeex@gmail.com> wrote:
On 3/19/06, Christopher Armstrong <radeex@gmail.com> wrote:
On 3/18/06, James Schend <blakeyrat@gmail.com > wrote:
When I run that example, I get the message that twisted.protocols.telnet is deprecated and I should instead be using twisted.conch.telnet.
Is there something I'm missing here, or is Twisted telling me that I should be using an unstable <1.0 library with no documentation that's not even part of the core install instead of a 2.2 version library with good documentation that *is* part of the core install? Is this deprecated warning in the wrong spot? I don't get it.
The telnet protocol implementation was simply moved to Conch. That
particular code is no more or less stable and documented than it was in its old location. Also, if you're downloading tarballs, you should be getting the full Twisted tarball, not the individual core/subproject tarballs. Those individual ones are for embedders and OS packagers, basically. (The old web site didn't make this as clear, and the new one encourages you to download the full Twisted package).
I'm sorry, it appears I'm mistaken. I was thinking that the telnet protocol implementation moved to twisted.conch in the Great Split of Two Point Oh, but I see that this was something else. The implementation in conch is definitely different (and probably better), but I don't think my comment about the state of documentation and stability is any less true.
-- Christopher Armstrong International Man of Twistery http://radix.twistedmatrix.com/ http://twistedmatrix.com/ http://canonical.com/
_______________________________________________ Twisted-Python mailing list Twisted-Python@twistedmatrix.com http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python