🐍 Графическая шпаргалка по Python

✄┈┈┈┈┈┈┈┈┈┈┈┈┈
Заметки программиста «(!?»
🇨🇱 Python Tech Code

📗 pdoc – генератор документации для Python с поддержкеи Type Hints

Автоматически создаёт чистую и современную документацию из docstring и аннотаций типов Python. Альтернатива Sphinx с фокусом на простоту и читаемость.

ℹ️ Главная задача:
Превращает docstring и type hints в интерактивную документацию без сложных конфигов.

Установка библиотеки:

pip install pdoc

Пример использования:

# Генерация документации для модуля
pdoc ./my_module --output-dir ./docs

💻 GitHub

✅ Ключевое преимущество:
Поддержка type hints и математических формул в Markdown из коробки.

✄┈┈┈┈┈┈┈┈┈┈┈┈┈
Заметки программиста «(!?»
🇨🇱 Python Tech Code

🚩Как написать ужасный код на Python: 6 смертных грехов

1️⃣ Криптованные имена переменных
x, data, temp — идеально! Пусть коллеги ломают голову, что делает этот код:

def f(a, b):
    return sum(i for i in range(a * 2) if b else a - b

2️⃣ Максимальная сложность в одной строке
Чем больше действий в одном выражении — тем лучше:

result = [x if x % 2 else (y // 2 if y > 10 else None) for x, y in zip(data1, data2) if x or y]

3️⃣ Глобальные переменные и перезапись типов
Меняйте типы на ходу и управляйте состоянием отовсюду:

value = "42"
value = int(value)  # Теперь число!
value = [value] * 3  # А теперь список!

4️⃣ Магические числа и eval()
Без комментариев и с опасными конструкциями:

if user.role == "XYZ_LEVEL_42":
    eval(f"delete_user({user.id})")  # Ничего не может пойти не так!

5️⃣ Игнорирование PEP 8
Отступы? Пробелы? Не, не слышали:

def foo():return 42
if True:print("Да")
else:  print("Нет")

6️⃣ Мёртвый код и копипаста
Никогда не удаляйте старый код. И вот этот шедевр с Stack Overflow тоже оставьте:

def calculate(x):
    # Кто-то на форуме сказал, что это работает...
    return (lambda y: y**2 + 1)(x) if x > 0 else 0

✄┈┈┈┈┈┈┈┈┈┈┈┈┈
Заметки программиста «(!?»
🇨🇱 Python Tech Code

🙏 You-Get — универсальный загрузчик медиа из командной строки

Популярный Python-инструмент для скачивания видео, аудио и изображений с 1000+ сайтов (YouTube, Twitter, Bilibili и др.). Работает напрямую через командную строку без API-ключей.

Установка библиотеки:

pip install you-get

Пример использования:

# Скачать видео/аудио по ссылке (автоопределение качества)
you-get https://www.youtube.com/watch?v=dQWgXcQ

# Показать доступные форматы без скачивания
you-get --info https://vimeo.com/1236789

# Скачать конкретный формат (по itag)
you-get --itag=137 https://youtu.be/VIDEO_ID  # 4K
you-get --itag=140 https://youtu.be/VIDEO_ID  # Аудио 128kbps

💻 GitHub

‼️ P.S. Хотите выбрать качество? Добавьте --info к команде, чтобы увидеть доступные варианты перед загрузкой.

✄┈┈┈┈┈┈┈┈┈┈┈┈┈
Заметки программиста «(!?»
🇨🇱 Python Tech Code

🚩Пять правил хорошего кода

1️⃣ Читаемые имена переменных

def calculate_discount(price, discount_rate):
    return price * (1 - discount_rate)

2️⃣ Разделяйте логику

def process_data(items):
    filtered = [item for item in items if item.is_valid()]
    return sum(filtered)

3️⃣ Локальные переменные и константы

MAX_RETRIES = 3  # Константа с понятным именем

def connect_to_api():
    retries = 0  # Локальная переменная

4️⃣ Документируйте и соблюдайте PEP 8

def format_user_name(user):
    """Возвращает полное имя пользователя в формате 'Имя Фамилия'."""
    return f"{user.first_name} {user.last_name}"

5️⃣ Удаляйте ненужное
Если код не используется — смело удаляйте. Git сохранит историю при необходимости.

✔️(Пишите код так, будто его будет поддерживать психопат, который знает, где вы живете.)

✄┈┈┈┈┈┈┈┈┈┈┈┈┈
Заметки программиста «(!?»
🇨🇱 Python Tech Code