Разработка приложения Django Excel
Покажем, как Django работает с файлами JSON, CSV, YAML, XLSX, разберемся с настройками media, и напишем приложение, которое использует XLSX (или Google Sheets) для загрузки данных. ← Часть 1 Django — что это? Обзор и установка фреймворка, структура проекта Приложения Django работают с файлами любых форматов – растровыми и векторными изображениями, аудио, видео, архивами и всевозможными документами. Путь к файлам можно указывать точно так же, как в обычных Python скриптах, но проще воспользоваться встроенным инструментом для работы с пользовательскими файлами – папкой media. В папке media размещаются файлы, которые загружаются или создаются пользователями – изображения профилей, фотографии, документы, презентации, аудио, видео и так далее. Django обеспечивает безопасное хранение и обслуживание этих файлов, а также предоставляет удобные методы для их обработки и отображения в приложении. Другими словами, использование папки media в Django значительно упрощает работу с пользовательскими файлами. Заметим, что media используется для размещения именно пользовательских файлов, а не статических. Статические файлы являются неотъемлемой частью приложения, не претерпевают никаких изменений со стороны пользователя и хранятся в папке static. Подробнее со статическими файлами мы разберемся в следующей главе. 🐍 Больше полезных материалов вы найдете на нашем телеграм-канале «Библиотека питониста» Интересно, перейти к каналу Прежде всего, нужно создать папку media в корневой директории проекта, на одном уровне с приложениями: Затем нужно добавить config/settings.py Кроме того, надо внести дополнения в в главный файл маршрутов config/urls.py: config/urls.py Хотя веб-приложения обычно работают с базами данных, иногда возникает необходимость сохранять информацию в файлах. Например, конфигурационные файлы JSON и YAML используют для хранения настроек, а Markdown файлы заменяют базу данных в генераторах статических сайтов. Кроме того, веб-приложения часто используют файлы JSON, XLSX, CSV и для загрузки информации в базу данных, и для экспорта данных из БД. В простых веб-приложениях файлы JSON, XLSX, CSV и YAML вполне могут заменить базу данных. Рассмотрим использование данных из различных файлов на примере приложения students. В этом примере мы будем использовать YAML файл, поэтому нам нужно установить PyYAML: Сохраните файл students.yaml в папке media. Поскольку Django знает, где находится media, путь к файлу выглядит как В шаблоне для создания списка используется HTML тег Добавьте маршрут для вызова функции в файл students/urls.py: И включите маршруты приложения students в список маршрутов в config/urls.py: config/urls.py Запустите сервер, перейдите по адресу http://localhost:8000/students/ – приложение успешно загружает данные из файла students.yaml: 🐍🚀 Django с нуля. Часть 1: пишем многопользовательский блог для клуба любителей задач Python Во втором примере мы воспользуемся файлом students.csv. Для загрузки данных нужно переписать функцию представления в students/views.py, а шаблон и urls.py останутся неизменными: Результат будет аналогичен первому примеру: Для загрузки данных из JSON-файлов Django использует модуль json из стандартной библиотеки Python, поэтому для этого примера не придется ничего устанавливать. Функция представления будет выглядеть так: Для работы с Excel таблицами в Django можно использовать библиотеку Pandas, которая позволяет загружать данные из XLSX-файлов максимально просто: Другой способ немного сложнее, зато он позволяет обойтись компактным модулем openpyxl: Результат будет одинаковым: Мы разработаем приложение, которое будет использовать XLSX-файл вместо базы данных. Код готового приложения находится здесь. Хотя Django может работать с практически любыми файлами, удобнее всего использовать именно XLSX, поскольку такие файлы можно редактировать с помощью любого приложения для работы с электронными таблицами – Excel, Google Sheets, LibreOffice Calc и так далее. Таблица, в которой хранятся данные о книгах, выглядит так: Приложение будет выводить данные из файла books.xlsx, который хранится в папке media. Для каждой книги выводится одинаковый набор данных: Обложки находятся в media/covers. Предусмотрено переключение темы со светлой на темную: Создайте виртуальное окружение и активируйте его: Поместите файл requirements.txt в myproject и установите все нужные зависимости: Создайте проект config и приложение books: Теперь нужно зарегистрировать приложение books в config/settings.py и добавить туда же настройки для папки media: config/settings.py Не забудьте добавить настройки media в файл config/urls.py: config/urls.py Напомним, что папка media располагается на одном уровне с приложением books. В media находится файл books.xlsx и вложенная директория covers, в которой хранятся обложки книг. За вывод списка всех существующих книг отвечает функция all_books(): При обработке данных из файла media/books.xlsx функция пропускает первую строку с названиями столбцов. Порядковый номер и год выпуска преобразуются в целые числа Если приложение использует не локальный файл books.xlsx из папки media, а таблицу Google Sheets, то функция all_books() будет выглядеть так: Заметим, что при использовании данных из таблицы Google Sheets имеет смысл хранить изображения не на локальном сервере, а загружать на подходящий фотохостинг. В этом случае в столбце Обложка нужно указывать прямую ссылку на изображение. Данные передаются в шаблон books.html. Обратите внимание, что шаблон books.html наследует базовый шаблон base.html, в котором: Подробнее механизмы наследования и включения шаблонов мы рассмотрим в главе, посвященной шаблонизатору Django. Заметим, что дополнительные CSS стили и JS-скрипты для крупных проектов обычно хранятся в отдельных файлах в папке static – с этой концепцией мы подробно разберемся в разделе «Статические файлы». Вывод данных в шаблоне происходит в цикле: Для ограничения описания книги до 120 символов используется конструкция Верхнее меню содержит ссылки на другие функции представления, которые обеспечивают вывод книг по жанрам: При нажатии на эти ссылки происходит запуск соответствующих функций представления в books/views.py: Маршруты, которые приводят в действие все эти функции, определены в books/urls.py: Все классы, используемые в шаблонах (например, Без этих стилей футер не будет «прилипать» к низу страницы, если на ней мало контента: Небольшие веб-приложения вполне могут обойтись без базы данных. К тому же использование файла вместо БД может быть оптимальным решением в том случае, если над сбором данных работают несколько человек: предоставить общий доступ к XLSX-файлу гораздо проще, чем к базе. *** 
Зачем нужна папка media в Django
Как настроить media в Django
|-- config/ |-- asgi.py |-- settings.py |-- urls.py |-- wsgi.py |-- __init__.py |-- __pycache__/ |-- media/ |-- students/ |-- admin.py |-- apps.py |-- migrations/ |-- __init__.py |-- models.py |-- tests.py |-- views.py |-- __init__.py |-- venv/ |-- manage.py import os и эти строки в файл настроек config/settings.py:
MEDIA_ROOT = os.path.join(BASE_DIR, 'media') MEDIA_URL = '/media/'
from django.conf import settings from django.conf.urls.static import static … urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) Файлы вместо базы данных в Django
Работа с YAML-файлами в Django
pip install pyyaml 'media/students.yaml'. Функция представления students/views.py загружает сведения о студентах из YAML-файла и передает данные в шаблон student_list.html:
import yaml from django.shortcuts import render def student_list(request): with open('media/students.yaml', encoding='utf-8') as file: students = yaml.safe_load(file) return render(request, 'student_list.html', {'students': students}) <ul></ul>, а для вывода пунктов – тег <li></li>:
<!DOCTYPE html> <html> <head> <title>Список студентов</title> </head> <body> <h1>Наши студенты</h1> <ul> {% for student in students %} <li>имя: {{ student.name }}, фамилия: {{ student.lastname }}, возраст: {{ student.age }}, курс: {{ student.year }}, факультет: {{ student.faculty }}</li> {% endfor %} </ul> </body> </html>
from django.urls import path from students.views import student_list urlpatterns = [ path('students/', student_list, name='student_list'), ]
path('', include('students.urls')), Как использовать CSV-файлы в Django
import csv from django.shortcuts import render def student_list(request): students = [] with open('media/students.csv', 'r', encoding='utf-8') as file: csv_data = csv.DictReader(file) for row in csv_data: students.append(row) return render(request, 'student_list.html', {'students': students}) Как работать с JSON-файлами в Django
import json from django.shortcuts import render def student_list(request): with open('media/students.json', 'r', encoding='utf-8') as file: students = json.load(file) return render(request, 'student_list.html', {'students': students}) Как загружать данные из Excel в Django
import pandas as pd from django.shortcuts import render def student_list(request): file_path = 'media/students.xlsx' df = pd.read_excel(file_path) students = df.to_dict('records') return render(request, 'student_list.html', {'students': students})
from django.shortcuts import render from openpyxl import load_workbook def student_list(request): file_path = 'media/students.xlsx' workbook = load_workbook(filename=file_path) worksheet = workbook.active students = [] skip_first_row = True for row in worksheet.iter_rows(values_only=True, min_row=2 if skip_first_row else 1): student = { 'name': row[0], 'lastname': row[1], 'age': row[2], 'faculty': row[3], 'year': row[4], 'average': row[5] } students.append(student) return render(request, 'student_list.html', {'students': students}) Проект 1: Приложение Books для хранения информации о книгах
Обзор проекта
Приступаем к работе
python -m venv myprojectvenv cd myproject venvscriptsactivate
pip install -r requirements.txt
django-admin startproject config . manage.py startapp books
INSTALLED_APPS = [ … 'books.apps.BooksConfig', ] … MEDIA_ROOT = os.path.join(BASE_DIR, 'media') MEDIA_URL = '/media/'
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) Функции представления views.py
def all_books(request): file_path = 'media/books.xlsx' workbook = load_workbook(filename=file_path) worksheet = workbook.active books = [] skip_first_row = True for row in worksheet.iter_rows(values_only=True, min_row=2 if skip_first_row else 1): book = { 'book_id': int(row[0]), 'title': row[1], 'author': row[2], 'genre': row[3], 'year': int(row[4]), 'description': row[5], 'cover': row[6] } books.append(book) return render(request, 'books.html', {'books': books}) int(), так как по умолчанию модуль openpyxl считает их float().
import csv import requests from django.shortcuts import render def all_books(request): sheet_id = "1IkfPkI5ZBtzVJlyomD21nFg4ZUMnJgqLqVrNbiTWkME" sheet_name = "Books" url = f"https://docs.google.com/spreadsheets/d/{sheet_id}/gviz/tq?tqx=out:csv&sheet={sheet_name}" response = requests.get(url) if response.ok: book_data = response.text reader = csv.DictReader(book_data.splitlines()) books = [ { 'book_id': int(row['Номер']), 'title': row['Название'], 'author': row['Автор'], 'genre': row['Жанр'], 'year': int(row['Год издания']), 'description': row['Краткое содержание'], 'cover': row['Обложка'] } for row in reader ] return render(request, 'books.html', {'books': books}) else: return render(request, 'error.html', {'message': 'Ошибка получения данных'}) <style></style>.
{% for book in books %} <div class="card mb-3 px-0"> <div class="row g-0"> <div class="col-md-4 card-image"> <img src="/media/covers/{{book.cover}}.jpeg" class="img-fluid rounded" alt="{{ book.cover }}"> </div> <div class="col-md-8"> <div class="card-body"> <h5 class="card-title">{{ book.title }}</h5> <h5 class="card-title text-muted">{{ book.author }}</h5> <span class="badge text-bg-danger">{{ book.genre }}</span> <p class="card-text">{{ book.description|truncatechars:"120"|linebreaks }}</p> <p class="text-end"><a href="{% url 'book_detail' book_id=book.book_id %}" class="btn btn-primary">Подробнее</a></p> </div> </div> </div> </div> {% endfor %} |truncatechars:"120"|linebreaks. Ссылка, привязанная к кнопке «Подробнее», обеспечивает передачу в функцию book_detail() порядкового номера книги – так Django узнает, о какой именно книге нужно вывести информацию на отдельной странице:
<ul class="navbar-nav ml-auto"> <li class="nav-item"> <a class="nav-link" href="{% url 'thriller' %}">Триллеры</a> </li> <li class="nav-item"> <a class="nav-link" href="{% url 'programming' %}">Программирование</a> </li> <li class="nav-item"> <a class="nav-link" href="{% url 'fantasy' %}">Фэнтези</a> </li> <li class="nav-item"> <a class="nav-link" href="{% url 'mystery' %}">Детективы</a> </li> </ul>
urlpatterns = [ path('books/', views.all_books, name='all_books'), path('book/<int:book_id>/', views.book_detail, name='book_detail'), path('programming/', views.programming, name='programming'), path('thriller/', views.thriller, name='thriller'), path('mystery/', views.mystery, name='mystery'), path('fantasy/', views.fantasy, name='fantasy'), ] class="card-text">) являются классами Bootstrap. Классы позволяют применять к элементам шаблона наборы CSS стилей, которые обеспечивают тексту и изображениям привлекательный внешний вид. Стили можно дополнять, а при необходимости – полностью переопределять. Например, в шаблоне base.html мы определяем два стиля, которые обеспечивают фиксированную позицию для футера – внизу страницы:
.content-wrapper { min-height: 100%; position: relative; padding-bottom: 60px; } footer { position: absolute; bottom: 0; width: 100%; height: 60px; background-color: #343a40; color: #fff; text-align: center; padding: 15px; } Подведем итоги
Содержание курса
- 0 views
- 0 Comment