gtrending icon indicating copy to clipboard operation
gtrending copied to clipboard

⚡ Python library for the GitHub Trending page

gtrending

checks codecov docs status pypi version Python Requirements Code style: black

Fetch repositories and developers from GitHub trending.

from gtrending import fetch_repos


repos = fetch_repos(language="python")  # Returns a dictionary

for repo in repos:
    print(repo["fullname"])  # "user/repo" for each repo

The above example will fetch all the trending Python projects on GitHub trending today and print their full names.

Requirements

  • Python 3.6 or higher

Installation

gtrending is published on PyPI, use your favorite package manager and add it as a dependency.

Pip:

pip3 install gtrending

Poetry:

poetry add gtrending

You get the idea.

API

Documentation: Read the docs

fetch_repos()

Fetch trending repositories on GitHub.

Parameters:

  • language (str, optional): Filtering by language, eg: python
  • spoken_language_code (str, optional): The spoken language, eg: en for english
  • since (str, optional): The time range, choose from: [daily, weekly, monthly]. Defaults to "daily"

Returns:

A list of dictionaries containing information for the trending repositories found.


fetch_developers()

Fetch trending developers on GitHub.

Parameters:

  • language (str, optional): The programming language, eg: python
  • since (str, optional): The time range, choose from [daily, weekly, monthly]. Defaults to "daily"

Returns:

A list of dictionaries containing information for the trending developers found.


languages_list()

Fetch languages

Returns:

A list of dictionaries containing programming languages.


spoken_languages_list()

Fetch spoken languages.

Returns:

A list of spoken languages.


check_language()

Check if the language exists.

Parameters:

  • language (str): The language, eg: python.

Returns:

A boolean value. True for valid language, False otherwise.


check_spoken_language()

Check if the spoken language exists.

Parameters:

  • spoken_language_code (str): The spoken language, eg: en for english.

Returns:

A boolean value. True for valid spoken language, False otherwise.


check_since()

Check if the time range is correct.

Parameters:

  • since (str): The time range.

Returns:

A boolean value. True for valid parameter, False otherwise.


Uses