Hitchhiker's Guide to Python: Python best practices guide
/python-guide
Hitchhiker's Guide to Python gom những lời khuyên cài đặt và quy trình làm việc thực tế vào một chỗ, thay vì bắt bạn tự đi lục từng mảnh. Những chương đã hoàn thiện thực sự hữu ích — phần đóng gói và testing đọc như do ai đó từng triển khai dự án thật viết ra — nhưng nhiều đoạn vẫn còn gán nhãn work in progress, nên hãy coi đây là tài liệu đi kèm tài liệu chính thức, không phải thứ thay thế nó.
Hitchhiker's Guide to Python là gì?
Hitchhiker's Guide to Python là một tài liệu tham khảo do cộng đồng duy trì — lưu dưới dạng reStructuredText trong repo này và xuất bản tại docs.python-guide.org — hướng dẫn cài Python, chọn công cụ đóng gói và chọn thư viện cho các tác vụ thường gặp. README gọi đây là một guide có quan điểm riêng, dành cho cả người mới lẫn người có kinh nghiệm, thiên về lời khuyên dùng hằng ngày hơn là một khóa học từng bước.
Cẩm nang này bao gồm những chủ đề nào?
- ✓Hướng dẫn cài đặt Python theo từng nền tảng và từng phiên bản
- ✓Nêu tên trực tiếp các công cụ đóng gói và freeze: Py2app, Py2exe, bbfreeze, và PyInstaller
- ✓Hướng dẫn dùng Pip và virtualenv để cô lập dependency của dự án
- ✓Điểm qua bộ công cụ khoa học dữ liệu — Numpy, SciPy, statpy, pyplot, và matplotlib
- ✓Nội dung về Fabric cho việc deploy từ xa
- ✓Danh sách khuyến nghị module được README gọi là 'exhaustive' (đầy đủ), nhóm theo chủ đề
- ✓Ghi chú cấu hình server để chạy nhiều framework web Python khác nhau
- ✓Một phần ngắn hướng dẫn dùng lệnh Mercurial (hg) cùng với Git
Điểm mạnh
- ✓Nhóm các khuyến nghị module theo mục đích sử dụng thay vì chỉ liệt kê link, nên bạn có câu trả lời kiểu 'việc này thì dùng cái này'.
- ✓Bao quát cả những phần kém hấp dẫn của công việc Python — cấu hình server, thiết lập testing, thói quen viết doc — mà nhiều bài how-to bỏ qua.
- ✓Có hai dạng để đọc: reStructuredText thô ngay trong repo này, hoặc bản HTML gần như cập nhật tại docs.python-guide.org.
- ✓Miễn phí, không cần đăng ký hay trả phí.
Những điều cần lưu ý trước khi bắt đầu
- △README tự gọi dự án là 'Work in progress' và nói đang trong giai đoạn phát triển mạnh, nên một số phần đọc còn sơ sài hoặc chưa hoàn thiện.
- △Metadata của repo không ghi license, nên kiểm tra lại tại docs.python-guide.org trước khi dùng lại bất kỳ đoạn text nào.
- △Một số công cụ được nhắc tới đã cũ — Fabric và bbfreeze không còn là lựa chọn đầu tiên của phần lớn lập trình viên Python cho dự án mới.
- △Đây là văn bản để đọc, không phải một dự án chạy được. Đừng kỳ vọng có ví dụ chạy được hay một CLI để pip install.
Các tài nguyên Python best practices khác
Các câu hỏi thường gặp
Hitchhiker's Guide to Python bao gồm cài đặt Python trên nhiều nền tảng, các công cụ đóng gói như Pip và PyInstaller, virtualenv, bộ công cụ Numpy/SciPy/matplotlib, deploy bằng Fabric, khuyến nghị module theo mục đích, cấu hình server, và testing với Jenkins cùng tox.
Hitchhiker's Guide to Python miễn phí để đọc, toàn bộ nội dung được xuất bản tại docs.python-guide.org, không cần đăng ký hay trả phí. Bạn cũng có thể đọc trực tiếp mã nguồn reStructuredText trong repository GitHub này nếu muốn xem bản thô.
README không nêu rõ một phiên bản Python cụ thể — chỉ nói rằng cẩm nang này bao gồm hướng dẫn cài đặt theo từng nền tảng và từng phiên bản. Hãy kiểm tra tài liệu trực tiếp tại docs.python-guide.org để có thông tin phiên bản mới nhất, vì metadata của repo không ghi rõ điều này.
README gắn nhãn Hitchhiker's Guide to Python là 'Work in progress' và nói dự án đang trong giai đoạn phát triển mạnh, đồng thời kêu gọi người đóng góp vì còn nhiều việc cần làm. Đó là tín hiệu rõ ràng nhất trong repo về tình trạng duy trì hiện tại.
PEP 8 là một đặc tả hẹp về style và format code, trong khi Hitchhiker's Guide to Python là một cẩm nang rộng hơn, bao gồm cài đặt, đóng gói, chọn thư viện, cấu hình server và testing. Có thể xem PEP 8 như một chương nằm gọn trong phạm vi rộng hơn nhiều của cẩm nang này.
README nói Hitchhiker's Guide to Python được viết để mang lại cho 'cả lập trình viên mới lẫn chuyên gia Python' một cẩm nang thực hành cho việc cài đặt, cấu hình và sử dụng hằng ngày. Vì vậy nó phù hợp cho cả người mới bắt đầu lẫn người đã có kinh nghiệm, không chỉ riêng một trình độ.
Trường hợp sử dụng tốt nhất
- •Onboard một lập trình viên Python mới cần một tài liệu duy nhất để tham khảo về cài đặt, đóng gói và quy ước testing
- •Chọn giữa các thư viện hoặc công cụ đóng gói cạnh tranh nhau cho một tác vụ, mà không phải đọc năm bài tutorial khác nhau
- •Cài đặt máy dev Windows hoặc Mac mới và cần ghi chú cài đặt riêng theo từng nền tảng ở một chỗ
- •Viết tiêu chuẩn tài liệu nội bộ cho team và cần một điểm tham chiếu cho khái niệm 'tốt' là như thế nào
Nên dùng cho ai — và ai nên bỏ qua
Hãy thử Hitchhiker's Guide to Python nếu bạn mới học Python và muốn có một tài liệu duy nhất giải thích lựa chọn cài đặt, đóng gói và testing, thay vì đọc mười bài blog riêng lẻ, hoặc nếu bạn dẫn dắt một team và cần thứ gì đó để chỉ cho các lập trình viên junior. Bỏ qua nó nếu bạn cần hướng dẫn cập nhật liên tục về tooling hiện đại — thông báo 'work in progress' ngay trong README nghĩa là một số phần có thể chậm hơn hệ sinh thái đóng gói Python hiện tại, nên hãy đối chiếu lại bất kỳ chi tiết nào liên quan đến phiên bản với tài liệu trực tiếp tại docs.python-guide.org.
Repo liên quan
Vẫn đang phân vân về python-guide?
Một cú bấm sẽ gửi câu hỏi kèm trang này cho AI — xem AI nói gì về python-guide.