<commit_before><commit_msg>Add a README<commit_after>*************
Python-Tunigo
*************

Python-Tunigo is a python package that allows for simple access to `Tunigo
<http://tunigo.com/>`_'s API. This is an API for fetching featured playlists and
new releases for `Spotify <https://www.spotify.com/>`_. It supports featured
playlists, top playlists, new album releases and playlists for a range of
different genres.

Tunigo's API is what the Spotify client uses to provide its Browse-feature.

Note that the API is not documented or officially released, so it may change at
any time.


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

To install Python-Tunigo, you can use pip::

    pip install tunigo


Examples
========

.. code-block:: python

    import tunigo
    tunigo = tunigo.Tunigo()
    for playlist in tunigo.get_featured_playlists():
        print(playlist.title)


License
=======

Python-Tunigo is copyright 2014 <NAME> and contributors.
Python-Tunigo is licensed under the `Apache License, Version 2.0
<http://www.apache.org/licenses/LICENSE-2.0>`_.


Project resources
=================

- `Source code <https://github.com/trygveaa/python-tunigo>`_
- `Issue tracker <https://github.com/trygveaa/python-tunigo/issues>`_
- `Download development snapshot <https://github.com/trygveaa/python-tunigo/archive/master.tar.gz#egg=python-tunigo-dev>`_

.. image:: https://img.shields.io/pypi/v/tunigo.svg?style=flat
    :target: https://pypi.python.org/pypi/tunigo/
    :alt: Latest PyPI version

.. image:: https://img.shields.io/pypi/dm/tunigo.svg?style=flat
    :target: https://pypi.python.org/pypi/tunigo/
    :alt: Number of PyPI downloads

.. image:: https://img.shields.io/travis/trygveaa/python-tunigo/master.png?style=flat
    :target: https://travis-ci.org/trygveaa/python-tunigo
    :alt: Travis CI build status

.. image:: https://img.shields.io/coveralls/trygveaa/python-tunigo/master.svg?style=flat
   :target: https://coveralls.io/r/trygveaa/python-tunigo?branch=master
   :alt: Test coverage


Changelog
=========

v0.1.0 (UNRELEASED)
-------------------

- Initial release.
{'fraction_non_alphanumeric': 0.1642651296829971, 'fraction_numerical': 0.005283381364073006, 'mean_word_length': 3.9011764705882355, 'pattern_counts': {'":': 0, '<': 10, '<?xml version=': 0, '>': 10, 'https://': 12, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3976697', 'n_tokens_mistral': 737, 'n_tokens_neox': 696, 'n_words': 169}