#docstring #функции #модули

Что такое Docstrings в Python?
Docstrings (документационные строки) — это строковые литералы, которые размещаются сразу после определения функции, метода, класса или модуля в Python. Они служат для документирования кода и предоставляют информацию о том, что делает данный элемент кода.Основные характеристики docstrings:

Расположение: Docstring должен быть первой строкой в теле функции, класса или модуля. Это позволяет Python распознавать его как документацию для данного элемента.

Формат: Docstrings обычно заключаются в тройные кавычки (одинарные или двойные), что позволяет им занимать несколько строк, если это необходимо. Это делает их удобными для более подробного описания.

Цель: В отличие от обычных комментариев, которые могут объяснять отдельные строки кода, docstrings предоставляют высокоуровневое описание того, что делает функция, класс или модуль. Это помогает другим разработчикам (или вам самим в будущем) быстро понять назначение и использование кода.

Доступность: Docstrings доступны через встроенную функцию help(), что позволяет пользователям получать информацию о функции или классе, не заглядывая в исходный код.

Стандарты: Существуют определенные соглашения по написанию docstrings, такие как PEP 257, которые описывают, как правильно оформлять и структурировать документацию.

Пример использования docstring
Вот простой пример функции с docstring:

def add(a, b):
"""
Возвращает сумму двух чисел.

Параметры:
a (int, float): Первое число.
b (int, float): Второе число.

Возвращает:
int, float: Сумма a и b.
"""
return a + b

В этом примере docstring описывает, что делает функция add, какие параметры она принимает и что возвращает. Это делает код более понятным и удобным для использования
_________________________
Записать. Проверить код.
Перейдите на сайт Colab Откройте colab.research.google.com в любом браузере.

🥸Перейти, узнать больше про канал👀📚📃

📌 Функции и объекты: определения

1️⃣ Функция

Функция — это именованный блок кода, который выполняет определенную задачу и может принимать параметры (аргументы), а также возвращать результат.

def greet(name): # Объявление функции
return f"Привет, {name}!"

print(greet("Анна")) # Вызов функции

👉 Ключевые свойства:


Имеет имя (greet).

Может принимать входные данные (name).

Может возвращать результат (return).


2️⃣ Объект

В Python всё является объектом — это экземпляр класса, который содержит:

Данные (атрибуты).

Методы (функции, связанные с объектом).

numbers = [1, 2, 3] # numbers — объект класса list
numbers.append(4) # append() — метод объекта

👉 Даже числа, строки и функции — это объекты!


🔁 Функции как объекты (first-class citizens)

В Python функции — объекты первого класса, поэтому их можно:

1️⃣ Присваивать переменным

def say_hello():
return "Hello!"

greeting = say_hello # Функция становится объектом в переменной
print(greeting()) # Hello!

2️⃣ Передавать в другие функции

def apply(func, x):
return func(x) # Вызов переданной функции

def square(n):
return n * n

print(apply(square, 5)) # 25

3️⃣ Возвращать из функций

def create_multiplier(factor):
def multiplier(x):
return x * factor
return multiplier # Возвращаем функцию!

double = create_multiplier(2)
print(double(10)) # 20

4️⃣ Хранить в структурах данных

funcs = [lambda x: x + 1, lambda x: x * 2]
print(funcs[0](5)) # 6 (первая функция)
print(funcs[1](5)) # 10 (вторая функция)

💡 Зачем это нужно?

✅ Гибкость: Можно создавать абстракции высшего порядка (например, декораторы).

✅ Повторное использование кода: Логику можно менять, подставляя разные функции.

✅ Функциональное программирование: Возможность работать с функциями как с данными.

# Пример: декоратор (функция, принимающая и возвращающая функцию)
def logger(func):
def wrapper(*args):
print(f"Вызов функции {func.name}")
return func(*args)
return wrapper

@logger
def add(a, b):
return a + b

print(add(3, 5)) # Вывод: "Вызов функции add", затем 8

Вывод: В Python функции — это объекты, которые можно передавать, возвращать и видоизменять, что открывает множество возможностей!

👉 Используете ли вы функции как объекты в своих проектах? 💬

#Юмор #ИИ #Видео

ИИ буквально изобразил меню.

📚🌎✍️Задание по языку для 2 класса: Вставьте пропущенные слова:

- "Какая [...] (кто?) завела нас в этот [...] (какой?) лес?"🫦

Почему-то после армии даются тяжело.👀


🥸 Знаешь с кем поделиться? 👀📚📃

