Git Search

Simple command line to search github.

Introduction

git-search is a simple command line tool that allows you to search for users and repositories in GitHub.

Installation

To install git search you can use pip with the following command;

pip3 install gitsearch-cli

Usage

By default the search will be scoped to look in repositories, however you can change the scope to look specifically for users.

Searching for Users

git-search --scope users owen rumney

or

git-search --scope users owenrumney

This will yield the following results;

username	url
owenrumney	https://github.com/owenrumney

Searching for repositories

When searching for repositories you can create a general search by keyword or focus the search by including the language and/or user.

git-search -l scala -u apache spark

This will give the following result;

name	owner	url
fluo-muchos	apache	https://github.com/apache/fluo-muchos
predictionio	apache	https://github.com/apache/predictionio
spark	apache	https://github.com/apache/spark
spark-website	apache	https://github.com/apache/spark-website

If you want to only return results where the keyword is in the name, you can use the --nameonly flag

git-search -l scala -u apache spark --nameonly

This will give the following result;

name	owner	url
spark	apache	https://github.com/apache/spark
spark-website	apache	https://github.com/apache/spark-website

Date based criteria

You can search for repositories based on created or updated dates using natural date periods, all of the below examples are acceptable (not limited to this). If you use a date period that isn't acceptable, the search will use the beginning of time (1979-30-10)

git-search -l=scala --updated="last week" # return 30 scala projects updated in the last week

git-search -l=python --created="yesterday" # return 30 scala projects created yesterday

git-search gitsearch -l=python --created "3 days ago"  # return 30 scala projects created yesterday

TODO

• Add date based options for search criteria
• Add tests
• Refactor the code to be more pythonic