Skip to main content

Generate TODO from LaTeX files

Project description

latex-todo-gen

Extract all TODOs and FIXMEs from LaTeX project.

Usage

-h, --help                Show this help message and exit
--outfile OUTFILE
-o OUTFILE                Output file.
                          Supported extensions: md, tex, pdf.
                          Default: TODO.md
--directories DIRECTORIES
-d DIRECTORIES            Comma separated list of directories.
                          Default: text
--files FILES
-f FILES                  Comma separated list of files.
                          Defaults to none.
--keywords KEYWORDS
-k KEYWORDS               Comma separated list of keywords.
                          Default: FIXME,TODO,NOTE
--scheme SCHEME           Color scheme for output PDF file.
                          Options: light, plain, mariana, marianne, dark.
                          Default: light
--description DESCRIPTION Set output file description.
                          Default: Statistics for this LaTeX project.
--footer FOOTER           Set file footer.
                          Defaults to link to this project.

Multiple output files supported:

  • Markdown (.md). This is a default.
  • LaTeX (.tex).
  • PDF (.pdf). Generates .tex file and converts it using the latex package.

Multiple color schemes for output PDF are supported. See docs for comparison.

Examples

# Use default settings
latex-todo-gen

# Set custom keywords
latex-todo-gen -k "REVIEW,FIXME,TODO,NOTE"

# Set description and output file as PDF
latex-todo-gen --description "This file is generated on every commit." -o "WIP.pdf"

# Set source directories and one main file
latex-todo-gen -d "src,settings" -f "main.tex"

# Set color scheme for output PDF
latex-todo-gen -o "TODO.pdf" --scheme marianne

Contributing

PRs are welcome. I'm currently looking for:

  • pre-commit: I haven't been able to make it work, it seemed not to be able to locate the python script.
  • Load setup from config file. Maybe .todo-gen.yaml?
  • Universal TODO generator. This has proven to be much more universal program: you can just swap latex' % with python's # and you've got python-todo-gen. I'm probably migrate it sometime, but for now, it's just latex.
  • Multiple lines below the keyword: # TODO3 would append three lines instead of one

Project details


Download files

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

Source Distribution

latex-todo-gen-0.3.0.tar.gz (3.0 kB view hashes)

Uploaded Source

Built Distribution

latex_todo_gen-0.3.0-py3-none-any.whl (3.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page