Главная
Блог разработчиков phpBB
 
+ 17 предустановленных модов
+ SEO-оптимизация форума
+ авторизация через соц. сети
+ защита от спама

PyFence: верификация типов для Python

Anna | 15.06.2014 | нет комментариев
PyFence — самопальная утилита-библиотека, которая разрешает следить за соответствием типов во время отладки вашего плана. PyFence берет информацию о типах из docstring’ов функций в стандартном формате Sphinx. То есть, если у вас теснее есть документация, огромнее ничего делать для применения PyFence не необходимо!

Скажем, возьмем дальнейший класс:

class RationalFormatter (object):
    def format(self, number):
        """
        Stringifies a number to numerator/denominator format
        Example::

            >>> print(RationalFormatter().format(1.25))
            5/4

        :param number: input number
        :type  number: float
        :raises      : None
        :rtype       : str
        """
        return '%i/%i' % number.as_integer_ratio()

    def display(self, number):
        print(str(number)   ' = '   self.format(number))

Способ format представляет число в виде дроби, применяя способ float.as_integer_ratio()

Пробуем:

>>> from formatter import RationalFormatter
>>> f = RationalFormatter()
>>> f.display(1.25)
1.25 = 5/4

Как бы работает? Впрочем все сломается, если передать int, чай int, к сожалению, .as_integer_ratio() не содержит.

>>> f.display(5)
Traceback (most recent call last):
  File "example.py", line 5, in <module>
    f.display(5)
  File "/home/eugeny/Work/pyfence/example_formatter.py", line 18, in display
    print(str(number)   ' = '   self.format(number))
  File "/home/eugeny/Work/pyfence/example_formatter.py", line 15, in format
    return '%i/%i' % number.as_integer_ratio()
AttributeError: 'int' object has no attribute 'as_integer_ratio'

Однако, при применении PyFence такую задачу дозволено было бы подметить значительно прежде:

$ pip install pyfence
...
$ fence example.py --fence:strict,stop
1.25 = 5/4
 *** PyFence ERROR ---------------------------
 *** PyFence ERROR PyFence verification failed
 *** PyFence ERROR  :: example_formatter.RationalFormatter.format(<example_formatter.RationalFormatter object at 0x7ff097a47d10>, 5)
 *** PyFence ERROR in example_formatter.py:2
 *** PyFence ERROR number was 5 (int) instead of ['float']
 *** PyFence ERROR Aborting

Помимо того, PyFence может проверять типы возникающих в функциях/методах исключений и возвращаемые типы.
Дозволено также импортировать модуль pyfence в самом плане, в этом случае не придется применять отдельную утилиту fence.
Разумеется, применять fence стоит только при разработке, а не в продакшне, так как из-за проверок допустимо падение продуктивности.

Я буду дюже признателен любому фидбеку и Pull Request’ам!

Источник: programmingmaster.ru
Оставить комментарий
Форум phpBB, русская поддержка форума phpBB
Рейтинг@Mail.ru 2008 - 2017 © BB3x.ru - русская поддержка форума phpBB