May 6, 2016
The short answer is in the title. Never use static methods in Python.
The initial intention of this post was to provide a simple and concrete use case for a static method in Python. I started with this 7-year conversation about static methods on StackOverflow, which seemed promising. But it doesn’t contain a single practical use case. And I think I know why. There are none.
One rule-of-thumb: ask yourself “does it make sense to call this method, even if no Obj has been constructed yet?” If so, it should definitely be static.
Initially, I thought that made sense. But, assuming you have decided to use an object-oriented rather than a procedural approach to coding, why would you ever want to call a method before instantiating an object?
obj.method() always better than
Or to give a more concrete example, wouldn’t you rather write
Math.abs(-5) as Miško Hevery suggest in Static Methods are Death to Testability?
In Java, I can see how it is helpful to call a method on a class when you want to pass in multiple arguments. For example,
Math.max(5, 7). But why does this need to be a static method? In Python, you could just make it a class method, only callable on the class itself and not on instances of a class.
Math class in Java is basically just a grouping of math-related utility methods. In Python, this is generally handled via modules (e.g., the
math module), not classes.
Incidentally, in this discussion, Google Senior Software Developer and author of C# in Depth, Jon Skeet explains why he thinks static methods in Java should have been designed to behave like class methods in Python do and should not be callable on instance objects.
It’s hard to find an example of a practical use of a static method in Python. I found two examples of static methods built in to Python:
strclass object is always available in Python, so why would you want to call
maketrans()on an instance of
I’m sure there are other examples, but I bet they are all equally obscure and not worth the time it takes to type “@staticmethod”.
So, are static methods completely useless in Python? Guido van Rossum basically said as much in April, 2012:
We all know how limited static methods are. (They’re basically an accident — back in the Python 2.2 days when I was inventing new-style classes and descriptors, I meant to implement class methods but at first I didn’t understand them and accidentally implemented static methods first. Then it was too late to remove them and only provide class methods.
So, if you’re wondering if you should make one of your Python methods static, as far as I can tell, you shouldn’t do it. Ever. Right?
Related Training: Python