jettex 0.0.2

A lightweight Python wrapper for TinyTeX - blazing-fast install, compile, and auto-manage packages

jettex

A lightweight Python wrapper for TinyTeX, providing easy LaTeX installation, compilation, and automatic package management.

Features

• Easy Installation: Install TinyTeX with a single function call
• LaTeX Compilation: Compile documents with pdflatex, xelatex, or lualatex
• Automatic Package Installation: Automatically detect and install missing LaTeX packages (like R's tinytex)
• Package Management: Full tlmgr wrapper for installing, removing, and updating packages
• Cross-Platform: Works on Windows, macOS, and Linux

Installation

pip install jettex

Quick Start

import jettex

# Install TinyTeX (only needed once)
jettex.install_tinytex()

# Compile a document with automatic package installation
result = jettex.compile_tex("document.tex")

if result.success:
    print(f"PDF created: {result.output_file}")

Usage

Installing TinyTeX

import jettex

# Install default version (~90 packages)
jettex.install_tinytex()

# Install minimal version (no packages)
jettex.install_tinytex(version=0)

# Install extended version (more packages)
jettex.install_tinytex(version=2)

# Force reinstall
jettex.install_tinytex(force=True)

# Check if installed
if jettex.is_tinytex_installed():
    print(f"TinyTeX is at: {jettex.tinytex_root()}")

Compiling Documents

import jettex

# Compile with auto-install (recommended)
# Automatically installs missing packages
result = jettex.compile_tex("document.tex")

# Use a specific engine
result = jettex.compile_tex("document.tex", engine="xelatex")
result = jettex.compile_tex("document.tex", engine="lualatex")

# Compile without auto-install
result = jettex.pdflatex("document.tex")
result = jettex.xelatex("document.tex")
result = jettex.lualatex("document.tex")

# Use latexmk for complex documents
result = jettex.latexmk("document.tex", engine="pdflatex")

# Check result
if result.success:
    print(f"Output: {result.output_file}")
else:
    print(f"Failed: {result.stderr}")

Package Management

import jettex

# Install packages
jettex.tlmgr_install(["geometry", "amsmath", "hyperref"])

# Remove packages
jettex.tlmgr_remove(["unused-package"])

# Update all packages
jettex.tlmgr_update(all_packages=True)

# Update tlmgr itself
jettex.tlmgr_update(self_update=True)

# List installed packages
packages = jettex.tlmgr_list()

# Search for a package
results = jettex.tlmgr_search("tikz")

# Find which package provides a file
package = jettex.find_package_for_file("geometry.sty")

Command Line Interface

jettex also provides a CLI:

# Install TinyTeX
jettex install

# Compile a document
jettex compile document.tex

# Compile with specific engine
jettex compile document.tex --engine xelatex

# Install packages
jettex install-pkg geometry amsmath

# Search for packages
jettex search tikz

# List installed packages
jettex list

# Update all packages
jettex update --all

# Show TinyTeX info
jettex info

TinyTeX Versions

Version	Description	Size
0	Infraonly (minimal, no packages)	~1 MB
1	Default (~90 common packages)	~100 MB
2	Extended (more packages)	~200+ MB

Comparison with R's tinytex

This package aims to provide feature parity with R's tinytex:

Feature	R tinytex	jettex
Install TinyTeX	✅	✅
Compile LaTeX	✅	✅
Auto-install packages	✅	✅
tlmgr wrapper	✅	✅
Cross-platform	✅	✅

Requirements

• Python 3.8+
• requests library (for downloading TinyTeX)

License

MIT License

TinyTeX itself is licensed under GPL-2.