Pythonのtextwrapモジュールでテキストを整形・折り返す方法を徹底解説

Pythonには、プレーンテキストを整形したり折り返したりするための標準ライブラリtextwrapモジュールが用意されています。このモジュールを使うと、段落内の改行位置を調整しながら、テキストを見やすい形式に整えることができます。

textwrapモジュールを使用するには、まずコード内でインポートする必要があります。

import textwrap

TextWrapperの主な属性一覧

textwrap.TextWrapperクラスのコンストラクタには、以下のようなインスタンス属性があります。これらを組み合わせることで、柔軟にテキストの整形ルールを制御できます。

textwrapモジュールの主要メソッド

textwrapモジュールには、テキスト整形のための便利なメソッドがいくつか用意されています。代表的なものを紹介します。

textwrap.wrap(text, width=70, **kwargs)

入力された段落を指定した行幅で折り返すメソッドです。デフォルトの行幅は70文字で、戻り値として折り返し後の各行が格納されたリストを返します。

textwrap.fill(text, width=70, **kwargs)

fill()メソッドはwrap()とほぼ同じ動作をしますが、リストではなく改行文字を含む単一の文字列を返す点が異なります。指定した幅を超えるたびに改行文字が挿入されます。

textwrap.shorten(text, width, **kwargs)

文字列を指定した幅に切り詰める（省略する）メソッドです。切り詰め後のテキスト全体の長さがwidth以内に収まるように調整され、末尾にプレースホルダー「[...]」が追加されます。

サンプルコード

実際にwrap()、fill()、shorten()を使った例を見てみましょう。

import textwrap

python_desc = """Python is a general-purpose interpreted, interactive, object-oriented, 
                 and high-level programming language. It was created by Guido van Rossum 
                 during 1985- 1990. Like Perl, Python source code is also available under 
                 the GNU General Public License (GPL). This tutorial gives enough 
                 understanding on Python programming language."""

my_wrap = textwrap.TextWrapper(width = 40)
wrap_list = my_wrap.wrap(text=python_desc)

for line in wrap_list:
   print(line)
    
single_line = """Python is a general-purpose interpreted, interactive, object-oriented, 
                 and high-level programming language."""

print('\n\n' + my_wrap.fill(text = single_line))

short_text = textwrap.shorten(text = python_desc, width=150)
print('\n\n' + my_wrap.fill(text = short_text))

実行結果

Python is a general-purpose interpreted,
interactive, object-oriented,
and high-level programming language. It
was created by Guido van Rossum
during 1985- 1990. Like Perl, Python
source code is also available under
the GNU General Public License (GPL).
This tutorial gives enough
understanding on Python programming
language.

Python is a general-purpose interpreted,
interactive, object-oriented,
and high-level programming language.

Python is a general-purpose interpreted,
interactive, object-oriented, and high-
level programming language. It was
created by Guido van Rossum [...]

このように、textwrapモジュールを使えば、wrap()で行ごとのリストを取得したり、fill()で整形済みの文字列を生成したり、shorten()で長い文章を簡潔に要約したりすることが簡単に実現できます。ログ出力やCLIツール、レポート生成など、テキストの見栄えを整えたい場面でぜひ活用してみてください。