Skip to content
Home / Fundamentals

Python Static Class Variables and Methods

Static class variables and methods are class-level variables and methods that are shared by all instances of a class. They can be accessed through the class itself or through any instance of the class. In Python, static class variables and methods are defined using the @staticmethod and @classmethod decorators, respectively.

Static methods

A static method is a method that belongs to a class rather than an instance of the class. It can be called on the class itself, as well as on any instance of the class. Static methods do not have access to the instance data of the class, and they do not have access to the self variable.

Here is an example of a class with a static method:

class MyClass:
    def __init__(self, value):
        self.value = value

    @staticmethod
    def static_method():
        print("This is a static method")

# You can call the static method on the class itself
MyClass.static_method()  # Output: "This is a static method"

# You can also call the static method on an instance of the class
obj = MyClass(5)
obj.static_method()  # Output: "This is a static method"

Static methods are useful for defining utility functions that are related to a class, but do not need to access any instance data.

Class methods

A class method is a method that belongs to a class and is shared by all instances of the class. It can be called on the class itself, as well as on any instance of the class. Class methods have access to the cls variable, which refers to the class itself.

Here is an example of a class with a class method:

class MyClass:
    class_variable = "class variable"

    def __init__(self, value):
        self.value = value

    @classmethod
    def class_method(cls):
        print(f"This is a class method. Class variable: {cls.class_variable}")

# You can call the class method on the class itself
MyClass.class_method()  # Output: "This is a class method. Class variable: class variable"

# You can also call the class method on an instance of the class
obj = MyClass(5)
obj.class_method()  # Output: "This is a class method. Class variable: class variable"

Class methods are useful for defining methods that need to access or modify class-level variables.

Static class variables

Static class variables are class-level variables that are shared by all instances of a class. They can be accessed through the class itself or through any instance of the class.

Here is an example of a class with a static class variable:

class MyClass:
    static_class_variable = "static class variable"

    def __init__(self, value):
        self.value = value

# You can access the static class variable through the class itself
print(MyClass.static_class_variable)  # Output: "static class variable"

# You can also access the static class variable through an instance of the class
obj = MyClass(5)
print(obj.static_class_variable)

Modifying static class variables

Static class variables can be modified through the class itself or through any instance of the class. However, it's important to note that modifying a static class variable through one instance of the class will affect all other instances of the class as well, since they all share the same class-level variable.

Here is an example of modifying a static class variable:

class MyClass:
    static_class_variable = "static class variable"

    def __init__(self, value):
        self.value = value

# Modify the static class variable through the class itself
MyClass.static_class_variable = "modified static class variable"

# The static class variable has been modified for all instances of the class
obj1 = MyClass(5)
print(obj1.static_class_variable)  # Output: "modified static class variable"

obj2 = MyClass(10)
print(obj2.static_class_variable)  # Output: "modified static class variable"

It's generally a good idea to avoid modifying static class variables, as it can make it more difficult to understand and maintain the code. Instead, it's usually better to define a new class variable or use a class method to modify the class-level state.

Using static and class methods

Static and class methods can be useful for organizing and modularizing code, and for defining utility functions that are related to a class but do not need to access instance data. They can also be useful for defining methods that need to access or modify class-level variables.

Here is an example of a class with both static and class methods:

class MyClass:
    class_variable = "class variable"

    def __init__(self, value):
        self.value = value

    @staticmethod
    def static_method():
        print("This is a static method")

    @classmethod
    def class_method(cls):
        print(f"This is a class method. Class variable: {cls.class_variable}")

# Call the static method
MyClass.static_method()  # Output: "This is a static method"

# Call the class method
MyClass.class_method()  # Output: "This is a class method. Class variable: class variable"

# You can also call the static and class methods on an instance of the class
obj = MyClass(5)
obj.static_method()  # Output: "This is a static method"
obj.class_method()  # Output: "This is a class method. Class variable: class variable"