CTAN Comprehensive TeX Archive Network

Directory support/texlogsieve

README.md

texlogsieve - (yet another program to) filter and summarize log files

texlogsieve reads a log file (or the standard input if no file is specified), filters out less relevant messages, and displays a summary report. It is a texlua script, similar in spirit to tools such as texfot, texloganalyser, rubber-info, textlog_extract, texlogparser, texlogfilter, pulp, and others. Highlights:

  • Two reports: the most important messages from the log file followed by a summary of repeated messages, undefined references etc.;
  • The program goes to great lengths to correctly handle line wrapping and does a much better job at that than existing tools;
  • Multiline messages are treated as a single entity;
  • Several options to control which messages should be filtered out;
  • No messages are accidentally removed.

texlogsieve must be run from the same directory as [pdf|lua|xe]latex, because it searches for the files used during compilation (packages loaded from the current directory, files included with \input etc.). Also, since it cannot detect if stops for user input, you should really run in nonstopmode when texlogsieve is reading from a pipe.

The defaults are reasonable; hopefully, you can just do

[pdf|lua|xe]latex -interaction nonstopmode myfile.tex | texlogsieve

or

texlogsieve myfile.log

and be satisfied with the result (still, you should check the "Tips" section of the documentation).

Since it needs to know what messages to expect, texlogsieve is currently geared towards ; I have no idea how it would work with Cont or plain . Still, adding support to them should not be too difficult.

If you want to know more about the log file and the workings of the program, check the initial comments in the code.


Code etc: https://gitlab.com/lago/texlogsieve

Copyright (C) 2021-2024 Nelson Lago <lago@ime.usp.br>

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Download the contents of this package in one zip archive (136.4k).

texlogsieve – Filter and summarize log files

texlogsieve reads a log file (or the standard input if no file is specified), filters out less relevant messages, and displays a summary report. It is a texlua script, similar in spirit to tools such as texfot, texloganalyser, rubber-info, textlog_extract, texlogparser, texlogfilter, pulp, and others. Highlights:

  • Two reports: the most important messages from the log file followed by a summary of repeated messages, undefined references etc.;
  • The program goes to great lengths to correctly handle line wrapping and does a much better job at that than existing tools;
  • Multiline messages are treated as a single entity;
  • Several options to control which messages should be filtered out;
  • No messages are accidentally removed;
  • The summary report is currently simple, but useful.

Packagetexlogsieve
Repositoryhttps://gitlab.com/lago/texlogsieve
Version1.4.2 2024-11-22
LicensesGNU General Public License, version 3 or newer
Copyright2021–2024 Nelson Lago
MaintainerNelson Lago
Contained inTeX Live as texlogsieve
MiKTeX as texlogsieve
TopicsLog manipulation
Use Lua
Compiler management
...
Guest Book Sitemap Contact Contact Author