2010-06-04 3 views
14

Da un po 'di tempo guardo in giro. Sembra interessante: sembra un buon modo per sfruttare molta potenza quando si scrivono server. Sfortunatamente, nonostante abbia scritto alcuni server web usando twisted.web (leggendo la fonte di altre persone e un libro O'Reilly estremamente datato), non mi sono mai sentito veramente come se avessi raggiunto un'affinità con una torsione ... un livello di comprensione che in realtà ha dato a me il un po 'del potere che sembra abbia.Esiste una documentazione completa e approfondita su Twisted che sia migliore del sito ufficiale?

Penso di aver bisogno di una buona documentazione per arrivare ad un migliore livello di comprensione - Semplicemente non ho il tempo di sondare la fonte, e altri thread su SO hanno menzionato twisted's official documentation, che è irregolare al meglio, assente a peggio, e occasionalmente molto antiquato.

C'è qualcos'altro là fuori che è più completo, più indulgente e più utile, o sono bloccato con un altro classico, noioso STFU e RTFM anche se TFM non è utile?


Aggiornamento

In risposta al commento di JP Calderone che sto avendo solo una cagna, in una certa misura credo che io sono, ma penso che l'ampiezza della domanda è valida considerando l'ampiezza e il valore di Twisted e la mancanza di documentazione evidente e approfondita. Ho in mente alcune cose che volevo indagare, ma ho ottenuto risultati soddisfacenti semplicemente hackerando le cose insieme e chiedendo dei dettagli quando una comprensione più profonda e ampia è ciò che sto cercando è, nella mia mente, non utile .

Il contrasto che mi viene immediatamente in mente è Django ... Riesco a leggere la documentazione (molto approfondita) di Django e non necessariamente sapere come fare tutto ciò che può fare immediatamente, ma posso ottenere una buona panoramica di come Potrei fare tutto ciò che dovevo fare e sapere esattamente dove guardare quando arriva il momento.

+5

Se tu fossi più specifico su ciò che vuoi capire, qualcuno potrebbe essere in grado di riferirti ad una documentazione che potrebbe darti quella comprensione. Solo dicendo che vuoi capire "Twisted" significa che la migliore risposta disponibile è leggere la documentazione Twisted. Chiaramente c'è qualcosa di specifico che cerchi, ma non hai detto di cosa si tratta. In questo modo, questa "domanda" si presenta come una scusa per lamentarsi della documentazione di Twisted, non una domanda utile o interessante. Puoi modificarlo per chiedere qualcosa di più significativo e possibile rispondere? –

+1

Wow, non mi aspettavo di sentire uno dei principali contributori al progetto! Sì, credo di avere un po 'di sfogo ma penso che la domanda sia ancora valida. Twisted sembra davvero fantastico ed è stato molto utile per me, ma la documentazione è un enorme buco in un progetto molto degno. C'è qualche piano per mettere in forma la documentazione (specialmente ora che la cosa web e web2 è ordinata per sempre)? Sarei d'aiuto ma sono ancora (ovviamente) piuttosto nuovo ad esso. Inoltre, "non c'è" è una risposta accettabile se questo è effettivamente il caso. – Shabbyrobe

risposta

15

Ripeterò ciò che alcuni degli intervistati hanno detto (sono tutte buone risposte) nella speranza di fornire una risposta che sia abbastanza esauriente.

  1. Mentre la documentazione inclusa è macchiata nei punti, the core documentation contiene numerose introduzioni utili e brevi ai concetti di base in Twisted. In particolare, vedere Using Deferreds, Writing Clients e Writing Servers.
  2. Inoltre, lo API documentation - in particolare la documentazione in interface modules - è sempre più completo e coerente con ogni versione successiva.
  3. Se sei interessato a una descrizione di livello superiore degli obiettivi e della progettazione di Twisted in modo da sapere come affrontare alcuni di questi altri documenti, I co-authored a paper presented at USENIX 2003 con Itamar Turner-Trauring.
  4. Twisted's FAQ è anche un po 'tortuoso, ma può aiutare con molti ostacoli che le persone colpiscono quando si lavora attraverso il materiale introduttivo.
  5. Il O'Reilly book about Twisted ha alcuni grandi esempi che possono ulteriormente chiarire concetti fondamentali come Deferreds e Reactor.
  6. Jean-Paul Calderone's "Twisted Web In 60 Seconds" tutorials sono una buona introduzione al twisted.web un po 'più elevato, ovviamente, ma vedrai anche molti schemi utili ripetuti durante il quale potrebbero esserti utili in qualunque applicazione tu stia scrivendo.
  7. Ho scritto un paio di articoli su blocchi predefiniti utilizzati all'interno di Twisted, su deal with the filesystem e su load plugins.
  8. Ultimo ma sicuramente non ultimo, Dave Peticolas's modestly titled "Twisted Intro" è una descrizione molto completa, con diagrammi e aneddoti, sul materiale introduttivo a cui così tante persone hanno difficoltà.

Si noti inoltre che tutte le nuove funzionalità vengono fornite con la nuova documentazione API (ad esempio riferimento); speriamo che questo renderà più ragionevole per le persone con abilità di scrittura tecnica scrivere documentazione senza dover lottare fino a comprendere anche cosa significano i nomi dei metodi.

2

Verifica Twisted Web in 60 seconds di Jean-Paul Calderone!

Ma, onestamente, la documentazione ufficiale di Twisted non è perfetta ma non la chiamerò disgustosa. Ci sono molte informazioni preziose in esso.

+0

Sì, bel poliziotto. Era inutilmente infiammatorio. L'ho cambiato, ma non troppo. È * piuttosto male in alcuni punti. – Shabbyrobe

7

Il Twisted Intro da Dave Peticolas è un sorprendente panoramica di Twisted da zero. Inizia semplice e poi inizia a diventare sempre più profondo mentre spiega tutto lungo la strada.

Ho usato Twisted per anni e ho trovato questa intro per colmare tutte quelle lacune che mi mancavano e far luce su tutto. Sicuramente vale la pena di darci un'occhiata!