Metadata-Version: 2.0
Name: imgur-uploader
Version: 0.1.1
Summary: A simple command line client for uploading files to Imgur.
Home-page: https://github.com/atbaker/imgur-uploader
Author: Andrew Tork Baker
Author-email: andrew@atbaker.me
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Utilities
Requires-Dist: click
Requires-Dist: imgurpython

imgur-uploader
==============

A simple command line client for uploading files to Imgur.

Created for my `PyCon US 2015 Docker tutorial <https://us.pycon.org/2015/schedule/presentation/312/>`_ so that students using my cloud servers can see the gifs they create at the end of exercise 1.

This tool is open source under the `MIT License <LICENSE>`_.

Quickstart
----------

Getting Imgur API credentials
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Go to https://api.imgur.com/oauth2/addclient and register a new Imgur API client. You will need an Imgur account to do this.

You can put it any valid URL for the callback URL - we won't be using it.

Installing imgur-uploader
^^^^^^^^^^^^^^^^^^^^^^^^^

Installing imgur-uploader is easy. It runs on versions of Python >=2.7 or >=3.3.

#. Clone this repository
#. Install the tool with ``pip install -e .``
#. Set the ``IMGUR_API_ID`` and ``IMGUR_API_SECRET`` environment variables using your client's credentials

Using imgur-uploader
^^^^^^^^^^^^^^^^^^^^

Upload an image by running ``imgur-uploader path/to/my.gif``

The tool return a shortened link to your uploaded gif upon completion::

    Uploading file output.gif
    ...
    File uploaded - see your gif at http://i.imgur.com/6WsQPpw.gif


