PYTHON ヘルプ

PythonのTenacityで関数を再試行する

公開済み 2024年7月1日

共有:

Pythonプログラミング言語で強力かつ堅牢なプログラムを開発する際、特に外部サービスやネットワーク操作に取り組む時に、一時的なエラーを優雅に処理することが一般的です。これは強力なPython汎用リトライライブラリTenacityが役立つところです。開発者は、Tenacity と IronPDF を組み合わせることで、Python アプリケーションでの PDF 生成操作の信頼性と堅牢性を向上させることができます。IronPDF は、PDF ドキュメントの作成に豊富な機能を備えたフレームワークです。

Tenacityは、ネットワークの不具合、タイムアウト、サービスの中断など、一時的な問題により失敗したり例外を引き起こしたりするタスクの再試行を行うための適応可能でカスタマイズ可能な構造を提供します。Tenacityの使いやすいAPIと豊富な機能セットにより、再試行ロジックの開発が簡単になり、開発者は一時的な障害を心配するのではなく、信頼性の高いシステムの作成に集中することができます。

この投稿では、TenacityライブラリとIronPDFを統合することの利点について説明し、実用的な例を示し、Pythonアプリケーションで信頼性の高いPDF生成プロセスを作成するためのアドバイスを提供します。開発者は Tenacity の力を IronPDF と組み合わせることで、アプリの堅牢性と信頼性を向上させ、ユーザーに高品質なPDFドキュメントを提供できます。

デコレーター方式のリトライ

テナシティは、プログラマーがPythonデコレータを使用して関数やメソッドに再試行ロジックを追加できるようにします。このため、元のコードを変更せずに特定のアクションに再試行の動作を追加することは簡単です。

カスタマイズ可能なリトライプラン

Tenacityは、リトライプランを指定するためのいくつかの調整可能なパラメータを提供します。リトライの最大回数、リトライ間の間隔、およびリトライが行われる状況はすべて、開発者によってカスタマイズ可能です。

指数バックオフ

断固さは、各リトライの試行回数に応じてリトライ間隔が指数関数的に増加する、現在人気のあるリトライ呼び出し技術である指数バックオフを支持しています。これを行うことにより、トラフィックや輻輳が多い場合にターゲットサービスにリクエストが殺到することを避けることができます。

ジッターとランダム性

Tenacityは、同期の問題やサンダリングハード問題を防ぐために、再試行遅延にジッターやランダム性を導入するオプションを提供します。これは再試行の取り組みを時間の中で分散させることで、複数のクライアントが一斉に再試行する可能性を減らします。

再試行条件と例外

操作の戻り値や発生した例外に応じて、開発者は固有のリトライ条件を作成することができます。これにより、再試行を行うタイミングと条件を正確に調整することが可能になります。

タイムアウトと期限

タナシティは一般的な操作のタイムアウトと期限を作成するための機能を提供し、リトライの試みが無期限に続けられないようにし、操作が事前に決められた閾値を超える場合には最終的に終了することを保証します。

環境の作成および設定

指数バックオフ

from tenacity import wait_exponential

# Exponential backoff sleeping
@retry(wait=wait_exponential(multiplier=1, min=1, max=10))
def my_function():
    ...

from tenacity import wait_exponential

# Exponential backoff sleeping
@retry(wait=wait_exponential(multiplier=1, min=1, max=10))
def my_function():
    ...

PYTHON

multiplier: リトライ間の間隔を延ばすには、指数乗のマルチプライヤーを使用してください。
min: 試行間の最短時間。
max: 試行回数の間の最長間隔。

ランダムジッター

from tenacity import wait_random

@retry(wait=wait_random(min=1, max=10))
def my_function():
    ...

from tenacity import wait_random

@retry(wait=wait_random(min=1, max=10))
def my_function():
    ...

PYTHON

「min：試行間の間隔の数による最小の任意制限。」
「max」：試行回数の間隔の数による任意の最大制限。

リトライ条件のカスタマイズ

例外カスタマイズリトライ

from tenacity import retry_if_exception_type

# Coroutines retry code block, exceptions customize retrying
@retry(retry=retry_if_exception_type(ConnectionError))
def my_function():
    ...

from tenacity import retry_if_exception_type

# Coroutines retry code block, exceptions customize retrying
@retry(retry=retry_if_exception_type(ConnectionError))
def my_function():
    ...

PYTHON

発生した例外の型が一致する場合にのみ再試行を試みてください。(この場合、ConnectionError)エラーメッセージが提供されます。

戻り値に基づいて再試行

from tenacity import retry_if_result

# Retry forever ignoring exceptions code block
@retry(retry=retry_if_result(lambda result: result is None))
def my_function():
    ...

from tenacity import retry_if_result

# Retry forever ignoring exceptions code block
@retry(retry=retry_if_result(lambda result: result is None))
def my_function():
    ...

PYTHON

メソッドがNoneを返した場合にのみ、再試行してください。

停止条件 (停止条件 (Stop Conditions))

from tenacity import stop_after_delay

@retry(stop=stop_after_delay(30))
def my_function():
    ...

from tenacity import stop_after_delay

@retry(stop=stop_after_delay(30))
def my_function():
    ...

PYTHON

所定の時間が経過した後(例えば、30秒)やめてください。

リトライコールバック

from tenacity import after_log

# Custom callbacks
@retry(after=after_log(logger, logging.DEBUG))
def my_function():
    ...

from tenacity import after_log

# Custom callbacks
@retry(after=after_log(logger, logging.DEBUG))
def my_function():
    ...

PYTHON

関数に添付されたリトライ属性およびその試行は、指定されたロガーを使用して記録されるべきです。(loggerのように)特定のログレベルを引き上げる(DEBUGのように).

