Property python что это
Метод property() в Python
Автор: Кольцов Д · Опубликовано 21.11.2020 · Обновлено 25.11.2020
Конструкция property() возвращает атрибут свойства.
Параметры
Свойство функции принимает четыре необязательных параметра:
Возвращаемое значение из свойства
Метод возвращает атрибут свойства из заданного средства получения, установки и удаления:
Пример 1: Создание атрибута с помощью метода получения, установки и удаления
Здесь _name используется в качестве частной переменной для хранения имени Person.
Теперь мы устанавливаем новое имя атрибута свойства, вызывая метод property().
Как показано в программе, обращение к p.name изнутри вызывает get_name() как getter, set_name() как setter и del_name() как deleteter через напечатанный вывод, присутствующий внутри методов.
Пример 2: Использование декоратора
Вместо использования property() в Python вы можете использовать декоратор @property() для назначения получателя, установщика и удалителя.
Здесь вместо использования property() мы использовали декоратор @property.
Во-первых, мы указываем, что метод name() также является атрибутом Person. Это делается с помощью @property перед методом получения, как показано в программе.
Затем мы используем имя атрибута, чтобы указать установщик и удалитель.
Это делается с помощью @ name.setter для метода установки и @ name.deleter для метода удаления.
Обратите внимание, мы использовали одно и то же имя метода() с разными определениями для определения получателя, установщика и удалителя.
Изучаем Декораторы в Python
Декораторы Python весьма хороши, однако их достаточно сложно понять при первом знакомстве. Декоратор в Python – это функция, которая принимает другую функцию в качестве аргумента. Декоратор модифицирует или улучшает принятую функцию и выдает измененную. Это значит, что когда вы вызываете декорированную функцию, вы получите функцию, которая может иметь небольшие отличия, в виде дополнительных функций, совмещенных с базовым определением. Нам нужно рассмотреть основу декоратора, а именно функцию.
Простая функция
Python Функция это блок кода, который начинается с ключевого слова def, с дальнейшим названием функции. Функция может принимать от нуля и более аргументов, ключевые аргументы или сочетание этих аргументов. Функция всегда выдает результат. Если вы не определили, что именно она должна выдавать, она выдаст None. Вот очень простой пример функции, которая выдает строку:
Все что мы сделали в этом коде, это вызвали функцию и указали значение выдачи. Давайте создадим другую функцию:
Эта функция принимает один аргумент и этот аргумент должен быть функцией или вызываемой. По факту, ее стоит вызывать, используя определенную в прошлом функцию. Вы заметите, что это функция содержит вложенную внутрь функцию, которую мы называем other_func. Она принимает результат переданной функции, её выражение и создает строку, которая говорит нам о том, что мы сделали, после чего она возвращается.
Давайте взглянем на полную версию данного кода:
Так и работает декоратор. Мы создали одну функцию и передали её другой второй функции. Вторая функция является функцией декоратора. Декоратор модифицирует или усиливает функцию, которая была передана и возвращает модификацию. Если вы запустите этот код, вы увидите следующий выход в stdout:
Давайте немного изменим код, чтобы превратить another_function в декоратор:
Обратите внимание на то, что декоратор начинается с символа @, за которым следует название функции, которую мы собираемся «декорировать». Для получения декоратора python, вам нужно только разместить его в строке перед определением функции. Теперь, когда мы вызываем **a_function, она будет декорирована, и мы получим следующий результат:
Давайте создадим декоратор, который будет делать что-нибудь полезное.
Есть вопросы по Python?
На нашем форуме вы можете задать любой вопрос и получить ответ от всего нашего сообщества!
Telegram Чат & Канал
Вступите в наш дружный чат по Python и начните общение с единомышленниками! Станьте частью большого сообщества!
Паблик VK
Одно из самых больших сообществ по Python в социальной сети ВК. Видео уроки и книги для вас!
Создание логируемого декоратора
Возможно, вам потребуется логировать того, что делает ваша функция. Большую часть времени логинг будет встроен внутри вашей функции. Однако, бывают случаи, когда вам нужно сделать это на уровне функции, что бы получить представление о потоке программы или, возможно, для следования тем или иным условиям бизнеса, таким как аудит. Посмотрим на небольшой декоратор, который мы можем использовать для записи названия любой функции и того, что она делает:
Этот небольшой скрипт содержит функцию log, которая принимает функцию как единственный аргумент. Мы создаем объект логгер, а название лог файла такое же, как и у функции. После этого, функция log будет записывать, как наша функция была вызвана и что она возвращает, если возвращает.
Встроенные декораторы
Python содержит несколько встроенных декораторов. Из всех этих декораторов, самой важной троицей являются:
Также существуют декораторы в различных разделах стандартной библиотеки Python. Одним из примеров является functools.wraps. Мы сосредоточимся на трех главных декораторах, указанных выше.
@classmethod и @staticmethod
Я не пользовался ими ранее, так что сделал небольшое исследование.
Если мы взглянем на пример кода, в котором показано, как работает декоратор, это может помочь понять основные принципы:
Функция property() в Python
Приглашаем всех желающих на двухдневный онлайн-интенсив «Разработка десктоп-приложения с помощью библиотеки Tkinter». На интенсиве получим начальные навыки бэкенд-разработки на Python, а также начнем разработку десктоп-приложения с помощью библиотеки Tkinter. По итогам 2х дней сможем создать инвестиционное приложение для просмотра актуальной цены на необходимые акции или валюту. Присоединяйтесь!
Функция property() используется для определения свойств в классах.
Метод property() обеспечивает интерфейс для атрибутов экземпляра класса. Он инкапсулирует атрибуты экземпляров и предоставляет свойства, аналогично тому, как это работает в Java и C#.
fget : (опционально) Функция для получения значения атрибута. Значение по умолчанию None.
fset : (опционально) Функция для задания значения атрибута. Значение по умолчанию None.
fdel : (опционально) Функция для удаления значения атрибута. Значение по умолчанию None.
doc : (опционально) Строка, содержащая документацию. Значение по умолчанию None.
Возврат значений:
Возвращает атрибут свойства из заданных геттера, сеттера и функции удаления.
Аналогично можно написать метод удаления свойства, как в коде ниже.
Таким образом, мы можем определить свойство в классе с помощью функции property() в Python.
Регистрация на двухдневный онлайн-интенсив «Разработка десктоп-приложения с помощью библиотеки Tkinter»: День 1, День 2.
Использование property в Python
Руководство с примерами использования функции property в языке программирования Python.
Введение
Функция property — создает вычисляемое свойство, которое позволяет использовать методы класса в качестве свойств объектов. Свойство — это аттрибут класса, который может считывать или записывать информацию. Использование property создает дескриптор, который позволяет создавать свойства объекту.
Проблема
Давайте рассмотрим пример. Существует класс человек, возраст которого не может быть меньше 0 и больше 120. Типичная ООП программа будет выглядеть примерно так:
Как мы видим в этой реализации присутствуют некоторые проблемы и давайте их рассмотрим внимательно.
Создадим экземпляр 30 летнего человека, и проверим корректность введенных данных.
Число 30 входит в рамки человеческой жизни и проблем у нас не возникло.
Попробуем ввести возраст вне рамок человеческой жизни
В данном примере мы обратились к методу класса, который проверил входные данные, из-за чего нам не удалось выставить некорректный возраст.
Но мы можем напрямую обратиться к аттрибуту self.age и указать абсолютно любой возраст.
Таким способом мы нарушаем алгоритм работы нашего класса, что является серьезной проблемой.
Решение
Для решения этой проблемы существуют два способа. Первый способ подразумевает использование декоратора функции, а второй способ указывает в функции property getter, setter и deleter.
Использование декоратора
@property — это декоратор, который обрабатывает получение, установку и удаление переменных класса так, как это было задумано в Python. Код для вышеописанного сценария будет выглядеть теперь так:
Наш код стал более лаконичным, но давайте разберемся по пунктам что же все таки изменилось и на что это повлияло.
Обратите внимание, что обе функции имеют одинаковое имя. Это необходимо для работы программы.
Попробуем установить некорректное значение и посмотрим что получится:
Используя декоратор @property мы ограничиваем возможность указания значений переменным в классе.
Прямое указание функций
Во втором варианте использование property мы описываем функцию для установки значения и получения значения.
Как видите, нам просто нужно было изменить переменные и добавить специальную строку age = property(get_age, set_age), которая залатала дыры в нашем исходном коде и сэкономила нам кучу времени!
Все работает, как и ожидалось.
Вывод
В данном руководстве мы рассмотрели, как и для чего использовать property, воспользовались двумя вариантами реализации и проверили оба. Я не упомянул в статье о так называемых deleter, предлагаю вам сделать это самостоятельно.
Декоратор свойств @property в Python
Сегодня мы узнаем о декораторе свойств @property в Python.
Как мы уже говорили, мы можем улучшить функцию с помощью декораторов. Есть несколько встроенных декораторов.
@property в Python – один из встроенных декораторов. Основная цель любого декоратора – изменить методы или атрибуты вашего класса таким образом, чтобы пользователю вашего класса не нужно было вносить какие-либо изменения в свой код.
Рассмотрим следующий сегмент класса:
Он будет выводиться, как показано ниже:
Теперь предположим, что мы хотим изменить атрибут name класса ученика, что тогда произойдет? Добавьте следующие 3 строки после предыдущего кода:
Обратите внимание, что атрибут name был изменен, но предложение, созданное атрибутом gotmarks, осталось таким же, каким оно было установлено во время инициализации объекта student.
Но мы хотим, чтобы при обновлении имени учащегося также менялись метки.
Использование функции
Он будет выводиться следующим образом:
Внимательно посмотрите на код. Мы удалили атрибут gotmarks из конструктора и добавили метод с именем gotmarks.
Итак, теперь в нашем классе нет атрибута с именем gotmarks, и у нас есть метод с именем gotmarks().
И из-за этого изменения любой пользователь, использующий мой класс, столкнется с проблемами, поскольку им придется заменить все атрибуты gotmarks вызовом функции gotmarks(). Предположим, что есть 1000 строк кода, тогда как это будет сложно для кодировщика.
Решение вышеуказанной проблемы
Поэтому мы решим эту проблему питоническим способом, используя декоратор свойств. Обратите внимание на следующий код:
Он предоставит тот же результат, что и раньше, и не забудьте удалить ‘()’ после меток при его печати. Просто напишите @property над функцией gotmarks(), чтобы ее можно было использовать как свойство.
А пользователь нашего класса даже не знает, что атрибут gotmarks удален, и у нас есть для этого функция. Вот как декоратор свойств помогает поддерживать слабую связь нашего кода с клиентским кодом.
Пример установки
Теперь предположим, что мы хотим установить атрибут name и mark, когда мы изменяем значение gotmarks. Внимательно следите за кодом:
Поскольку мы хотим обновить значение имени и меток, когда мы устанавливаем значение gotmarks. Итак, используя установщик декоратора @proprety, мы можем добиться этого.
Обратите внимание, что мы написали @ gotmarks.setter, что означает, что мы применяем сеттер к методу gotmarks. Затем мы разбиваем предложение и обновляем значение имени и оценок.
Приведенный выше декоратор свойств с установщиком выдаст результат ниже.