Добро пожаловать на мой канал Код на салфетке!

Меня зовут Иван, и я рад приветствовать вас в этом канале, посвящённом программированию и моему личному опыту в этой сфере.

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

Я полагаю, что у нас есть много общих интересов, и с большим удовольствием поделюсь всей информацией, которую найду в процессе своего обучения. Мой канал - это площадка, где вы сможете узнать что-то новое, поделиться своим опытом и успехами в программировании и, конечно же, задать свои вопросы.

Давайте вместе будем учиться программировать! Присоединяйтесь к обсуждению и делитесь опытом.

Планы на ближайшее будущее.

Приветствую.

Канал только создан, а планов уже вагон и маленькая тележка!

Планы по развитию канала:
1. Нарисовать аватарку =)
2. Сделать Telegram-бота для канала
3. Сделать сайт с более расширенными версиями постов.
4. Делать качественный контент ;)

С чего собственно начнём?
Вот с сайта и начнём.
Скоро начнется серия (возможно длинная серия) постов о процессе создания собственного сайта на Django.
Также возможно, что это будет перемешиваться с постами о разработке бота и последующей связке сайта с ботом.

Также, если у вас есть идеи для контента, интересные вам библиотеки или фреймворки, занятные задачки на программирование - смело предлагайте в комментариях. То, что заинтересует меня, может появиться в будущих публикациях.

Оглавление для серии постов по Django.

Для удобства навигации по предстоящим материалам, в данном посте будут публиковаться ссылки на сообщения.

Django 1. Установка Django
Django 2. Создание проекта
Django 3. Базовая конфигурация
Поправка к посту Django 3. Базовая конфигурация
Django 4. Суперпользователь и первый запуск
Django 5. Инициализация приложения блога
Django 6. Базовый шаблон
Django 7. Первое представление
Django 8. Первая модель
Поправка к посту Django 8 Первая модель.
Django 9. Регистрация модели
Django 10. Пишем API - Сериализатор
Django 11. Пишем API - Обработчик запросов
Django 12. Настройка отправки почты
Django 13. Сброс пароля
Django 14. Модель пользователя бота
Django 15. Пишем API - Добавление пользователя
Django 16. Модель категорий
Django 17. Разделение шаблонов
Django 18. Представление для главной и категорий
Django 19. Визуальный редактор CKEditor5
Django 20. Модель поста
Django 21. Регистрация модели поста
Django 22. Представление для страницы поста
Django 23. Добавляем sitemap и счётчики
Django 24. Связь модели файла и поста
Django 25. Добавляем теги к постам
Django 26. Контекстные процессоры
Django 27.1 Представления на основе классов
Django 27.2 Представления на основе классов - Практика
Django 28. Добавляем пагинацию на сайт
Django 29.1 Добавляем поиск на сайт
Django 29.2 Добавляем поиск на сайт, продолжение
Django 30. Рефакторинг и допущенные ошибки
Django 31. Форма авторизации и кнопка выхода
Django 32. Форма регистрации
Django 33. Сброс пароля пользователя
Django 34.1. Простой профиль пользователя - страница профиля
Django 34.2. Простой профиль пользователя - страница настроек
Django 35.1. Расширенный профиль пользователя - модель и сигналы
Django 35.2. Расширенный профиль пользователя - форма и шаблон
Django 36. Добавление постов пользователем
Django 37. Две формы - добавление категории и файла
Django 38.1. Кабинет и все посты автора
Django 38.2. Добавление, редактирование, удаление поста
Django 39. Капча и подтверждение регистрации по email
Django 40. Собственные страницы ошибок
Django 41. Комментарии к постам
Django 42. Запуск Django-проекта на VPS
Django 43. Подключаем Celery и Redis для фоновой отправки почты
Django 44. Отправка электронной почты в фоновом режиме


#django #оглавление

Django 1. Установка Django

Наверняка, вы уже видели установку и создание базового проекта в Django множество раз, но поскольку данный цикл подразумевает серию постов "от начала и до победного", начнем с основ.

