readwise-pyinstapaper 0.2.3

PyInstapaper is a Python wrapper for the full Instapaper API.

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.

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

Usage

from pyinstapaper.instapaper import Instapaper, Folder

INSTAPAPER_KEY = 'MY_INSTAPAPER_API_KEY'
INSTAPAPER_SECRET = 'MY_INSTAPAPER_API_SECRET'
INSTAPAPER_LOGIN = '[e-mail]'
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:

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