Metadata-Version: 1.1
Name: simple-youtube-api
Version: 0.1.0
Summary: A python YouTube API wrapper
Home-page: https://github.com/jonnekaunisto/simple-youtube-api
Author: Jonne Kaunisto
Author-email: jonneka@gmail.com
License: MIT License
Description: Simple Youtube API
        ==================
        
        .. image:: https://badge.fury.io/py/simple-youtube-api.svg
            :target: https://badge.fury.io/py/simple-youtube-api
            :alt: Simple YouTube API page on the Python Package Index
        .. image:: https://travis-ci.org/jonnekaunisto/simple-youtube-api.svg?branch=master
            :target: https://travis-ci.org/jonnekaunisto/simple-youtube-api
            :alt: Build status on travis
        .. image:: https://coveralls.io/repos/github/jonnekaunisto/simple-youtube-api/badge.svg?branch=master
            :target: https://coveralls.io/github/jonnekaunisto/simple-youtube-api?branch=master
            :alt: Coverage on coveralls
        
        
        
        Simple Youtube API is a Youtube API wrapper for python, making it easier to search and upload your videos.
        
        
        Examples
        --------
        
        In this example we log in into a YouTube channel, set the appropriate variables for a video and upload the video to the YouTube channel that we logged into:
        
        .. code:: python
        
            from simple_youtube_api.Channel import Channel 
            from simple_youtube_api.Video import Video
        
            channel = Channel() 
            channel.login("client_secret.json", "credentials.storage")
        
            video = LocalVideo(file_path="test_vid.mp4", title="This is a title") 
            video.set_description("This is a description")
            video.set_tags(["this", "tag"]) 
            video.set_category("film") 
            video.set_privacy_status("private")
        
            channel.upload_video(video)
        
        
        Installation
        ------------
        Simple YouTube API needs API keys from Google in order to be able to make queries to YouTube.
        
        **Installation by hand:** you can download the source files from PyPi or Github:
        
        .. code:: bash
        
            $ (sudo) python setup.py install
        
        **Installation with pip:** make sure that you have ``pip`` installed, type this in a terminal:
        
        .. code:: bash
        
            $ (sudo) pip install simple-youtube-api
            
          
        Generating YouTube API Keys
        ---------------------------
        1. Log into https://console.cloud.google.com
        2. Create a new Project
        3. Search for "YouTube Data API V3"
        4. Click Credentials
        5. Click Create Credentials
        6. Select that you will call API from "Web Server"
        7. Select "Public Data" if you want to not get private data and "User Data" if you do
        8. Download or copy your API key from the Credentials tab
        
        Documentation
        -------------
        Running Tests
        -------------
        Run the python command
        
        .. code:: bash 
        
           python pytest
        
        References
        ----------
        `YouTube API Documentation`_
        
        `Python YouTube API Examples`_
        
        
        Contribute
        ----------
        1. Fork the repository from Github
        2. Clone your fork 
        
        .. code:: bash 
        
           git clone https://github.com/yourname/simple-youtube-api.git
        
        3. Add the main repository as a remote
        
        .. code:: bash
        
            git remote add upstream https://github.com/jonnekaunisto/simple-youtube-api.git
        
        4. Create a pull request and follow the guidelines
        
        
        Maintainers
        -----------
        jonnekaunisto (owner)
        
        
        .. _`YouTube API Documentation`: https://developers.google.com/youtube/v3/docs/
        .. _`Python YouTube API Examples`: https://github.com/youtube/api-samples/tree/master/python
        
        
        
Keywords: youtube
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
