Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Simple LaTeX log file parsing library.

Project description


Simple output/log file parsing library for LaTeX builds.

LaTeX log files are notoriously unstructured and there is a wide variance in the style and content of messages. Messages can be roughly characterised as an error, an warning, a bad box, or info. Packages and classes can also generate messages and, while there are template macros for producing such messages, no structure is enforced on the messages.

Many LaTeX editors provide a log file parser that runs automatically on building the document. A summary of the errors, warnings, and bad boxes is usually displayed to the user. There does not seem to be any library or tool for parsing log files separate from these editors.


The library can be installed via Pip

pip install texoutparse


The main class provided by this library is LaTexLogParser, which is used to parse the log file and collect the statistics.

from texoutparse import LatexLogParser

parser = LatexLogParser()
with open('sample.log') as f:

The parser object contains lists of errors, warnings, and bad boxes, each described by an LogFileMessage object. Both objects provide a __str__ method that prints a summary of the error in the case of LatexLogParser and the raw lines in the case of LogFileMessage.

>>> print(parser)
Errors: 1, Warnings: 1, Badboxes:1

>>> print(parser.errors[0])
! Undefined control sequence.
l.6 \dtae
{December 2004}


  1. Fork it. (
  2. Create a feature branch. (git checkout -b feature/name)
  3. Commit your changes. (git commit -m 'add some feature')
  4. Push the branch to Github. (git push origin feature/name)
  5. Create a pull request.


Sam Morley - -

Distributed under the MIT license. See LICENSE for more information.

Release History

  • 1.0. Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for texoutparse, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size texoutparse-1.0.0-py2.py3-none-any.whl (5.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size texoutparse-1.0.0.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page