SpeciesTrait update, and srd-2024 Species (open5e#805)

* added srd-2024 species

* SpeciesTrait key is now a string - updated data

* updated SpeciesTrait model to include nullable 'type' and 'order' fields

* added srd-2024 dragonborn data

* added srd-2024 dwarf SpeciesTraits

* added srd-2024 elf SpeciesTraits

* added srd-2024 gnome SpeciesBenefits

* updated SpeciesTrait sort order

* added srd-2024 goliath SpeciesTraits

* added srd-2024 halfling SpeciesBenefits

* added srd-2024 human SpeciesTraits

* added srd-2024 orc SpeciesTraits

* added srd-2024 tiefling SpeciesTraits

* updated species test data to reflect new shape of API response

Author: calumbell

api_v2/migrations/0062_remove_speciestrait_id_speciestrait_key.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.1 on 2025-10-01 12:12
+
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api_v2', '0061_characterclass_desc_alter_abilitydescription_desc_and_more'),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name='speciestrait',
+            name='id',
+        ),
+        migrations.AddField(
+            model_name='speciestrait',
+            name='key',
+            field=models.CharField(default=django.utils.timezone.now, help_text='Unique key for the Document.', max_length=100, primary_key=True, serialize=False),
+            preserve_default=False,
+        ),
+    ]

api_v2/migrations/0063_speciestrait_order_alter_speciestrait_type.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.2.1 on 2025-10-02 09:25
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api_v2', '0062_remove_speciestrait_id_speciestrait_key'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='speciestrait',
+            name='order',
+            field=models.SmallIntegerField(blank=True, help_text='The position in the list of features that a feature appears in its source statblock', null=True),
+        ),
+        migrations.AlterField(
+            model_name='speciestrait',
+            name='type',
+            field=models.CharField(blank=True, choices=[('ABILITY_MODS', 'ABILITY_MODS'), ('SIZE', 'SIZE'), ('SPEED', 'SPEED')], max_length=16, null=True),
+        ),
+    ]

api_v2/migrations/0064_alter_speciestrait_options.py

@@ -0,0 +1,17 @@
+# Generated by Django 5.2.1 on 2025-10-02 10:28
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api_v2', '0063_speciestrait_order_alter_speciestrait_type'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='speciestrait',
+            options={'ordering': ['parent', 'order']},
+        ),
+    ]

api_v2/models/species.py

@@ -1,8 +1,7 @@
 """The model for a species, sub-species, and it's traits."""
 
 from django.db import models
-from .abstracts import HasName, HasDescription, HasPrerequisite
-from .abstracts import Modification
+from .abstracts import HasName, HasDescription, HasPrerequisite, Modification, key_field
 from .document import FromDocument
 from drf_spectacular.utils import extend_schema_field
 from drf_spectacular.types import OpenApiTypes
@@ -12,9 +11,30 @@ class SpeciesTrait(Modification):
 
     It inherits from modification, which is an abstract concept.
     """
-
+    key = key_field()
     parent = models.ForeignKey('Species', on_delete=models.CASCADE)
 
+    SPECIES_FEATURE_TYPES = [
+        ('ABILITY_MODS', 'ABILITY_MODS'),
+        ('SIZE', 'SIZE'),
+        ('SPEED', 'SPEED'),
+    ]
+
+    type = models.CharField(
+        blank=True,
+        null=True,
+        max_length=16,
+        choices=SPECIES_FEATURE_TYPES,
+    )
+
+    order = models.SmallIntegerField(
+        blank=True,
+        null=True,
+        help_text='The position in the list of features that a feature appears in its source statblock'
+    )
+
+    class Meta:
+        ordering = ['parent', 'order']
 
 class Species(HasName, HasDescription, FromDocument):
     """

api_v2/serializers/species.py

@@ -11,7 +11,7 @@ class SpeciesTraitSerializer(GameContentSerializer):
 
     class Meta:
         model = models.SpeciesTrait
-        fields = ['name', 'desc']
+        fields = ['name', 'desc', 'type', 'order']
 
 
 class SpeciesSerializer(GameContentSerializer):

api_v2/tests/responses/TestObjects.test_species_example.approved.json

@@ -23,39 +23,57 @@
     "traits": [
         {
             "desc": "Your Dexterity score increases by 2.",
-            "name": "Ability Score Increase"
+            "name": "Ability Score Increase",
+            "order": null,
+            "type": null
         },
         {
             "desc": "Your base walking speed is 25 feet.",
-            "name": "Speed"
+            "name": "Speed",
+            "order": null,
+            "type": null
         },
         {
             "desc": "A halfling reaches adulthood at the age of 20 and generally lives into the middle of his or her second century.",
-            "name": "Age"
+            "name": "Age",
+            "order": null,
+            "type": null
         },
         {
             "desc": "Most halflings are lawful good. As a rule, they are good-hearted and kind, hate to see others in pain, and have no tolerance for oppression. They are also very orderly and traditional, leaning heavily on the support of their community and the comfort of their old ways.",
-            "name": "Alignment"
+            "name": "Alignment",
+            "order": null,
+            "type": null
         },
         {
             "desc": "Halflings average about 3 feet tall and weigh about 40 pounds. Your size is Small.",
-            "name": "Size"
+            "name": "Size",
+            "order": null,
+            "type": null
         },
         {
             "desc": "You can speak, read, and write Common and Halfling. The Halfling language isn't secret, but halflings are loath to share it with others. They write very little, so they don't have a rich body of literature. Their oral tradition, however, is very strong. Almost all halflings speak Common to converse with the people in whose lands they dwell or through which they are traveling.",
-            "name": "Languages"
+            "name": "Languages",
+            "order": null,
+            "type": null
         },
         {
             "desc": "When you roll a 1 on the d20 for an attack roll, ability check, or saving throw, you can reroll the die and must use the new roll.",
-            "name": "Lucky"
+            "name": "Lucky",
+            "order": null,
+            "type": null
         },
         {
             "desc": "You have advantage on saving throws against being frightened.",
-            "name": "Brave"
+            "name": "Brave",
+            "order": null,
+            "type": null
         },
         {
             "desc": "You can move through the space of any creature that is of a size larger than yours.",
-            "name": "Halfling Nimbleness"
+            "name": "Halfling Nimbleness",
+            "order": null,
+            "type": null
         }
     ],
     "url": "http://localhost:8000/v2/species/srd_halfling/"