Documentation – Начало работы

Pythonjava: Введение

Mon, 01 Jan 0001 00:00:00 +0000

Pythonjava: Использование PyInstaller для удобного распространения приложений на Python

Mon, 01 Jan 0001 00:00:00 +0000

Для чего используется PyInstaller?

PyInstaller читает Python-скрипт, написанный вами. Он анализирует ваш код для определения всех других модулей и библиотек, необходимых для выполнения вашего скрипта. Затем он собирает копии всех этих файлов - включая активный интерпретатор Python!

Зачем использовать Pyinstaller для упаковки Python?

PyInstaller используется для упаковки кода Python в автономные исполняемые приложения для различных операционных систем. Он берет скрипт Python и создает одиночный исполняемый файл, который содержит все необходимые зависимости и может быть запущен на компьютерах, на которых не установлен Python. Это облегчает распространение и развертывание приложений на Python, поскольку пользователю не нужно устанавливать Python и необходимые модули на своей системе для запуска приложения. Кроме того, PyInstaller также может использоваться для создания однофайловых исполняемых файлов, которые представляют собой единый исполняемый файл, содержащий все необходимые зависимости для приложения. Это может сделать распространение приложения еще проще, поскольку пользователю нужно лишь загрузить один файл.

Как установить PyInstaller

PyInstaller доступен как обычный пакет Python. Исходные архивы для выпущенных версий доступны на PyPi, но установить последнюю версию легче с помощью pip:

C:\> pip install pyinstaller

Чтобы обновить существующую установку PyInstaller до последней версии, используйте:

C:\> pip install --upgrade pyinstaller

Чтобы установить текущую версию разработки, используйте:

C:\> pip install https://github.com/pyinstaller/pyinstaller/tarball/

Как создать EXE с помощью PyInstaller

Мы возьмем один файл Python в качестве примера, чтобы подробно объяснить шаги по упаковке. Возьмем Python 3.11.0 в качестве примера после установки aspose.cells.

Создайте образец файла Python с именем example.py.

import os
from jpype import *

__cells_jar_dir__ = os.path.dirname(__file__)
addClassPath(os.path.join(__cells_jar_dir__, "aspose-cells-23.1.jar"))
addClassPath(os.path.join(__cells_jar_dir__, "bcprov-jdk15on-160.jar"))
addClassPath(os.path.join(__cells_jar_dir__, "bcpkix-jdk15on-1.60.jar"))
addClassPath(os.path.join(__cells_jar_dir__, "JavaClassBridge.jar"))

import jpype
import asposecells
jpype.startJVM()
from asposecells.api import Workbook, FileFormatType, CellsHelper

print(CellsHelper.getVersion())
workbook = Workbook(FileFormatType.XLSX)
workbook.getWorksheets().get(0).getCells().get("A1").putValue("Hello World")
workbook.save("output.xlsx")

jpype.shutdownJVM()

Создайте папку под названием c:\app и скопируйте файл example.py (прикрепленный) в c:\app.
Откройте командную строку и выполните команду pyinstaller example.py.
```
C:\app> pyinstaller example.py
```
Скопируйте файлы-заготовки (aspose-cells-xxx.jar, bcprov-jdk15on-160.jar, bcpkix-jdk15on-1.60.jar, JavaClassBridge.jar. Они находятся в папке C:\Python311\Lib\site-packages\asposecells\lib) в c:\app.
Отредактируйте файл с суффиксом spec, чтобы добавить секцию данных, пример под названием example.spec.
Выполните pyinstaller example.spec в окне командной строки.
```
C:\app> pyinstaller example.spec
```
Перейдите в каталог C:\app\dist\example, и вы найдете файл example.exe.

Pythonjava: Поддерживаемые форматы файлов

Mon, 01 Jan 0001 00:00:00 +0000

