https://github.com/zazuum/xlsxgrep

xlsxgrep is a CLI tool to search text in XLSX, XLS, XLSM, CSV, TSV and ODS files. It works similarly to Unix/GNU Linux grep.
https://github.com/zazuum/xlsxgrep

command-line-tool csv-files grep ods-files regex regular-expression tsv-files unix xls-files xlsm-files xlsx xlsx-files

Last synced: 2 months ago
JSON representation

xlsxgrep is a CLI tool to search text in XLSX, XLS, XLSM, CSV, TSV and ODS files. It works similarly to Unix/GNU Linux grep.

• Host: GitHub
• URL: https://github.com/zazuum/xlsxgrep
• Owner: zazuum
• License: mit
• Created: 2019-08-14T10:56:09.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2025-12-23T23:04:04.000Z (6 months ago)
• Last Synced: 2025-12-25T11:20:03.522Z (6 months ago)
• Topics: command-line-tool, csv-files, grep, ods-files, regex, regular-expression, tsv-files, unix, xls-files, xlsm-files, xlsx, xlsx-files
• Language: Python
• Homepage: https://pypi.org/project/xlsxgrep/
• Size: 60.5 KB
• Stars: 47
• Watchers: 1
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
## Owerview

*xlsxgrep* is a CLI tool to search text in XLSX, XLS, XLSM, CSV, TSV and ODS files. It works similarly to Unix/GNU Linux *grep*.

## Features

- Grep compatible: xlsxgrep tries to be compatible with Unix/Linux grep, where it makes sense.

  Some of grep options are supported (such as `-r`, `-i`  or `-c`).

- Search many XLSX, XLS, XLSM, CSV, TSV and ODS files at once, even recursively in directories.

- Regular expressions: Python regex.

- Supported file types: csv, ods, tsv, xls, xlsx, xlsm.

- Works on all major platforms: Windows, macOS, BSD and Linux,

## Usage:

```

usage: xlsxgrep [-h] [-V] [-P] [-F] [-i] [-w] [-c] [-r] [-H] [-N] [-l] [-L] [-S SEPARATOR]

                [-Z] [-d] PATTERN FILE [FILE ...]

positional arguments:

  PATTERN                   use PATTERN as the pattern to search for.

  FILE                      file or folder location.

optional arguments:

  -h, --help	            show this help message and exit.

  -V, --version	            display version information and exit.

  -P, --python-regex        PATTERN is a Python regular expression. This is the default.

  -F, --fixed-strings       interpret PATTERN as fixed strings, not regular expressions.

  -i, --ignore-case         ignore case distinctions.

  -w, --word-regexp         force PATTERN to match only whole words.

  -c, --count               print only a count of matches per file.

  -r, --recursive           search directories recursively.

  -H, --with-filename       print the file name for each match.

  -N, --with-sheetname      print the sheet name for each match.

  -l, --files-with-match    print only names of FILEs with match pattern.

  -L, --files-without-match print only names of FILEs with no match pattern.

  -S SEPARATOR, --separator SEPARATOR define custom list separator for output, the 

                            default is TAB.

  -Z, --null                output a zero byte (the ASCII NUL character) instead of the

                            usual newline.

```

## Examples:

```sh

xlsxgrep -i "foo" foobar.xlsx

```

```sh

xlsxgrep -c -H "(?i)foo|bar" /folder

```

## Installation

```sh

pip install xlsxgrep

```