読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 引数を決める

2.1 検査する引数

練習の practice/agent_data/tools.py の get_invoice は、次のように引数を検査します。

def get_invoice(conn, user, document_number=None, supplier_reference=None) -> dict:
    """請求書1件を、伝票番号か仕入先の請求書番号で返す。"""
    if (document_number is None) == (supplier_reference is None):
        raise ToolError("document_number と supplier_reference の、どちらか一方だけを指定してください")
    if document_number is not None and not DOCUMENT_NUMBER.match(document_number):
        raise ToolError("document_number は 51 で始まる10桁の数字です")
    ...

検査には2つの目的があります。

目的例
取り違えを止める発注番号 4500000002 を伝票番号として渡したら、エラーにする
意味のあいまいな呼び方を止める伝票番号と仕入先の請求書番号を両方渡したら、どちらで探すか分からないためエラーにする

番号の形の決まり(51で始まる10桁)は、業務データモデルの属性の説明と同じものを使います。決まりを道具ごとに書き分けると、道具によって受け付ける値が違ってしまいます。

6 / 20