Django-בוס הוא יישום הרעיונות המתוארים בפוסט בבלוג שלי על פקודות ניהול יחידת. עם זאת, אתה יכול לציין פקודות באפליקציות בודדות ולאחר מכן להפעיל אותם באמצעות ממשק שורת הפקודה djboss.
יחידת-בוס התקנה
כרגע, התקנה נעשית באמצעות easy_install Django-בוס או PIP להתקין יחידת-בוס. התנאים המוקדמים רק argparse, התקנה שמתבצע על ידי setuptools, ויחידה, שבו אתה צריך שהותקן על ידי החברה בכל מקרה.
כתיבת פקודות
פקודות מוגדרות כמקרים של djboss.commands.Command, הווה בsubmodule פקודות בתוך אפליקציה מותקנת. לדוגמא, תיקח את פריסת האפליקציה הבאה:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
קובץ commands.py הוא submodule שניתן לייבא כechoapp.commands.
עם Decorators
הבא היא דוגמא מושלמת של קובץ commands.py תקף:
מdjboss.commands לייבא *
command
def שלום (args):
& Nbsp; "" "הדפסת קלישה למסוף." ""
& Nbsp; הדפסה "שלום, העולם!"
דוגמא זו משתמשת במעצבcommand להצהיר כי הפונקציה היא פקודת Django-הבוס. אתה יכול להוסיף טיעונים לפקודות מדי; פשוט להשתמש במעצבargument (לוודא שהם יבואו אחריcommand):
command
argument ('- נ', '--no-שורה חדשה ", פעולה =' store_true ',
& Nbsp; עזרה = "אל לצרף שורה חדשה נגררת.")
def שלום (args):
& Nbsp; "" "הדפסת קלישה למסוף." ""
& Nbsp; אם args.no_newline:
& Nbsp; sys יבוא
& Nbsp; sys.stdout.write ("! שלום, העולם")
& Nbsp; אחר:
& Nbsp; הדפסה "שלום, העולם!"
מעצבargument מקבל כל מה argparse.ArgumentParser.add_argument () עושה; להתייעץ מסמכי argparse לקבלת מידע נוסף.
אתה יכול גם להוסיף הערות פקודות על ידי מתן טיעוני מילות מפתח ל@command:
command (name = "משהו", תיאור = "האם משהו.")
do_something def (args):
& Nbsp; "" ". האם משהו" ""
& Nbsp; "כבר עשה משהו." הדפסה
במקרה זה, את הפקודה תיקרא "משהו" במקום "משהו לעשות-" נוצר באופן אוטומטי, והתיאור שלה יהיה שונה מdocstring. לקבלת מידע נוסף על מה שיכול להיות מועבר לכאן, להתייעץ מסמכי argparse.ArgumentParser.
ללא Decorators
API הוא דומה מאוד בלי מעצבים. כיתת הפיקוד משמשת לעטוף פונקציות, ואתה יכול לתת טיעוני מילת המפתח כאשר הפנייה כעםcommand:
def הד (args):
& Nbsp; ...
הד = פיקוד (הד, שם = '...', תיאור = '... ")
שיטה של add_argument (); הוספת טיעונים משתמש Command.add_argument (שיטה), הנמצאת במרחק התייחסות למשנה המנתח & rsquo שנוצר:
def הד (args):
& Nbsp; ...
הד = פיקוד (הד, שם = '...', תיאור = '... ")
echo.add_argument ('- נ', '--no-שורה חדשה ", ...)
echo.add_argument ("מילות", nargs '*' =)
הפעלת פקודות
פקודות מתבצעות דרך ממשק שורת הפקודה djboss. לשם כך כדי לפעול כראוי, אתה צריך אחד משני דברים:
* משתנה סביבת DJANGO_SETTINGS_MODULE המתייחס למודול תקף, ליבוא פייתון.
* מודול תקף, הגדרות ליבוא בספריית העבודה הנוכחית.
ברגע שאחד מאותם מכוסים, אתה יכול להפעיל אותו:
djboss --help
שימוש: djboss הפקודה [-v] [-h] [רמת -l] ...
פקודות ניהול יחידת-בוס לרוץ.
טיעונים אופציונליים:
& Nbsp; -h, --help יציג הודעת עזרה זה וצא
& Nbsp; -v, מספר הגרסה של --version תכנית המופע ויציאה
& Nbsp; רמת -l, רמה ברמת --log
& Nbsp; בחר רמת יומן מDEBUG, INFO, להזהיר (ברירת מחדל)
& Nbsp; או שגיאה.
פקודות:
& Nbsp; COMMAND
& Nbsp; הד הד הטיעונים חזרה לקונסולה.
& Nbsp; שלום הדפס קלישה לקונסולה.
לגלות תת-פקודות, ממצאי djboss הראשונים ויבוא הגדרות אופטימיות שלך.
משתנה סביבת DJANGO_SETTINGS_MODULE עדיף, אבל אם לא פורטו, djboss יחפש `מודול settings` בספרייה הנוכחית. פקודות צריכה להיות מוגדרות ב` submodule commands` של כל אפליקציה. djboss יחפש כל אחד מINSTALLED_APPS לפקודות ניהול.
כל מיפקדת-המישנה גם מקבלת אפשרות --help:
djboss הד --help
שימוש: djboss הד [מילות [מילות ...]] [-h] [-n]
הד הטיעונים חזרה לקונסולה.
טיעוני positional:
& Nbsp; מילות
טיעונים אופציונליים:
& Nbsp; -h, --help יציג הודעת עזרה זה וצא
& Nbsp; -n, --no-שורה חדשה אין להדפיס שורה חדשה לאחר מכן.
ואז אתה יכול להפעיל אותו:
djboss הד כמה מילות כאן
כמה מילות כאן
עוד מאותו הדבר:
djboss שלום --help
שימוש: djboss שלום [-h]
הדפס קלישה לקונסולה.
טיעונים אופציונליים:
& Nbsp; -h, --help יציג הודעת עזרה זה וצא
ולבסוף:
djboss שלום
! שלום, העולם
דרישות :
- יחידת
- פייתון
תגובות לא נמצא