tononkira 1.1.0
Unofficial Module and CLI tool to get Malagasy song lyrics from https://tononkira.serasera.org
Requires Python: >=3.6

# tononkira

Unofficial Module and CLI tool to get Malagasy song lyrics from https://tononkira.serasera.org

<p>
 <a href='https://pypi.org/project/tononkira/'> <img src='https://img.shields.io/pypi/v/tononkira?style=for-the-badge'/></a>
 <a href='https://pypi.org/project/ampalibe/'> <img src='https://img.shields.io/pypi/dm/tononkira?label=DOWNLOADS&style=for-the-badge'/></a>
 <a href='#'> <img src='https://img.shields.io/badge/Maintained-Yes-darkgreen?style=for-the-badge'/></a>
 <a href='https://pypi.org/project/tononkira/'> <img src='https://img.shields.io/pypi/pyversions/tononkira?style=for-the-badge'/></a>
</p>

## INSTALLATION

```s
pip install tononkira
```

## USAGE

### MODULE 

```python
from tononkira import Tononkira 

tononkira = Tononkira()

print(tononkira.get("Ampy anahy")) 
``` 

### CLI TOOL

![image](https://user-images.githubusercontent.com/43904633/181905251-f08f27de-7032-4ec6-9b7a-55495b69fd06.png)


## ADVANCE USAGE 

```python
from tononkira import Tononkira 

tononkira = Tononkira()

# global search
res = tononkira.search("Ambondrona") 
print(res[:2])

# specific search by artist
res = tononkira.search_by(artist="LJO") 
print(res[:2])

# specific search by title
res = tononkira.search_by(title="Donia") 
print(res[:2])

# specific search by lyrics
res = tononkira.search_by(lyrics="tia anao aho") 
print(res[:2])

# specific search by title and lyrics
res = tononkira.search_by(title="Ngoma", lyrics="Mena masoandro") 
print(res[:2])

``` 


> OUTPUT 

```python
[
{'title': 'Ajanony any', 'artist': 'AmbondronA', 'url': 'https://tononkira.serasera.org/hira/ambondrona/ajanony-any-1'},
{'title': 'ALEO ALOHA', 'artist': 'AmbondronA', 'url': 'https://tononkira.serasera.org/hira/ambondrona/aleo-aloha'}
]
...
[
{'title': 'Aya', 'artist': 'LJo', 'url': 'https://tononkira.serasera.org/hira/ljo/aya'},
{'title': 'Ino tianÃ´ ?', 'artist': 'LJo', 'url': 'https://tononkira.serasera.org/hira/ljo/ino-tian-'}
]
...
[
{'title': 'Donia', 'artist': 'Lion Hill', 'url': 'https://tononkira.serasera.org/hira/lion-hill/donia'},
{'title': 'RABODONIARIVO', 'artist': "Jonny R'afa", 'url': 'https://tononkira.serasera.org/hira/jonny-rafa/rabodoniarivo'}
]
...
[
{'title': '#586# [Feat. Mr Sayda]', 'artist': '306 BUK', 'url': 'https://tononkira.serasera.org/hira/306-buk/586-feat.-mr-sayda-1'},
{'title': "'Lay andro hodianao", 'artist': 'Mr Sayda (MisiÃ© Sayda)', 'url': 'https://tononkira.serasera.org/hira/mr-sayda-misi-sayda/lay-andro-hodianao'}
]
...
[
{'title': 'Ngoma', 'artist': 'Shyn', 'url': 'https://tononkira.serasera.org/hira/shyn-1/ngoma-1'}, 
{'title': 'Ngoma (feat Denise)', 'artist': 'Shyn', 'url': 'https://tononkira.serasera.org/hira/shyn-1/ngoma-feat-denise'}
]

```
_________________________________________

```python
from tononkira import Tononkira 

tononkira = Tononkira()

res = tononkira.fetch("https://tononkira.serasera.org/hira/ambondrona/aleo-aloha") 
print(res)
```` 
> OUTPUT 

```

ALEO ALOHA (Ambondrona)
----------------------

toa ts aritro iany
ny iandry anao
niezaka iany aho fa toa
...

```