mrg - Công cụ khắc phục hiện tượng tách jamo trên macOS và xóa các tệp metadata linh tinh

mrg là một tiện ích CLI dùng để xóa các tệp linh tinh được tạo trên macOS hoặc chuẩn hóa tên tệp sang Unicode.

Tính năng của mrg

• Chuẩn hóa NFC cho tên tệp Unicode(--bad-unicode): khắc phục hiện tượng tách jamo.
• Xóa tệp .DS_Store(--ds-store): xóa các tệp .DS_Store được tạo khi mở thư mục bằng Finder.
• Xóa tệp ._*(--dot): xóa các tệp ._* dùng để lưu metadata hoặc thông tin lập chỉ mục trên macOS.

Đặc điểm của mrg

• Hỗ trợ màu ANSI: mrg hỗ trợ màu terminal đẹp mắt. Bạn có thể trực quan kiểm tra trạng thái thư mục thông qua màu sắc. Tất nhiên cũng có thể tắt bằng biến môi trường NO_COLOR.
• Cung cấp báo cáo phân tích đẹp mắt: khi quét hoặc dọn dẹp bằng mrg, công cụ sẽ cung cấp báo cáo phân tích trực quan về kết quả. Nhờ đó bạn có thể nắm được ngay những gì mrg đã quét và xử lý.
• Cung cấp báo cáo phân tích JSON: ngoài báo cáo trực quan cho con người, công cụ còn cung cấp phân tích ở định dạng JSON để máy có thể đọc được.
• Cung cấp Python API: mrg cũng có thể được dùng như một mô-đun Python. Thông qua mô-đun mrg, bạn có thể chạy hoặc tùy biến mrg bằng Python.
• Không có phụ thuộc bên ngoài: ở runtime, mrg không sử dụng bất kỳ thư viện ngoài nào ngoài các thư viện cơ bản mà Python cung cấp sẵn.

Cài đặt

Bạn có thể cài đặt mrg thông qua homebrew.

brew tap ilotoki0804/homebrew-mrg  
brew install mrg  

Nếu dùng uv, bạn cũng có thể cài đặt qua uvx mrg.

Cách dùng

Về cơ bản, mrg nhận path làm đối số. Để kiểm tra một thư mục, hãy nhập đường dẫn sau lệnh mrg như bên dưới.

mrg .  

Nếu chỉ chạy như vậy mà không có đối số khác thì mặc định sẽ là “chế độ quét”.
Ở trạng thái này, công cụ sẽ không thay đổi bất kỳ tệp nào, mà chỉ khảo sát trạng thái thư mục rồi cung cấp kết quả phân tích.

Để thực sự dọn dẹp hoặc sửa tệp, bạn cần thêm đối số. Bạn có thể dọn thư mục bằng cách thêm một hoặc nhiều đối số sau.

• --dot: xóa các tệp ._*. Mặc định chỉ xóa khi tệp có kích thước thông thường và tồn tại tệp tương ứng.
• --bad-unicode: chuẩn hóa các tên tệp/thư mục Unicode chưa được chuẩn hóa NFC.
• --ds-store: xóa các tệp .DS_Store.

Ví dụ, để chuẩn hóa tất cả tệp và thư mục trong thư mục . sang NFC, bạn có thể dùng lệnh sau.

mrg . --bad-unicode  

Nếu muốn chạy đồng thời --bad-unicode, --ds-store, --dot, bạn có thể dùng cờ --all.

mrg . --all  

mrg là từ viết tắt của “mekregi”, một từ ghép giữa macOS và “rác”, mang ý nghĩa dọn các tệp rác được tạo trên macOS.

Vui lòng tham khảo liên kết để xem mô tả đầy đủ. Đây là một công cụ mã nguồn mở được phát hành theo Apache 2.0 và mọi PR, issue, v.v. đều được chào đón.

Tài liệu (tiếng Hàn) / Tài liệu (tiếng Anh)