Интерфейс ввода 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 допускает такой запрос ввода.