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

Python World of Warcraft Armory API

Project description

Change history


0.5 (09-13-10)

  • Initial release

0.6 (09-13-10)

  • Added doctest

0.7 (09-13-10)

  • More detailed doctest (also used as readme)

0.8 (09-16-10)

  • Fixed a typo in the doctest
  • Modified to fetch en_GB XML if Plone language is “en”, if “de” -> de_DE XML, for better i18n (getCharacter(self, raiderName, raiderServer, raiderZone) -> getCharacter(self, raiderName, raiderServer, raiderZone, language))

Detailed Documentation


The armory-API is a modified version of the armorypy @

The additional info you can get from it:

  • Primary & secondary spec with name and icon (to build a icon link with wowhead or wow-europe)
  • Major and minor glyphs for the active spec with name, type and effect
  • 2v2, 3v3 and 5v5 arenateams with name, rating and ranking
  • Secondary professions (cooking, fishing etc.) with name and value
  • Prefix titles, such as Private, Twilight Vanquisher etc.


To use the API, just do an import like this

>>> from armory_api import Armory

Mock Armory.getCharacter

Returns a dictionary similar to the dictionary we would get from the API, so that this test can be used while offline

>>> from test_armory import mocked_getCharacter

Mocking the function

>>> Armory.getCharacter = mocked_getCharacter

First create an instance of the Armory object

>>> armory = Armory()

To get the character info, use getCharacter(name, realm, zone, language) currently only “de” and “en” are supported

>>> raider = armory.getCharacter("Kutschurft","Azshara","EU", "en")

Now you can get the info with get(<key>)

>>> name = raider.get("name")
>>> name == "Kutschurft"

>>> server = raider.get("server")
>>> server == "Azshara"

>>> zone = raider.get("zone")
>>> zone == "EU"


Marc Goetz, Author

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 wow.armoryapi, version 0.8
Filename, size File type Python version Upload date Hashes
Filename, size (10.5 kB) File type Source Python version None Upload date Hashes View hashes

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