No project description provided
Project description
Создатель презентаций Nanofootball
Формирует из dict
объекта презентацию, которую можно отправить клиенту. Требует около трех секунд на одно упражнение. Таким образом создание презентации из шесть упражнения займет 10-20 секунд
Установка
Для Линукс систем
pip install nf_presentation
Для Виндоус систем
На данный момент pipwin перестал работать, так что установка кринжеватая. Но быстрая
Тут потребуется дополнительная установка библиотеки cairocffi
, которую нужно скачать вручную с http://www.lfd.uci.edu/~gohlke/pythonlibs/#cairocffi
Выбрать под свою версию питона, например cairocffi‑1.3.0‑cp310‑cp310‑win_amd64.whl (для систем х64 и и питона 3.10(это можно узнать по записи cp310
))
pip install cairocffi‑1.3.0‑cp310‑cp310‑win_amd64.whl //или другой ваш файл
pip install nf_presentation
Проверить можно так:
python
>> import nf_presentation
Если все прошло гладко, значит ты молодец, установка прошла успешно. В противном случачае вылезет ошибка
OSError: no library called "cairo-2" was found
no library called "cairo" was found
no library called "libcairo-2" was found
cannot load library 'libcairo.so.2': error 0x7e
cannot load library 'libcairo.2.dylib': error 0x7e
cannot load library 'libcairo-2.dll': error 0x7e
Значит cairocffi
все еще неправильно установлена, попробуй удалить ее pip uninstall cairocffi
и попробуй еще раз
Использование
Ломовые изменния в 0.2.0:
- теперь у нас только две функции
from_training()
,from_single exercise()
. Одна для создания презентаций из тренировок, вторая для упражнений. - Данные подаются через аргумент
input_data
. Можно использовать значение'test'
для использования тестовых данных output_file
больше не принимает файл-объекты потоков
Базовый код выглядит теперь так
import nf_presentation
# для тренировки
pptx_bytes= nf_presentation.from_training(input_data=training_data_dict)
# или для одного упражнения
pptx_bytes= nf_presentation.from_single_exercise(
input_data=exercise_data_dict,
render_options={
'scheme_1':True,
'scheme_2':False,
'video_1':True,
'video_2':False,
'animation_1':True
})
response=HttpResponse(pptx_bytes, content-type='application/vnd.ms-powerpoint'
resonse['Content-Disposition']='attachement;filename="out.pptx"'
return response
pptx_bytes
это массив байтов, которые уже можно передать пользователям nf
Запись в файл или поток
Для работы локально иногда может потребовать записать данные файл, для этого достаточно добавитьь аргумент output_file
.
import nf_presentation
nf_presentation.from_training(input_data=training_data_dict, output_file='out.pptx')
Теперь create_pptx()
вернет None
Тестовые данные
В пакет встроенны тестовые данные, и работоспособность пакета можно указав input_data='test'
import nf_presentation
pptx_bytes= nf_presentation.from_training(input_data='test')
# или для одного упражнения
pptx_bytes= nf_presentation.from_singe_exercise(input_data='test')
Для вывода во временный файл достаточно назначить аргумент output_file
вывода во временный файл можно использовать поток, как в примере выше
import nf_presentation
nf_presentation.from_singe_exercise(output_file='from_test_data.pptx')
Тестирование
В корневой скачанной папке запустить python -m unittest
Проблемы
- Больше всего времени уходит на создание схемы. А все потому что он выкачивает из интернета ссылки на файлы, если бы я знал, где локально хранятся файлы, это можно было бы в разы ускорить
- Описание пока вообще не рендерится
- Упражнения которые приходят из событий по структуре отличаются от упражнений в списке упражнений
TODO
- коспект из методички рфс 6 пуктов -> инфо слайд треинровки
- Где в training_data лежат анимации
- Можно ли получить исходный формат exercise_info как в nanofootball.com/exercises
- Использовать схемы из новой рисовалки при возможности
- Левая таблица названия капсом
- Тестирование
- 12 Шрифт
- Добавить слияние ячеек в таблице, если есть пустые строки
- Создать абстрактный класс, который бы мог работать как с упражнениями из событий так и обычными, а может потом будет ещё какая-то новая структура. Надо быть готовым :(
- Настроить логгер вместо print(..)
-
Устранить утечку памяти где создается поток для объектак. Используя with -
Презентация в широком формате -
Новое форматирование - Описание сделал читабельным
- Размер шрифта
- положение в строке
- Форматирование в шаблоне двухконтентном
-
Цвета - Cоздать презентацию для каждого упражнения, дабы отловить возможные ошибки
- Ошибка, если файл не найдеy в assets, и картинка по умолчанию)
Текущие проблемы
Некоторые схемы получаются искаженными, даже в упражнении из тестовых данных. Там одни из ворот почему-то вытянуты по диагонали. Слава богу, в похожей схеме из другого упражнения все нормально. Так что сравнив схемы там и там, можно решить проблему
В данный момент изображения создаются из других изображений(ворот, игроков и прочее). И эти ворота игроки скачиваются из интернета. Было бы неплохо, если бы можно было искать эти файлы локально, на сервере. Это помогло бы ускорить процесс.
Битый SVG
В аттрибуте shchemeData упражения хранится svg фай схемы. Можно было бы легко пользоваться этими свг, и переделать их в пнг. Но есть проблема. Эти SVG битые.
Аттрибуты записаны некорректно. То есть с точки зрения браузера они написаны верно, а с точки зрения форматирования svg - нет. Дело в том, что для браузера не существует различий между прописными с строчными буквами, например viewBox и viewbox для браузера выглядят одинаково, но для любой программы читающей изображения(в том числе cairoSVG) viewbox без большой буквы будет считаться ошибкой и пропущен обработчиком.
Поэтому важно поправить данные полях схем, перед передачей в субпрограмму, которая из этой свг сделает PNG
При обработке SVG данных из schemeData упражнения будут сделаны такие замены
- viewbox -> viewBox
- markerwidth -> markerWidth
- refx -> refX
- ...
Все такие замены набиваются руками и лежат в nf_presentation.settings.svg_replacements так же можно воспользоваться фукцией nf_presentation.settings.add_svg_replacement(old,fix), чтобы добавить новую подстановку. Потому что в дальнейшем список таких замен будет только расширяться, и если картинка на выходе не совсем походит на ту, что на сайте, скорее всего нужно поправить какой-то битый аттрибут.
Зависимости SVG
В каждой картинке схемы из базы данных хранится ссылки на другие файлы, к счастью CairoSVG может использовать веб ссылки для картинок, чтобы создать потом png файл
При обрботке svg схемы все ссылки /static/schemeDrawer/img/... будут заменяться на http://nanofootball.com/static/schemeDrawer/img/...
Подразумевается что все картинки доступны по адресу http://nanofootball.com/static/schemeDrawer/img/...
Зависимости перекодировщика SVG -> PNG
Модуль cairosvg, который собсно и перегружает картинки имеет в зависимостях cairocffi, которые на виндоус надо устанавливать отдельно, а в линуксе пока вообще хз что. Кажется это довольно грузная зависимость для сервера NF
В данный момент подразумевается, что при установке пакета nf-presentation устанавливается CairoSVG, которая в свою очередь автоматически установит cairocffi на линкус систему. Подразумевается, что наш НФ сервер работает на линуксе
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for nf_presentation-0.3.0.dev5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60ebb6373a5dc23d1b7943c97818e0ee6b7e143bd8cc16eeae282561395997b7 |
|
MD5 | 2d8a438c3aed8eab3ffcf0ce41fdb0f3 |
|
BLAKE2b-256 | 52ecd42b0e172872e951c9b46143e8f58aa0753bab1b23e518098c754142fff3 |
Hashes for nf_presentation-0.3.0.dev5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de536394af2345bf2b37e11683e7fc4451c77e7b42da3ef08c721ccf61d31f6a |
|
MD5 | 782acd2c19372dd21647218d9393bda5 |
|
BLAKE2b-256 | e6451178cab2e71ebffe3a8bc0c1cefb248e7c40b913a518997c044b61468ef4 |