simple-classproperty 1.0.1

Provides a 'classproperty' decorator.

Simple Python classproperty decorator

This module provides a simple way for defining class properties.

Install

You can install this Python module via pip:

pip install simple-classproperty

Otherwise the module can be downloaded from PyPI: https://pypi.org/project/simple-classproperty/

Usage

1. Import the module:

   from simple_classproperty import ClassPropertyMeta, classproperty
   

2. Create a class with a class property:

   class NewClass(metaclass=ClassPropertyMeta):
       _attr = "val"
   
       @classproperty
       def attr(cls):
           return cls._attr
   

   Don't forget to set the metaclass!
3. (Optional) Define also a setter and deleter for the newly created class property (this works like the standard python property):

   @attr.setter
   def attr(cls, value):
       cls._attr = value
   
   @attr.deleter
   def attr(cls):
       del cls._attr
   

Tips

The classproperty is also accessible from an instance:

instance = NewClass()
print(instance.attr)  # "val"

But when the value of the property is changed from an instance object, only the instance has this value:

instance = NewClass()
instance.attr = "new"
print(instance.attr)  # "new"
print(NewClass.attr)  # "val"

When deleting the property from the instance, the class value is used again:

instance = NewClass()
instance.attr = "new"
print(instance.attr)  # "new"

del instance.attr
print(instance.attr)  # "val"