Стоит упомянуть используемую в данных постах среду разработки:
- Интерпретатор Python 3.11.4, но работать точно будет на любой версии 3.10+. Скачать актуальную версию Python можно на сайте: https://www.python.org/
- IDE Pycharm, скачать Community-версию можно на сайте: https://www.jetbrains.com/pycharm/download/
- Или IDE VisualStudio Code, скачать можно на сайте: https://code.visualstudio.com/download
- Разработка ведётся на Windows 11. В дальнейшем проект переедет на VPS с Debian 12, но разработка по-прежнему будет на Windows.
- Локально запущен Docker-контейнер с PostgreSQL.
О дополнительных инструментах и библиотеках буду сообщать, когда они будут использоваться.

Приступим.
Создаём новый проект в PyCharn.
Сразу же после создания проекта в корне папки создаём файл requirements.txt. В данный файл будем заносить используемые в проекте библиотеки и их версии. Это необходимо для быстрой установки используемых библиотек в других средах разработки или при запуске проекта в Docker-контейнере. Также жесткая привязка к версиям позволит избежать возможных проблем, связанных с нововведениями в той или иной библиотеке.

Для установки Django, открываем терминал и выполняем команду:
pip install Django.
Начнётся процесс скачивания и установки Django и требуемых зависимостей.

Далее находим в конце вывода строку вида:
Successfully installed Django-4.2.2.
На данный момент актуальная версия Django - 4.2.2.
Копируем название библиотеки и версию и вставляем в файл requirements.txt, заменив - на ==.
Должно получиться: Django==4.2.2.

На этом установка завершена. В следующем посте будем инициализировать проект.

Файлы к посту, можно получить в боте по коду: 994192
Пост на сайте.
Поддержать канал.

#django #python #установка

Первый пункт планов - выполнен.

Как вам аватарка канала?

Django 2. Создание проекта

Django установлена, самое время создать проект.

Для создания проекта, в терминале вводим команду django-admin startproject pressanybutton. Где pressanybutton - название вашего проекта. После выполнения команды, в корне появится папка с названием проекта и основными конфигурационными файлами.

Теперь надо определиться с базой данных. По умолчанию в Django используется SQLite, что отлично подойдёт для обучения и локальной разработки, но будет весьма плохим выбором в реальной работе сайта.
Для изменения базы данных, необходимо открыть файл settings.py в папке проекта и найти параметр DATABASES.

Конфигурация по умолчанию:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

Если на данный момент у вас нет локального или удалённого сервера БД, оставляйте значение по умолчанию.

Для себя я сразу буду использовать базу на PosgreSQL. И собственно рекомендую эту базу данных. Она быстрая, современная и в Django для неё есть множество дополнительных возможностей.
Конфигурация для PostgreSQL:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'имя_базы_данных',
        'USER': 'имя_пользователя_базы',
        'PASSWORD': 'пароль_базы',
        'HOST': 'сервер_БД(localhost если сервер установлен локально или hostname/ip если сервер запущен удалённо)',
        'PORT': '5432',
    }
}

Для работы Django с PostgreSQL необходимо установить библиотеку psycopg. Для этого выполняем команду в терминале pip install psycopg. Не забываем добавить название библиотеки и установленную версию в файл requirements.txt.

После настроек БД, не зависимо от того, меняли ли тип БД, необходимо применить первоначальные миграции. Это необходимо для создания таблиц используемых в дальнейшей работе.
Для этого в терминале необходимо перейти в папку проекта cd pressanybutton и вызвать миграции python manage.py migrate.

В следующем посте продолжим первоначальную конфигурацию Django.

Файлы к посту, можно получить в боте по коду: 246189
Пост на сайте.
Поддержать канал.

#django #python #проект #настройка

Django 3. Базовая конфигурация

Чтобы не возвращаться к теме основной конфигурации, давайте сразу изменим необходимые параметры для проекта.
Откроем файл settings.py в папке проекта.
Пройдемся по параметрам в файле, требующим изменения.

