Metadata-Version: 1.1
Name: catscan
Version: 0.0.5
Summary: Investigate wtf you were working on... where is that damn file?
Home-page: https://www.bitbucket.org/johannestaas/catscan
Author: Johan Nestaas
Author-email: johannestaas@gmail.com
License: GPLv3+
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
        
        To enable --start/--end filters to restrict to filtering specific time periods::
        
            $ catscan-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 available::
        
            # search for something you worked on between 36 hours ago and 12 hours ago
            $ catscan 'args' -s 36 -e 12
            /home/johannestaas/dev/catscan/catscan/scan.py
        
            # 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.3:
            bugfree (enough) version for release
        :0.0.2:
            Finished main features
        :0.0.1:
            Project created
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications :: Qt
Classifier: Environment :: MacOS X
Classifier: Environment :: Win32 (MS Windows)
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
