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

A minimal pokedex library

Project description

Travis Build Status Appveyor Build status Codecov PyPI PyPI - Python Version License

PyPokedex is a minimal pokedex library for Python that uses PokeAPI internally to get Pokemon data. A simple example:

Requirements

  • Python 3.6+

Installing

Use:

$ pip install pypokedex

to get the latest stable release, or:

$ pip install git+https://github.com/arnavb/pypokedex.git@master

to get the latest commit on master.

Documentation

This package (pypokedex) only provides one function through the public API—get. It can be used as follows:

import pypokedex

pokemon = pypokedex.get(dex=DEX)  # DEX must be a valid _national_ pokedex
                                  # number
pokemon2 = pypokedex.get(name=NAME)  # NAME must be a valid name of a pokemon

Possible Exceptions

  • A TypeError will be raised if the wrong number of arguments or the wrong type of arguments are passed.
  • A PyPokedexHTTPError will be raised with an HTTP code of 404 if the Pokemon requested is not found. Note: The name parameter to get is case-insensitive.
  • A PyPokedexHTTPError will be raised with the proper HTTP code if another type of HTTP error occurs.
  • A PyPokedexError will be raised if a requests exception occurs (with the exception of requests.exceptions.HTTPError, handled in the previous two bullet points).
  • A PyPokedexError will be raised if data is missing when parsing the returned JSON from PokeAPI (usually this indicates an API change).

Once a valid pypokedex.pokemon.Pokemon object is returned, the following members are provided for its consumption:

Member Variables

  • dex (int): Contains the national Pokedex number of the current Pokemon.
  • name (str): Contains the name of the current Pokemon.
  • height (int): Contains the height of the current Pokemon in decimeters (see veekun/pokedex#249).
  • weight (int): Contains the weight of the current Pokemon in hectograms (see veekun/pokedex#249).
  • base_experience (intt): Contains the base experience yield of the current Pokemon.
  • types (List[str]): Contains a list of strings with the name of the current Pokemon's types.
  • abilities (List[Ability]): Contains a list of named tuples called Ability. Each Ability has the following members:
    • name (str): The name of the current ability.
    • is_hidden (bool): Whether the current ability is a hidden ability or not.
  • base_stats (BaseStats): Contains a named tuple with the current Pokemon's base stats stored as follows (all ints):
    • hp: The base HP of the current Pokemon.
    • atk: The base attack of the current Pokemon.
    • def: The base defense of the current Pokemon.
    • sp_atk: The base special attack of the current Pokemon.
    • sp_def: The base special defense of the current Pokemon.
    • speed: The base speed of the current Pokemon.
  • moves (DefaultDict[str, List[Move]]): Contains a dictionary of game names (according to PokeAPI) to a list of named tuples called Move representing the moves the current Pokemon learns in the respective game. The Move named tuple contains the following members:
    • name (str): The name of the current move.
    • learn_method (str): The method the current Pokemon uses to learn the current move (according to PokeAPI).
    • level (int): The level the current Pokemon learns the current move if learn_method is level-up, None otherwise.

Member Functions

  • def exists_in(self, game: str) -> bool: Method to check whether the current Pokemon exists in a specific game.
  • def learns(self, move_name: str, game: str) -> bool: Method to check whether the current Pokemon learns a specific move in a specific game.
  • def __str__(self) -> str: Method to get a string represenation of the current Pokemon. This string is of the form: Pokemon(dex={self.dex}, name='{self.name}').
  • __eq__, __lt__, __gt__, __le__, __ge__: Methods that implement various comparison operators for Pokemon objects in terms of their Pokedex number.

Possible Exceptions

  • learns will raise a PyPokedexError if the current Pokemon does not exist in the game specified.

License

This library is licensed under the MIT License.

Dependency Licenses

This library depends on requests, which is licensed under the Apache 2.0 License.

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 pypokedex, version 1.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pypokedex-1.2.0-py36-none-any.whl (6.7 kB) File type Wheel Python version py36 Upload date Hashes View hashes
Filename, size pypokedex-1.2.0.tar.gz (225.7 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