Metadata-Version: 2.0
Name: pyinstapaper
Version: 0.1.0
Summary: A Python wrapper for the full Instapaper API.
Home-page: https://github.com/mdorn/pyinstapaper
Author: Matt Dorn
Author-email: mdorn@textmethod.com
License: ISCL
Keywords: pyinstapaper
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: ISC License (ISCL)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: httplib2 (==0.9.1)
Requires-Dist: oauth2 (==1.9.0.post1)

===============================
Python Instapaper API wrapper
===============================

.. image:: https://travis-ci.org/mdorn/pyinstapaper.svg
        :target: https://travis-ci.org/mdorn/pyinstapaper

.. image:: https://img.shields.io/pypi/v/pyinstapaper.svg
        :target: https://pypi.python.org/pypi/pyinstapaper


Instapaper_ is a tool for saving web pages to read later, e.g. offline on a
mobile device.  PyInstapaper is a Python wrapper for the `full Instapaper API`_.  

.. _Instapaper: https://www.instapaper.com
.. _full Instapaper API: https://www.instapaper.com/api

To use it, in addition to your Instapaper account username and password,
you'll need to request API credentials from Instapaper.

Usage
=====

.. code-block:: python

    from pyinstapaper.instapaper import Instapaper, Folder

    INSTAPAPER_KEY = 'MY_INSTAPAPER_API_KEY'
    INSTAPAPER_SECRET = 'MY_INSTAPAPER_API_SECRET'
    INSTAPAPER_LOGIN = 'me@example.com'
    INSTAPAPER_PASSWORD = 'p@ssw0rd'

    instapaper = Instapaper(INSTAPAPER_KEY, INSTAPAPER_SECRET)
    instapaper.login(INSTAPAPER_LOGIN, INSTAPAPER_PASSWORD)

    # Get the 10 latest instapaper bookmarks for the given account and do
    # something with the article text
    bookmarks = instapaper.get_bookmarks('starred')
    for bookmark in enumerate(bookmarks):
        do_something(bookmark.get_text())
        bookmark.archive()

    # Create a new folder
    folder = Folder(instapaper, title='cool stuff')
    result = folder.add()

Installation
============

To install PyInstapaper, simply:

.. code-block:: bash

    pip install pyinstapaper

Additional info
===============

* Free software: MIT License
* Documentation: https://pyinstapaper.readthedocs.org.
* Boilerplate courtesy of cookiecutter: https://github.com/audreyr/cookiecutter
* Thanks to `Ryan Galloway`_ for pointing the way to using the Python oauth2
  library for Instapaper's XAuth implementation, though ideally pyinstapaper
  would use `requests-oauthlib`_

.. _Ryan Galloway: https://github.com/rsgalloway/instapaper
.. _requests-oauthlib: https://requests-oauthlib.readthedocs.org/en/latest/




History
-------

0.1.0 (2015-09-26)
---------------------

* First release on PyPI.


