feat: add new type PokemonStatPast

Author: jemarq04

data/v2/build.py

@@ -2281,6 +2281,17 @@ def csv_record_to_objects(info):
 
     build_generic((PokemonStat,), "pokemon_stats.csv", csv_record_to_objects)
 
+    def csv_record_to_objects(info):
+        yield PokemonStatPast(
+            pokemon_id=int(info[0]),
+            generation_id=int(info[1]),
+            stat_id=int(info[2]),
+            base_stat=int(info[3]),
+            effort=int(info[4]),
+        )
+
+    build_generic((PokemonStatPast,), "pokemon_stats_past.csv", csv_record_to_objects)
+
     def csv_record_to_objects(info):
         yield PokemonType(
             pokemon_id=int(info[0]), type_id=int(info[1]), slot=int(info[2])

data/v2/csv/pokemon_stats_past.csv

@@ -0,0 +1,2 @@
+pokemon_id,generation_id,stat_id,base_stat,effort
+1,1,1,500,100

pokemon_v2/migrations/0025_pokemonstatpast.py

@@ -0,0 +1,66 @@
+# Generated by Django 4.2.27 on 2026-01-24 22:11
+
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        (
+            "pokemon_v2",
+            "0024_alter_ability_generation_alter_abilitychange_ability_and_more",
+        ),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="PokemonStatPast",
+            fields=[
+                (
+                    "id",
+                    models.AutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("base_stat", models.IntegerField()),
+                ("effort", models.IntegerField()),
+                (
+                    "generation",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="%(class)s",
+                        to="pokemon_v2.generation",
+                    ),
+                ),
+                (
+                    "pokemon",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="%(class)s",
+                        to="pokemon_v2.pokemon",
+                    ),
+                ),
+                (
+                    "stat",
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.CASCADE,
+                        related_name="%(class)s",
+                        to="pokemon_v2.stat",
+                    ),
+                ),
+            ],
+            options={
+                "abstract": False,
+            },
+        ),
+    ]

pokemon_v2/models.py

@@ -1816,6 +1816,12 @@ class PokemonStat(HasPokemon, HasStat):
     effort = models.IntegerField()
 
 
+class PokemonStatPast(HasPokemon, HasStat, HasGeneration):
+    base_stat = models.IntegerField()
+
+    effort = models.IntegerField()
+
+
 class PokemonType(HasPokemon, HasType):
     slot = models.IntegerField()
 

pokemon_v2/serializers.py

@@ -4318,6 +4318,15 @@ class Meta:
         fields = ("base_stat", "effort", "stat")
 
 
+class PokemonStatPastSerializer(serializers.ModelSerializer):
+    generation = GenerationSummarySerializer()
+    stat = StatSummarySerializer()
+
+    class Meta:
+        model = PokemonStatPast
+        fields = ("base_stat", "effort", "generation", "stat")
+
+
 #########################
 #  POKEMON SERIALIZERS  #
 #########################
@@ -4340,6 +4349,7 @@ class PokemonDetailSerializer(serializers.ModelSerializer):
     moves = serializers.SerializerMethodField("get_pokemon_moves")
     species = PokemonSpeciesSummarySerializer(source="pokemon_species")
     stats = PokemonStatSerializer(many=True, read_only=True, source="pokemonstat")
+    past_stats = serializers.SerializerMethodField("get_past_pokemon_stats")
     types = serializers.SerializerMethodField("get_pokemon_types")
     past_types = serializers.SerializerMethodField("get_past_pokemon_types")
     forms = PokemonFormSummarySerializer(
@@ -4371,6 +4381,7 @@ class Meta:
             "sprites",
             "cries",
             "stats",
+            "past_stats",
             "types",
             "past_types",
         )
@@ -5083,6 +5094,39 @@ def get_past_pokemon_abilities(self, obj):
 
         return final_data
 
