Что такое kwargs python
Хватит злоупотреблять *args и **kwargs в Python
Да будет холивар! Использовать args/kwargs или не использовать, это показатель профессионализма или базовые знания, без которых должно быть стыдно? Часто листая github различных проектов натыкаешься на наличие данных аргументов в функциях просто потому что. И данная статья натолкнула на пообщаться на эту тему. Вообще, стараюсь не использовать неконтролируемое аргументирование на практике, но на сколько это вообще распространенный метод программирования? Делитесь в комментариях. И приятного чтения.
В Интернете полно обучалок, которые научат вас использовать *args и **kwargs при определении функции в Python. Возможно, вы уже часами пытаетесь понять, как раскрыть их потенциал. Может быть, после всего этого исследования вы теперь чувствуете в них уверенность.
Мощные инструменты опасны. Вы могли облегчить свою жизнь, но запомните мои слова, они вскоре вернутся, чтобы преследовать вас.
Немного основ
Параметры в Python функции могут принимать два типа аргументов:
Позиционные аргументы, которые передаются позиционно.
Именованные аргументы, которые передаются с ключевыми словами.
С другой стороны, **kwargs позволяет передавать вашей функции произвольное количество аргументов с ключевыми словами. Поскольку у каждого именованного аргумента есть ключевое слово и значение, он сгруппирован как итерируемый словарь внутри функции.
Photo by Susan Holt Simpson on Unsplash
Проблема
Код гораздо сложнее отлаживать, если вы злоупотребляете в нем подобными решениями, потому что вы позволяете передавать произвольное количество аргументов функции, и функция может вести себя непредсказуемо.
Когда всё-таки использовать аргументы?
Если кратко: используйте их, когда они вам действительно нужны. Например, функция с множеством необязательных полей, и некоторые из них используются только в редких ситуациях. Скажем, функция строит график, и вы можете передавать различные необязательные аргументы, чтобы изменить его цвет, стиль, размер и т.д.
Есть один сценарий, в котором их использование может быть неизбежным. Если вы создаете оболочку для функции с неизвестными аргументами, вам нужно будет принять произвольное количество позиционных и именованных аргументов, а затем передать их функции.
Например, декораторы в Python работают как оболочки, которые изменяют поведение кода, не изменяя сам код функции, тем самым расширяя дополнительные функции.
Photo by Alexander Schimmeck on Unsplash
Выводы
По возможности избегайте их.
Обратите внимание, что args и kwargs так называются просто по соглашению. Вы можете называть их как хотите. Именно звездочки * и ** дают функциям ту самую мощь.
Что такое *args и **kwargs в Python?
Функции — жизнь, не так ли? Не важно, новичок вы в программировании в целом или пришли из другого языка: осваивая Python, вы узнаете, что число параметров, указанных в определении функции, совпадает с числом передаваемых аргументов.
Не позволяйте синтаксису вас напугать. Это никакие не особые параметры. Они вообще не особо вычурны, и мы сейчас научимся их правильно использовать.
Позиционные аргументы против именованных
Для понимания *args и **kwargs нам потребуется разобраться с двумя принципами, а точнее понять разницу между позиционными и именованными аргументами. В самых простых функциях мы играем в игру сопоставления — аргумент 1 сопровождает параметр 1, аргумент 2 сопровождает параметр 2 и т.д.
Все три аргумента необходимы. Упущение любого из них вызовет ошибку.
Если мы назначим параметру в определении функции значение по умолчанию, тогда он станет опциональным.
Помимо этого, опциональные параметры получают возможность именования. То есть вы можете определить имя параметра в вызове функции, чтобы потом отобразить его.
Давайте назначим всем трем переменным значения по умолчанию none и посмотрим, как мы при этом сможем отобразить их независимо от последовательности.
Оператор *
Я могу описать его как оператор расширения, распаковывающий наборы домино, чтобы потом выстроить из них одну единую огромную последовательность. Однако звездочка представляет еще более мощную аналогию. Вот простой пример:
Как использовать *args и **kwargs
Итак, нам известно, что оператор * распаковывает множественные значения и существует два типа параметров функции. Если вы до сих пор не догадались, то *args — это сокращение от arguments (аргументы), а **kwargs — это сокращение от keyword arguments (именованные аргументы).
Каждый из них используется для распаковки соответствующих им типов аргументов, определенных вызовами функции, согласно списку аргументов переменной длины.
Например, давайте создадим функцию для печати баллов для тестирования студента:
Заключение
Немного мудрых слов в напутствие вам для избежания распространенных ошибок и расширения знаний:
Что такое *args и **kwargs в Python?
Функции — это жизнь. Правда? Если вы только начали осваивать Python, неважно — первый ли это ваш язык программирования, или вы пришли в Python из другого языка, то вы уже знаете о том, что количество параметров в объявлении функции соответствует количеству аргументов, которые передают функции при вызове.
Не позволяйте всяким значкам загонять себя в ступор. Тут нет ничего архисложного. В общем-то, если эти конструкции вам незнакомы — предлагаю с ними разобраться.
Позиционные и именованные аргументы
Сначала поговорим о том, чем они отличаются. В простейшей функции мы просто сопоставляем позиции аргументов и параметров. Аргумент №1 соответствует параметру №1, аргумент №2 — параметру №2 и так далее.
Для вызова функции необходимы все три аргумента. Если пропустить хотя бы один из них — будет выдано сообщение об ошибке.
Если при объявлении функции назначить параметру значение по умолчанию — указывать соответствующий аргумент при вызове функции уже необязательно. Параметр становится опциональным.
Опциональные параметры, кроме того, можно задавать при вызове функции, используя их имена.
В следующем примере установим три параметра в значение по умолчанию None и взглянем на то, как их можно назначать, используя их имена и не обращая внимания на порядок следования аргументов, применяемых при вызове функции.
Оператор «звёздочка»
Оператор * чаще всего ассоциируется у людей с операцией умножения, но в Python он имеет и другой смысл.
Этот оператор позволяет «распаковывать» объекты, внутри которых хранятся некие элементы. Вот пример:
Как пользоваться *args и **kwargs
Итак, мы знаем о том, что оператор «звёздочка» в Python способен «вытаскивать» из объектов составляющие их элементы. Знаем мы и о том, что существует два вида параметров функций. Вполне возможно, что вы уже додумались до этого сами, но я, на всякий случай, скажу об этом. А именно, *args — это сокращение от «arguments» (аргументы), а **kwargs — сокращение от «keyword arguments» (именованные аргументы).
Каждая из этих конструкций используется для распаковки аргументов соответствующего типа, позволяя вызывать функции со списком аргументов переменной длины. Например — создадим функцию, которая умеет выводить результаты, набранные учеником в тесте:
Итоги
Вот несколько советов, которые помогут вам избежать распространённых проблем, возникающих при работе с функциями, и расширить свои знания:
Что такое args и kwargs в Python
Python позволяет нам определять три типа аргументов для функции:
Некоторые важные моменты об аргументах функций:
Зачем нам нужны * args и ** kwargs?
Допустим, у нас есть функция для сложения двух чисел:
Теперь мы хотим расширить это, чтобы добавить три числа. Мы не можем просто изменить эту функцию, потому что она может использоваться в других местах, и это будет серьезное изменение. Итак, мы вводим еще одну функцию для сложения трех чисел.
Вы видите, к чему я клоню, верно? Поскольку у нас есть возможность указать переменное количество аргументов для функции, мы можем определить универсальную функцию для сложения чисел.
Пример с * args
Давайте определим универсальную функцию для сложения чисел с использованием переменных * args.
Что это за тип * args и ** kwargs?
Пример с ** kwargs
Давайте определим функцию, чтобы показать использование переменных ** kwargs.
Передача кортежа и словаря для сопоставления
Давайте посмотрим, как передать значения кортежа для сопоставления с элементами args и словаря переменной kwargs.
Обратите внимание на использование * при использовании кортежа для сопоставления его значений с аргументами. Аналогичным образом ** используется для сопоставления элементов dict с переменной kwargs.
Когда использовать?
Вы можете использовать их в любой функции, где вы ожидаете переменное количество аргументов. Однако они очень полезны в двух конкретных случаях — имитация ответа функции и написание общей функции-декоратора.
Имитация ответа функции
Допустим, у нас есть класс API, определенный следующим образом:
Мы можем создать функцию симулятора тестирования и сопоставить ее с функцией API, чтобы сгенерировать тестовый ответ.
Давайте теперь посмотрим, что произойдет, когда мы будем использовать наши функции API.
Функция декоратора
Давайте посмотрим, как мы можем определить функцию-декоратор для регистрации переменных функции.
Теперь мы можем использовать эту функцию декоратора с любой другой функцией для записи их аргументов в консоль.
Python: *args, **kwargs и декораторы для начинающих
Python имеет много конструкций, которые достаточно просты для изучения и использования в нашем коде. Тогда как есть некоторые конструкции, которые всегда смущают нас, когда мы сталкиваемся с ними в нашем коде.
Я думаю, что многие из моих друзей по Data Scientists сталкивались с ними тоже.
Большинство функций seaborn так или иначе используют *args и **kwargs.
Или как насчет декораторов?
В этой серии статей под названием « Python Shorts » я объясню некоторые простые конструкции, предоставляемые Python, некоторые важные советы и некоторые примеры использования, которые я регулярно придумываю в своей работе.
Этот пост посвящен объяснению некоторых сложных концепций в доступной для понимания форме.
Что такое *args?
Проще говоря, вы можете использовать, *args чтобы дать произвольное количество входных аргументов для вашей функции.
Простой пример:
Допустим, мы должны создать функцию, которая добавляет два числа. Мы можем сделать это легко в Python следующим образом.
Что если мы хотим создать функцию для добавления трех переменных?
Что если мы хотим, чтобы одна и та же функция добавила неизвестное количество переменных? Обратите внимание, что мы можем использовать *args или *argv или *anyOtherName чтобы сделать это.
Теперь вы можете использовать ту же функцию следующим образом:
Что такое **kwargs?
Проще говоря, вы можете использовать, **kwargs чтобы дать произвольное количество ключевых слов для вашей функции и получить к ним доступ, используя словарь.
Простой пример:
Допустим, вы хотите создать функцию печати, которая может принимать имя и возраст в качестве входных данных и печатать их.
Давайте теперь скажем, что вы хотите, чтобы одна и та же функция принимала два имени и два возраста.
Вы правильно догадались, что мой следующий вопрос: что если я не знаю, сколько аргументов мне понадобится?
Вы можете вызвать эту функцию используя:
Помните, что мы никогда не определяли Sansa, Arya или Tyrion в качестве аргументов наших методов.
Это довольно мощная концепция. И многие программисты используют это довольно умно, когда пишут библиотеки-обертки.
Это может сэкономить много усилий при написании кода, а также делает код на будущее. Если в какой-либо момент в будущем plt.scatter будет принимать какие-либо новые аргументы, функция seaborn.Scatterplot все равно будет работать.
Что такое декораторы?
Простой пример:
Допустим, мы хотим добавить пользовательские функции к некоторым из наших функций. Функциональность заключается в том, что всякий раз, когда вызывается функция, печатается « function name begins», а всякий раз, когда функция заканчивается, печатаются « function name ends» и время, затраченное функцией.
Давайте предположим, что наша функция:
Мы можем добавить несколько строк с print для всех наших функций, чтобы достичь этого.
Вот где декораторы нам пригодятся. Мы можем использовать декораторы, чтобы обернуть любую функцию.
Теперь мы можем использовать этот декоратор timer для украшения нашей функции somefunc
Теперь, вызывая эту функцию, мы получаем:
Теперь мы можем добавить @timer к каждой нашей функции, для которой мы хотим, чтобы печаталось время.
Соединяя все части
Что если наша функция принимает три аргумента? Или много аргументов?
Именно здесь соединяется все, что мы узнали до сих пор. Мы используем *args и **kwargs
Мы меняем нашу функцию декоратора так:
Теперь наша функция может принимать любое количество аргументов, и наш декоратор все равно будет работать.
На мой взгляд, декораторы могут быть очень полезными. Я предоставил только один вариант использования декораторов, но есть несколько способов их использования.
Вы можете использовать декоратор для отладки кода, проверяя, какие аргументы входят в функцию. Или декоратор может быть использован для подсчета количества вызовов конкретной функции. Это может помочь с подсчетом рекурсивных вызовов.
Заключение
В этом посте я рассказал о некоторых конструкциях, которые вы можете найти в исходном коде Python, и о том, как вы можете их понять.
Не обязательно, чтобы вы в конечном итоге использовали их в своем коде. Но я предполагаю, что понимание того, как эти вещи работают, помогает смягчить некоторую путаницу и панику, с которой сталкиваются каждый раз, когда появляются эти конструкции.