Skip to main content
Build Status
Codacy Badge
codecov

Greptile

Fast grep implementation in python, with replace features

usage: greptile.py [-h] [-v] [-x EXTENSIONS [EXTENSIONS ...]] [-r] [-l] [-i]
                   [-g REPLACE_EXPR] [-f REPLACE_EXPR]
                   expression [file]

file search and replace with regular expressions

positional arguments:
  expression            regular expression
  file                  file path (or directory if -r is used)

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -x EXTENSIONS [EXTENSIONS ...], --extensions EXTENSIONS [EXTENSIONS ...]
                        restrict search to file extensions (ex: .py .txt .java
                        .xml)
  -r, --recursive       recursively search in path
  -l, --list            list files matching pattern
  -i, --inplace         update the file inplace (with -g or -f)
  -g REPLACE_EXPR, --replace-global REPLACE_EXPR
                        global replacement expression
  -f REPLACE_EXPR, --replace-first REPLACE_EXPR
                        first occurrence replacement expression

Why fast?

Because it exclusively uses generators, reptile never allocates big lists, it always processes one line in one file at a time. you can do a search on big files and large directories like / recursively without memory overhead.

Examples:

Search "import" in ./greptile.py :

$ ./greptile.py "import" ./greptile.py
import re
import os
import sys
    import argparse

Replacement & easy grouping with python re.sub syntax :

$ greptile.py "\[(.*)\]\((.*)\)" README.md -g "<a href=\"\2\">\1</a>" | diff -u README.md -
--- README.md   2016-04-19 22:37:20.000000000 +0200
+++ -   2016-04-25 14:54:24.000000000 +0200
@@ -1,4 +1,4 @@
-![Agera](https://github.com/google/agera/blob/master/doc/images/agera.png)
+!<a href="https://github.com/google/agera/blob/master/doc/images/agera.png">Agera</a>
 Reactive Programming for Android
 ================================

Api:

import greptile

# Replace "import" by "export" from dir `./`, in all files and these extensions: .py, .xml, .java
greptile.replace('import', 'export', './', '.py', '.xml', '.java')

# Return filenames of all files containing the text "import" from dir `./` and .py, .xml, .java
my_list = greptile.grep_rl('import', './', '.py', '.xml', '.java')

# same as calling replace()
greptile.sed_i(my_list, 'import', 'export')

Metadata

Release files for Greptile 0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Greptile 0.9
File Size Uploaded
Greptile-0.9.tar.gz 2.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Greptile 0.9
File Interpreter ABI Platform
Greptile-0.9-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 6.6 kB

Release files / Greptile-0.9.tar.gz

Download URL Greptile-0.9.tar.gz
Size 2.7 kB
Tags Source
SHA-256 checksum
How to use checksums
52ab9c1f15a93937e72682edac854f0a1527d63576a859948e9bc73062e3a31f
BLAKE2b-256 checksum
How to use checksums
0c4b40ce082f83f69992de208c56e3d6af6fe1a6213d370caca1ab76e2abe974
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / Greptile-0.9-py2.py3-none-any.whl

Download URL Greptile-0.9-py2.py3-none-any.whl
Size 4.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
27ac2382eaf187569890f7d421372cae1ccca09b4ba0c54e3e0fce8ad8fb629e
BLAKE2b-256 checksum
How to use checksums
bed8256ddaf0622e4f5a4fcdcab0b967a468c50d333eb8125f6cf825d1983da7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.9 This release

2 release files

0.8

3 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page