Формат	Описание	Загружать	Сохранять
XLS	Таблица Excel 95/5.0 - 2003.
XLSX	Формат файла Office Open XML SpreadsheetML.
XLSB	Двоичная книга Excel.
XLSM	Макро-включенная книга Excel.
XLT	Шаблон Excel 97 - Excel 2003.
XLTX	Шаблон Excel.
XLTM	Макро-включенный шаблон Excel.
XLAM	Файл дополнения Excel с поддержкой макросов, используемый для добавления новых функций в Excel.
CSV	Файл CSV (значения, разделенные запятыми).
TSV	Файл с разделителями табуляции (TSV).
TabDelimited	Файл с текстом, разделенным табуляцией, то же самое, что и файл TSV.
TXT	Файл с обычным текстом, разделенным.
HTML	Формат HTML.
MHTML	Файл MHTML.
ODS	ODS (Файл для OpenDocument Spreadsheet).
SpreadsheetML	Файл XML Excel 2003 года.
Numbers	Документ создан приложением Apple “Numbers”, входящим в офисный пакет iWork, набор приложений, работающих на Mac OS X и iOS.
JSON	Нотация объектов JavaScript
DIF	Формат обмена данными.
DBF	Файл с расширением .dbf — это файл базы данных, используемый приложением системы управления базами данных под названием dBASE.
PDF	Формат Adobe Portable Document Format.
XPS	Формат XML Paper Specification.
SVG	Формат масштабируемой векторной графики.
TIFF	Формат тэгированного файла изображения.
PNG	Формат портативной сетевой графики.
BMP	Формат растрового изображения.
EMF	Формат улучшенного метафайла.
JPEG	JPEG - тип формата изображения, сохраняемого с использованием метода потерь сжатия.
GIF	Графический формат обмена.
MARKDOWN	Представляет документ markdown.
SXC	Это формат на основе XML, используемый в OpenOffice и StarOffice
FODS	Это формат Open Document, сохраненный в виде плоского XML.
DOCX	Хорошо известный формат для документов Microsoft Word, который представляет собой комбинацию XML и двоичных файлов.
PPTX	Формат PPTX основан на формате открытого файла презентации Microsoft PowerPoint.
SqlScript	Язык структурированных запросов.
XHtml	XHTML - это текстовый файловый формат с разметкой в формате XML, использующий переформулировку HTML 4.0.
Epub	Файлы с расширением .epub - это формат электронных книг, который предоставляет стандартный цифровой формат публикации для издателей и потребителей.
Xml	XML означает расширяемый язык разметки, который похож на HTML, но отличается использованием тегов для определения объектов.
Ots	Файл шаблона для открытого документа (OTS).
AZW3	AZW — это цифровой формат файла электронных книг, разработанный Amazon для устройств Kindle. AZW3, также известный как Kindle Format 8 (KF8).

Pythonjava: Как использовать Aspose.Cells для Python via Java в среде Gunicorn+Flask

Mon, 01 Jan 0001 00:00:00 +0000

Этот учебный материал показывает, как разработчики могут создать простое приложение (Hello World) с помощью Aspose.Cells для Python via Java. Приложение создает файл Microsoft Excel со словами Hello World в указанной ячейке листа.

Полная подготовка окружения

Окружение для запуска этого руководства — Ubuntu: 20.04, вы можете настроить его в соответствии со своей ситуацией. Чтобы гарантировать правильное выполнение примеров, необходимо установить некоторые необходимые инструменты. Ниже представлен краткий пошаговый гид, который поможет вам завершить этот процесс. Обратите внимание, что это лишь пример, конкретные детали могут отличаться в зависимости от вашей системы и потребностей.

Python

Если не установлен, установите его следующим образом:

sudo apt install python3 python3-pip # Ubuntu/Debian
#sudo yum install python3 python3-pip # CentOS/RHEL

Проверить версию

python3 --version
pip3 --version

Java

Если не установлен, установите его следующим образом:

sudo apt install openjdk-11-jdk # Ubuntu/Debian
#sudo yum install java-17-openjdk # CentOS/RHEL
ENV JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH

Проверить версию

java -version

виртуальная среда virtualenv

