<div dir="ltr">I have tried to play with the auto-doc ext and it seems to be half automatic, isn&#39;t there a way to automatically take unit test and make a docuent/html that explains the tests?<br><br><div class="gmail_quote">
On Wed, Aug 19, 2009 at 4:05 PM, Jesse Noller <span dir="ltr">&lt;<a href="mailto:jnoller@gmail.com">jnoller@gmail.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
For test specifications; I&#39;ve tended to use Sphinx (<a href="http://sphinx.pocoo.org" target="_blank">sphinx.pocoo.org</a>)<br>
and the autodoc extension. I tend to document my tests and modules<br>
pretty heavily, and so doing this allows me to extract nice-looking<br>
and easy to use documentation from my tests, and accentuate as needed.<br>
<br>
The nice thing with doing it this way, is that you can add further<br>
examples/notes/etc on top of what is within the test code itself. It<br>
also helps keep you disciplined about documentation on the tests and<br>
any supporting modules. All of the docs are in Restructured Text,<br>
which is close to the perfect markup :)<br>
<div><div></div><div class="h5"><br>
On Wed, Aug 19, 2009 at 7:07 AM, yoav glazner&lt;<a href="mailto:yoavglazner@gmail.com">yoavglazner@gmail.com</a>&gt; wrote:<br>
&gt; Hi all,<br>
&gt; I have a problem in my work, they want me to an &quot;ATP&quot;.<br>
&gt; which means a long Word document that expalains what tests are made.<br>
&gt; no one will ever really read this document.<br>
&gt; i was thinking on making the acceptance tests on top of unittest/pymock/nose<br>
&gt; and generate someting like the ATP,<br>
&gt; from the testFunctions docs.<br>
&gt; is something like this already available?<br>
&gt; Thanks a lot,<br>
&gt; Yoav Glazner<br>
</div></div>&gt; _______________________________________________<br>
&gt; testing-in-python mailing list<br>
&gt; <a href="mailto:testing-in-python@lists.idyll.org">testing-in-python@lists.idyll.org</a><br>
&gt; <a href="http://lists.idyll.org/listinfo/testing-in-python" target="_blank">http://lists.idyll.org/listinfo/testing-in-python</a><br>
&gt;<br>
&gt;<br>
</blockquote></div><br></div>