Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

A Python 3 module wrapper for RuneScape 3 Clan's API

Project description

rs3clans.py

PyPI PyPI - Python Version Build Status

A Python 3 module wrapper for RuneScape 3 API


Requirements:

  • Python 3.6+

  • requests>=2.19.1


Setup:

$ python3 -m pip install rs3clans

Usage:

Players

  • Creating a Player object
    • Always check if a player actually exists before doing anything with it
>>> from rs3clans import players
>>> player = players.Player(name='nriver')
>>> if player.exists:
...     pass
  • Whether the player exists or not
>>> player.exists
True
  • Whether his Runemetrics Profile is Private or not
>>> player.private_profile
False
  • You can also pass the argument runemetrics as False if you don't want their runemetrics info to be set
    • This will make you unable to use some attributes from the Player class
>>> player = players.Player(name='nriver', runemetrics=False)
  • Getting a player's name
    • (if his Runemetrics Profile is private it will return the same name passed when creating object)
>>> player.name
'NRiver'
  • Getting a player's total Exp (requires Public Runemetrics Profile)
>>> player.exp
1037291112
  • Getting a player's Total Level (requires Public Runemetrics Profile)
>>> player.total_level
  • Getting a player's Combat Level (requires Public Runemetrics Profile)
>>> player.combat_level
138
  • Quests information about a player (requires Public Runemetrics Profile)
>>> player.quests_not_started
32
>>> player.quests_started
5
>>> player.quests_complete
198
  • Getting information on a specific skill of the player (requires Public Runemetrics Profile)
>>> player.skill('agility').level
99
  • Skill name is case-insensitive
>>> player.skill('AtTaCk').rank
68311
  • Can pass skill names as well as id
    • (8 = Woodcutting for example)
>>> player.skill(8).exp
14054178.6
  • Getting a player's title
>>> player.title
'The Liberator'
  • Verifying if a player's title is a suffix or not
>>> player.suffix
True
  • Getting a player's clan
>>> player.clan
'Atlantis'

Clans

  • Creating a Clan object
    • Always check if a clan actually exists before doing anything with it
>>> from rs3clans import clans
>>> try:
...     clan = clans.Clan('Atlantis')
... except clans.ClanNotFoundError:
...     print('Clan not found.')
  • Getting a clan's total Exp
>>> clan.exp
151349638333
  • Getting information about a specific member in that clan
    • Clan.member attribute (dict) (requires case-sensitive name)
    • Clan.get_member() (method) (does not require case-sensitive name)
>>> # Case-sensitive
>>> clan.member['NRiver']
{'rank': 'Overseer', 'exp': 1041963324}
>>> clan.member['NRiver']['rank']
'Overseer'
>>> # Case-insensitive
>>> clan.get_member('nriver')
{'rank': 'Overseer', 'exp': 1041963324}
>>> clan.get_member('nRiVeR')['rank']
'Overseer'
  • Getting the number of players in a clan
>>> clan.count
499
  • Getting the average Clan Exp per player in clan
>>> clan.avg_exp
303305888.44288576

Documentation:

  • Documentations are currently outdated because of issues with readthedocs that i can't be arsed to do band-aid fixes to "fix", use the examples above instead

Docs

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
rs3clans-1.0.2-py3-none-any.whl (10.0 kB) Copy SHA256 hash SHA256 Wheel py3 Oct 12, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page