Bỏ qua đến nội dung chính
Mục lục

textwrap và pprint trong Python: trình bày đầu ra gọn

AIDev Team · duyệt: Nguyễn Việt Chung

Bài 13/25 · Chương 19

Thư viện chuẩn thường dùng

  • 8 phút
  • Trung cấp
  • Python 3.14
  • Cập nhật

textwrap là module của thư viện chuẩn Python dùng để ngắt một đoạn văn dài thành các dòng vừa độ rộng bạn chọn, rút gọn hay bỏ thụt lề thừa. Đi cùng nó trong bài là pprint để in dict và list lồng nhau thành nhiều dòng dễ đọc, và reprlib để rút gọn một giá trị quá dài khi in kiểm tra.

Cần biết trước: chuỗi, dict lồng nhau, import và __str__, __repr__.

Ngắt dòng bằng wrap() và fill()

Thực đơn in trên màn hình nhỏ hay trong tin nhắn cần mô tả món không dài quá vài chục ký tự mỗi dòng. textwrap.wrap() chia chuỗi thành list các dòng, mỗi dòng dài tối đa width ký tự và ngắt ở dấu cách (cả sau dấu gạch nối; từ dài hơn width bị cắt). textwrap.fill() làm việc đó rồi nối các dòng bằng ký tự xuống dòng thành một chuỗi:

python
import textwrap

mo_ta = ("Cà phê phin pha với sữa đặc, thêm đá, vị đậm và ngọt "
         "vừa, hợp buổi sáng.")
print(textwrap.wrap(mo_ta, width=24))
print(textwrap.fill(mo_ta, width=24))
print(textwrap.fill(mo_ta, width=24, initial_indent="- ",
                    subsequent_indent="  "))

KẾT QUẢ

['Cà phê phin pha với sữa', 'đặc, thêm đá, vị đậm và', 'ngọt vừa, hợp buổi sáng.']
Cà phê phin pha với sữa
đặc, thêm đá, vị đậm và
ngọt vừa, hợp buổi sáng.
- Cà phê phin pha với
  sữa đặc, thêm đá, vị
  đậm và ngọt vừa, hợp
  buổi sáng.

initial_indent đặt trước dòng đầu, subsequent_indent trước các dòng sau, và cả hai được tính vào width: dòng - Cà phê phin pha với dài 21 ký tự vì chữ sữa thêm vào sẽ quá 24. Chữ có dấu viết sẵn như ữ tính là một ký tự. Đổi "- " thành "* " rồi chạy lại: dòng thứ năm in * Cà phê phin pha với.

Rút gọn bằng shorten(), bỏ thụt lề bằng dedent()

textwrap.shorten() gộp các khoảng trắng liền nhau (cả xuống dòng) thành một dấu cách, rồi nếu chuỗi vẫn dài quá width thì cắt ở ranh giới từ và thêm phần đánh dấu placeholder, mặc định là [...]. textwrap.dedent() bỏ phần thụt lề chung của các dòng, hợp với chuỗi ba nháy viết thụt vào trong code:

python
import textwrap

mo_ta = "Cà phê phin pha với sữa đặc,\n  thêm đá, vị đậm."
print(textwrap.shorten(mo_ta, width=30))
print(textwrap.shorten(mo_ta, width=20, placeholder="…"))
gio_mo_cua = """
    Huế: 7:00 - 22:00
      Thứ Hai nghỉ
    Đà Lạt: 6:30 - 21:00
    """
print(textwrap.dedent(gio_mo_cua))

KẾT QUẢ

Cà phê phin pha với sữa [...]
Cà phê phin pha với…

Huế: 7:00 - 22:00
  Thứ Hai nghỉ
Đà Lạt: 6:30 - 21:00

Phần đánh dấu được tính vào width, nên dòng đầu dài đúng 29 ký tự. dedent() chỉ bỏ bốn dấu cách chung, dòng Thứ Hai nghỉ vẫn giữ hai dấu cách thụt thêm của nó. Dòng trống ở đầu và cuối là ký tự xuống dòng ngay sau """ mở và trước """ đóng.

In dữ liệu lồng nhau bằng pprint

print() in cả một dict lồng nhau trên một dòng dài. pprint.pprint() (pretty print) xuống dòng theo từng tầng khi dòng dài quá width (mặc định 80), và thụt lề cho thấy khóa nào thuộc dict nào. depth giới hạn số tầng được in, pprint.pformat() trả về chuỗi đó thay cho in ra:

python
import pprint

chi_nhanh = {
    "Huế": {"dia_chi": "12 ngõ Bạc Xỉu",
            "mon": ["cà phê sữa", "bạc xỉu", "trà đào"],
            "quan_ly": "Lan"},
    "Đà Lạt": {"dia_chi": "3 phố Trà Đào",
               "mon": ["sinh tố bơ"],
               "quan_ly": "Minh"},
}
pprint.pprint(chi_nhanh)
pprint.pprint(chi_nhanh, depth=1)
bang = pprint.pformat(chi_nhanh["Huế"], width=40)
print(bang)

KẾT QUẢ

{'Huế': {'dia_chi': '12 ngõ Bạc Xỉu',
         'mon': ['cà phê sữa', 'bạc xỉu', 'trà đào'],
         'quan_ly': 'Lan'},
 'Đà Lạt': {'dia_chi': '3 phố Trà Đào',
            'mon': ['sinh tố bơ'],
            'quan_ly': 'Minh'}}
{'Huế': {...}, 'Đà Lạt': {...}}
{'dia_chi': '12 ngõ Bạc Xỉu',
 'mon': ['cà phê sữa',
         'bạc xỉu',
         'trà đào'],
 'quan_ly': 'Lan'}

