Metadata-Version: 2.1
Name: simple-youtube-api
Version: 0.2.8
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: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Utilities
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: oauth2client (>=4.1.3)
Requires-Dist: decorator (>=4.4.0)
Requires-Dist: progressbar2 (>=3.42.0)
Requires-Dist: pyser (>=0.1.4)
Provides-Extra: doc
Requires-Dist: sphinx-rtd-theme (>=0.1.10b0S) ; extra == 'doc'
Requires-Dist: Sphinx (>=1.5.2) ; extra == 'doc'
Requires-Dist: sphinx-autodoc-typehints (>=1.10.3) ; extra == 'doc'
Provides-Extra: test
Requires-Dist: pytest-cov (>=2.5.1) ; extra == 'test'
Requires-Dist: pytest (>=3.0.0) ; extra == 'test'
Requires-Dist: coveralls (<2.0,>=1.1) ; extra == 'test'
Requires-Dist: docutils (>=0.14) ; extra == 'test'
Requires-Dist: rstcheck (>=3.3.1) ; extra == 'test'

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(full documentation_) 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.LocalVideo import LocalVideo

    # loggin into the channel
    channel = Channel()
    channel.login("client_secret.json", "credentials.storage")

    # setting up the video that is going to be uploaded
    video = LocalVideo(file_path="test_vid.mp4")

    # setting snippet
    video.set_title("My Title")
    video.set_description("This is a description")
    video.set_tags(["this", "tag"])
    video.set_category("gaming")
    video.set_default_language("en-US")

    # setting status
    video.set_embeddable(True)
    video.set_license("creativeCommon")
    video.set_privacy_status("private")
    video.set_public_stats_viewable(True)

    # setting thumbnail
    video.set_thumbnail_path('test_thumb.png')

    # uploading video and printing the results
    video = channel.upload_video(video)
    print(video.id)
    print(video)

    # liking video
    video.like()



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

    python setup.py install

**Installation with pip:** make sure that you have ``pip`` installed, type this in a terminal:

.. code:: bash

    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

For user data:
5. Select OAuth Client ID
6. Select that you will call API from "Web Server"
7. Download or copy your API key from the Credentials tab

For non-user data
5. Select API Key
6. Paste the key into a file

Running Tests
-------------
Run the python command

.. code:: bash 

   python setup.py test

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
.. _documentation: https://simple-youtube-api.readthedocs.io/





