A powerful, format-agnostic search tool
Project description
Super Grep
IMPORTANT: This is alpha software. If you have any version below 0.1.4, please update to 0.1.4 or later. There have been significant changes to the logic that processes the search pattern.
Super Grep is a powerful, format-agnostic search tool that allows you to search for patterns in files and directories with ease. It supports various naming conventions and provides options for controlling search depth, file content searching, and output colorization.
Features
- Format-agnostic pattern matching (supports camelCase, snake_case, PascalCase, kebab-case, Title Case, Capitalized With Spaces, etc.)
- Configurable search depth
- File content searching
- Colorized output option
- Multi-process search for improved performance
- Depth-controlled directory search
- File name only search option
- Stop on first match option
- Option to hide directory paths in output
- Option to show only file names with matches
Installation
You can install Super Grep using pip:
pip install super-grep
Usage
After installation, you can use the super-grep
command directly from your terminal:
super-grep [OPTIONS] DIRECTORY PATTERN
Options
--workers NUMBER
: Number of worker processes (default: CPU count)--contents
: Search within file contents (default: search filenames only)--color
: Colorize the output--depth NUMBER
: Depth of directory search (default: 0, search only in given directory; use -1 for unlimited depth)
Examples
-
Search only in the given directory:
super-grep /path/to/search "FooBar|first_name"
-
Search up to 2 levels deep:
super-grep /path/to/search "FooBar|first_name" --depth 2
-
Search all subdirectories:
super-grep /path/to/search "FooBar|first_name" --depth -1
-
Search file contents up to 3 levels deep with colored output:
super-grep /path/to/search "FooBar|first_name" --depth 3 --contents --color
-
Use 8 worker processes:
super-grep /path/to/search "FooBar|first_name" --workers 8
-
Hide the directory path in the output:
super-grep /path/to/search "getValueFromSection" -H
-
Show only filenames and stop on the first match:
super-grep /path/to/search "getValueFromSection" -H -s
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Support the Project
If you find Super Grep useful, please consider supporting its development. See the SUPPORT.md
file included in this package for more information on how you can contribute.
- PayPal: Donate via PayPal
License
This project is licensed under the MIT License - see the LICENSE file for details.
Supporting Super Grep
If you find Super Grep useful and would like to support its development, there are several ways you can contribute:
Financial Support
You can make a financial contribution to the project via:
- PayPal: Donate via PayPal
- GitHub Sponsors: Sponsor on GitHub
Other Ways to Support
- Star the project on GitHub
- Report bugs or suggest features by opening issues on GitHub
- Contribute code by submitting pull requests
- Spread the word about Super Grep to your colleagues and friends
Your support, in any form, is greatly appreciated and helps to ensure the continued development and maintenance of Super Grep. Thank you!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for super_grep-0.1.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 29b130539ed719a691bf0ddde9b749de4527fd659702d946803e8351e6ea2297 |
|
MD5 | 71552c8a2555b7fb46ba19fa7508a978 |
|
BLAKE2b-256 | 02b538242ed0b786f8a68aeaf441ff4125141ac01f21138690a375cf8e088b45 |