X-Git-Url: http://git.veekun.com/zzz-pokedex.git/blobdiff_plain/631bc7752831b39620d2039f19e7c2c33489d671..b3b3285a703226e551e34a89e59a0c6c4e97b16f:/pokedex/db/tables.py?ds=inline diff --git a/pokedex/db/tables.py b/pokedex/db/tables.py index 5164ff4..1de7e7b 100644 --- a/pokedex/db/tables.py +++ b/pokedex/db/tables.py @@ -1,3 +1,5 @@ +# encoding: utf8 + from sqlalchemy import Column, ForeignKey, MetaData, Table from sqlalchemy.ext.declarative import declarative_base from sqlalchemy.orm import backref, relation @@ -27,6 +29,84 @@ class EggGroup(TableBase): id = Column(Integer, primary_key=True, nullable=False) name = Column(Unicode(16), nullable=False) +class Encounter(TableBase): + """Rows in this table represent encounters with wild Pokémon. + + Within a given area in a given game, encounters are differentiated by the + slot they are in and a world condition. + + Groups of slots belong to encounter types; these are what the player is + doing to get an encounter, such as surfing or walking through tall grass. + + Within an encounter type, slots are defined primarily by rarity. Each slot + can also be affected by a world condition; for example, the 20% slot for + walking in tall grass is affected by whether a swarm is in effect in the + areas. "There is a swarm" and "there is not a swarm" are conditions, and + together they make a condition group. However, since "not a swarm" is a + base state rather than any sort of new state, it is omitted and instead + referred to by a NULL. + + A slot (20% walking in grass) and single world condition (NULL, i.e. no + swarm) are thus enough to define a specific encounter. + + Well, okay, almost: each slot actually appears twice. + """ + + __tablename__ = 'encounters' + id = Column(Integer, primary_key=True, nullable=False) + version_id = Column(Integer, ForeignKey('versions.id'), nullable=False, autoincrement=False) + location_area_id = Column(Integer, ForeignKey('location_areas.id'), nullable=False, autoincrement=False) + encounter_type_slot_id = Column(Integer, ForeignKey('encounter_type_slots.id'), nullable=False, autoincrement=False) + encounter_condition_id = Column(Integer, ForeignKey('encounter_conditions.id'), nullable=True, autoincrement=False) + pokemon_id = Column(Integer, ForeignKey('pokemon.id'), nullable=False, autoincrement=False) + min_level = Column(Integer, nullable=False, autoincrement=False) + max_level = Column(Integer, nullable=False, autoincrement=False) + +class EncounterCondition(TableBase): + """Rows in this table represent something different about the world that + can affect what Pokémon are encountered. + """ + + __tablename__ = 'encounter_conditions' + id = Column(Integer, primary_key=True, nullable=False) + encounter_condition_group_id = Column(Integer, ForeignKey('encounter_condition_groups.id'), primary_key=False, nullable=False, autoincrement=False) + name = Column(Unicode(64), nullable=False) + +class EncounterConditionGroup(TableBase): + """Rows in this table represent a group of mutually exclusive conditions, + such as morning/day/night. "Conditions" that are part of the default state + of the world, such as "not during a swarm" or "not using the PokéRadar", + are not included in this table and are referred to by NULLs in other + tables. + """ + + __tablename__ = 'encounter_condition_groups' + id = Column(Integer, primary_key=True, nullable=False) + name = Column(Unicode(64), nullable=False) + +class EncounterType(TableBase): + """Rows in this table represent ways the player can enter a wild encounter; + i.e. surfing, fishing, or walking through tall grass. + """ + + __tablename__ = 'encounter_types' + id = Column(Integer, primary_key=True, nullable=False) + name = Column(Unicode(64), nullable=False) + +class EncounterTypeSlot(TableBase): + """Rows in this table represent an abstract "slot" within an encounter + type, associated with both a condition group and a rarity. + + Note that there are two encounters per slot, so the rarities will only add + up to 50. + """ + + __tablename__ = 'encounter_type_slots' + id = Column(Integer, primary_key=True, nullable=False) + encounter_type_id = Column(Integer, ForeignKey('encounter_types.id'), primary_key=False, nullable=False, autoincrement=False) + encounter_condition_group_id = Column(Integer, ForeignKey('encounter_condition_groups.id'), primary_key=False, nullable=True, autoincrement=False) + rarity = Column(Integer, nullable=False, autoincrement=False) + class EvolutionChain(TableBase): __tablename__ = 'evolution_chains' id = Column(Integer, primary_key=True, nullable=False) @@ -47,16 +127,35 @@ class Generation(TableBase): main_region = Column(Unicode(16), nullable=False) class GrowthRate(TableBase): + """`formula` is written in LaTeX math notation.""" __tablename__ = 'growth_rates' id = Column(Integer, primary_key=True, nullable=False) + name = Column(Unicode(20), nullable=False) + formula = Column(Unicode(500), nullable=False) + +class Item(TableBase): + __tablename__ = 'items' + id = Column(Integer, primary_key=True, nullable=False) name = Column(Unicode(16), nullable=False) - formula = Column(Unicode(255), nullable=False) class Language(TableBase): __tablename__ = 'languages' id = Column(Integer, primary_key=True, nullable=False) name = Column(Unicode(16), nullable=False) +class Location(TableBase): + __tablename__ = 'locations' + id = Column(Integer, primary_key=True, nullable=False) + generation_id = Column(Integer, ForeignKey('generations.id'), nullable=False) + name = Column(Unicode(64), nullable=False) + +class LocationArea(TableBase): + __tablename__ = 'location_areas' + id = Column(Integer, primary_key=True, nullable=False) + location_id = Column(Integer, ForeignKey('locations.id'), nullable=False) + internal_id = Column(Integer, nullable=False) + name = Column(Unicode(64), nullable=True) + class MoveEffect(TableBase): __tablename__ = 'move_effects' id = Column(Integer, primary_key=True, nullable=False) @@ -83,10 +182,18 @@ class Move(TableBase): effect_id = Column(Integer, ForeignKey('move_effects.id'), nullable=False) effect_chance = Column(Integer) contest_type = Column(Unicode(8), nullable=False) - contest_effect_id = Column(Integer, ForeignKey('contest_effects.id'), nullable=False) + contest_effect_id = Column(Integer, ForeignKey('contest_effects.id'), nullable=True) super_contest_effect_id = Column(Integer, nullable=False) class Pokemon(TableBase): + """The core to this whole mess. + + Note that I use both 'forme' and 'form' in both code and the database. I + only use 'forme' when specifically referring to Pokémon that have multiple + distinct species as forms—i.e., different stats or movesets. 'Form' is a + more general term referring to any variation within a species, including + purely cosmetic forms like Unown. + """ __tablename__ = 'pokemon' id = Column(Integer, primary_key=True, nullable=False) name = Column(Unicode(20), nullable=False) @@ -112,6 +219,37 @@ class Pokemon(TableBase): has_gen4_fem_sprite = Column(Boolean, nullable=False) has_gen4_fem_back_sprite = Column(Boolean, nullable=False) + ### Stuff to handle alternate Pokémon forms + + @property + def national_id(self): + """Returns the National Pokédex number for this Pokémon. Use this + instead of the id directly; alternate formes may make the id incorrect. + """ + + if self.forme_base_pokemon_id: + return self.forme_base_pokemon_id + return self.id + + @property + def full_name(self): + """Returns the name of this Pokémon, including its Forme, if any.""" + + if self.forme_name: + return "%s %s" % (self.forme_name.capitalize(), self.name) + return self.name + + @property + def normal_form(self): + """Returns the normal form for this Pokémon; i.e., this will return + regular Deoxys when called on any Deoxys form. + """ + + if self.forme_base_pokemon: + return self.forme_base_pokemon + + return self + class PokemonAbility(TableBase): __tablename__ = 'pokemon_abilities' pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) @@ -135,6 +273,39 @@ class PokemonFlavorText(TableBase): version_id = Column(Integer, ForeignKey('versions.id'), primary_key=True, nullable=False, autoincrement=False) flavor_text = Column(Unicode(255), nullable=False) +class PokemonFormGroup(TableBase): + __tablename__ = 'pokemon_form_groups' + pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) + description = Column(Unicode(512), nullable=False) + +class PokemonFormSprite(TableBase): + __tablename__ = 'pokemon_form_sprites' + id = Column(Integer, primary_key=True, nullable=False) + pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) + name = Column(Unicode(16), nullable=True) + +class PokemonItem(TableBase): + __tablename__ = 'pokemon_items' + pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) + version_id = Column(Integer, ForeignKey('versions.id'), primary_key=True, nullable=False, autoincrement=False) + item_id = Column(Integer, ForeignKey('items.id'), primary_key=True, nullable=False, autoincrement=False) + rarity = Column(Integer, nullable=False) + +class PokemonMove(TableBase): + __tablename__ = 'pokemon_moves' + pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) + version_group_id = Column(Integer, ForeignKey('version_groups.id'), primary_key=True, nullable=False, autoincrement=False) + move_id = Column(Integer, ForeignKey('moves.id'), primary_key=True, nullable=False, autoincrement=False, index=True) + pokemon_move_method_id = Column(Integer, ForeignKey('pokemon_move_methods.id'), primary_key=True, nullable=False, autoincrement=False) + level = Column(Integer, primary_key=True, nullable=True, autoincrement=False) + order = Column(Integer, nullable=True) + +class PokemonMoveMethod(TableBase): + __tablename__ = 'pokemon_move_methods' + id = Column(Integer, primary_key=True, nullable=False, autoincrement=False) + name = Column(Unicode(64), nullable=False) + description = Column(Unicode(255), nullable=False) + class PokemonName(TableBase): __tablename__ = 'pokemon_names' pokemon_id = Column(Integer, ForeignKey('pokemon.id'), primary_key=True, nullable=False, autoincrement=False) @@ -190,10 +361,29 @@ class Version(TableBase): ### Relations down here, to avoid ordering problems +Encounter.pokemon = relation(Pokemon, backref='encounters') +Encounter.version = relation(Version, backref='encounters') +Encounter.location_area = relation(LocationArea, backref='encounters') +Encounter.slot = relation(EncounterTypeSlot, backref='encounters') +Encounter.condition = relation(EncounterCondition, backref='encounters') + +EncounterCondition.group = relation(EncounterConditionGroup, + backref='conditions') + +EncounterTypeSlot.type = relation(EncounterType, backref='slots') + EvolutionChain.growth_rate = relation(GrowthRate, backref='evolution_chains') + +LocationArea.location = relation(Location, backref='areas') + +Move.type = relation(Type, backref='moves') + Pokemon.abilities = relation(Ability, secondary=PokemonAbility.__table__, order_by=PokemonAbility.slot, backref='pokemon') +Pokemon.formes = relation(Pokemon, primaryjoin=Pokemon.id==Pokemon.forme_base_pokemon_id, + backref=backref('forme_base_pokemon', + remote_side=[Pokemon.id])) Pokemon.dex_numbers = relation(PokemonDexNumber, backref='pokemon') Pokemon.egg_groups = relation(EggGroup, secondary=PokemonEggGroup.__table__, order_by=PokemonEggGroup.egg_group_id, @@ -205,6 +395,7 @@ Pokemon.evolution_children = relation(Pokemon, primaryjoin=Pokemon.id==Pokemon.e remote_side=[Pokemon.id])) Pokemon.flavor_text = relation(PokemonFlavorText, backref='pokemon') Pokemon.foreign_names = relation(PokemonName, backref='pokemon') +Pokemon.items = relation(PokemonItem) Pokemon.generation = relation(Generation, backref='pokemon') Pokemon.shape = relation(PokemonShape, backref='pokemon') Pokemon.stats = relation(PokemonStat, backref='pokemon') @@ -214,6 +405,18 @@ PokemonDexNumber.generation = relation(Generation) PokemonFlavorText.version = relation(Version) +PokemonItem.item = relation(Item, backref='pokemon') +PokemonItem.version = relation(Version) + +PokemonFormGroup.pokemon = relation(Pokemon, backref=backref('form_group', + uselist=False)) +PokemonFormSprite.pokemon = relation(Pokemon, backref='form_sprites') + +PokemonMove.pokemon = relation(Pokemon, backref='pokemon_moves') +PokemonMove.version_group = relation(VersionGroup) +PokemonMove.move = relation(Move, backref='pokemon_moves') +PokemonMove.method = relation(PokemonMoveMethod) + PokemonName.language = relation(Language) PokemonStat.stat = relation(Stat) @@ -226,3 +429,7 @@ Type.target_efficacies = relation(TypeEfficacy, primaryjoin=Type.id ==TypeEfficacy.target_type_id, backref='target_type') + +Version.generation = relation(Generation, secondary=VersionGroup.__table__, + backref='versions') +Version.version_group = relation(VersionGroup, backref='versions')