semvec/pypi-packages huggingface dataset:
instapaperlib 0.5.1
Python library for the instapaper.com API
License: MIT

=================
instapaperlib.py
=================

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: :code:`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