pip install pydoclint

cat > /tmp/sample_doc.py << 'EOF'
def greet(name: str, times: int) -> str:
    """挨拶メッセージを生成する。

    Args:
        name (str): 挨拶する相手の名前

    Returns:
        str: 挨拶メッセージ
    """
    return f"Hello, {name}! " * times
EOF

# timesの引数説明が欠けているので違反が検出される
pydoclint --style=google /tmp/sample_doc.py

# 修正版
cat > /tmp/sample_doc_fixed.py << 'EOF'
def greet(name: str, times: int) -> str:
    """挨拶メッセージを生成する。

    Args:
        name (str): 挨拶する相手の名前
        times (int): 繰り返し回数

    Returns:
        str: 挨拶メッセージ
    """
    return f"Hello, {name}! " * times
EOF

# 違反なし
pydoclint --style=google /tmp/sample_doc_fixed.py