Виртуальная среда установлена в соответствии с вашими текущими потребностями. Рекомендуется использовать виртуальные среды для управления зависимостями проекта как в разработке, так и в производственной среде. Пожалуйста, следуйте следующей команде для установки:

sudo apt install python3-venv # Ubuntu/Debian
#sudo yum install python3-venv # CentOS/RHEL

Создать виртуальную среду

python3 -m venv myenv # Create a virtual environment named myenv in the current directory

Запустить виртуальную среду

source myenv/bin/activate

Внимание: если используется виртуальная среда, последующие операции требуют предварительной активации соответствующей виртуальной среды

Flask

Если не установлен, выполните следующую команду для установки:

pip install Flask

Gunicorn

Если не установлен, выполните следующую команду для установки:

pip install gunicorn

Jpype

Если не установлен, выполните следующую команду для установки:

pip install jpype1

aspose-cells

Если не установлен, выполните следующую команду для установки:

pip install aspose-cells

Создание приложения Hello World

Для создания приложения Hello World с использованием Aspose.Cells API:

Создайте экземпляр класса Workbook.
Примените лицензию:
1. Если вы приобрели лицензию, используйте ее в своем приложении, чтобы получить доступ ко всей функциональности Aspose.Cells
2. Если вы используете оценочную версию компонента (если вы используете Aspose.Cells без лицензии), пропустите этот шаг.
Создайте новый файл Microsoft Excel или откройте существующий файл, в котором вы хотите добавить/обновить некоторый текст.
Получите доступ к любой ячейке рабочего листа в файле Microsoft Excel.
Вставьте слова Привет, мир! в ячейку для доступа.
Сгенерируйте модифицированный файл Microsoft Excel.

Приведенные ниже примеры демонстрируют вышеуказанные шаги.

Создание рабочей книги

В следующем примере создается новая рабочая книга с нуля, записываются слова “Hello World!” в ячейку A1 на первом листе и сохраняется файл.

Допустим, у нас есть тестовый путь “/app”. В этом тестовом пути мы выполнит следующие работы.

Файлы приложения Flask: hello.py

Файл пользовательского класса запуска Gunicorn: custom_gunicorn.py

Запуск службы

Проверьте, установлены ли все необходимые для службы пакеты, затем запустите службу.

Если вы используете виртуальную среду python3-venv, вам нужно создать виртуальную среду в тестовом пути, запустить её и затем установить все необходимые инструменты.

python custom_gunicorn.py Or python3 custom_gunicorn.py

Проверка результатов

Откройте браузер и перейдите по адресу http://127.0.0.1:5000/.
Введите имя файла, который хотите сохранить, в поле ввода.
Нажмите кнопку ‘Генерировать’, чтобы сохранить файл.

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

Использование Docker

Или вы можете поместить вышеуказанные операции в контейнер Docker. Очень просто использовать Docker для сборки среды, используемой в примере. Просто поместите вышеуказанные операции в файл Dockerfile.

Вот файл Dockerfile для справки. В нем перечислены необходимые наборы инструментов, требуемые для сборки среды.

Dockerfile

