Cornice

Cornice cung cấp một lớp dịch vụ, bạn có thể sử dụng để xác định các dịch vụ web trong kim tự tháp.
Mỗi thể hiện của một lớp dịch vụ tương ứng với một đường dẫn máy chủ và bạn có thể thực hiện các phương pháp khác nhau HTTP trên con đường với trang trí đơn giản.
Cornice sẽ tự động trả về một lỗi 405 với quyền phép tiêu đề nếu một phương pháp mà không được thực hiện được yêu cầu.
Cornice cũng cung cấp một chỉ thị Sphinx có thể được dùng để ghi nhận các dịch vụ web của bạn. Việc lặp mở rộng các dịch vụ được định nghĩa và sẽ tự động tạo ra tài liệu dịch vụ web của bạn.
QuickStart
Để sử dụng Cornice, bắt đầu bằng bao gồm nó trong dự án của bạn với ** ** bao gồm phương pháp trong Kim tự tháp:
& Nbsp; & nbsp; & nbsp; def chính (global_config, ** cài đặt):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; config.include ("gờ")
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; ...
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; trở config.make_wsgi_app ()
Tìm hiểu thêm về bao gồm ít http://docs.pylonsproject.org/projects/pyramid/1.0/narr/advconfig.html#including-configuration-from-external-sources
Sau đó, bạn có thể bắt đầu để xác định các dịch vụ web trong quan điểm của bạn.
Ví dụ, hãy định nghĩa một dịch vụ mà bạn có thể ** GET ** và ** ** POST một giá trị tại ** / giá trị / {value} **, nơi giá trị * * là một giá trị ascii đại diện cho tên của các giá trị:
& Nbsp; & nbsp; & nbsp; json nhập khẩu
& Nbsp; & nbsp; & nbsp; Dịch vụ nhập khẩu từ cornice
& Nbsp; & nbsp; & nbsp; Dịch vụ giá trị = (name = 'foo', path = '/ giá trị / {value}',
                     Mô tả = "Cornice Demo")
& Nbsp; & nbsp; & nbsp; _VALUES = {}
& Nbsp; & nbsp; & nbsp; @ Values.get ()
& Nbsp; & nbsp; & nbsp; def get_value (yêu cầu):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Trả về giá trị.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['value']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; trở _VALUES.get (key)
& Nbsp; & nbsp; & nbsp; @ Values.post ()
& Nbsp; & nbsp; & nbsp; def set_value (yêu cầu):
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "Thiết lập giá trị.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; Returns * Đúng * hoặc * * False.
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; "" "
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; key = request.matchdict ['value']
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; thử:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; _VALUES.set (Khóa, json.loads (request.body))
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; trừ ValueError:
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; trở về False
& Nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; & nbsp; trở Đúng
Theo mặc định, Cornice sử dụng JSON trả lại

là gì mới trong phiên bản này:.

• Added Cross-Origin Resource Sharing ( CORS) hỗ trợ.

là gì mới trong phiên bản 0.12:.

• Fix tự động xác định các quan điểm TRỤ từ GET xem
• Hỗ trợ cho Colander thừa kế (được giới thiệu trong phiên bản mới của Colander)
• Kiểm tra lỗi trong cơ thể của các điểm và xác nhận (chỉ kiểm tra trong xác nhận trước đó)
• Thêm một tiện ích __version__ trong cornice / __ __ init. Py

là gì mới trong phiên bản 0.11:

• phần mở rộng nhân sư hiện đang được cung cấp bởi các cornice.ext. Module sphinxext
• Thêm hỗ trợ cho SPORE
• thêm một tùy chọn 'error_handler' để xem tờ khai.
• Services.default_ {xác nhận, bộ lọc} hiện đang được sử dụng. (Fix # 75)

là gì mới trong phiên bản 0.10:.

• sử dụng pcreate hơn paster tạo
• làm cho nó có thể để thêm giá trị tùy chỉnh lỗi.

là gì mới trong phiên bản 0.9:

• giá trị đồ mặc định được giả định là trong cơ thể
• tái cơ cấu nội bộ các API vì vậy chúng tôi không sử dụng trang trí nữa. Định nghĩa dịch vụ doanh nghiệp được tách ra từ khi đăng ký dịch vụ trong cơ chế định tuyến.
• xác nhận thêm lớp cấp và bộ lọc
• thêm tài liệu về ruột cornice
• phản đối các thuộc tính service.schema. Sử dụng service.definitions thay thế.

là gì mới trong phiên bản 0.8:

• thêm hỗ trợ cho HTTP của OPTIONS 'Động
• cho phép nhiều chấp nhận định nghĩa cho một dịch vụ.
• có được docstring validator cho các thế hệ doc tự động
• cố định không ascii vấn đề tài liệu
• thêm một cách để bỏ qua một số mô-đun khi quét với venusian.scan.

là gì mới trong phiên bản 0.7:.

• Giấy phép cập nhật để MPL 2.0
• cornice.schemas đổi tên thành cornice.errors
• Thêm get_view_wrapper phương pháp để lớp dịch vụ để hỗ trợ các lớp con gói view callables w / trang trí
• hỗ trợ buildout thêm
• quan điểm dựa trên lớp được bổ sung và trang trí của nguồn
• chắc chắn rằng chúng tôi sử dụng các ngoại lệ của Kim tự tháp. Không Webob của.
• hỗ trợ thêm bộ lọc
• Hỗ trợ giản đồ thêm
• thêm hỗ trợ JSON XSRF
• bây giờ tình trạng lỗi có thể khác nhau từ 400.

là gì mới trong phiên bản 0.6:

• sửa lỗi khác nhau trong MANIFEST

là gì mới trong phiên bản 0.3:

• Remove singleton & quot; _defined & quot; nhà nước từ cấp dịch vụ; điều này cho phép định nghĩa dịch vụ được nạp vào nhiều hơn một Configurator.

Yêu cầu :

• Python