This package provides a Java application to query OS information designed for use in TeX's shell escape mechanism. The application can query the following:

• locale and codeset,

• current working directory,

• user home directory

• temporary directory,

• OS name, arch and version,

• current date and time in PDF format (for TeX formats that don't provide \pdfcreationdate),

• date-time stamp of a file in PDF format (for TeX formats that don't provide \pdffilemoddate),

• size of a file in bytes (for TeX formats that don't provide \pdffilesize),

• contents of a directory (captured as a list),

• directory contents filtered by regular expression (captured as a list),

• URI or canonical path of a file. All paths use a forward slash as directory divider so results can be used, for example, in commands like \includegraphics.

There are files provided for easy access in TeX documents. texosquery.tex provides generic TeX code, whereas texosquery.sty is a LaTeX package, which provides commands to run texosquery using TeX's shell escape mechanism and capture the result in a control sequence.