Library to fetch trending repos/users on GitHub
Project description
gtrending
Lightweight and easy-to-use python library for fetching trending repositories and developers. Relies on github-trending-api, which is in JavaScript, so gtrending aims to fill the gap for python.
from gtrending import fetch_repos
repos = fetch_repos(language="python") # get the result as a dict
for repo in repos:
print(repo["fullname"]) # full name (user/repo) of 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
pip3 install gtrending
API
Documentation: read the docs
fetch_repos()
Fetch trending repositories on GitHub
Parameters:
language (str, optional)
: Filtering by language, eg: pythonspoken_language_code (str, optional)
: The spoken language, eg: en for englishsince (str, optional)
: The time range, choose from: [daily, weekly, monthly]. Defaults to "daily"
Returns:
A list of dicts containing information for the trending repositories found
fetch_developers()
Fetch trending developers on GitHub
Parameters:
language (str, optional)
: The programming language, eg: pythonsince (str, optional)
: The time range, choose from [daily, weekly, monthly]. Defaults to "daily"
Returns:
A list of dicts containing information for the trending repositories found
languages_list()
Fetch languages
Returns:
A list of dictionaries containing 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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gtrending-0.3.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3e7fd7700c970398dc7fd695a08d100688d4e72a46a6c18ecb9072461899dba1 |
|
MD5 | cddab65ce4a7c8a9187efa4f05deb8eb |
|
BLAKE2b-256 | 61cb5a547ca04fbd1f573ba0eea873c8a3ebfad62376b7e0a4db28ff7a7e9c6a |