What is the proper way to access python class variables?

Question

Having a class

class A(object):
    z = 0

    def Func1(self):
        return self.z

    def Func2(self):
        return A.z

Both methods (Func1 and Func2) give the same result and are only included in this artificial example to illustrate the two possible methods of how to address z.

The result of Func* would only differ if an instance would shadow z with something like self.z = None.

What is the proper python way to access the class variable z using the syntax of Func1 or Func2?

mgilson · Accepted Answer · 2012-11-19 13:50:04Z

3

I would say that the proper way to get access to the variable is simply:

a_instance.z  #instance variable 'z'
A.z           #class variable 'z'

No need for Func1 and Func2 here.

As a side note, if you must write Func2, it seems like a classmethod might be appropriate:

@classmethod
def Func2(cls):
    return cls.z

As a final note, which version you use within methods (self.z vs. A.z vs. cls.z with classmethod) really depends on how you want your API to behave. Do you want the user to be able to shadow A.z by setting an instance attribute z? If so, then use self.z. If you don't want that shadowing, you can use A.z. Does the method need self? If not, then it's probably a classmethod, etc.

answered Nov 19, 2012 at 13:50

mgilson

312k70 gold badges656 silver badges722 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Woltan Over a year ago

Thank you for your answer. I only included Func1 and Func2 as an example on how to address z. I like your idea of how the API should behave. So I guess that this is the answer I was looking for.

Marcin · Accepted Answer · 2012-11-19 13:52:07Z

1

I would usually use self.z, because in case there are subclasses with different values for z it will choose the "right" one. The only reason not to do that is if you know you will always want the A version notwithstanding.

Accessing via self or via a classmethod (see mgilson's answer) also facilitates the creating of mixin classes.

answered Nov 19, 2012 at 13:52

Marcin

50.1k18 gold badges137 silver badges207 bronze badges

Comments

C2H5OH · Accepted Answer · 2013-02-04 00:17:55Z

If you don't care about value clobbering and things like that, you're fine with self.z. Otherwise, A.z will undoubtedly evaluate to the class variable. Beware, though, about what would happen if a subclass B redefines z but not Func2:

class B(A):
    z = 7

b = B()
b.Func2()  # Returns 0, not 7

Which is quite logical, after all. So, if you want to access a class variable in a, somehow, polymorphic way, you can just do one of the following:

self.__class__.z
type(self).z

According to the documentation, the second form does not work with old-style classes, so the first form is usually more comptaible across Python 2.x versions. However, the second form is the safest one for new-style classes and, thus, for Python 3.x, as classes may redefine the __class__ attribute.

Collectives™ on Stack Overflow

What is the proper way to access python class variables?

3 Answers 3

1 Comment

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

1 Comment

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related