Tầng sâu hơn depth hiện thành {...}. Với width=40, list món không vừa một dòng nên cũng được tách mỗi phần tử một dòng. pprint in giá trị bằng repr(), nên chuỗi vẫn có dấu nháy.

Rút gọn giá trị dài bằng reprlib

Khi in kiểm tra một list hàng trăm mã đơn, bạn chỉ cần thấy vài phần tử đầu. reprlib.repr() giống repr() nhưng cắt bớt: list giữ 6 phần tử rồi thêm ..., chuỗi giữ tối đa 30 ký tự kể cả dấu nháy và phần ... ở giữa. Muốn giới hạn khác, tạo một reprlib.Repr với maxlist, maxstring:

python
import reprlib

ma_don = list(range(1001, 1101))
print(len(repr(ma_don)))
print(reprlib.repr(ma_don))
print(reprlib.repr("Đơn gồm " + "cà phê sữa, " * 10))
gon = reprlib.Repr(maxlist=3, maxstring=20)
print(gon.repr(["cà phê sữa", "bạc xỉu", "trà đào", "sinh tố bơ"]))
print(gon.repr("Cà phê phin pha với sữa đặc"))

KẾT QUẢ

600
[1001, 1002, 1003, 1004, 1005, 1006, ...]
'Đơn gồm cà p... cà phê sữa, '
['cà phê sữa', 'bạc xỉu', 'trà đào', ...]
'Cà phê ... sữa đặc'

repr() của cả list dài 600 ký tự, bản rút gọn chỉ một dòng ngắn. Chuỗi bị cắt ở giữa để giữ cả phần đầu và phần cuối. Bạn dùng reprlib.repr() trong dòng in kiểm tra hay trong __repr__ của class giữ nhiều dữ liệu.

Kiểm tra nhanh

  1. Sau dòng import textwrap, textwrap.wrap("cà phê sữa đá", width=7) cho kết quả gì?

    • 'cà phê\nsữa đá'
    • ['cà phê', 'sữa đá']
    • ['cà phê ', 'sữa đá']
  2. Sau dòng import pprint và d = {"b": 1, "a": 2}, những lệnh nào in ra {'b': 1, 'a': 2}?

    • print(d)
    • pprint.pprint(d)
    • pprint.pprint(d, sort_dicts=False)
    • print(pprint.pformat(d))
  3. Sau dòng import textwrap, textwrap.shorten("Trà đào cam sả size lớn", width=15) cho kết quả gì?

    • 'Trà đào cam sả'
    • 'Trà đào cam [...]'
    • 'Trà đào [...]'
    • Báo ValueError
  4. Sau dòng import reprlib, lệnh print(reprlib.repr(list(range(20)))) in ra gì?

    • [0, 1, 2, 3, 4, 5, ...]
    • [0, 1, 2, ..., 19]
    • [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, ...]
Đúng hết lần đầu +15 XP

Bài tập

In thẻ món có mô tả ngắt dòng

Màn hình gọi món chỉ hiện được rong ký tự mỗi dòng. Viết hàm the_mon(ten, mo_ta, rong) trả về thẻ món. Dòng đầu là ten, các dòng sau là mo_ta ngắt ở dấu cách sao cho mỗi dòng dài tối đa rong ký tự. Mỗi dòng mô tả bắt đầu bằng hai dấu cách, và hai dấu cách này tính vào rong. Các từ của mo_ta cách nhau một dấu cách, không từ nào dài quá rong - 2. Dùng module textwrap.

Ví dụ: the_mon("Trà đào", "Trà đào cam sả.", 30) trả về "Trà đào\n Trà đào cam sả.".

Trả về: thẻ món nhiều dòng, một str.

python
def the_mon(ten, mo_ta, rong):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • textwrap.wrap() trả về list các dòng, textwrap.fill() trả về một chuỗi đã ngắt, cả hai ngắt theo width, ưu tiên ở dấu cách.

  • initial_indent, subsequent_indent thụt lề dòng đầu và các dòng sau, tính vào width.

  • shorten() gộp khoảng trắng và cắt ở ranh giới từ kèm [...]; width nhỏ hơn 5 báo ValueError.

  • dedent() bỏ phần thụt lề chung của chuỗi ba nháy.

  • pprint.pprint() in dữ liệu lồng nhau theo tầng và sắp xếp khóa, trừ khi sort_dicts=False.

  • reprlib.repr() rút gọn list, chuỗi dài khi in kiểm tra.

Câu hỏi thường gặp

Module textwrap có đếm đúng độ dài chữ tiếng Việt không?

textwrap đếm số ký tự của chuỗi, nên chữ có dấu viết sẵn như ữ tính là một. Văn bản dán từ vài nguồn có thể lưu một chữ thành chữ gốc cộng dấu rời, khi đó một chữ tính thành hai hoặc ba ký tự và dòng trông ngắn hơn. textwrap cũng không biết chữ hiển thị rộng hẹp khác nhau trên màn hình.

Hàm pprint() trong Python khác print() ở chỗ nào?

print() gọi str() và in mọi thứ trên một dòng. pprint.pprint() dùng repr(), xuống dòng theo tầng khi quá độ rộng và sắp xếp khóa dict. Với dict lồng nhau nhiều tầng, pprint giúp đọc nhanh cấu trúc khi kiểm tra.

In dict ra dạng JSON có thụt lề thì dùng pprint được không?

pprint in theo cú pháp Python: nháy đơn, True, None. Muốn đúng định dạng JSON để lưu file hay gửi đi, dùng module json ở bài JSON.

Căn cột cho bảng thì dùng textwrap được không?

textwrap chỉ ngắt và thụt lề từng đoạn văn. Căn trái, căn phải các cột của bảng là việc của định dạng chuỗi như {:<10} trong f-string.

Chủ đề

textwrap

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập