##

# .python.decorlib

##

"""

common decorators

"""

import os

import types

def propertydoc(ap):

"""

Helper function for extracting an `abstractproperty`'s real documentation.

"""

doc = ""

rstr = ""

if ap.fget:

ret = ap.fget.__annotations__.get('return')

if ret is not None:

rstr = " -> " + repr(ret)

if ap.fget.__doc__:

doc += os.linesep*2 + "GET::" + (os.linesep + ' '*4) + (os.linesep + ' '*4).join(

[x.strip() for x in ap.fget.__doc__.strip().split(os.linesep)]

)

if ap.fset and ap.fset.__doc__:

doc += os.linesep*2 + "SET::" + (os.linesep + ' '*4) + (os.linesep + ' '*4).join(

[x.strip() for x in ap.fset.__doc__.strip().split(os.linesep)]

)

if ap.fdel and ap.fdel.__doc__:

doc += os.linesep*2 + "DELETE::" + (os.linesep + ' '*4) + (os.linesep + ' '*4).join(

[x.strip() for x in ap.fdel.__doc__.strip().split(os.linesep)]

)

ap.__doc__ = "<no documentation>" if not doc else (

"Abstract Property" + rstr + doc

)

return ap

class method(object):

__slots__ = ('callable',)

def __init__(self, callable):

self.callable = callable

def __get__(self, val, typ):

if val is None:

return self.callable

return types.MethodType(self.callable, val)