Параметр TEMPLATES.
В данном параметре определяются настройки шаблонов и контекстные процессоры(Мы о них ещё поговорим, наберитесь терпения). В данный момент нам надо изменить подпараметр DIRS.
По умолчанию он 'DIRS': [],. Для того, чтобы Django знал, где искать шаблоны сайта, необходимо изменить поле на 'DIRS': [BASE_DIR / 'templates'],.

Параметр LANGUAGE_CODE.
Данный параметр определяет то, на каком языке используется Django.
По умолчанию установлено значение 'en-us'. Для Русского языка изменим его на 'ru-ru'.

Параметр TIME_ZONE.
Данный параметр необходим для того, чтобы Django верно считал время.
По умолчанию параметр установлен на 'UTC'. Тут необходимо установить удобный для вас часовой пояс. Если ваш сайт будет ориентироваться на Московское время, то 'Europe/Moscow', если ваш сайт направлен на, допустим, часовой пояс Владивостока, то стоит указать 'Asia/Vladivostok'.

Параметры STATIC_URL, STATIC_ROOT, MEDIA_URL, MEDIA_ROOT.
По умолчанию в конфигурации присутствует только один параметр - STATIC_URL, определяющий путь в URL-адресе до статических файлов шаблона. К статическим файлам относятся используемые в проекте CSS и JS файлы.
Давайте добавим недостающие параметры:

STATIC_URL = 'static/'
STATIC_ROOT = BASE_DIR / 'static/'

MEDIA_URL = 'media/'
MEDIA_ROOT = BASE_DIR / 'media/'

В коде выше, я добавил параметр MEDIA_URL, который определяет путь до медиа файлов. К ним относятся загружаемые изображения, видео, и т.д.
Также я определил два дополнительных параметра: STATIC_ROOT и MEDIA_ROOT. В них мы указываем физический путь до файлов.
Когда мы на сайте пытаемся получить фото по условному адресу "site.ru/media/photos/bestphoto.jpg", Django увидит запрос к медиа файлу в адресе и, получив полный путь из MEDIA_ROOT, передаст файл пользователю для отображения на сайте.

На этом базовая настройка закончена. В следующем посте будем создавать пользователя и производить тестовый запуск.

Файлы к посту, можно получить в боте по коду: 102802
Пост на сайте.
Поддержать канал.

#django #python #проект #настройка

Django 4. Суперпользователь и первый запуск

Предварительные настройки позади. Настало время проверить работоспособность, но перед этим давайте создадим суперпользователя.
Суперпользователь, как понятно из названия, это главный пользователь сайта с максимальными правами.
Для его создания необходимо в терминале выполнить команду python manage.py createsuperuser. Убедитесь, что в терминале вы находитесь в той же директории, что и файл manage.py. Проверить это можно командой ls, если файла manage.py в выводе нет, необходимо перейти в папку проекта командой: cd <название_проекта>.
После выполнения команды запустится интерактивное создание учётной записи. В интерактивном режиме необходимо будет заполнить 4 поля:
- Имя пользователя
- Адрес электронной почты
- Пароль
- Повторение пароля
Обратите внимание, во время ввода пароля вводимые символы не отображаются. Будьте внимательны!
В результате выполнения, должно появиться сообщение: Superuser created successfully.

Настало время проверить, что у нас получилось.
Для запуска Django необходимо в терминале выполнить следующую команду: python manage.py runserver. При запуске Django проверяет, нет ли ошибок в коде, мешающих запуску. После проверок будет запущен веб-сервер, и в терминале отобразится служебная информация. Среди неё будет ссылка для доступа к сайту: https://127.0.0.1:8000/.
Перейдя по ссылке или введя её в адресную строку браузера, вы должны увидеть приветственную страницу Django с ракетой и текстом "Установка прошла успешно! Поздравляем!".
Поздравляю и я. Всё работает корректно!

