wynncraft 1.1.0

A wrapper for the Wynncraft API.

wynncraft-python

A wrapper for the Wynncraft API, with local caching.

Install

Requires at least python 3.6

pip install wynncraft

Information

• All information returned in JSON format.
• For incorrect inputs ValueError will be raised.
• How does caching works?
  Only the wynncraft.cache.* functions will cache the response. If it called, it looks up the cache. If finds a valid cached response and returns it, otherwise it will make a new request, and caches it.
  A cached response is not valid if:
  • there isn't a response for that request in cache or
  • cached response is older than CACHE_TIME

Constants

Constant	Type	Descrpition	Default Value
API_KEY	String	Your API key. (Not required, but recommended)	""
CACHE_TIME	Nubmer	How long does a cached response can be used.	300
TIMEOUT	Number	Specifies a timeout in seconds for http request.	10
RL_ENABLE	Boolean	Enables the rate limiter.	True

Functions

Guild

• list

wynncraft.Guild.list()

• stats

wynncraft.Guild.stats("Wynncraft")

Ingredient

• get

wynncraft.Ingredient.get("apple")

• list

wynncraft.Ingredient.list()

• search

# Valid queries: name, tier, level, skills, sprite, identifications, itemOnlyIDs, consumableOnlyIDs
wynncraft.Ingredient.search(query, arg)

• search_name

# Same as Ingredient.search("name", arg)
wynncraft.Ingredient.search_name(arg)

• search_tier

# Same as Ingredient.search("tier", arg)
wynncraft.Ingredient.search_tier(arg)

• search_level

# Same as Ingredient.search("level", arg)
wynncraft.Ingredient.search_level(arg)

• search_skills

# Same as Ingredient.search("skills", arg)
wynncraft.Ingredient.search_skills(arg)

• search_sprite

# Same as Ingredient.search("sprite", arg)
wynncraft.Ingredient.search_sprite(arg)

• search_identifications

# Same as Ingredient.search("identifications", arg)
wynncraft.Ingredient.search_identifications(arg)

• search_item_only_ids

# Same as Ingredient.search("itemOnlyIDs", arg)
wynncraft.Ingredient.search_item_only_ids(arg)

• search_consumable_only_ids

# Same as Ingredient.search("consumableOnlyIDs", arg)
wynncraft.Ingredient.search_consumable_only_ids(arg)

Item

• database_category

# Valid categories: all, boots, bow, bracelet, chestplate, dagger, helmet, leggings, necklace, ring, spear, wand
wynncraft.Item.database_category(all)

• database_search

wynncraft.Item.database_search("Idol")

Leaderboard

• guild

wynncraft.Leaderboard.guild(timeframe)

• player

wynncraft.Leaderboard.player(timeframe)

• pvp

wynncraft.Leaderboard.pvp(timeframe)

Network

• server_list

wynncraft.Network.server_list()

• player_sum

wynncraft.Network.player_sum()

Player

• stats

wynncraft.Player.stats("Salted")

• uuid

wynncraft.Player.uuid("Salted")

Recipe

• get

wynncraft.Recipe.get("Boots-1-3")

• list

wynncraft.Recipe.list()

• search

# Valid queries: type, skill, level, durability, healthOrDamage, duration, basicDuration
wynncraft.Recipe.search(query, arg)

• search_type

# Same as Recipe.search("type", arg)
wynncraft.Recipe.search_type(arg)

• search_skill

# Same as Recipe.search("skill", arg)
wynncraft.Recipe.search_skill(arg)

• search_level

# Same as Recipe.search("level", arg)
wynncraft.Recipe.search_level(arg)

• search_durability

# Same as Recipe.search("durability", arg)
wynncraft.Recipe.search_durability(arg)

• search_health_or_damage

# Same as Recipe.search("healthOrDamage", arg)
wynncraft.Recipe.search_health_or_damage(arg)

• search_duration

# Same as Recipe.search("duration", arg)
wynncraft.Recipe.search_duration(arg)

• search_basic_duration

# Same as Recipe.search("basicDuration", arg)
wynncraft.Recipe.search_basic_duration(arg)

Search

• name

wynncraft.Search.name("Salted")

Territory

• list

wynncraft.Territory.list()

For more documentation see the Wynncraft API documentation.