Metadata-Version: 2.1
Name: gtrending
Version: 0.3.6
Summary: Fetch trending repositories and users on GitHub
Home-page: https://github.com/hedyhli/gtrending
Author: hedy
Author-email: hedy@tilde.cafe
License: MIT
Description: # `gtrending`
        
        ![checks](https://github.com/hedyhli/gtrending/workflows/checks/badge.svg)
        [![codecov](https://codecov.io/gh/hedyhli/gtrending/branch/master/graph/badge.svg?token=J19AQKEO4W)](https://codecov.io/gh/hedyhli/gtrending)
        [![docs status](https://readthedocs.org/projects/gtrending/badge/?version=latest)](https://gtrending.readthedocs.io/en/latest/)
        [![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)
        
        Fetch repositories and developers from [GitHub
        trending](https://github.com/trending).
        
        
        ```python
        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](https://gtrending.readthedocs.io/en/latest/API.html)
        
        ### `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.
        
        
        <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 dictionaries containing information for the trending developers
        > found.
        
        <br>
        
        ### `languages_list()`
        
        > Fetch languages
        
        Returns:
        > A list of dictionaries containing programming languages.
        
        <br>
        
        ### `spoken_languages_list()`
        
        > Fetch spoken languages.
        
        Returns:
        > A list of spoken languages.
        
        <br>
        
        ### `check_language()`
        
        > Check if the language exists.
        
        Parameters:
        * `language (str)`:  The language, eg: python.
        
        Returns:
        > A boolean value. True for valid language, False otherwise.
        
        <br>
        
        ### `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.
        
        <br>
        
        ### `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
        
        * [github-trending-api](https://github.com/huchenme/github-trending-api) --
          JavaScript library with API
        * requests -- Making API requests
        
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
