wawa 0.1.dev1

=======================================
`WaWA (WorkAround Web API for Python)`_
=======================================

Copyright (c) 2016 Jeremie DECOCK (http://www.jdhp.org)


* Web site: http://www.jdhp.org/projects_en.html#wawa
* Source code: https://github.com/jeremiedecock/wawa
* Issue tracker: https://github.com/jeremiedecock/wawa/issues
* WaWA on PyPI: https://pypi.python.org/pypi/wawa


Description
===========

WaWA (WorkAround Web API for Python) is an open source lightweight collection
of unofficial web APIs written for Python.

Note:

This project is still in beta stage, so the API is not finalized yet.


Dependencies
============

- Python >= 3.0
- Beautifulsoup
- Feedparser

.. _install:

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

Gnu/Linux
---------

You can install, upgrade, uninstall WaWA with these commands (in a
terminal)::

pip install --pre wawa
pip install --upgrade wawa
pip uninstall wawa

Or, if you have downloaded the WaWA source code::

python3 setup.py install

.. There's also a package for Debian/Ubuntu::
..
.. sudo apt-get install wawa

Windows
-------

Note:

The following installation procedure has been tested to work with Python
3.4 under Windows 7.
It should also work with recent Windows systems.

You can install, upgrade, uninstall WaWA with these commands (in a
`command prompt`_)::

py -m pip install --pre wawa
py -m pip install --upgrade wawa
py -m pip uninstall wawa

Or, if you have downloaded the WaWA source code::

py setup.py install

MacOSX
-------

Note:

The following installation procedure has been tested to work with Python
3.4 under MacOSX 10.6 (*Snow Leopard*).
It should also work with recent MacOSX systems.

You can install, upgrade, uninstall WaWA with these commands (in a
terminal)::

pip install --pre wawa
pip install --upgrade wawa
pip uninstall wawa

Or, if you have downloaded the WaWA source code::

python3 setup.py install


Bug reports
===========

To search for bugs or report them, please use the WaWA Bug Tracker at:

https://github.com/jeremiedecock/wawa/issues


License
=======

This project is provided under the terms and conditions of the
`MIT License`_.


.. _MIT License: http://opensource.org/licenses/MIT

.. _WaWA (WorkAround Web API for Python): http://www.jdhp.org/projects_en.html#wawa