Skip to main content

Investigate wtf you were working on... where is that damn file?

Project description

catscan, or mindgrep
=======

Forgot where you put that file? Forgot what you were working on?

Wish you could grep against a file you forgot about?

Installation
------------

From the project root directory::

$ pip install catscan

or::

$ python setup.py install


Usage
-----

Simply run it with something that might be in the file, and it will check through files you worked with in your bash history::

# Find files you worked on that have the search string 'install' in them.
$ catscan 'install'
/home/johannestaas/dev/catscan/catscan/install.py
/home/johannestaas/dev/catscan/setup.py
/home/johannestaas/dev/catscan/README.rst
/home/johannestaas/dev/catscan/catscan/install.py
/home/johannestaas/dev/mkpip/setup.py

Use --help/-h to view info on the arguments::

$ catscan --help

More complex scan behavior is also available::

# search using regex (python format)
$ catscan -r '201[56]-\d+-\d+'

# limit to files less than 1 megabyte
$ catscan -m 1 'foo'

# limit to files less than ~100 kilobytes
$ catscan -m 0.1 'foo'

# case insensitive search
$ catscan -i 'foo'

# Look for files that are not necessarily ASCII (using file magic)
$ catscan -a 'CAFEBABE'

# Quit after finding the first matching file
$ catscan -q 1 'foo'


Release Notes
-------------

:0.0.6:
Removed start/end features to simplify runtime requirements
:0.0.3:
bugfree (enough) version for release
:0.0.2:
Finished main features
:0.0.1:
Project created

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
catscan-0.0.7.tar.gz (6.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page