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.
Simple Demo
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 print 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.
If you liked this library, please give it a star, and maybe suggest more features!
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.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 66766bccadf483ddf51e9cd90ce9e1bf4d5cd649d14d11fc50bbd21e349d33f1 |
|
MD5 | f0e8d6e86db931862bb57207398f0280 |
|
BLAKE2b-256 | 02663cf6f9acae72363d4fe72c264e0c1a7f091d84f2092b3ea9477c0802f979 |