Module, package và thư viện chuẩn Python: datetime, random, math
Tách code thành module và package, import đúng cách, khối __main__, cùng các module chuẩn hay dùng: datetime, random, math, statistics.
Học xong bài này, bạn sẽ
- Tách code thành module, package và import đúng
- Hiểu if __name__ == "__main__"
- Dùng datetime, random, math, collections, statistics
Nên học trước: Hàm: tham số, giá trị trả về, phạm vi và lambda
Nội dung bài viết
Một file 2.000 dòng rất khó đọc, khó sửa và không ai dám đụng vào. Người đi làm chia code thành nhiều file nhỏ, mỗi file một nhiệm vụ: đó là module. Nhiều module gom thành thư mục là package. Python còn kèm sẵn hàng trăm module chuẩn, gọi là "pin có sẵn" (batteries included). Bài này dạy cả hai: tự tổ chức code và dùng thư viện chuẩn.
1. Module là một file .py
Tạo thư mục dự án:
chi_tieu/
├── tien_te.py ← hàm xử lý tiền
└── main.py ← chương trình chính
File tien_te.py:
"""Hàm tiện ích định dạng và đọc số tiền."""
def vnd(so: float) -> str:
"""1234567 → '1.234.567đ'"""
return f"{so:,.0f}".replace(",", ".") + "đ"
def doc_so_tien(chuoi: str) -> int:
"""'1.234.567' hoặc '1,234,567đ' → 1234567"""
sach = chuoi.replace(".", "").replace(",", "").replace("đ", "").strip()
return int(sach)
if __name__ == "__main__":
assert vnd(1234567) == "1.234.567đ"
assert doc_so_tien("1.234.567đ") == 1234567
print("tien_te.py: kiểm tra đạt")
tien_te.py: kiểm tra đạt
File main.py cùng thư mục:
# (minh họa) cần file tien_te.py ở cùng thư mục
import tien_te
from tien_te import vnd
so = tien_te.doc_so_tien("2.500.000")
print(vnd(so * 3))
PS D:\chi_tieu> python main.py
7.500.000đ
2. Các cách import
import math # dùng: math.sqrt(16)
from math import sqrt, pi # dùng thẳng: sqrt(16)
import datetime as dt # đặt bí danh: dt.date.today()
from collections import Counter as C # bí danh cho tên được import
print(math.sqrt(16), sqrt(25), round(pi, 4))
4.0 5.0 3.1416
import modulegiữ tên module khi gọi: đọc code biết ngay hàm từ đâu.from module import tengọn hơn khi dùng nhiều lần.- Tránh
from module import *: không biết tên nào từ đâu và dễ ghi đè tên của bạn. - Theo PEP 8, đặt import ở đầu file, theo thứ tự: thư viện chuẩn, thư viện bên ngoài, module của dự án; mỗi nhóm cách một dòng trống.
3. if __name__ == "__main__"
Mỗi module có biến đặc biệt __name__. Khi bạn chạy trực tiếp python tien_te.py, __name__ là "__main__"; khi file được import, __name__ là tên module ("tien_te"). Nhờ vậy khối if __name__ == "__main__": chỉ chạy khi chạy trực tiếp: hợp để đặt phần tự kiểm tra hoặc chương trình chính, mà không bị chạy khi module khác import.
random.py hay math.py trong dự án thì import random sẽ nạp file của bạn thay vì module chuẩn, và lỗi rất khó hiểu kiểu AttributeError: module 'random' has no attribute 'randint'. Python tìm module trong thư mục của script trước tiên.4. Package: thư mục chứa module
chi_tieu/
├── main.py
└── tien_ich/
├── __init__.py ← đánh dấu đây là package (có thể để trống)
├── tien_te.py
└── ngay_thang.py
# (minh họa) trong main.py
from tien_ich.tien_te import vnd
from tien_ich import ngay_thang
print(vnd(150000), ngay_thang.ten_thu_hom_nay())
Dấu chấm trong tien_ich.tien_te đi từ package vào module. File __init__.py chạy khi package được import lần đầu; có thể để trống. Ở chặng 6 bạn sẽ học cấu trúc dự án chuẩn với thư mục src/ và cài package để import từ bất kỳ đâu.
5. Dạo quanh thư viện chuẩn
datetime: ngày giờ
from datetime import date, datetime, timedelta
ngay = date(2026, 10, 29)
print(ngay.strftime("%d/%m/%Y"), ngay.isoformat(), ngay.weekday()) # thứ Hai = 0
print(ngay + timedelta(days=45))
print((date(2027, 1, 1) - ngay).days, "ngày đến năm mới")
mo = datetime.strptime("29/10/2026 08:30", "%d/%m/%Y %H:%M")
print(mo.hour, mo.minute)
29/10/2026 2026-10-29 3
2026-12-13
64 ngày đến năm mới
8 30
strftime chuyển ngày thành chuỗi theo mẫu, strptime làm ngược lại. Mã hay dùng: %d ngày, %m tháng, %Y năm 4 chữ số, %H:%M:%S giờ phút giây. Lấy thời điểm hiện tại: date.today(), datetime.now().
random, math, statistics
import math
import random
import statistics
random.seed(7) # cố định để kết quả lặp lại được
print(random.randint(1, 6), random.choice(["kéo", "búa", "bao"]))
print(random.sample(range(1, 46), 6)) # 6 số khác nhau từ 1 đến 45
print(math.ceil(4.1), math.floor(4.9), math.gcd(12, 18), math.dist((0, 0), (3, 4)))
luong = [12, 15, 15, 18, 22, 95] # triệu đồng
print(statistics.mean(luong), statistics.median(luong))
3 kéo
[26, 42, 4, 5, 35, 7]
5 4 6 5.0
29.5 16.5
Ví dụ lương cho thấy vì sao cần trung vị: một người lương 95 kéo trung bình lên 29,5 trong khi đa số chỉ khoảng 15–18. random phù hợp cho trò chơi và mô phỏng; sinh mật khẩu hay mã bảo mật thì phải dùng module secrets.
help(math.gcd) in tài liệu của hàm, dir(math) liệt kê mọi tên trong module. Danh sách đầy đủ module chuẩn nằm ở docs.python.org/3/library.Tóm tắt
- Module = file
.py; package = thư mục có__init__.py. import x,from x import y,import x as z; tránhimport *.if __name__ == "__main__":cho phần chỉ chạy khi chạy trực tiếp.- Không đặt tên file trùng module chuẩn.
datetime,random,math,statistics,collectionscó sẵn, không cần cài.
Bài tập
Bài 1. Đếm ngày đến sinh nhật
Viết module ngay_thang.py có hàm so_ngay_den_sinh_nhat(ngay_sinh, hom_nay) trả số ngày đến sinh nhật kế tiếp (0 nếu là hôm nay), kèm khối tự kiểm tra.
Xem đáp án
"""ngay_thang.py: hàm xử lý ngày tháng."""
from datetime import date
def so_ngay_den_sinh_nhat(ngay_sinh: date, hom_nay: date) -> int:
"""Số ngày từ hom_nay đến sinh nhật kế tiếp (0 nếu đúng hôm nay)."""
try:
sn = ngay_sinh.replace(year=hom_nay.year)
except ValueError: # sinh 29/2, năm nay không nhuận
sn = date(hom_nay.year, 3, 1)
if sn < hom_nay:
try:
sn = ngay_sinh.replace(year=hom_nay.year + 1)
except ValueError:
sn = date(hom_nay.year + 1, 3, 1)
return (sn - hom_nay).days
if __name__ == "__main__":
hom_nay = date(2026, 10, 29)
assert so_ngay_den_sinh_nhat(date(2000, 10, 29), hom_nay) == 0
assert so_ngay_den_sinh_nhat(date(2000, 10, 30), hom_nay) == 1
assert so_ngay_den_sinh_nhat(date(2000, 10, 28), hom_nay) == 364
print("Đến sinh nhật 15/01:", so_ngay_den_sinh_nhat(date(1999, 1, 15), hom_nay), "ngày")
Đến sinh nhật 15/01: 78 ngày
Truyền hom_nay vào làm tham số thay vì gọi date.today() bên trong giúp hàm cho kết quả cố định, nên kiểm tra được. Đây là thói quen thiết kế bạn sẽ thấy lại ở bài pytest. try/except xử lý người sinh 29/2; bạn sẽ học kỹ ở chặng 3.
Bài 2. Package tiện ích
Tạo package tien_ich chứa tien_te.py (hàm vnd) và ngay_thang.py (bài 1). Trong main.py, import theo hai cách khác nhau và gọi cả hai hàm.
Xem đáp án
bai2/
├── main.py
└── tien_ich/
├── __init__.py (để trống)
├── tien_te.py
└── ngay_thang.py
# (minh họa) bai2/main.py
from datetime import date
import tien_ich.ngay_thang
from tien_ich.tien_te import vnd
print(vnd(1_500_000))
print(tien_ich.ngay_thang.so_ngay_den_sinh_nhat(date(1999, 1, 15), date(2026, 10, 29)))
PS D:\bai2> python main.py
1.500.000đ
78
Chạy python main.py từ thư mục bai2 để Python tìm thấy package tien_ich.
Nguồn tham khảo: Python Tutorial: Modules; datetime; statistics; secrets.
Bài tập thực hành
- Viết module ngay_thang.py có hàm tính số ngày đến sinh nhật kế tiếp, kèm khối tự kiểm tra.
- Tạo package tien_ich gồm hai module và import từ main.py bằng hai cách.
Làm xong bài tập mới chuyển sang bài tiếp theo: tự viết code là cách duy nhất để nhớ lâu.


