Pythonのtextwrapモジュールでテキストを折り返し・整形する方法

Pythonのtextwrapモジュールは、テキストの折り返し（ラップ）や詰め込み（フィル）を行うためのTextWrapperクラスを提供しています。さらに、同じ目的で手軽に使える便利関数もいくつか用意されています。ここでは、代表的なwrap()とfill()の使い方を解説します。

wrap(text) — 折り返し結果をリストで取得する

wrap(text)は、引数として渡された1つの段落（文字列）を、各行が最大width文字以内に収まるように折り返します。戻り値は出力行のリストで、末尾に改行コードは含まれません。

fill(text) — 整形結果を1つの文字列で取得する

fill(text)は、同様に1つの段落を折り返しますが、改行で連結された整形済みの段落全体を「1つの文字列」として返します。そのまま出力したい場合などに便利です。

実行例：wrap() の基本動作

>>> sample_text = '''
The textwrap module provides some convenience functions, as well as TextWrapper class
that does all the work. If you’re just wrapping or filling one or two text strings,
the convenience functions should be good enough; otherwise, you should use an instance
of TextWrapper for efficiency.
'''
>>> import textwrap
>>> for line in (textwrap.wrap(sample_text, width = 50)):
print (line)

The textwrap module provides some convenience
functions, as well as TextWrapper class that
does all the work. If you’re just wrapping or
filling one or two text strings, the
convenience functions should be good enough;
otherwise, you should use an instance of
TextWrapper for efficiency.

この例では、width=50を指定することで、各行が50文字以内になるようにテキストが自動的に折り返されていることがわかります。

実行例：fill() で1つの文字列として取得する

>>> textwrap.fill(sample_text, width = 50)
' The textwrap module provides some convenience\nfunctions, as well as TextWrapper class that\ndoes all the work. If you’re just wrapping or\nfilling one or two text strings, the\nconvenience functions should be good enough;\notherwise, you should use an instance of\nTextWrapper for efficiency.'

補足ポイント

• width引数を省略した場合のデフォルト値は70文字です。
• 同じ設定で何度も折り返し処理を行う場合は、都度関数を呼び出すよりもTextWrapperクラスのインスタンスを作成して使い回す方が効率的です。
• wrap()はリスト形式のため行ごとの処理に向いており、fill()はまとめて出力・保存するのに適しています。