Mở rộng và nhúng trình thông dịch Python

Tài liệu này mô tả cách viết các mô-đun bằng C hoặc C++ để mở rộng trình thông dịch Python với các mô-đun mới. Các mô-đun đó không chỉ có thể xác định các hàm mới mà còn cả các loại đối tượng mới và phương thức của chúng. Tài liệu này cũng mô tả cách nhúng trình thông dịch Python vào một ứng dụng khác để sử dụng làm ngôn ngữ mở rộng. Cuối cùng, nó cho thấy cách biên dịch và liên kết các mô-đun mở rộng để chúng có thể được tải động (trong thời gian chạy) vào trình thông dịch, nếu hệ điều hành cơ bản hỗ trợ tính năng này.

Tài liệu này giả định kiến ​​thức cơ bản về Python. Để biết phần giới thiệu không chính thức về ngôn ngữ, hãy xem Hướng dẫn Python. Tài liệu tham khảo ngôn ngữ Python đưa ra định nghĩa chính thức hơn về ngôn ngữ. Thư viện chuẩn Python ghi lại các loại đối tượng, chức năng và mô-đun hiện có (cả tích hợp và viết bằng Python) giúp ngôn ngữ này có phạm vi ứng dụng rộng rãi.

Để biết mô tả chi tiết về toàn bộ Python/C API, hãy xem Hướng dẫn tham khảo Python/C API riêng.

Công cụ của bên thứ ba được đề xuất

Hướng dẫn này chỉ bao gồm các công cụ cơ bản để tạo tiện ích mở rộng được cung cấp như một phần của phiên bản CPython này. Một số third party tools cung cấp cả cách tiếp cận đơn giản hơn và phức tạp hơn để tạo phần mở rộng C và C++ cho Python.

Tạo tiện ích mở rộng mà không cần công cụ của bên thứ ba

Phần hướng dẫn này đề cập đến việc tạo tiện ích mở rộng C và C++ mà không cần sự hỗ trợ từ các công cụ của bên thứ ba. Nó chủ yếu dành cho những người tạo ra các công cụ đó chứ không phải là một cách được khuyến nghị để tạo các tiện ích mở rộng C của riêng bạn.

Xem thêm

PEP 489 -- Khởi tạo mô-đun mở rộng nhiều pha

• 1. Mở rộng Python bằng C hoặc C++
  • 1.1. Một ví dụ đơn giản
  • 1.2. Intermezzo: Lỗi và ngoại lệ
  • 1.3. Quay lại ví dụ
  • 1.4. Bảng phương thức và hàm khởi tạo của mô-đun
  • 1.5. Biên soạn và liên kết
  • 1.6. Gọi hàm Python từ C
  • 1.7. Trích xuất tham số trong hàm mở rộng
  • 1.8. Tham số từ khóa cho các hàm mở rộng
  • 1.9. Xây dựng giá trị tùy ý
  • 1.10. Số lượng tham chiếu
  • 1.11. Viết phần mở rộng bằng C++
  • 1.12. Cung cấp C API cho Mô-đun mở rộng
• 2. Xác định các loại tiện ích mở rộng: Hướng dẫn
  • 2.1. Khái niệm cơ bản
  • 2.2. Thêm dữ liệu và phương thức vào ví dụ Cơ bản
  • 2.3. Cung cấp khả năng kiểm soát tốt hơn đối với các thuộc tính dữ liệu
  • 2.4. Hỗ trợ thu gom rác theo chu kỳ
  • 2.5. Phân loại các loại khác
• 3. Xác định các loại tiện ích mở rộng: Các chủ đề khác nhau
  • 3.1. Quyết toán và hủy phân bổ
  • 3.2. Trình bày đối tượng
  • 3.3. Quản lý thuộc tính
  • 3.4. So sánh đối tượng
  • 3.5. Hỗ trợ giao thức trừu tượng
  • 3.6. Hỗ trợ tham khảo yếu
  • 3.7. Thêm đề xuất
• 4. Xây dựng phần mở rộng C và C++
  • 4.1. Xây dựng tiện ích mở rộng C và C++ bằng setuptools
• 5. Xây dựng tiện ích mở rộng C và C++ trên Windows
  • 5.1. Phương pháp tiếp cận sách dạy nấu ăn
  • 5.2. Sự khác biệt giữa Unix và Windows
  • 5.3. Sử dụng DLL trong thực tế

Nhúng thời gian chạy CPython vào một ứng dụng lớn hơn

Đôi khi, thay vì tạo một tiện ích mở rộng chạy bên trong trình thông dịch Python làm ứng dụng chính, bạn nên nhúng thời gian chạy CPython vào bên trong một ứng dụng lớn hơn. Phần này bao gồm một số chi tiết liên quan đến việc thực hiện điều đó thành công.

• 1. Nhúng Python vào ứng dụng khác
  • 1.1. Nhúng cấp độ rất cao
  • 1.2. Ngoài khả năng nhúng cấp độ rất cao: Tổng quan
  • 1.3. Nhúng thuần túy
  • 1.4. Mở rộng Python nhúng
  • 1.5. Nhúng Python vào C++
  • 1.6. Biên dịch và liên kết trong các hệ thống giống Unix