dm.zdoc

dm.zdoc היא עטיפת Python זעירה סביב pydoc כדי להפוך אותו לשימוש לZope.
הערה: גרסאות מתחת 2.6 Python חסרי תמיכה טובה לחבילות מרחב בpydoc. בעוד Zope עצמו אינו משתמש בחבילות מרחב לפני הגרסה 2.12 (המשתמש בפייתון 2.6), יישומים חשובים Zope (כגון פלון) לעשות שימוש בחבילות מרחב. במקרים אלה, התיעוד המיוצר על ידי pydoc (ועל ידי zdoc הארכה) אינו שלם.
שימוש
zdoc יכול לשמש דרך dmzdoc התסריט, באמצעות יבוא מודול או משולב במופע Zope פועל.
בשני המקרים הראשונים ייתכן שיהיה צורך להגדיר את INSTANCE_HOME Zope משתני הסביבה וSOFTWARE_HOME לספר zdoc בו ניתן למצוא מקורות Zope.
השתמש באמצעות dmzdoc
Dmzdoc התסריט מותקן כאשר יש לך setuptools המותקן.
אחרת, אתה חייב להתקין אותו בעצמך. יש לו את התוכן הבא:
dm.zdoc יבוא; dm.zdoc.cli ()
יש dmzdoc בדיוק את אותו אפשרויות ופרמטרים כpydoc, שתועדו בpydoc.
השתמש באמצעות יבוא מודול
Dm.zdoc מודול מגדיר אותם האובייקטים כpydoc, שתועדו בpydoc.
משולב במופע Zope פועל
לשימוש זה, עליך להתקין את מודול בהתקנת Zope שלך ​​ולהפעיל configure.zcml בעת אתחול Zope. זה ייתן לי "Zope Root Folder" zdoc@@התצוגה המציגה את התיעוד באותו אופן כמו שרת http pydoc.
שים לב: חשיפת התיעוד של מופע Zope בדרך זו מספקת תובנות הגיוניות ויכולה לתת האקרים רמזים חשובים להתקפות. סביר להניח, יהיה עליך להתקין את זה רק במקרים פיתוח עם גישה מוגבלת

מה חדש בהודעה זו :.