A Python 3 module wrapper for RuneScape 3 Clan's API
Project description
rs3clans.py
A Python 3 module wrapper for RuneScape 3 API
Requirements:
Setup with pip:
$ python3 -m pip install rs3clans
Manual Setup:
(Requires Git
)
$ cd /your/projects/dir/
$ git clone https://github.com/johnvictorfs/rs3clans.py
$ cd rs3clans.py
$ python3 setup.py install
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': 1043065027}
>>> clan.member['NRiver']['rank']
'Overseer'
>>> # Case-insensitive
>>> clan.get_member('nriver')
{'rank': 'Overseer', 'exp': 1043065027, 'name': 'NRiver'}
>>> 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
Contributing:
-
Guidelines:
- Follow Pep8 with the exception of
E501 (line too long)
- Follow Pep8 with the exception of
-
Fork the repository
-
Install Dev dependencies
- With pipenv
$ pipenv install --dev
- Without pipenv
$ pip install -r requirements-dev.txt
- With pipenv
-
Run the tests to make sure everything is ok
$ pytest
-
Send a GitHub Pull Request to the repository's
master branch
-
Make your changes to the code in the directory
rs3clans.py/rs3clans/
-
Add necessary tests to the
rs3clans.py/tests/
directory (pytest docs
) -
Run the tests again
$ pytest
-
Also run
flake8
just to check if the code style is also fine$ flake8 --ignore=E501
-
If everything went fine then send a Pull Request
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
rs3clans-1.0.8-py3-none-any.whl
(10.9 kB
view hashes)