Metadata-Version: 2.1
Name: geniuses
Version: 0.0.1
Summary: Genius REST API Client
Home-page: https://github.com/aksakalli/geniuses
Author: Can Güney Aksakalli
Author-email: cgaksakalli@gmail.com
License: Apache 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.6, <4
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: beautifulsoup4

# Genius Lyrics API Python Client

[![Travis (.org)](https://img.shields.io/travis/aksakalli/geniuses)](https://travis-ci.org/aksakalli/geniuses)
[![Coverage Status](https://img.shields.io/codecov/c/github/aksakalli/geniuses/master.svg)](https://codecov.io/github/aksakalli/geniuses?branch=master)

A Lightweight client for typed interaction with [Genius API](https://docs.genius.com/).

## Examples

```
from geniuses import GeniusClient

client = GeniusClient("<your_token>")
songs = client.search("Cariñito los hijos")

print(songs[0].primary_artist.name)  # Los hijos del sol
print(songs[0].lyrics)  # Lloro por quererte ...

songs_from_artist = list(songs[0].primary_artist.get_songs())
print(songs_from_artist)  # [<Song(title=Cariñito, id=1949442)>, <Song(title=Si Me Quieres, id=2078361)>]
```

## CLI

WIP

## Development

This project uses [tox](https://tox.readthedocs.io/en/latest/) for running tests and
other things (style check, coverage reports).

It is recommended to install [conda](https://docs.conda.io/en/latest/miniconda.html)
along with [tox-conda](https://github.com/tox-dev/tox-conda) for using tox.
Afterwards, `tox` command will run all the steps for you.

This project strictly uses [black](https://github.com/psf/black) as an opinionated code style.
Any written line should comply with that (don’t forget to run `black .` for PRs).


## License

Released under [the Apache License](LICENSE).


