<div class="gmail_quote">On Tue, Nov 17, 2009 at 1:16 PM, <span dir="ltr"><<a href="mailto:exarkun@twistedmatrix.com">exarkun@twistedmatrix.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
<div><div></div><div class="h5">On 06:00 pm, <a href="mailto:kevin.horn@gmail.com">kevin.horn@gmail.com</a> wrote:<br>
>On Tue, Nov 17, 2009 at 4:00 AM, lasizoillo <<a href="mailto:lasizoillo@gmail.com">lasizoillo@gmail.com</a>><br>
>wrote:<br>
>>2009/11/11 Kevin Horn <<a href="mailto:kevin.horn@gmail.com">kevin.horn@gmail.com</a>>:<br>
>> ><br>
>> > I have written up a proposal here:<br>
>> ><br>
>> > <a href="http://twistedsphinx.funsize.net/proposal.html" target="_blank">http://twistedsphinx.funsize.net/proposal.html</a><br>
>> ><br>
>><br>
>>In this proposal you say:<br>
>><br>
>>Development Work<br>
>> * fabric fabfile for automation of docs workflow<br>
>><br>
>>Future Work<br>
>> * This page has some stuff on using cog in RestructuredText comments<br>
>>to generate the output of sample scripts.<br>
>><br>
>>The second point (in Future Work) uses cog that is integrated in<br>
>>paver:<br>
>> * Paver allow automation of docs workflow (fabric is not needed).<br>
>> * With paver you can create an bootstraped instalation:<br>
>><br>
>><a href="http://www.blueskyonmars.com/projects/paver/getting_started.html#but-" target="_blank">http://www.blueskyonmars.com/projects/paver/getting_started.html#but-</a><br>
>>people-don-t-have-paver-yet<br>
>> * Paver is compatible with setuptools and distutils.<br>
>><br>
>>I think that fabric is great for cluster distributions, but paver is<br>
>>better for manage docs.<br>
>><br>
>>Regards,<br>
>> Javi<br>
>For the moment, I plan to continue using fabric, for the following<br>
>reasons:<br>
><br>
>- I'm already familiar with it<br>
>- it does what I need (run local commands, and send stuff over SSH)<br>
><br>
>I think Paver might be very useful down the road, though. I'll<br>
>definitely<br>
>check into it more as this project progresses.<br>
<br>
</div></div>Paver and fabric and such are only significant for the conversion,<br>
though, right?<br>
<br>
Jean-Paul<br>
<div><div></div><div class="h5"><br></div></div></blockquote><div><br>Yes. For right now at least, this is the case.<br><br>I think one or the other should probably be used in the future to automate/streamline Twisted releases, since this has been a long-standing desire of the development team (at least that's my perception...and there are a couple of tickets in Trac about it). This would prevent maintenance of yet another homegrown Twisted tool to perform said automation.<br>
<br>But that's a discussion for another day. Or at least another thread. <br><br>Right now I'm using fabric strictly as a (mostly) platform-neutral alternative to shell scripts (or some other solution) to be able to convert docs to ReST, build the Sphinx project, and deploy them to the server (sort of...still working out some kinks) with a single command. Once the conversion takes place (assuming this project is successful) much of my current need for it will go away, though it still might be useful for other things (as I mentioned above).<br>
<br>Kevin Horn<br></div></div><br>