+    def get_past_pokemon_stats(self, obj):
+        pokemon_past_stat_objects = PokemonStatPast.objects.filter(pokemon=obj)
+        pokemon_past_stats = PokemonStatPastSerializer(
+            pokemon_past_stat_objects, many=True, context=self.context
+        ).data
+
+        # post-process to the form we want
+        current_generation = ""
+        past_obj = {}
+        final_data = []
+        for pokemon_past_stat in pokemon_past_stats:
+            generation = pokemon_past_stat["generation"]["name"]
+            if generation != current_generation:
+                current_generation = generation
+                past_obj = {}
+
+                # create past stats object for this generation
+                past_obj["generation"] = pokemon_past_stat["generation"]
+                del pokemon_past_stat["generation"]
+
+                # create stats array
+                past_obj["stats"] = [pokemon_past_stat]
+
+                # add to past stats array
+                final_data.append(past_obj)
+
+            else:
+                # add to existing array for this generation
+                del pokemon_past_stat["generation"]
+                past_obj["stats"].append(pokemon_past_stat)
+
+        return final_data
+
     # {
     #   "slot": 1,
     #   "type": {

pokemon_v2/tests.py

@@ -1656,6 +1656,21 @@ def setup_pokemon_stat_data(cls, pokemon, base_stat=10, effort=10):
 
         return pokemon_stat
 
+    @classmethod
+    def setup_pokemon_past_stat_data(cls, pokemon, generation, base_stat=10, effort=10):
+        stat = cls.setup_stat_data(name="stt for pkmn")
+
+        pokemon_stat_past = PokemonStatPast(
+            pokemon=pokemon,
+            generation=generation,
+            stat=stat,
+            base_stat=base_stat,
+            effort=effort,
+        )
+        pokemon_stat_past.save()
+
+        return pokemon_stat_past
+
     @classmethod
     def setup_pokemon_type_data(cls, pokemon, type=None, slot=1):
         type = type or cls.setup_type_data(name="tp for pkmn")
@@ -4904,6 +4919,9 @@ def test_pokemon_api(self):
             pokemon=pokemon, generation=generation
         )
         pokemon_stat = self.setup_pokemon_stat_data(pokemon=pokemon)
+        pokemon_past_stat = self.setup_pokemon_past_stat_data(
+            pokemon=pokemon, generation=generation
+        )
         pokemon_type = self.setup_pokemon_type_data(pokemon=pokemon)
         pokemon_past_type = self.setup_pokemon_past_type_data(
             pokemon=pokemon, generation=generation
@@ -5029,6 +5047,29 @@ def test_pokemon_api(self):
             response.data["stats"][0]["stat"]["url"],
             "{}{}/stat/{}/".format(TEST_HOST, API_V2, pokemon_stat.stat.pk),
         )
+        # past stat params
+        past_stats_obj = response.data["past_stats"][0]
+        self.assertEqual(
+            past_stats_obj["generation"]["name"],
+            pokemon_past_stat.generation.name,
+        )
+        self.assertEqual(
+            past_stats_obj["generation"]["url"],
+            "{}{}/generation/{}/".format(
+                TEST_HOST, API_V2, pokemon_past_stat.generation.pk
+            ),
+        )
+
+        past_stats_stats_obj = past_stats_obj["stats"][0]
+        self.assertEqual(past_stats_stats_obj["base_stat"], pokemon_past_stat.base_stat)
+        self.assertEqual(past_stats_stats_obj["effort"], pokemon_past_stat.effort)
+        self.assertEqual(
+            past_stats_stats_obj["stat"]["name"], pokemon_past_stat.stat.name
+        )
+        self.assertEqual(
+            past_stats_stats_obj["stat"]["url"],
+            "{}{}/stat/{}/".format(TEST_HOST, API_V2, pokemon_past_stat.stat.pk),
+        )
         # type params
         self.assertEqual(response.data["types"][0]["slot"], pokemon_type.slot)
         self.assertEqual(
@@ -5719,6 +5760,9 @@ def test_case_insensitive_api(self):
             pokemon=pokemon, generation=generation
         )
         pokemon_stat = self.setup_pokemon_stat_data(pokemon=pokemon)
+        pokemon_past_stat = self.setup_pokemon_past_stat_data(
+            pokemon=pokemon, generation=generation
+        )
         pokemon_type = self.setup_pokemon_type_data(pokemon=pokemon)
         pokemon_past_type = self.setup_pokemon_past_type_data(
             pokemon=pokemon, generation=generation