Metadata-Version: 2.0
Name: wunderpy2
Version: 0.1.1
Summary: A Python library for the Wunderlist 2 REST API
Home-page: https://github.com/mieubrisse/wunderpy2
Author: mieubrisse
Author-email: mieubrisse@gmail.com
License: MIT
Keywords: wunderpy wunderpy2 wunderlist api cli
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: requests

Overview
========
Wunderpy2 is a thin Python library for accessing `the official Wunderlist 2 API <https://developer.wunderlist.com/documentation>`_. What does a 'thin' library mean here?

1. Only the bare minimum of error-checking to pass `the Wunderlist API specifications <https://developer.wunderlist.com/documentation>`_ is performed (e.g. there's no checking whether a task's title is empty, even though the Wunderlist web client enforces nonempty titles)
2. There aren't any 'convenience' functions (e.g. get a list by its name)

These choices were made intentionally, so as to avoid getting mired in fancy feature requests.

Installation
============
::

    pip install wunderpy2

Usage & Examples
================
Getting a client
----------------
Wunderlist uses OAuth2 to allow applications to access users' data, so you'll need to `create an application <https://developer.wunderlist.com/apps>`_ before doing anything. If you only want to access your own Wunderlist, generate an access token after creating your application and use it and the client ID as follows::

    api = wunderpy.WunderApi()
    client = api.get_client(access_token, client_id)    # Fill in your values

If you want other Wunderlisters to use your application, you'll need to see the "Redirect users to request Wunderlist access" section of `the authorization docs <https://developer.wunderlist.com/documentation/concepts/authorization>`_ in order to get a temporary code when a user has authorized your app. Once you have the code, you only need one more step::

    api = wunderpy.WunderApi()
    access_token = api.get_access_token(temporary_code, client_id, client_secret)   # Fill in your values here
    client = api.get_client(access_token, client_id)    # Fill in your client ID

TODO 
====
* Implement the following endpoints:
    * Avatar
    * File
    * File preview
    * Folder
    * Positions
    * Reminder
    * Subtask
    * Task comment
    * Upload
    * User
    * Webhooks?


Release History
===============

0.1.1 (2015/08/16)
------------------
* Fixed setup.py requiring 'argparse' module for Python >2.6

0.1.0 (2015/08/15)
------------------
* Initial release


wunderpy2 is written and maintained by `mieubrisse <https://github.com/mieubrisse>`_

Contributors
============
Nobody yet!