#Python #Lambda #Программирование #Код #Автоматизация #Фриза

Lambda-функции: кратко и мощно

"Сокращай код, увеличивай доход! Lambda-функции — твой инструмент для быстрых и элегантных решений."

# Обычная функция

def square(x):
return x ** 2

# Lambda-аналог
square_lambda = lambda x: x ** 2

print(square(5)) # 25
print(square_lambda(5)) # 25

Отличие от обычных функций:

✳️ Анонимность (нет имени)

✳️ Занимает 1 строку

✳️ Не требует return

Зачем нужны?

Для быстрых операций, где не нужно объявлять полноценную функцию (фильтрация, сортировка).

🥸 Знаешь с кем поделиться? 👀📚📃

#Лямбда #Python #LambdaФункции #Программирование #Код #Деньги


Почему Lambda? История и выгода

"Меньше кода — больше денег. Lambda-функции экономят время, а время — это деньги!"

# Фильтрация четных чисел (обычная функция)
def is_even(x):
return x % 2 == 0

# Lambda-версия
numbers = [1, 2, 3, 4, 5]
evens = list(filter(lambda x: x % 2 == 0, numbers))
print(evens) # [2, 4]

Почему появились Lambda?

🔹Упрощение кода для простых операций
🔹Удобство в функциях высшего порядка (map, filter, sorted)
🔹Не загромождают пространство имен

🥸 Знаешь с кем поделиться? 👀📚📃

#PythonDev #Lambda #Код #Заработок #Фриланс #IT

Lambda ФУНКЦИЯ

"Выбирай инструмент под задачу: Lambda для скорости, обычные функции для сложной логики. Оптимизируй и зарабатывай!"

# Сортировка по длине строк (обычная функция)
def sort_by_length(words):
return sorted(words, key=lambda x: len(x))

# Пример использования
words = ["Python", "Java", "C++", "JavaScript"]
print(sort_by_length(words)) # ['C++', 'Java', 'Python', 'JavaScript']

Когда использовать Lambda?

✅ Однострочные операции
✅ Временные функции
✅ В аргументах map/filter

Когда не использовать?

❌ Сложная логика (лучше обычная функция)
❌ Многократное использование (трудно читать)
Философия:
"Lambda — это не замена, а дополнение. Используй их там, где они делают код чище!"
________________________________________
Итог:
Lambda — анонимные, компактные, для простых задач.
Обычные функции — именованные, для сложной логики.
Выгода: Экономия времени → больше проектов → больше денег!
💡 Какой стиль предпочитаешь? Делитесь в комментариях!

🥸 Знаешь с кем поделиться? 👀📚📃

#PythonDev #Код #Заработок #Фриланс #IT

🔥✨"Что пользы в том, что ты многое знал,
раз ты не умел применять
твои знания к твоим нуждам."

👏 (Франческо Петрарка)


🥸 Знаешь с кем поделиться? 👀📚📃

Пора возвращаться в прошлое, чтобы исправить ошибки
#Юмор #ВосстаниеМашин #Андроид

🤖 Восстание машин началось 🔥

Ну да, пока вот такое

🥸 Знаешь с кем поделиться? 👀📚📃

🇨🇳 В Шанхае 432 робота переместили исторический комплекс зданий весом 7500 тонн обратно на его изначальное место

Этим домам больше ста лет. Их временно сдвинули, чтобы проложить под ними метро, а затем вернули обратно.

Роботы синхронно «шагали» больше двух недель, проходя по 10 метров в день.
В проекте были задействованы 432 робота.
Роботы использовали передовые технологии, такие как автоматизация и управление движением, что позволяло им совместно работать, избегая столкновений и обеспечивая безопасность.

Экологические аспекты: Проект также учитывал экологические факторы, минимизируя воздействие на окружающую среду и обеспечивая устойчивость новых построек.

🥸 Знаешь с кем поделиться? 👀📚📃

#Python #Lambda #Программирование #Код #Автоматизация #Фриланс


Lambda-функции: мощь в одной строке

"Освой лаконичный код - и первые заказы не заставят себя ждать! Lambda - твой шаг к профессиональному программированию."

# Сортировка списка по второму элементу
data = [(1, 5), (3, 2), (2, 8)]
sorted_data = sorted(data, key=lambda x: x[1])
print(sorted_data) # [(3, 2), (1, 5), (2, 8)]

Одна строка кода заменяет целую функцию – В чем сила брат?😃 Вот сила Python!

