Tips

今日の開発Tips(2025-06-30)

関数やメソッドを小さく保つことで、コードの理解度と保守性を向上させることができます。小さな関数は単一の明確なタスクを実行し、テストやデバッグも容易になります。 再利用性も高まり、よりモジュール化された、メンテナンスしやすいコードベースを構築できます。

小さな関数の記述

小さな関数、つまり単一の責任の原則(Single Responsibility Principle)に従った関数を書くことを心がけましょう。 一つの関数は一つのことを行うべきです。関数の行数が長くなってきたら、それをより小さな関数に分割することを検討しましょう。

# 大きすぎる関数
def process_data(data):
    cleaned_data = clean_data(data)
    transformed_data = transform_data(cleaned_data)
    result = calculate_result(transformed_data)
    save_result(result)

# 小さな関数に分割
def clean_data(data):
    # ... data cleaning logic ...
    return cleaned_data

def transform_data(data):
    # ... data transformation logic ...
    return transformed_data

def calculate_result(data):
    # ... calculation logic ...
    return result

def save_result(result):
    # ... saving logic ...

def process_data(data):
    cleaned_data = clean_data(data)
    transformed_data = transform_data(cleaned_data)
    result = calculate_result(transformed_data)
    save_result(result)

注意点:関数を小さく分割しすぎると、コードが断片化し、全体像の把握が難しくなる可能性があります。適切な粒度を見つけることが重要です。 関数名の命名にも注意を払い、その関数が何をしているかを明確に表現しましょう。 おすすめは、各関数の役割を明確に示す、簡潔で分かりやすい名前をつけることです。