Skip to main content

Python library for the instapaper.com API

Project description

Python library for the instapaper.com API.

http://instapaper.com

Usage

Use the library directly:

import instapaperlib

instapaperlib.auth("username", "password")
instapaperlib.add_item("username", "password", "URL", "title")
# with selection test set
instapaperlib.add_item("username", "password", "URL", "title", "selection")

Create an instance to work with:

from instapaperlib import Instapaper

i = Instapaper("username", "password")
i.auth()

Catch the return codes to work with:

from instapaperlib import Instapaper

i = Instapaper("username", "password")
(statuscode, statusmessage) = i.add_item("URL", "title")

Also catch the response header:

from instapaperlib import Instapaper

i = Instapaper("username", "password")
(statuscode, statusmessage, title, location) = i.add_item("URL", "title", response_info=True)

Or use the cli client:

instapaper.py -u user -p password -t title URL

If you have set your username:password in ~/.instapaperrc:

instapaper.py URL

Installation

Install via pip:

pip install instapaperlib

Or, if you must:

easy_install instapaperlib

Contributing

  • fork the repo

  • add your changes and tests so I don’t accidentally break anything in the future

  • run the tests: python instapaperlib/instapaperlib.py

  • open a pull request (also runs the tests via Travis CI)

  • high-five yourself, you’re awesome

Meta

Project:

http://github.com/mrtazz/InstapaperLibrary

Issues:

http://github.com/mrtazz/InstapaperLibrary/issues

History

0.5.1 (2016-01-13)

  • fix travis.yml misconfig that only ran tests on master branch

0.5.0 (2016-01-13)

  • add support for new instapaper API

0.4.0 (2010-09-06)

  • add support for JSONP

  • add support for redirect=close

0.3.1 (2010-06-05)

  • add doctest unit test

  • catch exception in auth because of new query method

0.3.0 (2010-05-24)

  • Choose between HTTP/HTTPS (HTTPS standard)

  • Set selection for added URL

  • proper use of auto-title parameter

  • Response headers (Content-Location, X-Instapaper-Title) are returned

0.2.0 (2010-05-20)

  • Restructured as python package

  • PyPi compatibility

  • Add CLI client

0.1.0 (2010-05-01)

  • Basic library working

  • Working add_item

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instapaperlib-0.5.1.tar.gz (4.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page