はじめに

IronPDFとは何ですか？

私たちは、人気のツールキットであるIronPDFの助けを借りて、プログラム内でPDFドキュメントを作成し、編集し、レンダリングすることができます。さまざまな方法でPDFを操作できます。HTMLページをPDFに変換したり、既存のPDFにテキスト、画像、形を追加したり、既存のPDFからテキストや画像を抽出したりできます。HTMLコンテンツ、画像、または未処理データから新しいPDFページを作成することも可能です。

IronPDFは非常に使いやすいことが、その主な利点の一つです。 Pythonの使いやすいAPIと豊富なドキュメントにより、開発者はプロジェクト内でPDFを作成し始めることが簡単になります。 IronPDF には、速度と効率という 2 つの機能も備わっており、開発者が高品質な PDF ドキュメントをすばやく作成できるようにします。

IronPDF のいくつかの利点:

画像、生データ、HTMLをPDFに変換する。
PDFファイルから画像とテキストを削除する。
PDFファイルにヘッダー、フッター、およびウォーターマークを追加する。
パスワードと暗号化によるPDFファイルの保護。
フォームを電子署名して記入する機能。

ライブラリのインストール

必須の依存関係をインストールし、両方のライブラリをPDF生成ワークフローに統合することが、TenacityとIronPDFをPythonアプリケーションで一緒に使用するための最初のステップです。

pip install tenacity
pip install ironpdf

Pythonスクリプトで、TenacityおよびIronPDFから必要なモジュールをインポートします。

from tenacity import retry, stop_after_attempt, wait_fixed
from IronPdf import IronPdf

from tenacity import retry, stop_after_attempt, wait_fixed
from IronPdf import IronPdf

PYTHON

Tenacityの@retryデコレーターを使用してPDF生成メソッドに装飾を施し、永遠にリトライするなどのリトライ動作を設定します。

@retry(
    stop=stop_after_attempt(3),   # Stop retrying after 3 attempts
    wait=wait_fixed(2)            # Wait 2 seconds between retry attempts
)
def generate_pdf(html_content):
    iron_pdf = IronPdf()
    iron_pdf.render_html_as_pdf(html_content)
    iron_pdf.save_as_pdf("output.pdf")

@retry(
    stop=stop_after_attempt(3),   # Stop retrying after 3 attempts
    wait=wait_fixed(2)            # Wait 2 seconds between retry attempts
)
def generate_pdf(html_content):
    iron_pdf = IronPdf()
    iron_pdf.render_html_as_pdf(html_content)
    iron_pdf.save_as_pdf("output.pdf")

PYTHON

@retry(試行の後に停止 = stop_after_attempt(3))3回試行しても成功しなかった場合、その関数は再試行を中止することを示します。 `wait_fixed(2)「:」は、各再試行呼び出しの試みに2秒間の間隔を設けることを示します。

関数を呼び出してPDFを作成し、HTMLテキストを渡します。 Tenacityは、例外が発生した場合、事前に設定されたリトライパラメータに従って自動的に関数をリトライします。

try:
    html_content = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
    generate_pdf(html_content)
    print("PDF generated successfully")
except Exception as e:
    print("Failed to generate PDF:", e)

try:
    html_content = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
    generate_pdf(html_content)
    print("PDF generated successfully")
except Exception as e:
    print("Failed to generate PDF:", e)

PYTHON

リトライの回数、リトライ条件と待機条件、リトライの間隔、およびリトライが発生する状況などの要素を変更することで、リトライの挙動をさらに変更することができます。 Tenacityには、リトライの動作を要件に合わせて微調整するために使用できる、さまざまなリトライ方法とリトライおよび待機条件の戦略が含まれています。

サンプル出力

以下は上記のコードから生成された出力です：

テナシティPython（開発者向けの動作方法）：図1 - 期待される返却結果リトライPDF出力

結論

要約すると、TenacityとIronPDFを組み合わせることで、Pythonアプリケーションにおいて堅牢で信頼性の高いPDF生成ワークフローを作成するための強力なソリューションが提供されます。開発者は、IronPDF の強力な PDF 生成機能と Tenacity のカスタマイズ可能なリトライロジックを活用することで、PDF 生成プロセスが一時的な障害やリトライに対して堅牢で耐久性のあるものになるように確保することができます。

Tenacityの豊富な機能セットを使用することで、開発者は複数の条件に対するリトライ戦術を正確に調整したり、独自のリトライ基準を指定したり、例外に対するリトライをカスタマイズしたり、高度な構成オプションを含めたりすることができます。粘り強さにより、開発者は一時的な障害（ネットワークの停止やサービスの中断など）を優雅に処理し、重要なPDF作成プロセスが即座に再試行されることを保証します。

結論として、TenacityとIronPDFを利用することで、開発者は現実の環境での厳しい要求に対応できる信頼性が高く堅牢なPDF生成ソリューションを作成できます。この組み合わせは、請求書、レポート、またはドキュメントの作成を目的としたワークフローであっても、Pythonアプリケーションで信頼性が高く、スケーラブルなPDF生成ワークフローを作成するための強力な基盤を提供します。

パッケージには、手ごろな料金でIronPDFの永久ライセンスが含まれています。多くのシステムにおいて、パッケージは非常に手頃な価格である749ドルで利用可能です。ライセンス所有者はオンライン技術サポートへの24時間アクセスを得ることができます。ライセンスページをご覧いただき、料金の詳細についてご確認ください。 Iron Softwareの製品について詳しく知るには、ライブラリページにアクセスしてください。

< 以前
PythonアプリケーションにおけるOpenTelemetry

次へ >
PythonでBeautifulSoupを使ったWebスクレイピング