<html><body><br />On 07:25 pm, itamar@itamarst.org wrote:<br />>> I'm working on tests for t.c.s.session.SSHSession, and it's difficult<br />>> because of the terrible API SSHSession currently has.  I've tried a<br />>> rewrite in branches/session-2710, but I wanted to know if anyone was<br />>> actually using that class directly?  The typical use case is writing<br />>> an Avatar->ISession adapter, and if you're doing it that way nothing<br />>> should change for you even with this update.<br />><br />>Rather than removing it, you could e.g. deprecate the old class and then<br />>write a new one (using test-driven development) to ensure a decent API and<br />>good test coverage.<br /><br />I tried a while ago to document some parts of the unspoken idioms around compatibility:<br /><br />    http://twistedmatrix.com/trac/wiki/CompatibilityPolicy<br /><br />It's still not done, but hey, as long as we're talking about it, Paul, have a look at the number of entries Conch has in that list near the bottom. ;-)<br /><br /></body></html>