Metadata-Version: 2.1
Name: fastgenius
Version: 0.0.3
Summary: A Python wrapper around the Genius API for large scale applications
Home-page: https://github.com/theomart/fastgenius
Author: Theo Martin
Author-email: contacttheomartin+fastgenius@gmail.com
License: GNU GPLv3
Keywords: genius api genius-api music lyrics artists songs fast async python wrapper
Platform: UNKNOWN
Classifier: Topic :: Software Development :: Libraries
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Requires-Dist: beautifulsoup4 (>=4.6.0)
Requires-Dist: aiohttp
Requires-Dist: tqdm
Requires-Dist: pickledb
Requires-Dist: nest-asyncio
Requires-Dist: unidecode
Requires-Dist: lxml
Provides-Extra: dev
Requires-Dist: sphinx (~=3.2) ; extra == 'dev'
Requires-Dist: sphinx-rtd-theme ; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx (~=3.2) ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'

[![fastgenius](./images/fastgenius_logo_with_namev3.png)](https://github.com/theomart/fastgenius)  

<br>
<br>


[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)


### Installation

````shell
pip install fastgenius
````

### Usage
````python
>>> import fastgenius
>>> genius = fastgenius.Genius('client_access_token')

>>> genius.get_artist('Madonna')
Artist(Madonna)

>>> genius.get_artist('Madona')
Artist(Madona (D’Lamotta))

>>> genius.get_artist(['Madonna', 'TuPac'])
{'Madonna': Artist(Madonna), 'TuPac': Artist(2Pac)}

>>> artists = genius.get_artist(['Madonna', 'TuPac'])
>>> artists['Madonna'].songs
[]

>>> artists = genius.get_artist(['Madonna', 'TuPac'], get_songs=True)
>>> artists['Madonna'].songs
[Song(Madonna - Into the Groove (Extended Remix)),
 Song(Leo The Kind - Material Girl),
 Song(Madonna - Masterpiece - MDNA World Tour / Live 2012),
 Song(Genius Polska Tłumaczenia - Madonna & Quavo - Future),
 ...]

>>> artists['Madonna'].songs[0].lyrics
"\\nAnd you can dance\\nFor inspiration\\nCome on\\nI'm waiting\\nCome, ..."

>>> big_syke = genius.get_artist('Big Syke', get_songs=True)
>>> len(big_syke.songs)
78

>>> big_syke = genius.get_artist('Big Syke', get_songs=True, primary_artist_only=True)
>>> len(big_syke.songs)
17

````

