Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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

Release History

Release History

This version
History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (10.5 kB) Copy SHA256 Checksum SHA256 Source Sep 16, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting