django-boss

django-ông chủ là một thực hiện các ý tưởng được nêu trong bài viết trên blog của tôi trên các lệnh quản lý Django. Với nó, bạn có thể chỉ định các lệnh trong các ứng dụng cá nhân và sau đó chạy chúng bằng cách sử dụng giao diện dòng lệnh djboss.
Cài đặt django-boss
Tại thời điểm này, trình cài đặt được thực hiện thông qua easy_install django-boss hoặc pips cài đặt django-boss. Các điều kiện tiên quyết duy nhất là argparse, có cài đặt được xử lý bởi setuptools, và Django, mà bạn nên đã cài đặt bằng bây giờ anyway.
Commands Viết
Lệnh được quy định như trường hợp của djboss.commands.Command, hiện diện trong một submodule lệnh bên trong một ứng dụng được cài đặt. Ví dụ, có những cách bố trí ứng dụng sau đây:
echoapp /
| - __init__.py
| - Commands.py
`- Models.py
Các tập tin commands.py là một submodule có thể được nhập khẩu như echoapp.commands.
Với trang trí
Sau đây là một ví dụ hoàn chỉnh của một tập tin commands.py hợp lệ:
từ djboss.commands nhập khẩu *
command
def hello (args):
& Nbsp; "" "In một sáo ngữ để giao diện điều khiển." ""
& Nbsp; print "Hello, World!"
Ví dụ này sử dụng trang trícommand để tuyên bố rằng các chức năng là một lệnh django-boss. Bạn có thể thêm tham số cho lệnh quá; chỉ cần sử dụng các trang tríargument (chắc chắn rằng họ đến sau khi cáccommand):
command
argument ('- n', '--no-newline', action = 'store_true',
& Nbsp; giúp đỡ = "Đừng thêm một dòng mới theo sau.")
def hello (args):
& Nbsp; "" "In một sáo ngữ để giao diện điều khiển." ""
& Nbsp; nếu args.no_newline:
& Nbsp; sys nhập khẩu
& Nbsp; sys.stdout.write ("Hello, World")
& Nbsp; khác:
& Nbsp; print "Hello, World!"
Các trang tríargument chấp nhận bất cứ điều gì argparse.ArgumentParser.add_argument () nào; tham khảo tài liệu argparse để biết thêm thông tin.
Bạn cũng có thể chú thích các lệnh bằng cách cho đối số từ khóa đểcommand:
command (name = "cái gì đó", mô tả = "Liệu điều gì đó.")
def do_something (args):
& Nbsp; "" ". Làm điều gì đó" ""
& Nbsp; in "một cái gì đó đã được thực hiện."
Trong trường hợp này, lệnh sẽ được gọi là "cái gì đó" thay vì tự động tạo ra "làm-gì đó", và mô tả của chúng sẽ khác nhau từ docstring của nó. Để biết thêm thông tin về những gì có thể được thông qua tại đây, tham khảo tài liệu argparse.ArgumentParser.
Nếu không có trang trí
Các API là rất tương tự mà không cần trang trí. Lớp Command được sử dụng để bọc các chức năng, và bạn có thể cho đối số từ khóa khi gọi nó như vớicommand:
def echo (args):
& Nbsp; ...
tiếng vang = Command (echo, name = '...', mô tả = '...')
Thêm đối số sử dụng Command.add_argument () phương pháp, mà chỉ là một tham chiếu đến tạo sub-parser & rsquo; s add_argument () phương pháp:
def echo (args):
& Nbsp; ...
tiếng vang = Command (echo, name = '...', mô tả = '...')
echo.add_argument ('- n', '--no-newline', ...)
echo.add_argument ('từ', nargs = '*')
Chạy lệnh
Lệnh được thực hiện thông qua giao diện dòng lệnh djboss. Đối với điều này để chạy một cách chính xác, bạn cần có một trong hai điều:
* Một biến môi trường DJANGO_SETTINGS_MODULE trong đó đề cập đến một mô-đun có thể nhập cảng Python hợp lệ.
* A có giá trị, các thiết lập có thể nhập cảng module trong thư mục làm việc hiện tại.
Một khi một trong những người được bảo hiểm, bạn có thể chạy nó:
djboss --help
cách sử dụng: djboss [h] [v] [LEVEL -l] COMMAND ...
Chạy các lệnh quản lý django-boss.
đối số tùy chọn:
& Nbsp; -h, --help hiển thị thông báo và thoát ra trợ giúp này
& Nbsp; -v, số phiên bản --version chương của chương trình và thoát
& Nbsp; LEVEL -l, --log cấp CẤP
& Nbsp; Chọn một mức độ đăng nhập từ DEBUG, INFO, WARN (mặc định)
& Nbsp; hoặc ERROR.
lệnh:
& Nbsp; COMMAND
& Nbsp; tiếng vang Echo các đối số trở lại giao diện điều khiển.
& Nbsp; xin chào In một sáo ngữ để giao diện điều khiển.
Để khám phá tiểu lệnh, phát hiện đầu tiên djboss và nhập khẩu các thiết lập Django của bạn.
Các biến môi trường DJANGO_SETTINGS_MODULE được ưu tiên, nhưng nếu không xác định, djboss sẽ tìm một module `settings` trong thư mục hiện hành. Lệnh cần phải được định nghĩa trong một `submodule commands` của mỗi ứng dụng. djboss sẽ tìm kiếm mỗi INSTALLED_APPS của bạn cho các lệnh quản lý.
Mỗi subcommand được một tùy chọn --help quá:
djboss vang --help
cách sử dụng: djboss vang [h] [-n] [từ [lời nói ...]]
Echo luận trở lại giao diện điều khiển.
đối số vị trí:
& Nbsp; từ
đối số tùy chọn:
& Nbsp; -h, --help hiển thị thông báo và thoát ra trợ giúp này
& Nbsp; -n, --no-newline Không in một dòng mới sau đó.
Và sau đó bạn có thể chạy nó:
djboss vang vọng một số từ ở đây
một số từ ở đây
Thêm sự giống nhau:
djboss chào --help
cách sử dụng: djboss chào [h]
In một sáo ngữ để giao diện điều khiển.
đối số tùy chọn:
& Nbsp; -h, --help hiển thị thông báo và thoát ra trợ giúp này
Và cuối cùng:
djboss chào
Xin chào, thế giới

Yêu cầu :

• Django
• Python