<html><body><br />On 07:25 pm, itamar@itamarst.org wrote:<br />&gt;&gt; I'm working on tests for t.c.s.session.SSHSession, and it's difficult<br />&gt;&gt; because of the terrible API SSHSession currently has. &#160;I've tried a<br />&gt;&gt; rewrite in branches/session-2710, but I wanted to know if anyone was<br />&gt;&gt; actually using that class directly? &#160;The typical use case is writing<br />&gt;&gt; an Avatar-&gt;ISession adapter, and if you're doing it that way nothing<br />&gt;&gt; should change for you even with this update.<br />&gt;<br />&gt;Rather than removing it, you could e.g. deprecate the old class and then<br />&gt;write a new one (using test-driven development) to ensure a decent API and<br />&gt;good test coverage.<br /><br />I tried a while ago to document some parts of the unspoken idioms around compatibility:<br /><br />&#160; &#160; 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>