Interfaz de entrada de Aspose.TeX | Python

Para obtener definiciones formales de la implementación de E/S en Aspose.TeX para Python, consulte la referencia de API.

La idea detrás del directorio de entrada

Dado que las primitivas de E/S del lenguaje TeX solo pueden manejar nombres de archivos, Aspose.TeX para Python define un directorio como un mapeo entre nombres y colecciones de datos. Estas colecciones de datos pueden ser archivos, secuencias, matrices o cualquier otro tipo. La API permite la especificación separada de directorios de trabajo de entrada y salida. Proporciona la clase general InputWorkingDirectory, que los usuarios pueden implementar para sus necesidades específicas. Además, la API proporciona implementaciones integradas, que se analizarán más adelante. La interfaz incluye el método get_file(), que recupera el flujo de datos y determina el nombre completo del archivo en función de un nombre determinado, que sirve como clave de mapeo.

Recuperar la entrada de archivos del sistema de archivos del disco

Este es el enfoque que adoptaríamos:

Establezca ASPOSE_TEX_OUTPUT_DIR en el directorio de salida (predeterminado: output). Aplique primero una licencia. Licensing.

# Read a TeX file from a file system working directory.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.xps import XpsDevice

input_dir = Path(os.environ.get("ASPOSE_TEX_INPUT_DIR", "input")).resolve()
if not (input_dir / "hello-world.tex").is_file():
    raise FileNotFoundError(input_dir / "hello-world.tex")
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()
options.input_working_directory = InputFileSystemDirectory(str(input_dir))
device = XpsDevice()
job_result = TeXJob("hello-world.tex", device, options).run()

Establezca ASPOSE_TEX_INPUT_DIR en la carpeta con hello-world.tex (predeterminada: input). El ejemplo usa TeX simple con TeXConfig.object_tex() y genera hello-world.xps y hello-world.log. Entrada:

Hello, World!
\end

Recuperar la entrada de un archivo desde un archivo ZIP

Otra opción es almacenar los archivos de entrada en un archivo ZIP y tratarlo como un directorio de entrada. En tal escenario, se deben seguir los siguientes pasos:

# Read a TeX file from a subdirectory inside a ZIP archive.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputZipDirectory, 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)
input_zip = Path(os.environ.get("ASPOSE_TEX_INPUT_ZIP", "zip-in.zip")).resolve()

# Keep the binary ZIP stream open until the job finishes.
with input_zip.open("rb") as input_stream:
    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()
    # Resolve hello-world.tex inside the in/ directory of the archive.
    options.input_working_directory = InputZipDirectory(input_stream, "in")
    device = XpsDevice()
    job_result = TeXJob("hello-world.tex", device, options).run()

ASPOSE_TEX_INPUT_ZIP indica un archivo con in/hello-world.tex (predeterminado: zip-in.zip). Ábralo en modo binario rb y mantenga el flujo abierto hasta que termine el trabajo.

Para empezar, creamos la secuencia que contiene el archivo ZIP. Posteriormente, después de crear las opciones de conversión, asignamos una instancia de la clase InputZipDirectory a la propiedad input_working_directory. El segundo parámetro del constructor representa la ruta base dentro del archivo. Si deseamos que todo el archivo funcione como directorio de entrada, debemos proporcionar una cadena vacía como argumento.

La idea detrás del terminal de entrada

Ahora consideremos el concepto de entrada terminal. Aspose.TeX para Python define la interfaz general IInputTerminal específicamente para este propósito, que incluye una propiedad única que devuelve una instancia de la implementación TerminalReader. Las implementaciones disponibles se discutirán más adelante.

Obtener entrada de terminal desde la consola

Para lograr esto, necesitamos asignar una instancia de la clase InputConsoleTerminal a la opción terminal_in.

# Read a line from the console while processing a TeX stream.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from io import BytesIO
from aspose.tex.io import InputConsoleTerminal, OutputConsoleTerminal, OutputFileSystemDirectory
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.SCROLL_MODE
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.terminal_in = InputConsoleTerminal()
options.terminal_out = OutputConsoleTerminal()
# Enter a line of text when TeX requests input.
with BytesIO(br"\read-1 to \answer \answer\par\end") as input_stream:
    job_result = TeXJob(input_stream, XpsDevice(), options).run()

El ejemplo lee una línea mediante \read y la escribe en texput.xps. Introduzca, por ejemplo, Terminal input works! en el terminal o suministre la línea por la entrada estándar. SCROLL_MODE permite esta solicitud de entrada.