🥸 Знаешь с кем поделиться? 👀📚📃

#Лямбда #Функции #PythonDev #Программирование #Старт #Деньги


❗️✨ Зарабатывай на компактном коде

"Чем чище и короче твои решения, тем ценнее ты как разработчик. Lambda-функции - твой инструмент для элегантного кода."

# Фильтрация четных чисел
numbers = [1, 2, 3, 4, 5]
evens = list(filter(lambda x: x % 2 == 0, numbers))
print(evens) # [2, 4]

Просто? Да. Эффективно? Еще как! Клиенты любят лаконичные решения.

🥸 Знаешь с кем поделиться? 👀📚📃

#Python #Lambda #Map #Кодер #Заработок #IT


Преврати lambda в деньги

"Чем быстрее ты решаешь задачи клиента, тем быстрее клиент решает свои задачи, а это дороже рекламных слоганов, и тем больше у тебя времени для проектов, которые сможешь взять. "

"Lambda - оружие эффективного разработчика!"

# Умножение всех элементов на 2
nums = [1, 2, 3]
doubled = list(map(lambda x: x * 2, nums))
print(doubled) # [2, 4, 6]

Одно lambda-выражение заменяет 5 строк кода. Время = деньги, а ты только что сэкономил и то, и другое!

🥸 Знаешь с кем поделиться? 👀📚📃

#lambda #docstring #СортировкиСписка

Пример кода на Python, который включает в себя использование lambda для сортировки списка, функцию с описанием через docstring, а также пояснения и комментарии:

def sort_list(input_list, reverse=False):
"""
Сортирует список чисел или строк в порядке возрастания или убывания.

Аргументы:
input_list (list): Список элементов (чисел или строк), которые нужно отсортировать.
reverse (bool): Если True, сортировка будет в порядке убывания. По умолчанию False.

Возвращает:
list: Отсортированный список.

Пример:
>>> sort_list([3, 1, 4, 1, 5, 9])
[1, 1, 3, 4, 5, 9]
>>> sort_list(["apple", "banana", "cherry"], reverse=True)
['cherry', 'banana', 'apple']
"""
# Используем встроенную функцию sorted() с ключом сортировки, заданным через lambda
# Если reverse=True, список сортируется в обратном порядке
return sorted(input_list, key=lambda x: x, reverse=reverse)


# Пример использования функции
if __name__ == "__main__":
# Список чисел
numbers = [3, 1, 4, 1, 5, 9]
print("Сортировка чисел по возрастанию:", sort_list(numbers))
print("Сортировка чисел по убыванию:", sort_list(numbers, reverse=True))

# Список строк
words = ["apple", "banana", "cherry"]
print("Сортировка строк по возрастанию:", sort_list(words))
print("Сортировка строк по убыванию:", sort_list(words, reverse=True))

Пояснения к коду:

Функция sort_list:
Принимает два аргумента:
input_list: список элементов (чисел или строк), которые нужно отсортировать.
reverse: логический флаг, указывающий, нужно ли сортировать в обратном порядке.
Использует встроенную функцию sorted() для сортировки.
В качестве ключа сортировки используется lambda x: x, что означает, что элементы сортируются "как есть".

Lambda-функция:
lambda x: x — это анонимная функция, которая просто возвращает элемент x. Она используется как ключ сортировки.

Docstring:
Описание функции написано в формате docstring, чтобы можно было получить справку через help(sort_list).

Комментарии:
В коде добавлены комментарии, поясняющие, что делает каждая часть.

Пример использования:
В блоке if name == "main": показано, как использовать функцию для сортировки чисел и строк.


Как проверить описание функции:

После запуска кода в Python, вы можете вызвать help(sort_list) для получения справки:

>>> help(sort_list)


Вывод будет таким:

Help on function sort_list in module __main__:

sort_list(input_list, reverse=False)
Сортирует список чисел или строк в порядке возрастания или убывания.

Аргументы:
input_list (list): Список элементов (чисел или строк), которые нужно отсортировать.
reverse (bool): Если True, сортировка будет в порядке убывания. По умолчанию False.

Возвращает:
list: Отсортированный список.

Пример:
>>> sort_list([3, 1, 4, 1, 5, 9])
[1, 1, 3, 4, 5, 9]
>>> sort_list(["apple", "banana", "cherry"], reverse=True)
['cherry', 'banana', 'apple']

Этот код универсален и подходит для сортировки как чисел, так и строк.

🥸 Знаешь с кем поделиться? 👀📚📃