Metadata-Version: 2.1
Name: ytpy
Version: 2020.10.9.1
Summary: Python asynchronous wrapper for youtube data api v3.
Home-page: https://github.com/madeyoga/ytpy
Author: yeogaa
Author-email: yeogaa02@gmail.com
License: UNKNOWN
Description: # ytpy
        [![CodeFactor](https://www.codefactor.io/repository/github/madeyoga/ytpy/badge)](https://www.codefactor.io/repository/github/madeyoga/ytpy)
        ![pypi-version](https://img.shields.io/pypi/v/ytpy)
        [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/MadeYoga/aio-ytpy/issues)
        [![Discord Badge](https://discordapp.com/api/guilds/458296099049046018/embed.png)](https://discord.gg/Y8sB4ay)
        
        Python wrapper for youtube data api v3. Simple *asynchronous* wrapper to get youtube video or playlist data.
        The purpose of this project is to make it easier for developers to extract data from YouTube.
        
        - [Youtube Data API v3 documentations](https://developers.google.com/youtube/v3/docs)
        
        ## Requirements
        - Python 3.x
        - [Get Google API' Credential 'API KEY'](https://developers.google.com/youtube/registering_an_application)
        
        ## Dependencies
        - urllib
        
        ### For examples & tests
        - asyncio
        - aiohttp
        
        ## Install
        ```bash 
        pip install --upgrade ytpy
        ```
        
        ### Run Test Code
        - On project root. run command:
        ```python ytpy/test/test_import.py```
        
        ### Asynchronous Youtube Service Object
        Use `AioYoutubeService` object for asynchronous tasks.
        You can pass your api key on `dev_key` param when building the object or just set your api key on environment variable named `DEVELOPER_KEY` and `AioYoutubeService` object will get it for you.
        ```py
        import aiohttp
        
        session = aiohttp.ClientSession()
        
        # will get your api key from environment (named DEVELOPER_KEY).
        ayt = AioYoutubeService(session)
        
        # you can also pass it on dev_key param.
        ayt = AioYoutubeService(session, dev_key='replace me')
        
        session.close()
        ```
        
        ### Basic Usage: Search Video by `Search Key`
        https://developers.google.com/youtube/v3/docs/search
        
        params:
        - `q`, string. Search key. default: empty string.
        - `part`, string. Valid parts: snippet, contentDetails, player, statistics, status. default: snippet.
        - `type`, string. Valid types: video, playlist, channel.
        
        Example `Search` method
        ```py
        async def main():
          session = aiohttp.ClientSession()
          
          ayt = AioYoutubeService(session, dev_key='<replace-me>')
          
          # test search
          results = await ayt.search(q="kpop song", search_type="video", max_results=3)
          print(results['items'][0])
          
          session.close()
        ```
        
        ### Example Asynchronous
        Check [examples](https://github.com/madeyoga/ytpy/tree/master/examples) for the full code example 
        
Keywords: youtube-api-v3 python youtube-search asynchronous
Platform: UNKNOWN
Description-Content-Type: text/markdown
