# Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved.

# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

#

# The Universal Permissive License (UPL), Version 1.0

#

# Subject to the condition set forth below, permission is hereby granted to any

# person obtaining a copy of this software, associated documentation and/or

# data (collectively the "Software"), free of charge and under any and all

# copyright rights in the Software, and any and all patent rights owned or

# freely licensable by each licensor hereunder covering either (i) the

# unmodified Software as contributed to or provided by such licensor, or (ii)

# the Larger Works (as defined below), to deal in both

#

# (a) the Software, and

#

# (b) any piece of software and/or hardware listed in the lrgrwrks.txt file if

# one is included with the Software each a "Larger Work" to which the Software

# is contributed by such licensors),

#

# without restriction, including without limitation the rights to copy, create

# derivative works of, display, perform, and distribute the Software and make,

# use, sell, offer for sale, import, export, have made, and have sold the

# Software and the Larger Work(s), and to sublicense the foregoing rights on

# either these or other terms.

#

# This license is subject to the following condition:

#

# The above copyright notice and either this complete permission notice or at a

# minimum a reference to the UPL must be included in all copies or substantial

# portions of the Software.

#

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

# SOFTWARE.

class property(object):

"""

property(fget=None, fset=None, fdel=None, doc=None) -> property attribute

fget is a function to be used for getting an attribute value, and likewise

fset is a function for setting, and fdel a function for del'ing, an

attribute. Typical use is to define a managed attribute x:

class C(object):

def getx(self): return self._x

def setx(self, value): self._x = value

def delx(self): del self._x

x = property(getx, setx, delx, "I'm the 'x' property.")

Decorators make defining new properties or modifying existing ones easy:

class C(object):

@property

def x(self):

"I am the 'x' property."

return self._x

@x.setter

def x(self, value):

self._x = value

@x.deleter

def x(self):

del self._x

"""

def __init__(self, fget=None, fset=None, fdel=None, doc=None, name=None):

self.__get = fget

self.__set = fset

self.__delete = fdel

self.doc = doc

self.name = name

self._owner = None

def __get__(self, instance, owner):

if self._owner is None:

self._owner = owner

if instance is None:

return self

if self.__get is None:

raise AttributeError("unreadable attribute")

return self.__get(instance)

def __set__(self, instance, value):

if self.__set is None:

raise AttributeError("attribute '{}' of '{}' objects is not writable".format(

self.name, getattr(self._owner, "__name__", str(self._owner))))

return self.__set(instance, value)

def __delete__(self, instance):

if self.__delete is None:

raise AttributeError("can't delete attribute")

return self.__delete(instance)

def setter(self, func):

self.__set = func

return self

def deleter(self, func):

self.__delete = func

return self

def getter(self, func):

self.__get = func

return self

def __repr__(self):

return "'".join([

"<property ",

str(self.name),

" of ",

getattr(self._owner, "__name__", str(self._owner)),

" objects>"

])