Skip to main content

Fetch trending repositories and users on GitHub

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gtrending-0.3.6.tar.gz (3.4 kB view hashes)

Uploaded Source

Built Distribution

gtrending-0.3.6-py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page