Tính năng định dạng mã được đưa vào uv dưới dạng thử nghiệm

• Phiên bản uv mới cung cấp tính năng định dạng mã dưới dạng thử nghiệm
• Lệnh uv format sử dụng trình định dạng của Ruff ở bên trong để áp dụng kiểu định dạng nhất quán cho mã Python
• Giờ đây có thể dọn dẹp mã thuận tiện chỉ với uv mà không cần công cụ riêng biệt như trước
• Người dùng có thể tinh chỉnh chi tiết hành vi định dạng thông qua các đối số bổ sung
• Vì vẫn là tính năng thử nghiệm, cách dùng lệnh, xử lý lỗi và các phần khác vẫn có thể thay đổi

---

Tổng quan

Bản phát hành mới nhất của uv (0.8.13) đã giới thiệu uv format, một lệnh thử nghiệm mà các nhà phát triển Python đã chờ đợi từ lâu. Với tính năng này, có thể chuẩn hóa style mã chỉ bằng công cụ uv mà không cần quản lý thêm công cụ định dạng riêng trong dự án

uv format là gì?

• Lệnh uv format cung cấp khả năng định dạng mã Python thông qua giao diện uv
• Bên trong, nó gọi trình định dạng Ruff để tự động sắp xếp mã một cách nhất quán

Lưu ý cho nhà phát triển

Charlie Marsh (nhà phát triển uv) đã giải thích như sau trên Hacker News

Ruff và uv không được hợp nhất, và chúng vẫn là hai công cụ riêng biệt
Mục tiêu đơn giản là cải thiện trải nghiệm để người dùng có thể dùng trình định dạng mà không cần xem đó là một công cụ riêng
Điều này tương tự mối quan hệ giữa cargo fmt và rustfmt trong hệ sinh thái Rust

Cách sử dụng

• Cần dùng uv phiên bản 0.8.13 trở lên
• Chạy lệnh uv format ở thư mục gốc của dự án sẽ mang lại hiệu quả tương đương với việc chạy ruff format
• Cách thực thi tuân theo giao diện lệnh của uv

Truyền đối số bổ sung

• Có thể đặt các tùy chọn chi tiết để truyền cho Ruff theo dạng uv format -- [đối số bổ sung]
• Có thể tận dụng đồng thời sự tiện lợi của uv và khả năng cấu hình chi tiết của Ruff

Hướng dẫn về giai đoạn thử nghiệm

• Hiện tại, tính năng này vẫn ở giai đoạn thử nghiệm, nên trong tương lai cách dùng lệnh hoặc cách tích hợp với cấu trúc dự án có thể thay đổi
• Cách xử lý lỗi, định dạng đầu ra và các phần khác cũng sẽ tiếp tục được cải thiện
• Tính năng này dự kiến sẽ tiếp tục phát triển dựa trên phản hồi của người dùng

Kết luận

• Nếu bạn cần định dạng mã đơn giản và nhất quán cho dự án Python, có thể tích cực thử uv format
• Vì đây là bổ sung mang tính thử nghiệm, việc trực tiếp sử dụng rồi gửi phản hồi sẽ giúp đóng góp cho sự phát triển của uv trong tương lai