Metadata-Version: 2.4
Name: osrs-hiscores-client
Version: 0.1.1
Summary: Python client for Old School RuneScape Hiscores API.
Author: Valtteri Remes
License-Expression: MIT
Project-URL: Homepage, https://github.com/vremes/osrs-hiscores
Project-URL: Documentation, https://github.com/vremes/osrs-hiscores
Project-URL: Repository, https://github.com/vremes/osrs-hiscores.git
Project-URL: Issues, https://github.com/vremes/osrs-hiscores/issues
Keywords: osrs,hiscores,runescape,api,client
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Dynamic: license-file

# OSRS Hiscores

Simple OSRS Hiscores client for Python.

---

## Installation

```bash
pip install osrs-hiscores-client
```


## Usage

```py
from osrs_hiscores.client import HiscoresClient

rsn = "Lynx Titan"

client = HiscoresClient()

stats = client.get_player_stats(rsn)

print(f"Player {stats.rsn} has agility level of {stats.skills.agility.level}, {stats.skills.agility.experience} experience and rank {stats.skills.agility.rank}.")
# Player Lynx Titan has agility level of 99, 200000000 experience and rank 24.

# You can also loop all skills if you want to!
for skill in stats.skills:
    print(f"Player {stats.rsn} has {skill.name} level of {skill.level}, {skill.experience} experience and rank {skill.rank}")

# Player Lynx Titan has Total level of 2278, 4600000000 experience and rank 83066
# Player Lynx Titan has Attack level of 99, 200000000 experience and rank 15
# Player Lynx Titan has Defence level of 99, 200000000 experience and rank 28
# Player Lynx Titan has Strength level of 99, 200000000 experience and rank 18
# Player Lynx Titan has Hitpoints level of 99, 200000000 experience and rank 7
# ...

# Each object can be turn into dictionary if need.
print(stats.skills.cooking.to_dict())
# {'name': 'Cooking', 'rank': 150, 'level': 99, 'experience': 200000000}
```
