AllGitClone

A system that searches and lists the Github repositories that users need based on criteria.
The overall design of the program was referred to Github API docs.



Retrofit + OkHttp

How to communicate to web Server as Client?

@GET("search/repositories")
Call<JsonObject> getJavaRepositories(@QueryMap Map<String, String> lang);
  • query to search (ex: api.github.com/search/repositories?q=language:java)

Declaration to communicating object

Retrofit retro = new Retrofit.Builder()
                              .baseUrl(BASE_URL)
                              .addConverterFactory(GsonConverterFactory.create())
                              .build();



Available Options (2020-08-05 updated)

Option

Option description usage
-l language (java, c, cpp, javascript, ruby, etc.) -l java
-l c
-f fork count -f >=500
-f 10..200
-d last pushed date -d <=2020-08-15
-d 2019-01-01..2020-06-30
-c created date -c >2019-12-31
-c 2019-01-01..2020-01-15
-cb (optional) commit count (criteria of commit count) -cb >500
-cb <10
-auth (optional) authentication token for Github user.
It allows to send more requests per minute.
-auth 'token'



About commit option

Users can give criteria for the total number of commits in the last year of each repository. However, since no services related to commit are provided in the repository searching query, the system will once again compute the list of discovered. Unfortunately, this may take a long time to create a list of thousands of repositories that meets the criteria. The commit option is certainly important, but it can be used when necessary because it can give results quickly when not in use.



Example

AllGitClone -l java -f 100..2000 -d 2019-01-01..2020-01-01 -auth 'personal_token'  

This means that we can get a list of repositories, written in java, have fork counts greater than 100 and less than 2000,
and whose last committed date is 2019-01-01 to 2020-01-01, using personal authentication token.

AllGitClone -l cpp -f >=50 -d >=2020-07-15 -cb > 50

This means that we can get a list of repositories, written in C++, have forks counts greater than 50,
and have commmits greater than 50, without any token.