Устаревать параметр функции - PullRequest
Новая
       8

Устаревать параметр функции

0 голосов
/ 01 марта 2019

Иногда нам нужно пометить параметр функции как устаревший, используя декоратор.

Например: 

@deprecated_param(version="0.2.3",
                  reason="you may consider using *styles* instead.",
                  deprecated_args='color background_color')
def paragraph(text, color=None, background_color=None, styles=None):
    styles = styles or {}
    if color:
        styles['color'] = color
    if background_color:
        styles['background-color'] = background_color
    html_styles = " ".join("{k}: {v};".format(k=k, v=v) for k, v in styles.items())
    html_text = xml.sax.saxutils.escape(text)
    return ('<p styles="{html_styles}">{html_text}</p>'
            .format(html_styles=html_styles, html_text=html_text))

См. https://github.com/tantale/deprecated/issues/8

Я ищухороший способ реализовать это.

Есть ли у вас сейчас примеры кода в стандартной библиотеке Python или в известных проектах с открытым исходным кодом (таких как Flask, Django, setuptools ...)?

1 Ответ

0 голосов
/ 01 марта 2019

Вы можете разделить deprecated_args на набор, чтобы можно было использовать пересечение наборов для получения аргументов ключевого слова: 

class deprecated_param:
    def __init__(self, deprecated_args, version, reason):
        self.deprecated_args = set(deprecated_args.split())
        self.version = version
        self.reason = reason

    def __call__(self, callable):
        def wrapper(*args, **kwargs):
            found = self.deprecated_args.intersection(kwargs)
            if found:
                raise TypeError("Parameter(s) %s deprecated since version %s; %s" % (
                    ', '.join(map("'{}'".format, found)), self.version, self.reason))
            return callable(*args, **kwargs)
        return wrapper

, чтобы: 

@deprecated_param(version="0.2.3",
                  reason="you may consider using *styles* instead.",
                  deprecated_args='color background_color')
def paragraph(text, color=None, background_color=None, styles=None):
    pass

paragraph('test')
paragraph('test', color='blue', background_color='white')

выводил: 

TypeError: Parameter(s) 'color', 'background_color' deprecated since version 0.2.3; you may consider using *styles* instead.
...