Re: [Twisted-Python] High-level view of Twisted

2011-01-31 Thread Jason Heeris
On 1 February 2011 13:58, Kevin Horn wrote: > A couple of us are getting fired up about cleaning up the documentation to > make it easier for those new to Twisted to find what they're looking for, so > please do speak up with any feedback you have. My only suggestion is this: no magic! As per my

Re: [Twisted-Python] High-level view of Twisted

2011-01-31 Thread Kevin Horn
On Mon, Jan 31, 2011 at 10:58 PM, Jason Heeris wrote: > Hi, > > I'd like to come to grips with Twisted, and so far I've been following > and tweaking example after example. But I'm finding it incredibly hard > to get a high level view of the Twisted "landscape" — and because I > don't know what I

Re: [Twisted-Python] High-level view of Twisted

2011-01-31 Thread Jason Heeris
On 1 February 2011 13:15, Andrew Bennetts wrote: > Jason Heeris wrote: > [...] >> 2. What is a Factory, anyway? What are they *for*? > > > says: Oh, and I also has a link to a "client writing howto"[1], which was one of

Re: [Twisted-Python] High-level view of Twisted

2011-01-31 Thread Jason Heeris
On 1 February 2011 13:15, Andrew Bennetts wrote: > Jason Heeris wrote: > [...] >> 2. What is a Factory, anyway? What are they *for*? > > (I couldn't resist the opportunity to link to the glossary after the recent > thread about it...) I completely missed the glossary somehow, thanks :) — Jason

Re: [Twisted-Python] High-level view of Twisted

2011-01-31 Thread Andrew Bennetts
Jason Heeris wrote: [...] > 2. What is a Factory, anyway? What are they *for*? says: In general, an object that constructs other objects. In Twisted, a Factory usually refers to a twisted.internet.protocol.Factory,

[Twisted-Python] High-level view of Twisted

2011-01-31 Thread Jason Heeris
Hi, I'd like to come to grips with Twisted, and so far I've been following and tweaking example after example. But I'm finding it incredibly hard to get a high level view of the Twisted "landscape" — and because I don't know what I don't know, it's hard to know what questions to even ask. I want t

Re: [Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Glyph Lefkowitz
On Jan 31, 2011, at 3:07 PM, Jonathan Jacobs wrote: > On Tue, Feb 1, 2011 at 00:25, Glyph Lefkowitz wrote: >> Nevertheless, it isn't present in Twisted yet and so it should have a 'tx' >> name until that point. If he really wanted to get 'twisted' into the name, >> the branch should have been l

Re: [Twisted-Python] Task-based documentation started

2011-01-31 Thread exarkun
On 10:39 pm, t...@recursivedream.com wrote: > >Take < >http://twistedmatrix.com/documents/10.2.0/web/howto/web-in-60/static- >content.html >>: > >Tell me the one command I need to serve a directory, *then* show me the >code >that one command effectively runs and vaguely what it does. I think thi

Re: [Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Jonathan Jacobs
On Tue, Feb 1, 2011 at 00:25, Glyph Lefkowitz wrote: > Nevertheless, it isn't present in Twisted yet and so it should have a 'tx' > name until that point.  If he really wanted to get 'twisted' into the name, > the branch should have been lp:~jjacobs/twisted/enum instead :). There was no real deci

Re: [Twisted-Python] Task-based documentation started

2011-01-31 Thread Tom Davis
On Mon, Jan 31, 2011 at 5:22 PM, Glyph Lefkowitz wrote: > > On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > > Thoughts? > > > I'll have to write more later, but maybe you should read *all* of the > existing twisted.web documentation first? I am sorry to say it, but this > seems like a less infor

Re: [Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Glyph Lefkowitz
On Jan 31, 2011, at 5:57 AM, Tristan Seligmann wrote: > On Mon, Jan 31, 2011 at 3:15 PM, Itamar Turner-Trauring > wrote: >> On Mon, 2011-01-31 at 12:31 +0200, Jonathan Jacobs wrote: >> >>> The current code is hosted on Launchpad [2] and the source code is >>> viewable on the web [3]. >> >> One

Re: [Twisted-Python] Task-based documentation started

2011-01-31 Thread Glyph Lefkowitz
On Jan 31, 2011, at 11:41 AM, Tom Davis wrote: > Thoughts? I'll have to write more later, but maybe you should read all of the existing twisted.web documentation first? I am sorry to say it, but this seems like a less informative and more confusing version of

Re: [Twisted-Python] Using SerialPort with t.a.s.Application

2011-01-31 Thread exarkun
On 03:50 pm, albert.bra...@weiermayer.com wrote: >Hi! > >I'm quite happy that my question (or really: Itamar's answer) triggered >the interesting discussion about glossaries. But there are some aspects >about SerialPort that are not yet clear to me. So I'm trying to reclaim >this thread ;-). > >On

[Twisted-Python] Task-based documentation started

2011-01-31 Thread Tom Davis
I have the beginnings of some task-based documentation available in twisted-docs (https://github.com/tdavis/twisted-docs) now. You can find the built version in the usual place (http://docs.recursivedream.com/twisted/) -- just remember to bust the cache. I chose serving web content as a starting p

Re: [Twisted-Python] Using SerialPort with t.a.s.Application

2011-01-31 Thread Albert Brandl
Hi! I'm quite happy that my question (or really: Itamar's answer) triggered the interesting discussion about glossaries. But there are some aspects about SerialPort that are not yet clear to me. So I'm trying to reclaim this thread ;-). On Fri, Jan 28, 2011 at 08:25:52AM -0500, Itamar Turner-T

Re: [Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Tristan Seligmann
On Mon, Jan 31, 2011 at 3:15 PM, Itamar Turner-Trauring wrote: > On Mon, 2011-01-31 at 12:31 +0200, Jonathan Jacobs wrote: > >> The current code is hosted on Launchpad [2] and the source code is >> viewable on the web [3]. > > One comment unrelated to the actual code: we prefer people don't prefix

Re: [Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Itamar Turner-Trauring
On Mon, 2011-01-31 at 12:31 +0200, Jonathan Jacobs wrote: > The current code is hosted on Launchpad [2] and the source code is > viewable on the web [3]. One comment unrelated to the actual code: we prefer people don't prefix their projects with "twisted", to prevent confusion. The suggested pref

[Twisted-Python] A Python enum library with a Twist

2011-01-31 Thread Jonathan Jacobs
Hi, First off there isn't actually a twist, it's just for Twisted addressing the points in #4671 [1]. Sorry to disappoint. Secondly I realise there are already at least a thousand Python enum libraries, most of which I haven't explored, feel free to mention these with supporting arguments. My poi