Metadata-Version: 2.1
Name: gtrending
Version: 0.2.0
Summary: Library to fetch trending repos/users on GitHub
Home-page: https://github.com/hedythedev/gtrending
Author: Hedy Li
Author-email: hedyhyry@gmail.com
License: MIT
Description: # `gtrending`
        
        ![checks](https://github.com/hedythedev/starcli/workflows/checks/badge.svg)
        [![codecov](https://codecov.io/gh/hedythedev/gtrending/branch/master/graph/badge.svg?token=J19AQKEO4W)](https://codecov.io/gh/hedythedev/gtrending)
        [![pypi version](https://img.shields.io/pypi/v/gtrending)](https://pypi.org/project/gtrending/)
        [![Python Requirements](https://img.shields.io/pypi/pyversions/gtrending)](https://pypi.org/project/gtrending/)
        [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
        
        Lightweight and easy-to-use python library for fetching
        trending repositories and developers. Relies on
        [github-trending-api](https://github.com/huchenme/github-trending-api)
        which is in JavaScript, so gtrending aims to fill the gap
        for python.
        
        ### Simple Demo
        
        ```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 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
        
        **`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 dicts containing information for the trending repositories found
        
        
        <br>
        
        
        **`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 dicts containing information for the trending repositories found
        
        ---
        
        If you liked this library, please give it a star, and maybe suggest more features!
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Python: >=3.6
Description-Content-Type: text/markdown
