Re: [Twisted-Python] Deferred documentation rewrite

2009-08-05 Thread Glyph Lefkowitz
On Mon, Aug 3, 2009 at 6:00 PM, Edward Z. Yang wrote: > I have updated my draft here: > >http://ezyang.com/twisted/defer2.html > Thanks. Looks like it's improving. I've got more points to critique now, but that's only because there's more meat to the tutorial now :). 1. The coding stan

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-04 Thread Edward Z. Yang
Thanks! I've updated the docs accordingly. Cheers, Edward ___ Twisted-Python mailing list Twisted-Python@twistedmatrix.com http://twistedmatrix.com/cgi-bin/mailman/listinfo/twisted-python

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-04 Thread Ying Li
In the Callbacks and errbacks section: "Notice that in the synchronous version, process is inside the try..except block. This translates over to the asynchronous code: if process throws an exception, handle_twisted will get a Failure object..." : I think you may mean "handle_twisted_error", not "ha

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-04 Thread Don Dwiggins
Andrew Francis wrote: > Simple definition: In a synchronous call, the caller blocks until a result is > ready. Upon return the next statement is executed (barring something like an > exception). In an asynchronous call, the caller does not wait for a result > and continues. Just a thought on te

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-04 Thread Andrew Francis
Hi Edward: Message: 2 Date: Mon, 03 Aug 2009 18:00:07 -0400 From: "Edward Z. Yang" Subject: Re: [Twisted-Python] Deferred documentation rewrite To: Twisted general discussion Message-ID: <1249336297-sup-7...@javelin> Content-Type: text/plain; charset=UTF-8 >Why callbacks

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-03 Thread Dave Britton
- Original Message - From: "Edward Z. Yang" To: "Twisted general discussion" Sent: Monday, August 03, 2009 6:00 PM Subject: Re: [Twisted-Python] Deferred documentation rewrite I like the side-by-side regular and twisted versions, that's helpful

Re: [Twisted-Python] Deferred documentation rewrite

2009-08-03 Thread Edward Z. Yang
I have updated my draft here: http://ezyang.com/twisted/defer2.html The most notable change is I've removed the section "From Synchronous to Asynchronous". I believe (and I think other people agree with me) that this is an important topic to cover, but it's really *hard* to teach asynchronou

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Glyph Lefkowitz
On Fri, Jul 31, 2009 at 6:40 PM, Edward Z. Yang wrote: > You can view an initial draft of the rewrite here: This is a great first draft! Very substantial. I really appreciate you working on this. Now I will proceed to rip it to shreds by way of giving you some feedback, but please try to tak

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Itamar Shtull-Trauring
On Fri, 2009-07-31 at 18:40 -0400, Edward Z. Yang wrote: > You can view an initial draft of the rewrite here: > > http://ezyang.com/twisted/defer2.html > > For reference, this is the planned outline (X means done, ? means > almost done): > > X Synchronous to Asynchronous: The Method to the Madne

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Edward Z. Yang
You can view an initial draft of the rewrite here: http://ezyang.com/twisted/defer2.html For reference, this is the planned outline (X means done, ? means almost done): X Synchronous to Asynchronous: The Method to the Madness X Convert synchronous code to asynchronous code X Why asynchro

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Kevin Horn
On Fri, Jul 31, 2009 at 9:07 AM, Terry Jones wrote: > > "Michael" == Michael Hudson writes: > Michael> The accompanying paper is here: > http://mumak.net/stuff/twisted-intro.html > > I agree, that's a really nicely done document. It would be good to extend > it, moving into a description an

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-31 Thread Terry Jones
> "Michael" == Michael Hudson writes: Michael> The accompanying paper is here: http://mumak.net/stuff/twisted-intro.html I agree, that's a really nicely done document. It would be good to extend it, moving into a description and explanation of deferreds. Terry

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Dave Britton
- Original Message - From: "Michael Hudson" To: "Twisted general discussion" The accompanying paper is here: http://mumak.net/stuff/twisted-intro.html Thanks for this incredibly helpful link! -Dave ___ Twisted-Python mailing list Twisted-Pyt

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Nitro
Am 30.07.2009, 23:45 Uhr, schrieb Kevin Horn : > Thanks for this, Terry. I'd never thought of it that way, and it's > quite a > good point. I agree. I've come to think it's partially a fault of using normal text based editors. Those fit the programming models from 30 years ago well, but to

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Michael Hudson
2009/7/31 ezyang : > Excerpts from Jamu Kakar's message of Thu Jul 30 15:03:16 -0400 2009: >> Jono Lange gave a presentation recently (can't remember what it was >> called... maybe something about being an evil hacker or about how >> your code sucks and he hates you) where he presented step-by-step

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Kevin Horn
On Thu, Jul 30, 2009 at 4:27 PM, Terry Jones wrote: > > Right. Everything you could do synchronously, you can do asynchronously > > (and a bit more too). It just /looks/ really weird. > > At some point I realized that it helps to realize that code that looks > synchronous really isn't at all. P

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Terry Jones
> Right. Everything you could do synchronously, you can do asynchronously > (and a bit more too). It just /looks/ really weird. At some point I realized that it helps to realize that code that looks synchronous really isn't at all. Probably all the programming that almost all of us will ever do

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread ezyang
Excerpts from Jamu Kakar's message of Thu Jul 30 15:03:16 -0400 2009: > Your outline looks nice. Something that *really* helped me a lot > with Deferreds was seeing how they are modelled after standard > Python flow control behaviour. I guess that's what the first > section your proposing is abou

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Kevin Horn
This looks really great...looking forward to the results! Kevin Horn On Thu, Jul 30, 2009 at 2:03 PM, Jamu Kakar wrote: > Hi Edward, > > On Thu, Jul 30, 2009 at 11:24 AM, Edward Z. Yang wrote: > > I have been prodded by the members of #twisted into rewriting the > > Deferred documentation. You

Re: [Twisted-Python] Deferred documentation rewrite

2009-07-30 Thread Jamu Kakar
Hi Edward, On Thu, Jul 30, 2009 at 11:24 AM, Edward Z. Yang wrote: > I have been prodded by the members of #twisted into rewriting the > Deferred documentation.  You can check out the plan at this > ticket: > > http://twistedmatrix.com/trac/ticket/3943 > > Comments would be appreciated. Your outl