/ghs

GitHub Search Engine: Web Application used to retrieve, store and present projects from GitHub, as well as any statistics related to them.

Primary LanguageJavaMIT LicenseMIT

GHSearch Platform

This project is made of two subprojects:

  1. application: The main application has two main responsibilities:
    1. Crawling GitHub and retrieving repository information. This can be disabled with app.crawl.enabled argument.
    2. Serving as the backend server for website/frontend
  2. front-end: A frontend for searching the database, which is available at http://seart-ghs.si.usi.ch

Setup & Run Project Locally (for development)

The detailed instruction can be find here.

Dockerisation 🐳

The instruction to deploy the project via Docker is available here.

More Info on Flyway and Database Migration

To learn more about Flyway you can read on here.

FAQ

How can I report a bug or request a feature or ask a question?**

Please add a new issue and we will get back to you very soon.

How add a new programming language to platform?

  1. Add the new language name to supported_languages table via:
    1. Flyway migration file (recommended): Create a new file src/main/resources/db/migration/Vx__NewLangs.sql containing: INSERT INTO supported_language (name,added) VALUES ('C++',current_timestamp);
    2. Or, manually editing the table.
    • Note: A comprehensive list of valid languages (and their aliases) are available at here. Plus you can see a similar list at GitHub Advanced Search Page. You can use the following link to verify if a language, say "C++" is valid: https://api.github.com/search/repositories?q=language:C%2B%2B.
  2. Add the new language icon: See the following commit: Adding C# on December 17th 2020