Click là một gói Python để tạo các giao diện dòng lệnh đẹp mắt theo cách có thể kết hợp được với càng ít mã càng tốt. Đó là “Bộ công cụ tạo giao diện dòng lệnh”. Nó có cấu hình cao nhưng đi kèm với các giá trị mặc định hợp lý.
Nó nhằm mục đích làm cho quá trình viết các công cụ dòng lệnh trở nên nhanh chóng và thú vị đồng thời ngăn chặn bất kỳ sự thất vọng nào do không thể triển khai API CLI dự kiến
Bấm vào ba điểm
lồng các lệnh tùy ý
tạo trang trợ giúp tự động
hỗ trợ lười tải các lệnh con khi chạy
Nó trông như thế nào?
import click @click.command[] @click.option['--count', default=1, help='Number of greetings.'] @click.option['--name', prompt='Your name', help='The person to greet.'] def hello[count, name]: """Simple program that greets NAME for a total of COUNT times.""" for x in range[count]: click.echo[f"Hello {name}!"] if __name__ == '__main__': hello[]
Và nó trông như thế nào khi chạy
$ python hello.py --count=3 Your name: John Hello John! Hello John! Hello John!
Nó tự động tạo các trang trợ giúp được định dạng độc đáo
$ python hello.py --help Usage: hello.py [OPTIONS] Simple program that greets NAME for a total of COUNT times. Options: --count INTEGER Number of greetings. --name TEXT The person to greet. --help Show this message and exit.
Bạn có thể lấy thư viện trực tiếp từ PyPI
pip install click
Tài liệu¶
Phần tài liệu này hướng dẫn bạn qua tất cả các kiểu sử dụng của thư viện
- Tại sao nhấp chuột?
- Tại sao không Argparse?
- Tại sao không phải là Docopt, v.v. ?
- Tại sao các hành vi được mã hóa cứng?
- Tại sao không có Auto Correction?
- Bắt đầu nhanh
- virtualenv
- Screencast và ví dụ
- Các khái niệm cơ bản - Tạo một lệnh
- vang vọng
- Lệnh lồng nhau
- Đăng ký lệnh sau
- Thêm tham số
- Chuyển sang Setuptools
- Tích hợp công cụ thiết lập
- Giới thiệu
- Kiểm tra kịch bản
- Tập lệnh trong Gói
- Thông số
- sự khác biệt
- Loại thông số
- Tên thông số
- Triển khai các loại tùy chỉnh
- Tùy chọn
- Đặt tên cho các tùy chọn của bạn
- Tùy chọn giá trị cơ bản
- Tùy chọn đa giá trị
- Tuples dưới dạng tùy chọn đa giá trị
- nhiều lựa chọn
- Đếm
- Cờ Boolean
- Công tắc tính năng
- Lựa chọn Tùy chọn
- nhắc nhở
- Lời nhắc mật khẩu
- Mặc định động cho lời nhắc
- Gọi lại và tùy chọn háo hức
- Có Thông số
- Giá trị từ biến môi trường
- Nhiều giá trị từ các giá trị môi trường
- Các ký tự tiền tố khác
- Tùy chọn phạm vi
- Gọi lại để xác thực
- Giá trị tùy chọn
- Tranh luận
- Đối số cơ bản
- Đối số biến đổi
- Đối số tệp
- Đối số đường dẫn tệp
- An toàn mở tệp
- Biến môi trường
- Đối số giống như tùy chọn
- Lệnh và Nhóm
- Yêu cầu gọi lại
- Truyền tham số
- Xử lý lồng nhau và bối cảnh
- Lệnh trang trí
- Gọi nhóm mà không cần lệnh
- Nhiều lệnh tùy chỉnh
- Hợp nhất nhiều lệnh
- Chuỗi đa lệnh
- Đường ống đa lệnh
- Ghi đè mặc định
- Mặc định bối cảnh
- Giá trị trả về của lệnh
- Lời nhắc đầu vào của người dùng
- Lời nhắc tùy chọn
- Lời nhắc đầu vào
- Lời nhắc xác nhận
- Tập lệnh tài liệu
- Văn bản trợ giúp
- Ngăn chặn gói lại
- Cắt bớt văn bản trợ giúp
- Biến meta
- Lệnh ngắn Trợ giúp
- Trợ giúp Tùy chỉnh thông số
- Ứng dụng phức tạp
- Các khái niệm cơ bản
- Xây dựng bản sao Git
- Mẫu nâng cao
- bí danh lệnh
- Sửa đổi thông số
- Bình thường hóa mã thông báo
- Gọi các lệnh khác
- Lệnh đánh giá gọi lại
- Chuyển tiếp tùy chọn không xác định
- Truy cập bối cảnh toàn cầu
- Phát hiện nguồn của tham số
- Quản lý tài nguyên
- Kiểm tra các ứng dụng nhấp chuột
- Thử nghiệm cơ bản
- Cách ly hệ thống tệp
- Luồng đầu vào
- tiện ích
- In ra thiết bị xuất chuẩn
- Màu ANSI
- Hỗ trợ máy nhắn tin
- Xóa màn hình
- Lấy nhân vật từ Terminal
- Chờ nhấn phím
- Khởi chạy trình chỉnh sửa
- Khởi chạy ứng dụng
- In tên tệp
- Luồng tiêu chuẩn
- Mở tệp thông minh
- Tìm thư mục ứng dụng
- Hiển thị thanh tiến độ
- Hoàn thành vỏ
- Kích hoạt hoàn thành
- Hoàn thành loại tùy chỉnh
- Ghi đè giá trị hoàn thành
- Thêm hỗ trợ cho Shell
- Xử lý ngoại lệ
- Lỗi được xử lý ở đâu?
- Nếu tôi không muốn điều đó thì sao?
- Ngoại lệ nào tồn tại?
- Hỗ trợ Unicode
- Xử lý thay thế
- Ghi chú bảng điều khiển Windows
- Đối số Unicode
- Đầu ra và đầu vào Unicode
Tham chiếu API¶
Nếu bạn đang tìm kiếm thông tin về một hàm, lớp hoặc phương thức cụ thể, thì phần tài liệu này là dành cho bạn