/osrs-hiscores

OSRS-Hiscores is a python based Old School Runescape (OSRS) Hiscores library for integrating user skills into your applications easily!

Primary LanguagePythonMIT LicenseMIT

OSRS Hiscores API Library

maintained
platform & version support

version
downloads
size

STATUS

This Package is no longer supported and instead has been implemented into OSRSBytes

Purpose

The purpose of this library is to interface with Old School Runescape (OSRS)'s Hiscores page and allow developers to access stat levels, ranks, and experience levels in a more intuitive way (via dictionary). This library accesses this information via a http.client request and parses the information accordingly.


Installation and Upgrades

Installation

python -m pip install OSRS-Hiscores

Upgrade

python -m pip install OSRS-Hiscores --upgrade

New Features (v0.5)

upgrade OSRS-Hiscores with:

python -m pip install OSRS-Hiscores --upgrade

Newest features include:

from OSRS_Hiscores import Hiscores

username = 'Zezima'
user = Hiscores(username, 'N')

# Lets get our attack level, rank, and experience the new way
print("Current level:", user.skill('attack', 'level'))
print("Current rank:", user.skill('attack', 'rank'))
print("Current exp:", user.skill('attack', 'experience'))

# Lets say we want to now the exact experience needed for the next level... simple
print("Total XP to Next Level:", user.skill('attack','next_level_exp'))

# What if we want the Experience remaining until next level?  We can do that too!
print("XP Remaining:", user.skill('attack','exp_to_next_level'))

Example Usage

from OSRS_Hiscores import Hiscores

# User to lookup
username = 'Zezima'

# Initialize user object, if no account type is specified, we assume 'N'
user = Hiscores(username, 'N')

# Get the entire stat dictionary
user.stats

# Get total Levels
user.skill('total')

# Get a specific skill's ranking, level, and experience
user.stats['runecrafting']

# Get skill's level, ranking, and experience separately
user.stats['runecrafting']['level']
user.stats['runecrafting']['rank']
user.stats['runecrafting']['experience']

# NEW
user.stats['runecrafting']['next_level_experience'] # Total Exp needed for next level
user.stats['runecrafting']['exp_to_next_level'] # Exp remaining til next level

# A simpler way to just get a skill's attributes
print("Current level:", user.skill('attack', 'level'))
print("Current rank:", user.skill('attack', 'rank'))
print("Current exp:", user.skill('attack', 'experience'))
print("Exp remaining:", user.skill('attack','exp_to_next_level'))