Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

framework created to use the API provided by the online game Hattrick

Project description


pyCHPP is an object-oriented python framework created to use the API provided by the online game Hattrick (


pyCHPP can be installed using pip :

pip install pychpp


First connection

from pychpp import CHPP
# Set consumer_key and consumer_secret provided for your app by Hattrick
consumer_key = ''
consumer_secret = ''
# Initialize CHPP instance
chpp = CHPP(consumer_key, consumer_secret)
# Get url, request_token and request_token_secret to request API access
# You can set callback_url and scope
auth = chpp.get_auth(callback_url="", scope="")
# auth['url'] contains the url to which the user can grant the application
# access to the Hattrick API
# Once the user has entered their credentials,
# a code is returned by Hattrick (directly or to the given callback url)
code = ""

# Get access token from Hattrick
# access_token['key'] and access_token['secret'] have to be stored
# in order to be used later by the app
access_token = chpp.get_access_token(

Further connections

# Once you have obtained access_token for a user
# You can use it to call Hattrick API
chpp = CHPP(consumer_key,
# Now you can use chpp methods to get datas from Hattrick API
# For example :
current_user = chpp.user()
all_teams = current_user.teams

best_team_ever =
best_team_ever # <HTTeam object : Les Poitevins de La Chapelle (1165592)>

best_team_arena = best_team_ever.arena
best_team_arena # <HTArena object : Stade de La Chapelle (1162154)> # 'Stade de La Chapelle'

worth_team_ever =
worth_team_ever # <HTTeam object : Capdenaguet (1750803)>

player = chpp.player(ht_id=6993859)
player # <HTPlayer object : Pedro Zurita (6993859)>
player.career_goals # 1163

match = chpp.match(ht_id=68599186)
match # <HTMatch object : Skou United - FC Barentin (68599186)> # datetime.datetime(2006, 2, 23, 20, 0)

Mapping table between classes and CHPP XML files

The following table shows the relationships between pyCHPP classes and CHPP XML files :

pyCHPP class CHPP XML files
HTArena arenadetails.xml
HTChallengeManager challenges.xml
HTLeague leaguedetails.xml
HTMatch matchdetails.xml
HTMatchLineup matchlineup.xml
HTMatchesArchive matchesarchive.xml
HTPlayer playerdetails.xml
HTRegion regiondetails.xml
HTTeam teamdetails.xml
HTUser managercompendium.xml
HTWorld worlddetails.xml
HTYouthPlayer youthplayerdetails.xml
HTYouthTeam youthteamdetails.xml


pyCHPP is licensed under the Apache License 2.0.

Project details

Download files

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

Files for pychpp, version 0.2.7
Filename, size File type Python version Upload date Hashes
Filename, size pychpp-0.2.7-py3-none-any.whl (37.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pychpp-0.2.7.tar.gz (30.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page