Summary  
This chapter explains how to create and apply Python decorators using the @ syntax and nested wrapper functions that leverage *args and **kwargs to flexibly augment any function’s behavior.  

General domain of usage  
Logging and debugging of function calls.

**デコレーター**は、関数を引数として受け取り、その関数を**ラッパー**関数内で実行する仕組み。

デコレーターを適用するには、**@**記号の後にデコレーター関数名を記述し、修飾したい関数の直前に配置する。以下はその例：

``` python
def decorator(func):
    ...

# First method
@decorator
add(a,b):
    print(f"Function add: {a} + {b}")

add(2, 3)

# Second method
add(a,b):
    print(f"Function add: {a} + {b}")

inner = decorator(add)

inner(2, 3)
```

この例では、どちらの方法も同じ結果となる。`@`記号を使う第一の方法は、`decorators`を適用するより読みやすく簡潔な方法であり、「*シンタックスシュガー*」と呼ばれることが多い。

デコレーター内で`wrapper`という名前のネストされた関数を使用するのが一般的。

#### 柔軟なデコレータ：多様な関数引数への対応

関数はしばしば異なる数の引数を必要とします。
異なる引数の数を持つ関数に適用できるデコレータを作成するには、`*args` 関数内で `**kwargs` および `wrapper()` を利用するのが効果的です。

def indicate(func):
    def wrapper(*args, **kwargs):
        print("=" * 15)
        print("Taken arguments:", *args, kwargs)
        result = func(*args, **kwargs)
        print("=" * 15)
        return result
    return wrapper


@indicate
def avg_two(a, b):
    """Calculate the average of two numbers"""
    return round((a + b) / 2, 1)

@indicate
def avg_three(a, b, c):
    """Calculate the average of three numbers"""
    return round((a + b + c) / 3, 1)

@indicate
def avg_many_kwargs(**kwargs):
    """Calculate the average of multiple numbers in a dictionary"""
    keys = 0
    total = 0

    for value in kwargs.values():
        keys += 1
        total += value

    return round(total / keys, 1)

print("Returned:", avg_two(14, 21), "\n")
print("Returned:", avg_three(225, 12, 11), "\n")
print("Returned:", avg_many_kwargs(first=51, second=11, third=47, fourth=93))

このコースでは、関数の引数、イテレータ、ジェネレータ、クロージャ、デコレータなどの高度なトピックを学習します。数多くの練習問題を通じて、これらのトピックを理解できます。

このトピックは楽しく学べ、単一の代入で値をパックおよびアンパックする方法を習得できます。

Pythonの関数引数、*args、**kwargsの強力な機能を探求し、関数を引数として効果的に使用する方法を学習します。

高階関数と、関数が他の関数への引数として渡される方法について学びます。

変数のスコープとは何か、そして以前はどのようにそれを管理していたのか。本トピックは、クロージャやデコレータといった次のテーマを理解するために不可欠です。このトピックは楽しく、実用的であることをお約束します。ローカル変数、ノンローカル変数、グローバル変数についての知識を身につけることができます。

このセクションでは、関数の動作を修正および強化する強力な機能であるPythonデコレータについて、詳細に解説します。受講者は独自のデコレータの作成方法、組み込みデコレータの理解、実践的なシナリオでのデコレータの活用方法を学びます。

Pythonデコレーターの構文：デコレーターの記述と適用

柔軟なデコレータ：多様な関数引数への対応