2010-06-04 7 views
14

Tôi đã nhìn vào một lúc. Nó trông thú vị - nó có vẻ như một cách tốt để tận dụng rất nhiều quyền lực khi viết máy chủ. Thật không may, mặc dù viết một vài máy chủ web bằng cách sử dụng twisted.web (từ đọc nguồn của người khác và một cuốn sách O'Reilly cực kỳ ngày) Tôi chưa bao giờ thực sự cảm thấy như tôi đã đạt được một mối quan hệ với xoắn ... một mức độ hiểu biết thực tế là đã cung cấp cho tôi một số quyền lực có vẻ như nó có.Có tài liệu toàn diện, rộng về Twisted tốt hơn trang web chính thức không?

Tôi nghĩ rằng tôi cần một số tài liệu tốt để đạt được mức độ hiểu biết tốt hơn - tôi chỉ đơn giản là không có thời gian để tìm hiểu nguồn gốc, và các chủ đề khác trên SO đã đề cập đến twisted's official documentation. tồi tệ nhất, và đôi khi rất lỗi thời.

Có điều gì khác ngoài đó triệt để hơn, tha thứ hơn và hữu ích hơn không, hoặc tôi có mắc kẹt với một STFU và RTFM nhàm chán cổ điển mặc dù TFM không hữu ích không?


Cập nhật

Đáp lại bình luận JP Calderone rằng tôi chỉ có một con chó cái, ở một mức độ nào đó tôi đoán tôi, nhưng tôi nghĩ rằng bề rộng của câu hỏi là hợp lệ xem xét bề rộng và giá trị của Twisted và thiếu tài liệu rõ ràng, kỹ lưỡng. Tôi có một vài điều trong tâm trí rằng tôi muốn điều tra, nhưng tôi đã nhận được kết quả OK chỉ hack những thứ với nhau và yêu cầu cụ thể khi một sâu hơn, rộng hơn sự hiểu biết là những gì tôi đang tìm kiếm, trong tâm trí của tôi, không hữu ích .

Sự tương phản ngay lập tức nảy ra trong đầu là Django ... Tôi có thể đọc qua tài liệu Django (rất kỹ lưỡng) và không nhất thiết biết cách làm mọi thứ ngay lập tức, nhưng tôi có thể có được cái nhìn tổng quan về làm thế nào Tôi có thể làm tất cả mọi thứ tôi cần làm, và biết chính xác nơi để tìm khi thời gian đến.

+5

Nếu bạn cụ thể hơn về những gì bạn muốn hiểu, ai đó có thể giới thiệu bạn với một số tài liệu có thể cung cấp cho bạn sự hiểu biết đó. Chỉ cần nói rằng bạn muốn hiểu "Xoắn" có nghĩa là câu trả lời tốt nhất hiện có là đọc tài liệu Xoắn. Rõ ràng có một cái gì đó cụ thể bạn đang sau, nhưng bạn đã không nói nó là gì. Như vậy, "câu hỏi" này là một lý do để khiếu nại về tài liệu của Twisted, không phải là một câu hỏi hữu ích hay thú vị. Bạn có thể chỉnh sửa nó để hỏi một cái gì đó có ý nghĩa hơn và có thể trả lời? –

+1

Wow, tôi không mong đợi được nghe từ một trong những người đóng góp chính cho dự án! Có, tôi đoán tôi đang có một chút lỗ thông hơi nhưng tôi nghĩ rằng câu hỏi vẫn còn hợp lệ. Twisted có vẻ khá tuyệt vời và nó rất hữu ích với tôi, nhưng tài liệu là một lỗ hổng lớn trong một dự án rất xứng đáng. Có kế hoạch nào để lấy tài liệu thành hình dạng (đặc biệt là khi web và web2 được sắp xếp tốt)? Tôi sẽ giúp nhưng tôi vẫn (rõ ràng) khá mới mẻ với nó. Ngoài ra, "không có" là một câu trả lời chấp nhận được nếu đó thực sự là trường hợp. – Shabbyrobe

Trả lời

15

Tôi sẽ lặp lại những gì một số người trả lời ở đây đã nói (tất cả đều là câu trả lời hay) với hy vọng cung cấp câu trả lời có phần toàn diện.

  1. Trong khi tài liệu được bao gồm có vị trí tại chỗ, the core documentation chứa một số giới thiệu hữu ích và ngắn gọn về các khái niệm cơ bản trong Twisted. Đặc biệt, xem Using Deferreds, Writing ClientsWriting Servers.
  2. Ngoài ra, API documentation - đặc biệt là tài liệu trong interface modules - ngày càng triệt để và mạch lạc với mỗi bản phát hành tiếp theo.
  3. Nếu bạn quan tâm đến mô tả cấp cao hơn về mục tiêu và thiết kế của Twisted để bạn biết cách tiếp cận một số tài liệu khác này, I co-authored a paper presented at USENIX 2003 với Itamar Turner-Trauring.
  4. Twisted's FAQ cũng là một chút uốn khúc, nhưng có thể giúp bạn với nhiều trở ngại mà mọi người gặp phải khi làm việc theo cách của họ thông qua tài liệu giới thiệu.
  5. O'Reilly book about Twisted có một số ví dụ tuyệt vời có thể làm sáng tỏ thêm các khái niệm cốt lõi như Hoãn và Lò phản ứng.
  6. Jean-Paul Calderone's "Twisted Web In 60 Seconds" tutorials là một phần giới thiệu tốt về mức xoắn cao hơn một chút, tất nhiên, nhưng bạn cũng sẽ thấy nhiều mẫu hữu ích lặp đi lặp lại trong suốt có thể hữu ích cho bạn trong bất kỳ ứng dụng nào bạn đang viết.
  7. Tôi đã viết một cặp bài viết về các khối xây dựng được sử dụng trong Twisted, đến deal with the filesystem và đến load plugins.
  8. Cuối cùng nhưng chắc chắn không kém, Dave Peticolas's modestly titled "Twisted Intro" là mô tả rất toàn diện, có sơ đồ và giai thoại, trên tài liệu giới thiệu mà rất nhiều người gặp khó khăn.

Cũng xin lưu ý rằng tất cả chức năng mới đi kèm với tài liệu API mới (tức là tham chiếu); chúng tôi hy vọng rằng điều này sẽ làm cho nó hợp lý hơn cho những người có kỹ năng viết kỹ thuật để viết tài liệu mà không cần phải đấu tranh thông qua ngay cả việc hiểu ý nghĩa của tên phương thức.

2

Kiểm tra Twisted Web in 60 seconds bởi Jean-Paul Calderone!

Nhưng, thành thực, tài liệu chính thức của Twisted không hoàn hảo nhưng tôi sẽ không gọi nó là kinh tởm. Có rất nhiều thông tin giá trị trong đó.

+0

Đúng, cảnh sát công bằng. Đó là viêm không cần thiết. Tôi đã thay đổi nó, nhưng không quá nhiều. Nó * là * khá xấu ở những nơi. – Shabbyrobe

7

Các Twisted Intro bởi Dave Peticolas là một tuyệt vời tổng quan của Twisted từ mặt đất lên. Nó bắt đầu đơn giản và sau đó bắt đầu nhận được sâu hơn và sâu hơn trong khi giải thích tất cả mọi thứ trên đường đi.

Tôi đã sử dụng Twisted trong nhiều năm và tìm thấy phần giới thiệu này để điền vào tất cả những khoảng trống tôi đã bỏ lỡ và làm sáng tỏ toàn bộ sự việc. Chắc chắn giá trị thời gian của bạn để kiểm tra xem nó ra!