Мы не просто создавали суперпользователя.
Если перейти по адресу https://127.0.0.1:8000/admin/, мы попадём на страницу авторизации в панель администратора Django.
Вводим логин и пароль, указанные ранее, и нажимаем "Войти". Таким образом, мы попадаем в панель администратора.

Если вы ранее работали с CMS, то административная панель может показаться не просто скучной, а буквально пустой. Это объясняется тем, что Django - это фреймворк, а не CMS, и многие инструменты мы должны создавать самостоятельно, добавляя их в административную панель.

Что бы остановить веб-сервер, в терминале с запущенным Django достаточно нажать сочетание клавиш CTRL+C.

В следующем посте, начнём создавать своё приложение блога.

Файлы к посту, можно получить в боте по коду: 491226
Пост на сайте.
Поддержать канал.

#django #python #запуск

Оглавление для серии постов по AIOgram3

Для удобства навигации по предстоящим материалам, в данном посте будут публиковаться ссылки на сообщения.

AIOgram3 1. Начинаем создавать Telegram-бота
AIOgram3 1.5. Регистрация бота
AIOgram3 2. Точка входа
AIOgram3 3. Основная функция
AIOgram3 4. Эхо-бот
AIOgram3 5.1. Создание структуры
AIOgram3 5.2. Создание структуры, продолжение
AIOgram3 6. Информирование администратора
AIOgram3 7. Получение пути до файла по API
AIOgram3 8.1 Команда отправки файла
AIOgram3 8.2 Команда отправки файла, продолжение
AIOgram3 9. Команда start
AIOgram3 10. Пара простых команд
AIOgram3 11. Обновление для команды get_file
AIOgram3 12. Добавление бота в чат
AIOgram3 13. Прогноз погоды в боте - OpenWeatherMap
AIOgram3 14. Фильтруем запрещённые слова
AIOgram3 15. Обработка события вступления или покидания чата
AIOgram3 16. Перевод голосовых сообщений в текст
AIOgram3 17. Подготовка к разворачиванию на сервере
AIOgram3 18. Подключаем оплату Telegram StarsAIOgram3 19. Капча для вступающих в чатБот-автоответчик с ChatGPT для Бизнес-аккаунта в Telegram на Aiogram 3

#aiogram #оглавление

AIOgram3 1. Начинаем создавать Telegram-бота

Telegram-боты - интересная и весьма обширная тема. Можно сделать простейшего бота, повторяющего слова, а можно создать многофункциональный комбайн с множеством строк чистой логики.

Этим постом, я начинаю серию, посвящённую разработке Telegram-бота на основе библиотеки AIOgram версии 3, и конечно, "от начала и до победного".

Почему я выбрал именно AIOgram 3, который в данный момент находится в стадии бета-тестирования? Именно по этой причине. К тому моменту, когда AIOgram 3 выйдет из бета-версии, у меня будет множество наработок по разработке, и это будет являться большим плюсом. Кроме того, он асинхронный и поддерживает FSM.

И чтобы сделать содержимое еще более интересным, посты о Django и боте будут переплетаться между собой. У меня в планах реализовать бота, который будет выдавать дополнительные материалы в ответ на запросы, а для удобного управления файлами бот будет обращаться к Django через API.

Я надеюсь, что это будет полезным и интересным.

Приступаем к работе.
Создаём новый проект в IDE и сразу же создаём файл requirements.txt.
Чтобы установить библиотеку, нужно выполнить следующую команду в терминале: pip install -U --pre aiogram. Эта команда установит последнюю доступную бета-версию библиотеки.
На данный момент актуальная версия AIOgram - 3.0.0b7.
Добавляем ее в файл requiremets.txt, копируем название и версию из вывода терминала, заменяя знак - на ==.
Так как это бета-версия, Pycharm может считать, что указанная версия в requirements.txt не соответствует действительности. В этом случае нужно проигнорировать ошибку.

В следующем посте начнём делать бота.

Файлы к посту, можно получить в боте по коду: 347734
Пост на сайте.
Поддержать канал.

#aiogram #python #установка