Using python decorator with or without parentheses

by

some_decorator in the first code snippet is a regular decorator:

@some_decorator
def some_method():
    pass

is equivalent to 

some_method = some_decorator(some_method)

On the other hand, some_decorator in the second code snippet is a callable that returns a decorator:

@some_decorator()
def some_method():
    pass

is equivalent to

some_method = some_decorator()(some_method)

As pointed out by Duncan in comments, some decorators are designed to work both ways. Here’s a pretty basic implementation of such decorator:

def some_decorator(arg=None):
    def decorator(func):
        def wrapper(*a, **ka):
            return func(*a, **ka)
        return wrapper

    if callable(arg):
        return decorator(arg) # return 'wrapper'
    else:
        return decorator # ... or 'decorator'

pytest.fixture is a more complex example.

More Related Contents:

  1. How to make function decorators and chain them together?
  2. How does the @property decorator work in Python?
  3. Creating a singleton in Python
  4. How to get method parameter names?
  5. Is there a decorator to simply cache function return values?
  6. Preserving signatures of decorated functions
  7. Python decorators in classes
  8. Calling class staticmethod within the class body?
  9. Python memoising/deferred lookup property decorator
  10. Attaching a decorator to all functions within a class
  11. Can I patch a Python decorator before it wraps a function?
  12. Why does @foo.setter in Python not work for me?
  13. Decorator execution order
  14. Introspection to get decorator names on a method?
  15. What are some common uses for Python decorators? [closed]
  16. What is the best way to do automatic attribute assignment in Python, and is it a good idea?
  17. How to create abstract properties in python abstract classes
  18. Can I combine two decorators into a single one in Python?
  19. Python decorator? – can someone please explain this? [duplicate]
  20. How to get all methods of a Python class with given decorator?
  21. Python version
  22. How do I write a decorator that restores the cwd?
  23. Python decorator as a staticmethod
  24. Generating dictionary keys on the fly [duplicate]
  25. Python functools.wraps equivalent for classes
  26. How to auto register a class when it’s defined
  27. Auto-register class methods using decorator
  28. Applying a decorator to every method in a class?
  29. Decorator error: NoneType object is not callable
  30. How to skip a pytest using an external fixture?

Leave a Comment