Tổng Quan

Trong buổi thực hành tuần này, chúng ta được giao nhiệm vụ thêm hai tính năng mới cho dự án của mình và làm việc với nhiều nhánh khác nhau trước khi gộp lại vào nhánh chính. Đây là một cơ hội tốt để tôi thực hành vì tôi luôn cảm thấy hơi lo lắng khi làm việc với các nhánh và thường chỉ làm việc trên nhánh chính cho tất cả các dự án của mình. Nhưng hóa ra việc này không khó chút nào.

Tính Năng

Hai tính năng tôi đã chọn để thêm vào dự án này là: thêm cờ --verbose để in thông tin chi tiết và hiển thị thời gian và ngày tháng 'được sửa đổi gần nhất' cho mỗi tệp.

Thêm cờ chế độ chi tiết (verbose mode)

Để thêm thông tin chi tiết với cờ --verbose, tôi đã chọn sử dụng thư viện logging để có quyền truy cập vào hệ thống ghi nhật ký sự kiện đã được tạo sẵn. Điều này giúp tôi không phải viết một câu lệnh if để kiểm tra xem đối số cho verbose có đúng không cho mỗi câu lệnh in. Thay vào đó, tôi chỉ cần thiết lập cấu hình cơ bản trong hàm main:

import logging

logging.basicConfig( level=logging.INFO if args.verbose else logging.WARNING, format="%(levelname)s: %(message)s" )

Ví dụ về một câu lệnh ghi nhật ký thông tin chỉ in ra nếu cờ verbose được thêm vào:

logging.info("Đã hoàn thành phân tích cấu trúc cho: %s", absolute_path)

Thêm dấu thời gian sửa đổi gần nhất

Tính năng này rất nhanh để thêm vào. Tôi đã sử dụng thư viện time để kiểm tra xem các tệp nào đã được sửa đổi gần đây, vì vậy chỉ cần một vài dòng mã sử dụng thư viện đó để in chuỗi ngày tháng theo định dạng mong muốn:

import os
time import time

try:
    # Lấy thời gian sửa đổi cuối cùng (giây epoch)
    time_seconds = os.path.getmtime(file_path)
    # Định dạng thành chuỗi có thể đọc được
    modified_time = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime(time_seconds))
except Exception as e:
    logging.error("Không thể lấy thời gian sửa đổi cho %s: %s", file_path, e)
    modified_time = "Không xác định"

Làm Việc Với Các Nhánh và Ghi Nhận Song Song

Tôi đã tạo hai nhánh riêng biệt có tên là issue-8 và issue-9 để làm việc trên các tính năng mới, sau đó gộp cả hai nhánh cùng một lúc. May mắn thay, không có xung đột nào xảy ra và quá trình diễn ra rất suôn sẻ.

Với kinh nghiệm này, tôi không nghĩ rằng mình sẽ quay trở lại làm việc trên nhánh chính nữa. Việc tạo và gộp các nhánh đã trở nên khá dễ dàng và đáng để làm nhằm giữ cho mọi thứ sạch sẽ và phân tách rõ ràng.

Thực Hành Tốt Nhất

• Sử dụng Git để quản lý nhánh: Luôn tạo nhánh mới cho mỗi tính năng hoặc sửa lỗi. Điều này giúp bạn dễ dàng quay lại nếu gặp sự cố.
• Viết thông tin nhật ký rõ ràng: Ghi lại tất cả các bước bạn thực hiện trong quá trình phát triển giúp dễ dàng theo dõi và sửa lỗi trong tương lai.

Những Cạm Bẫy Thường Gặp

• Xung đột khi gộp nhánh: Đảm bảo kiểm tra và giải quyết các xung đột trước khi gộp nhánh để tránh mất dữ liệu.
• Không ghi nhật ký đủ thông tin: Thường xuyên ghi nhật ký giúp bạn và đồng đội hiểu rõ hơn về quá trình phát triển.

Mẹo Tối Ưu Hiệu Suất

• Sử dụng mức độ ghi nhật ký hợp lý: Không nên ghi nhật ký quá nhiều thông tin không cần thiết có thể làm chậm ứng dụng.
• Kiểm tra và thêm các tính năng mới từng bước: Đảm bảo rằng mọi thứ hoạt động như mong đợi trước khi thêm các tính năng mới.

Giải Quyết Vấn Đề

Nếu bạn gặp phải lỗi trong quá trình phát triển:

1. Kiểm tra nhật ký lỗi: Điều này có thể giúp bạn xác định nguyên nhân gốc rễ của vấn đề.
2. Thử nghiệm với các thay đổi nhỏ: Đôi khi, việc quay lại một thay đổi nhỏ có thể giúp bạn xác định sự cố.

Kết Luận

Việc thêm các tính năng mới vào dự án không chỉ giúp cải thiện khả năng sử dụng mà còn là một cơ hội tuyệt vời để học hỏi. Hãy bắt đầu làm việc với các nhánh và ghi nhật ký để giữ cho dự án của bạn luôn trong trạng thái tốt nhất. Bắt tay vào thực hiện ngay hôm nay với những mẹo và hướng dẫn bên trên!

Câu Hỏi Thường Gặp

1. Làm thế nào để tôi thêm một cờ vào dự án của mình?
Bạn có thể sử dụng thư viện argparse để dễ dàng thêm cờ vào dự án Python của mình.

2. Tại sao tôi nên sử dụng nhánh trong Git?
Sử dụng nhánh giúp tổ chức công việc và giữ cho mã nguồn sạch sẽ.

3. Làm thế nào để xử lý xung đột khi gộp nhánh?
Bạn cần kiểm tra từng xung đột và quyết định cách giải quyết trước khi hoàn tất việc gộp nhánh.