Інтерфейс виводу Aspose.TeX | Python через .NET

Щоб отримати офіційні визначення реалізації вводу/виводу, зверніться до посилання на API **Aspose.TeX для Python **.

Ідея вихідного каталогу

Aspose.TeX визначає каталог як відображення між іменами та масивами даних, де масиви даних можуть бути файлами, потоками, масивами або іншими типами даних. API дозволяє специфікувати окремі вхідні та вихідні робочі каталоги. Для виведення API надає загальний інтерфейс IOutputWorkingDirectory, який користувач може реалізувати для своїх конкретних потреб. Крім того, API надає готові до використання реалізації, які будуть розглянуті нижче. Інтерфейс IOutputWorkingDirectory розширює IInputWorkingDirectory, оскільки механізм може спочатку створити та записати файл, а потім прочитати його назад. Інтерфейс містить метод get_output_file(), який повертає потік для запису, на відміну від методу get_file(), який повертає потік для читання.

Збереження результату як файл у файловій системі диска

Як згадувалося вище, output_working_directory зазвичай встановлюється як екземпляр класу OutputFileSystemDirectory.

Ось як ми це встановимо:

Укажіть вихідний каталог у ASPOSE_TEX_OUTPUT_DIR (типово output). Спочатку застосуйте ліцензію. Licensing.

# Write an XPS document and its transcript to a file system directory.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

options = TeXOptions.console_app_options(TeXConfig.object_tex())
options.interaction = Interaction.NONSTOP_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_out = OutputMemoryTerminal()
device = XpsDevice()
with BytesIO(b"Hello, World!\\end") as input_stream:
    job_result = TeXJob(input_stream, device, options).run()

Вбудований потік plain TeX створює texput.xps і texput.log у вихідному каталозі.

Збереження результату як архівний файл ZIP.

Інший варіант — створити файл або потік і використовувати його як ZIP-архів для зберігання вихідних файлів. Ось приклад:

# Write an XPS document and transcript into a finalized ZIP archive.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputZipDirectory, OutputMemoryTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

with (output_dir / "zip-xps-out.zip").open("wb") as output_stream:
    directory = OutputZipDirectory(output_stream)
    options = TeXOptions.console_app_options(TeXConfig.object_tex())
    options.interaction = Interaction.NONSTOP_MODE
    options.output_working_directory = directory
    options.terminal_out = OutputMemoryTerminal()
    try:
        device = XpsDevice()
        with BytesIO(b"Hello, World!\\end") as input_stream:
            job_result = TeXJob(input_stream, device, options).run()
    finally:
        # Write the ZIP directory before closing its underlying stream.
        directory.finish()

zip-xps-out.zip відкривається у двійковому режимі wb. Викличте finish() в OutputZipDirectory перед закриттям потоку. Архів містить texput.xps і texput.log.

Для початку ми створюємо вихідний потік для файлу ZIP. Потім, після створення параметрів перетворення, ми встановлюємо параметр output_working_directory як екземпляр класу OutputZipDirectory.

Ідея вихідного терміналу

Вивід терміналу є ще одним важливим аспектом виводу. Для цього Aspose.TeX для Python визначає загальний інтерфейс IOutputTerminal, який має єдину властивість, яка повертає екземпляр реалізації TerminalWriter. Доступні реалізації будуть розглянуті нижче.

Запис виведення терміналу на консоль

Щоб досягти цього, нам потрібно встановити параметр terminal_out як екземпляр класу OutputConsoleTerminal.

# Write TeX terminal output to the console.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputFileSystemDirectory, OutputConsoleTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

options = TeXOptions.console_app_options(TeXConfig.object_tex())
options.interaction = Interaction.NONSTOP_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_out = OutputConsoleTerminal()
device = XpsDevice()
with BytesIO(b"Hello, World!\\end") as input_stream:
    job_result = TeXJob(input_stream, device, options).run()

Знову ж таки, це значення параметра за замовчуванням, тому немає справжньої потреби вказувати його. Тому цей розділ надається виключно для демонстрації.

Запис вихідних даних терміналу у файл

На відміну від вхідного терміналу, Aspose.TeX для Python містить реалізацію інтерфейсу IOutputTerminal, який дозволяє нам записувати вихідні дані терміналу у файл у вказаному каталозі виведення.

# Write TeX terminal output to a .trm file.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import OutputFileSystemDirectory, OutputFileTerminal
from aspose.tex.presentation.xps import XpsDevice

output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

options = TeXOptions.console_app_options(TeXConfig.object_tex())
options.interaction = Interaction.NONSTOP_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_out = OutputFileTerminal(options.output_working_directory)
device = XpsDevice()
with BytesIO(b"Hello, World!\\end") as input_stream:
    job_result = TeXJob(input_stream, device, options).run()

Конструктор OutputFileTerminal приймає вихідний робочий каталог і записує туди texput.trm поруч із texput.xps і texput.log.