Eingabeschnittstelle von Aspose.TeX | Python

Formale Definitionen der I/O-Implementierung in Aspose.TeX für Python finden Sie in der API-Referenz.

Die Idee hinter dem Eingabeverzeichnis

Da die I/O-Primitive der TeX-Sprache nur Dateinamen verarbeiten können, definiert Aspose.TeX für Python ein Verzeichnis als Zuordnung zwischen Namen und Datensammlungen. Diese Datensammlungen können Dateien, Streams, Arrays oder jeder andere Typ sein. Die API ermöglicht die separate Angabe von Eingabe- und Ausgabearbeitsverzeichnissen. Es stellt die allgemeine Klasse InputWorkingDirectory bereit, die Benutzer für ihre spezifischen Anforderungen implementieren können. Darüber hinaus bietet die API integrierte Implementierungen, die später erläutert werden. Die Schnittstelle enthält die Methode get_file(), die den Datenstrom abruft und den vollständigen Dateinamen basierend auf einem vorgegebenen Namen ermittelt, der als Zuordnungsschlüssel dient.

Dateieingaben aus dem Festplattendateisystem abrufen

Hier ist der Ansatz, den wir wählen würden:

Setzen Sie ASPOSE_TEX_OUTPUT_DIR auf das Ausgabeverzeichnis (Standard: output). Wenden Sie zuerst eine Lizenz an. 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()

Setzen Sie ASPOSE_TEX_INPUT_DIR auf den Ordner mit hello-world.tex (Standard: input). Das Beispiel verwendet plain TeX mit TeXConfig.object_tex() und erzeugt hello-world.xps sowie hello-world.log. Eingabe:

1Hello, World!
2\end

Dateieingaben aus einem ZIP-Archiv abrufen

Eine andere Möglichkeit besteht darin, die Eingabedateien in einem ZIP-Archiv zu speichern und es als Eingabeverzeichnis zu behandeln. In einem solchen Szenario sollten die folgenden Schritte befolgt werden:

 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 bezeichnet ein Archiv mit in/hello-world.tex (Standard: zip-in.zip). Öffnen Sie es im Binärmodus rb und halten Sie den Stream bis zum Auftragsende offen.

Zunächst erstellen wir den Stream, der die ZIP-Datei enthält. Anschließend weisen wir nach dem Erstellen der Konvertierungsoptionen eine Instanz der Klasse InputZipDirectory der Eigenschaft input_working_directory zu. Der zweite Parameter des Konstruktors stellt den Basispfad innerhalb des Archivs dar. Wenn wir möchten, dass das gesamte Archiv als Eingabeverzeichnis fungiert, sollten wir als Argument eine leere Zeichenfolge angeben.

Die Idee hinter dem Eingabeterminal

Betrachten wir nun das Konzept der Terminaleingabe. Aspose.TeX für Python definiert speziell für diesen Zweck die allgemeine Schnittstelle IInputTerminal, die eine einzelne Eigenschaft enthält, die eine Instanz der Implementierung von TerminalReader zurückgibt. Die verfügbaren Implementierungen werden später besprochen.

Terminaleingabe von der Konsole abrufen

Um dies zu erreichen, müssen wir der Option terminal_in eine Instanz der Klasse InputConsoleTerminal zuweisen.

 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()

Das Beispiel liest mit \read eine Zeile und schreibt sie nach texput.xps. Geben Sie im Terminal etwa Terminal input works! ein oder leiten Sie die Zeile über die Standardeingabe ein. SCROLL_MODE erlaubt diese Eingabeanforderung.