Summary  
Python decorators are higher-order functions that take another function as an argument, define and return a wrapper function that encloses the original function to add behavior before and after its execution using closures.

General domain of usage  
Logging function execution.

デコレーターについて説明します。
`decorators` は初心者にとって難しいトピックとなる場合があります。デコレーターがどのように機能するかを、段階的に詳しく解説します。最初は理解が難しいかもしれません。これらの課題に取り組む準備はできていますか？そのためにここに来たのです！

`Decorators` は、**クロージャ**を利用して、他の関数に追加の機能を付与する *関数* です。以下はデコレーターの動作例です:

def decorator(func):
    def wrapper(argument1, argument2):
        print("Function starts executing")
        result = func(argument1, argument2)
        print("Function ends executing")

        return result

    return wrapper


def add(a, b):
    print(f"Function add: {a} + {b}")
    return a + b


add = decorator(add)

print(add(14, 12))
print(add(11, 28))
print(add(33, 16))

この例では、`decorator()` 関数は別の関数を**引数**として受け取り、`wrapper()` 関数を**定義**し、与えられた関数を `wrapper()` 内に**閉じ込め**、`wrapper()` を**返します**。デコレータの動作には3つのステップがあります：
1. 関数を引数として受け取る。
2. その関数を新たに定義した関数（ラッパー）内に閉じ込める。
3. 元の関数を内包したラッパー関数を返す。

`wrapper()` 関数はデコレータの主なロジックを含み、与えられたパラメータで関数を呼び出します。`add()` 関数は `wrapper()` によって返された `decorator()` 関数によって再代入され、これにより `add()` 関数が内包されます。

1. Pythonインタプリタは最初にデコレータ関数を読み込み、*定義*します。この時点ではデコレータ内のコードは実行されず、単に関数名が記録されるだけです。
2. 次に、`add = decorator(add)` 関数を*定義*します。`decorator` と同様、この関数もまだ実行されず、*定義*されるだけです。
3. addの定義後、次の行 `wrapper` が実行されます。ここでデコレータ関数が呼び出され、add関数が引数として渡されます。`add` 内で `add` が*定義*され、その後**返され**ます。これにより、`wrapper` は元の関数ではなく、返された `decorator` を参照するようになります。
4. `add(14, 12)` が実行されると、`wrapper` 関数が呼び出されます。
* wrapper は「Function starts executing」を出力します。
* 元の add 関数を呼び出し、「Function add: 14 + 12」を出力し、26を返します。
* 「Function ends executing」を出力します。
* wrapper は26を返し、print(add(14, 12)) によって出力されます。

次の呼び出しも同様の手順を繰り返します。

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

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

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

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

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

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

Pythonデコレータ入門