13.1.1. Trình soạn thảo tập lệnh

Trình soạn thảo là một trình soạn thảo văn bản chuyên nghiệp đầy đủ tính năng, được xây dựng trên lõi Qt Creator, với bố cục cửa sổ đơn theo tab. Các tab ở trên cùng chuyển đổi giữa các tệp đang mở, và các thao tác tệp và chỉnh sửa thông thường nằm trong menu File và Edit cũng như trên các nút thanh công cụ dọc theo cạnh trái. Hầu hết các tính năng hoạt động đúng như bạn mong đợi từ bất kỳ trình soạn thảo nào; các tính năng dưới đây là những tính năng quan trọng đối với công việc MicroPython.

13.1.1.1. Khoảng trắng

Thụt lề là cú pháp trong Python, và một IndentationError gây ra bởi một ký tự tab lạc chỗ sẽ vô hình trong chế độ hiển thị thông thường. Khi điều đó xảy ra, hãy bật Visualize Whitespace trong Edit → Advanced -- mọi dấu cách và tab đều được vẽ trên màn hình, và ký tự lạ sẽ dễ dàng nhìn thấy.

13.1.1.2. Tìm kiếm và thay thế

Nhấn Ctrl+F để mở thanh tìm kiếm và thay thế. Nó hỗ trợ khớp văn bản thông thường, toàn từ hoặc biểu thức chính quy, và phần thay thế có thể sử dụng nhóm bắt và bảo tồn kiểu chữ của mỗi kết quả khớp. Nhấn Ctrl+Shift+F cho Advanced Find, mở rộng phạm vi tìm kiếm đến tất cả các tệp đang mở hoặc mọi tệp trong một thư mục trên đĩa và hiển thị các kết quả dưới dạng liên kết có thể nhấp.

13.1.1.3. Hoàn thành mã và gợi ý hàm

Trình soạn thảo biết API Python của camera. Nhập . sau tên module hoặc đối tượng và danh sách hoàn thành sẽ mở ra với các hàm, phương thức và hằng số của nó; chọn một mục và gợi ý hàm sẽ hướng dẫn bạn qua các đối số. Di chuột qua bất kỳ tên API nào để xem tài liệu của nó trong tooltip -- cùng nội dung như tài liệu tham khảo thư viện, mà không cần rời khỏi trình soạn thảo. Tính năng hoàn thành bao gồm các module dành riêng cho camera (csi, image, machine, và phần còn lại của tài liệu tham khảo thư viện) cũng như ngôn ngữ Python.

Một máy chủ ngôn ngữ Python tích hợp sẽ kiểm tra mã của bạn khi bạn gõ, gạch chân các tên chưa được định nghĩa, các lần nhập không sử dụng và lỗi cú pháp trước khi tập lệnh chạy -- một loạt lỗi đánh máy gây ra sự cố sẽ không bao giờ đến được camera.

The editor's completion popup open after typing a dot, listing the image methods with their call signatures

Nhập dấu chấm và danh sách hoàn thành sẽ mở ra -- mỗi mục đều có chữ ký gọi đầy đủ.

13.1.1.4. GitHub Copilot

Trình soạn thảo hỗ trợ GitHub Copilot để gợi ý mã AI nội tuyến. Tính năng này không hoạt động cho đến khi bạn đăng nhập bằng tài khoản GitHub có đăng ký Copilot, trong phần Copilot của hộp thoại tùy chọn. Để tắt lại, hãy đăng xuất hoặc bỏ chọn hộp kích hoạt của nó.

13.1.1.5. Ngoài các tệp Python

Trình soạn thảo mở được nhiều hơn chỉ là tập lệnh. Mở tệp ảnh và nó xuất hiện trong trình xem ảnh với các điều khiển phóng to và vừa màn hình -- tiện lợi để kiểm tra các ảnh chụp và mẫu đã lưu mà không cần rời khỏi IDE. Mở tệp nhị phân và nó xuất hiện trong trình soạn thảo hex, hữu ích để xem nhanh bên trong tệp ghi âm hoặc tệp bộ mô tả.

13.1.1.6. Chỉnh sửa bên ngoài IDE

Tập lệnh là các tệp .py thông thường, và không có gì yêu cầu bạn phải chỉnh sửa chúng trong IDE. Khi một tệp đang mở trong trình soạn thảo thay đổi trên đĩa -- được lưu từ trình soạn thảo khác, hoặc được kéo từ hệ thống kiểm soát phiên bản -- IDE sẽ nhận thấy ngay khi cửa sổ của nó lấy lại tiêu điểm và tải lại tệp. Nó chỉ hỏi trước khi tải lại nếu bản sao trong trình soạn thảo có các thay đổi chưa được lưu của riêng nó.