FROM ubuntu:20.04
ENV DEBIAN_FRONTEND=noninteractive
RUN apt-get update && apt-get install -y \
    python3 \
    python3-pip \
    python3-dev \
    python3-venv \
    build-essential \
    libssl-dev \
    libffi-dev \
    libpq-dev \
    openjdk-11-jdk \
    wget \
    curl \
    unzip \
    && rm -rf /var/lib/apt/lists/*
ENV JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
ENV PATH=$JAVA_HOME/bin:$PATH
WORKDIR /app
COPY . /app
RUN pip install -r requirements.txt
CMD ["python3", "custom_gunicorn.py"]

requirements.txt

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

aspose-cells==24.11.0
jpype1==1.5.1
Flask==3.0.3
gunicorn==23.0.0

Основные файлы

Основная структура файлов следующая:

app/
|-requirements.txt
|-hello.py
|-custom_gunicorn.py

Запуск контейнера

Вы можете запустить контейнер с помощью следующей команды

docker run --rm -p 127.0.0.1:5000:5000 gunicorn_flask:v1.0 # gunicorn_flask:v1.0 - Image built by Dockerfile

Pythonjava: Почему Aspose.Cells для Python via Java

Mon, 01 Jan 0001 00:00:00 +0000

Возможные сценарии использования

Когда вам нужно сравнить, какой продукт лучше подходит для вашего решения, есть множество критериев для оценки, но основное внимание обычно уделяется функциональности и усилиям, необходимым для использования продукта. Если вам нужна более быстрая, простая и легкая библиотека для обработки файлов, то вам может захотеться сравнить Aspose.Cells для Python via Java и другие библиотеки Excel Python. Тогда вы сможете заметить, что на самом деле эти продукты не конкурируют, а решают немного различные задачи пользователей.
Сравнивая три самые сильные библиотеки Python (pandas, xlwings и Aspose.Cells для Python via Java) для чтения данных из файла Excel, записи данных в файл Excel и добавления диаграммы в файл Excel, вы можете открыть удобство использования, высокую производительность и другие уникальные преимущества библиотеки Aspose.Cells для Python via Java.

Сравнение нескольких библиотек Excel в Python

Давайте сначала посмотрим на сравнение десяти библиотек на Python, которые могут работать с файлами Excel.

Почему Aspose.Cells для Python via Java

Aspose.Cells для Python - мощная, простая в использовании, эффективная и безопасная библиотека для всех видов сценариев, где вам нужно работать с файлами Excel. Есть много причин использовать Aspose.Cells для Python, включая, но не ограничиваясь следующими моментами:

Полнофункциональность

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

Простота использования

API Aspose.Cells разработан так, чтобы быть интуитивно понятным и простым в использовании, что позволяет разработчикам на Python легко интегрировать функциональность Excel в свои приложения.

Поддержка кроссплатформенности

Aspose.Cells поддерживает различные операционные системы, включая Windows, Linux и macOS, тем самым обеспечивая стабильную работу в различных средах.

Высокая производительность

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

Безопасность

Aspose.Cells обеспечивает защиту данных и шифрование, чтобы обеспечить безопасность файлов Excel от несанкционированного доступа и изменений.

Множество форматов файлов

Aspose.Cells поддерживает различные форматы файлов Excel, включая XLS, XLSX, CSV, ODS и т. д., для удобного взаимодействия с данными из различных источников.

Хорошая техническая поддержка

Aspose.Cells предоставляет подробную документацию и образцы кода, чтобы помочь разработчикам быстро начать работу. В то же время мы также предоставляем профессиональную техническую поддержку для решения возникших проблем в процессе использования.

Преимущества Aspose.Cells для Python via Java

Aspose.Cells для Python - полностью функциональная, простая в использовании, отличная производительность, безопасная, надежная, гибкая и высокоинтегрированная библиотека. Независимо от того, работаете ли вы с маленькими или большими файлами Excel, анализом данных, генерацией отчетов или другими операциями с Excel, Aspose.Cells предоставляет разработчикам эффективное и удобное решение. У Aspose.Cells для Python следующие преимущества:

Гибкие API

API Aspose.Cells предлагает множество функций, которые можно настраивать и расширять в соответствии с различными потребностями. Это позволяет разработчикам легко реализовать свои бизнес-требования, не полагаясь на другие инструменты или библиотеки.

Поддержка нескольких языков программирования

Помимо Python, Aspose.Cells также поддерживает Java, C#, C++ и другие языки программирования. Это означает, что разработчики могут выбрать наиболее подходящий язык программирования для реализации функций Excel в соответствии с их предпочтениями и навыками.

Высокая интеграция

Aspose.Cells легко интегрируется с другими библиотеками и фреймворками Python, такими как Django, Flask и т. д. Это позволяет разработчикам без проблем интегрировать функциональность Excel в их веб-приложения или настольные приложения, увеличивая полезность и удобство их приложений.

Чтение данных из файла Excel

Начнем с практических применений и сравним три самые сильные библиотеки Python (pandas, xlwings и Aspose.Cells для Python via Java) для чтения данных из образца файла.

Чтение данных из файла Excel с использованием Aspose.Cells для Python via Java

Чтение данных из файла Excel с использованием xlwings

Чтение данных из файла Excel с использованием pandas

Запись данных в файл Excel

Начнем с практических применений и сравним три самые сильные библиотеки Python (pandas, xlwings и Aspose.Cells для Python via Java) для записи данных в файл Excel.

Запись данных в файл Excel с использованием Aspose.Cells для Python via Java

Запись данных в файл Excel с использованием xlwings

Запись данных в файл Excel с использованием pandas

Добавление диаграммы в файл Excel

Начнем с практических применений и сравним три самые сильные библиотеки Python (pandas, xlwings и Aspose.Cells для Python via Java) для добавления диаграммы в файл Excel.

Добавление диаграммы в файл Excel с использованием Aspose.Cells для Python via Java

Добавление диаграммы в файл Excel с использованием xlwings

Добавление диаграммы в файл Excel с использованием pandas

В Pandas можно использовать объект ExcelWriter и функцию to_excel(), чтобы добавить диаграммы в файл Excel. Однако обратите внимание, что сам Pandas не поддерживает встраивание диаграмм напрямую в файлы Excel, он может только записывать данные в файлы Excel. Для добавления диаграммы вам нужно использовать библиотеку openpyxl или xlsxwriter для манипулирования файлами Excel. Вот пример использования библиотеки xlsxwriter для добавления диаграммы в файл Excel.

Pythonjava: Лицензирование

Mon, 01 Jan 0001 00:00:00 +0000

Вы можете установить оценочную версию Aspose.Cells для Python via Java с помощью pip install aspose-cells. Оценочная версия предоставляет абсолютно те же возможности, что и лицензионная версия продукта. Кроме того, оценочная версия просто становится лицензированной, когда вы приобретаете лицензию и добавляете несколько строк кода для применения лицензии.

Как только вы оцените Aspose.Cells, вы можете приобрести лицензию на веб-сайте Aspose. Ознакомьтесь с предлагаемыми различными типами подписок. Если у вас есть вопросы, не стесняйтесь связаться с командой продаж Aspose.

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

Если вы хотите протестировать Aspose.Cells без ограничений оценочной версии, запросите временную лицензию на 30 дней. Пожалуйста, обратитесь к Как получить временную лицензию? для получения более подробной информации.

Ограничения оценочной версии

Оценочная версия продукта Aspose.Cells (без указания лицензии) обеспечивает полную функциональность продукта, но ограничивается открытием 100 файлов в одной программе и одним дополнительным листом с оценочной надписью.

Ограничения показаны ниже:

1-е Ограничение: Количество открытых файлов

При запуске вашей программы вы можете открыть только 100 файлов Excel. Если ваше приложение превышает это количество, будет сгенерировано исключение.

2-е Ограничение: Лист с оценочной надписью

Этот лист всегда будет отображаться как активный лист. Только в лицензированной версии вы сможете установить активный лист в другие листы.

Установка лицензии

Лицензия представляет собой файл XML в формате обычного текста, который содержит такие детали, как название продукта, количество разработчиков, на которых она лицензирована, дата истечения подписки и т. д. Файл имеет цифровую подпись, поэтому не изменяйте его; даже непреднамеренное добавление дополнительного перевода строки в файл приведет к его недействительности.

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

Лицензию можно загрузить из файла в следующих местах:

Явный путь.
Рабочая папка.

Используйте метод License.setLicense для лицензирования компонента. Чаще всего самый простой способ установить лицензию - поместить файл лицензии в ту же папку, что и Aspose.Cells.jar, и указать только имя файла без пути, как показано в следующем примере:

Пример

В этом примере Aspose.Cells попытается найти файл лицензии в вашей рабочей папке.

from asposecells.api import License

lic = License()
lic.setLicense("Aspose.Cells.lic")