Интерфейс ввода Aspose.TeX | Python через .NET
Формальные определения реализации ввода-вывода в Aspose.TeX для Python см. в справочнике API.
Идея входного каталога
Учитывая, что примитивы ввода-вывода языка TeX могут обрабатывать только имена файлов, Aspose.TeX for Python определяет каталог как сопоставление между именами и наборами данных. Этими коллекциями данных могут быть файлы, потоки, массивы или любой другой тип. API позволяет отдельно указывать входные и выходные рабочие каталоги. Он предоставляет общий класс InputWorkingDirectory, который пользователи могут реализовать для своих конкретных нужд. Кроме того, API предоставляет встроенные реализации, которые будут обсуждаться позже. Интерфейс включает метод get_file(), который извлекает поток данных и определяет полное имя файла на основе заданного имени, которое служит ключом сопоставления.
Получение входных файлов из файловой системы диска
Вот какой подход мы бы выбрали:
Укажите выходной каталог в ASPOSE_TEX_OUTPUT_DIR (по умолчанию output). Предварительно примените лицензию.
Licensing.
1# Read a TeX file from a file system working directory.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.xps import XpsDevice
7
8input_dir = Path(os.environ.get("ASPOSE_TEX_INPUT_DIR", "input")).resolve()
9if not (input_dir / "hello-world.tex").is_file():
10 raise FileNotFoundError(input_dir / "hello-world.tex")
11output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
12output_dir.mkdir(parents=True, exist_ok=True)
13
14options = TeXOptions.console_app_options(TeXConfig.object_tex())
15options.interaction = Interaction.NONSTOP_MODE
16options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
17options.terminal_out = OutputMemoryTerminal()
18options.input_working_directory = InputFileSystemDirectory(str(input_dir))
19device = XpsDevice()
20job_result = TeXJob("hello-world.tex", device, options).run()Укажите в ASPOSE_TEX_INPUT_DIR папку с hello-world.tex (по умолчанию input). Пример использует plain TeX с TeXConfig.object_tex() и создаёт hello-world.xps и hello-world.log. Входной файл:
1Hello, World!
2\endПолучение ввода файла из ZIP-архива
Другой вариант — сохранить входные файлы в ZIP-архиве и использовать его как входной каталог. В таком случае следует выполнить следующие шаги:
1# Read a TeX file from a subdirectory inside a ZIP archive.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from aspose.tex.io import InputZipDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
6from aspose.tex.presentation.xps import XpsDevice
7
8output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
9output_dir.mkdir(parents=True, exist_ok=True)
10input_zip = Path(os.environ.get("ASPOSE_TEX_INPUT_ZIP", "zip-in.zip")).resolve()
11
12# Keep the binary ZIP stream open until the job finishes.
13with input_zip.open("rb") as input_stream:
14 options = TeXOptions.console_app_options(TeXConfig.object_tex())
15 options.interaction = Interaction.NONSTOP_MODE
16 options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
17 options.terminal_out = OutputMemoryTerminal()
18 # Resolve hello-world.tex inside the in/ directory of the archive.
19 options.input_working_directory = InputZipDirectory(input_stream, "in")
20 device = XpsDevice()
21 job_result = TeXJob("hello-world.tex", device, options).run()ASPOSE_TEX_INPUT_ZIP задаёт архив с in/hello-world.tex (по умолчанию zip-in.zip). Откройте его в двоичном режиме rb и сохраняйте поток открытым до завершения задания.
Для начала мы создаем поток, содержащий ZIP-файл. Впоследствии, после создания параметров преобразования, мы присваиваем экземпляр класса InputZipDirectory свойству input_working_directory. Второй параметр конструктора представляет базовый путь внутри архива. Если мы хотим, чтобы весь архив функционировал как входной каталог, мы должны предоставить в качестве аргумента пустую строку.
Идея входного терминала
Теперь давайте рассмотрим концепцию терминального ввода. Aspose.TeX для Python определяет общий интерфейс IInputTerminal специально для этой цели, который включает в себя одно свойство, возвращающее экземпляр реализации TerminalReader. Доступные реализации будут обсуждаться позже.
Получение терминального ввода с консоли
Для этого нам нужно назначить экземпляр класса InputConsoleTerminal опции terminal_in.
1# Read a line from the console while processing a TeX stream.
2import os
3from pathlib import Path
4from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
5from io import BytesIO
6from aspose.tex.io import InputConsoleTerminal, OutputConsoleTerminal, OutputFileSystemDirectory
7from aspose.tex.presentation.xps import XpsDevice
8
9output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
10output_dir.mkdir(parents=True, exist_ok=True)
11
12options = TeXOptions.console_app_options(TeXConfig.object_tex())
13options.interaction = Interaction.SCROLL_MODE
14options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
15options.terminal_in = InputConsoleTerminal()
16options.terminal_out = OutputConsoleTerminal()
17# Enter a line of text when TeX requests input.
18with BytesIO(br"\read-1 to \answer \answer\par\end") as input_stream:
19 job_result = TeXJob(input_stream, XpsDevice(), options).run()Пример читает строку командой \read и записывает её в texput.xps. Введите в терминале, например, Terminal input works! или передайте строку через стандартный ввод. SCROLL_MODE допускает такой запрос ввода.