Metadata-Version: 2.1
Name: kon_quotes
Version: 1.0.0
Summary: K-ON Quotes API, get quotes from the K-ON Anime
Home-page: https://github.com/ZeyaTsu/k-on-quotes
Author: ZeyaTsu
Project-URL: Bug Tracker, https://github.com/ZeyaTsu/k-on-quotes/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# K-ON Quotes
Get quotes from the K-ON anime in the most easiest way possible<br/>
<img src="https://i.imgur.com/0qVCV8Z.jpeg" alt="Mio Akiyama" width="46%"/>

# Table of contents
* Content
* Usage
* Splitting the quote from the author
* Fixing UnicodeError whe using local file

# Content
Currently the file contains 213 quotes, however, more quotes are going to come in the future. <br/>
You can ask to add quotes by opening either an issue or a pull request

# Usage
## 1 - With .txt file (online)
Example to print a random quote from the online file
```py
import requests, random

file_url = "https://zeyatsu.github.io/k-on-quotes/quotes.json" # No need to download the txt file.
response = requests.get(file_url)

if response.status_code == 200:
  lines = response.text.splitlines()
  random_line = random.choice(lines)
  print(random_line)
else:
  print("Error: ", response.status_code)
```
## 2 - With .json file (online)
```py
import random
import requests

json_url = "https://zeyatsu.github.io/k-on-quotes/quotes.json" # No need to download the json file.

response = requests.get(json_url)

if response.status_code == 200:
    data = response.json()
    random_author = random.choice(list(data["authors"].keys()))
    random_quote = random.choice(data["authors"][random_author])

    print(f"{random_quote} by {random_author}")
```

For characters replace "k-on-quotes/quotes.json" by "k-on-quotes/characters/the_character_you_want.json"

# Splitting the quote from the author
```py
quote, author = random_quote.strip().split(" / ")
print(f"Quote: {quote} by {author}")
```

# Fixing UnicodeError when using local file
If you download the quotes.txt file instead of using the url, it is possible to get a UnicodeError. In this case, you will have to add a encoding parameter </br>
```py
with open('quotes.txt', 'r', encoding='utf-8') as f:
```

# Credits
<table>
  <tr>
    <td style="align:center;">
      <a href="https://github.com/ZeyaTsu"> 
        <img src="https://avatars.githubusercontent.com/u/43354103?v=4" alt="Author: ZeyaTsu" width="100" height="100"/>
        <br/>
        <span>ZeyaTsu</span>
      </a>
    </td>
  </tr>
</table>
