pss

pss is a power-tool for searching inside source code files.

https://github.com/eliben/pss

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.6%) to scientific vocabulary

Keywords from Contributors

packaging pip
Last synced: 11 months ago · JSON representation

Repository

pss is a power-tool for searching inside source code files.

Basic Info
  • Host: GitHub
  • Owner: eliben
  • License: other
  • Language: Python
  • Default Branch: main
  • Size: 335 KB
Statistics
  • Stars: 340
  • Watchers: 20
  • Forks: 48
  • Open Issues: 6
  • Releases: 0
Created about 13 years ago · Last pushed about 1 year ago
Metadata Files
Readme Changelog License

README.rst

===
pss
===

.. image:: https://github.com/eliben/pss/workflows/pss-tests/badge.svg
  :align: center
  :target: https://github.com/eliben/pss/actions

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 ``.git`` or ``.svn``), 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://github.com/eliben/pss/wiki/pss-and-ack).

Pre-requisites
--------------

**pss** needs only Python to run. It's being tested with several of the latest
Python 3.x versions on Linux, Mac OS and Windows. Earlier versions of Python 3.x
may work as well, but this isn't guaranteed. Python 2 is no longer supported
(but you may download pss version 1.43 or older if you need it to work with
Python 2).

Installing
----------

**pss** can be installed from PyPI (Python Package Index)::

    > pip install pss

Alternatively, you can download the source distribution either from PyPI or
from the main Github project page. 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://github.com/eliben/pss/wiki/Usage-samples

License
-------

**pss** is open-source software. Its code is in the public domain. See the
``LICENSE`` file for more details.

Owner

  • Name: Eli Bendersky
  • Login: eliben
  • Kind: user
  • Location: California
  • Company: @google

GitHub Events

Total
  • Watch event: 9
  • Push event: 7
  • Pull request event: 1
  • Pull request review event: 1
  • Fork event: 2
Last Year
  • Watch event: 9
  • Push event: 7
  • Pull request event: 1
  • Pull request review event: 1
  • Fork event: 2

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 274
  • Total Committers: 25
  • Avg Commits per committer: 10.96
  • Development Distribution Score (DDS): 0.179
Past Year
  • Commits: 5
  • Committers: 1
  • Avg Commits per committer: 5.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Eli Bendersky e****n@g****m 225
TobiasPleyer t****r@g****m 6
Mickaël Schoentgen c****t@t****r 5
Adam Matan a****m@m****e 5
eli.bendersky d****l@l****t 4
Mike Pennington m****g 3
Jason Robinson m****l@j****e 3
Ben Hoyt b****t@g****m 2
Bernhard Leiner b****r@g****m 2
Christian Hattemer K****H 2
Paul Moore p****e@g****m 2
tbunyk t****k@g****m 2
Brian Neal b****l@g****m 1
Aleksandar Dimitrov a****v@g****m 1
CrazyMerlyn c****n@g****m 1
Heath Kehoe h****h@d****m 1
Mauricio Souza de Alencar 8****r 1
Neil Chintomby n****y@g****m 1
Paul Ollis p****l@c****g 1
Pekka Klärck p****e@i****i 1
Spencer Herzberg s****g@g****m 1
c-f-h c****r@g****t 1
denrou d****l@g****m 1
rdburns r****s@g****m 1
aleksey sivokon a****n@g****m 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 34
  • Total pull requests: 41
  • Average time to close issues: 5 months
  • Average time to close pull requests: about 1 month
  • Total issue authors: 17
  • Total pull request authors: 24
  • Average comments per issue: 3.38
  • Average comments per pull request: 1.1
  • Merged pull requests: 31
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • benhoyt (6)
  • eliben (4)
  • pekkaklarck (4)
  • assaf758 (3)
  • TobiasPleyer (3)
  • bunyk (2)
  • techtonik (2)
  • clach04 (1)
  • aaltat (1)
  • adamatan (1)
  • hellmutleo (1)
  • shoecart (1)
  • tlynn (1)
  • mpenning (1)
  • DamienCassou (1)
Pull Request Authors
  • adamatan (5)
  • BoboTiG (5)
  • eliben (4)
  • KrilleGH (3)
  • jaywink (3)
  • pekkaklarck (2)
  • benhoyt (2)
  • mpenning (2)
  • pfmoore (1)
  • TobiasPleyer (1)
  • vsajip (1)
  • crazymerlyn (1)
  • rdburns (1)
  • sherzberg (1)
  • techtonik (1)
Top Labels
Issue Labels
enhancement (5) wontfix (2) bug (1) question (1)
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 21,432 last-month
  • Total docker downloads: 55
  • Total dependent packages: 2
  • Total dependent repositories: 11
  • Total versions: 15
  • Total maintainers: 1
pypi.org: pss

Tool for grepping through source code

  • Versions: 15
  • Dependent Packages: 2
  • Dependent Repositories: 11
  • Downloads: 21,432 Last month
  • Docker Downloads: 55
Rankings
Downloads: 1.3%
Docker downloads count: 2.3%
Dependent packages count: 3.2%
Average: 3.4%
Stargazers count: 3.5%
Dependent repos count: 4.4%
Forks count: 6.0%
Maintainers (1)
Last synced: 11 months ago