В чем отличие между @foobar и @foobar()?

Декоратор @foobar применяется к функции или классу, используя экземпляр самого декоратора foobar. Декоратор @foobar() вызывает фабричную функцию foobar, которая должна вернуть объект декоратора (экземпляр callable-класса или функцию), который затем применяется к функции или классу.

Пример:

# Декоратор без параметров
def simple_decorator(func):
    def wrapper(*args, **kwargs):
        print("Executing simple decorator")
        return func(*args, **kwargs)
    return wrapper

@simple_decorator
def my_function():
    print("Executing my_function")

# my_function() эквивалентно simple_decorator(my_function)()

# Декоратор с параметрами
def decorator_factory(param):
    def actual_decorator(func):
        def wrapper(*args, **kwargs):
            print(f"Executing decorator with param: {param}")
            return func(*args, **kwargs)
        return wrapper
    return actual_decorator

@decorator_factory("example_param")
def another_function():
    print("Executing another_function")

# another_function() эквивалентно decorator_factory("example_param")(another_function)() - сначала вызывается фабрика, потом полученный декоратор

Таблица сравнения: