Metadata-Version: 1.1
Name: pss
Version: 0.36
Summary: Tool for grepping through source code
Home-page: https://bitbucket.org/eliben/pss
Author: Eli Bendersky
Author-email: eliben@gmail.com
License: Public domain
Description: 
        Introduction: what is pss?
        --------------------------
        
        **pss** is a power-tool for searching inside source code files. **pss**
        searches recursively within a directory tree, knows which extensions and
        file names to search and which to ignore, automatically skips directories
        you wouldn't want to search in (for example ``.svn`` or ``.git``), colors
        its output in a helpful way, and does much more.
        
        If you're familiar with the **ack** tool, then you will find **pss** very
        similar (see https://bitbucket.org/eliben/pss/wiki/PssAndAck).
        
        Pre-requisites
        --------------
        
        **pss** needs only Python to run. It works with with Python versions 2.6, 2.7
        and 3.2 on Linux and Windows. Some testing was done on on Mac OS X and FreeBSD
        as well.
        
        Installing
        ----------
        
        **pss** can be installed from PyPi (Python package index)::
        
            > pip install pss
        
        Alternatively, you can download the source distribution either from PyPi or go to the *Downloads* tab on the `pss project page <https://bitbucket.org/eliben/pss>`_ and pick the version you're interested in from *Tags*. When you unzip the source distribution, run::
        
            > python setup.py install
        
        Running without installing
        --------------------------
        
        **pss** supports direct invocation even without installing it. This may
        be useful if you're on a machine without administrator rights, or want to
        experiment with a source distribution of **pss**.
        
        Just unzip the **pss** distribution into some directory. Let's assume its full
        path is ``/path/to/pss``. You can now run::
        
            > /path/to/python /path/to/pss
        
        And this will invoke **pss** as expected. This command can also be tied to an
        alias or placed in a shell (or batch) script for convenience.
        
        How to use it?
        --------------
        
        **pss** is meant to be executed from the command line. Running it with no
        arguments or with ``-h`` will print a detailed usage message. 
        
        For some detailed usage examples, check out the 
        Usage wiki page - https://bitbucket.org/eliben/pss/wiki/Usage.
        
        License
        -------
        
        **pss** is open-source software. Its code is in the public domain. See the
        ``LICENSE`` file for more details.
        
        
Platform: Cross Platform
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
