Skip to main content

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

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page