Interface de saisie d'Aspose.TeX | Python

Pour les définitions formelles de l’implémentation E/S dans Aspose.TeX pour Python, veuillez consulter la référence API.

L’idée derrière le répertoire d’entrée

Étant donné que les primitives d’E/S du langage TeX ne peuvent gérer que les noms de fichiers, Aspose.TeX pour Python définit un répertoire comme un mappage entre des noms et des collections de données. Ces collections de données peuvent être des fichiers, des flux, des tableaux ou tout autre type. L’API permet de spécifier séparément les répertoires de travail d’entrée et de sortie. Il fournit la classe générale InputWorkingDirectory, que les utilisateurs peuvent implémenter pour leurs besoins spécifiques. De plus, l’API fournit des implémentations intégrées, qui seront abordées plus tard. L’interface inclut la méthode get_file(), qui récupère le flux de données et détermine le nom complet du fichier en fonction d’un nom donné, qui sert de clé de mappage.

Récupération des entrées de fichiers à partir du système de fichiers du disque

Voici l’approche que nous adopterions :

Définissez ASPOSE_TEX_OUTPUT_DIR sur le répertoire de sortie (par défaut : output). Appliquez d’abord une licence. 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()

Définissez ASPOSE_TEX_INPUT_DIR sur le dossier contenant hello-world.tex (par défaut : input). L’exemple utilise plain TeX avec TeXConfig.object_tex() et génère hello-world.xps et hello-world.log. Entrée :

1Hello, World!
2\end

Récupération d’un fichier d’entrée à partir d’une archive ZIP

Une autre option consiste à stocker les fichiers d’entrée dans une archive ZIP et à la traiter comme un répertoire d’entrée. Dans un tel scénario, les étapes suivantes doivent être suivies :

 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 désigne une archive contenant in/hello-world.tex (par défaut : zip-in.zip). Ouvrez-la en mode binaire rb et gardez le flux ouvert jusqu’à la fin du travail.

Pour commencer, nous créons le flux qui contient le fichier ZIP. Par la suite, après avoir créé les options de conversion, nous attribuons une instance de la classe InputZipDirectory à la propriété input_working_directory. Le deuxième paramètre du constructeur représente le chemin de base dans l’archive. Si nous souhaitons que l’archive entière fonctionne comme répertoire d’entrée, nous devons fournir une chaîne vide comme argument.

L’idée derrière le terminal d’entrée

Considérons maintenant le concept d’entrée de terminal. Aspose.TeX pour Python définit l’interface générale IInputTerminal spécifiquement à cet effet, qui inclut une propriété unique qui renvoie une instance de l’implémentation de TerminalReader. Les implémentations disponibles seront discutées plus tard.

Obtenir l’entrée du terminal depuis la console

Pour y parvenir, nous devons attribuer une instance de la classe InputConsoleTerminal à l’option 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()

L’exemple lit une ligne avec \read et l’écrit dans texput.xps. Saisissez par exemple Terminal input works! dans le terminal ou fournissez la ligne via l’entrée standard. SCROLL_MODE autorise cette demande de saisie.