Metadata-Version: 2.1
Name: simple-youtube-api
Version: 0.2.2
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
Keywords: youtube
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: cachetools (>=3.1.0)
Requires-Dist: google-api-python-client (>=1.7.7)
Requires-Dist: google-auth (>=1.6.2)
Requires-Dist: google-auth-httplib2 (>=0.0.3)
Requires-Dist: httplib2 (>=0.12.1)
Requires-Dist: oauth2client (>=4.1.3)
Requires-Dist: pyasn1 (>=0.4.5)
Requires-Dist: pyasn1-modules (>=0.2.4)
Requires-Dist: rsa (>=4.0)
Requires-Dist: six (>=1.12.0)
Requires-Dist: uritemplate (>=3.0.0)
Requires-Dist: pytube (>=9.5.1)
Requires-Dist: decorator (>=4.4.0)

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




