Rename mature to sensitive

api/api/admin/__init__.py

@@ -2,7 +2,7 @@
 
 from api.admin.site import openverse_admin
 from api.models import PENDING, Audio, AudioReport, ContentProvider, Image, ImageReport
-from api.models.media import AbstractDeletedMedia, AbstractMatureMedia
+from api.models.media import AbstractDeletedMedia, AbstractSensitiveMedia
 
 
 admin.site = openverse_admin
@@ -72,7 +72,7 @@ def has_add_permission(self, *args, **kwargs):
 
 
 for klass in [
-    *AbstractMatureMedia.__subclasses__(),
+    *AbstractSensitiveMedia.__subclasses__(),
     *AbstractDeletedMedia.__subclasses__(),
 ]:
     admin.site.register(klass, MediaSubreportAdmin)

api/api/migrations/0056_rename_mature_to_sensitive.py

@@ -0,0 +1,27 @@
+# Generated by Django 4.2.9 on 2024-02-08 18:26
+
+import api.models.media
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('api', '0055_alter_matureaudio_table_alter_matureimage_table'),
+    ]
+
+    operations = [
+        migrations.RenameModel('MatureImage', 'SensitiveImage'),
+        migrations.RenameModel('MatureAudio', 'SensitiveAudio'),
+        migrations.AlterField(
+            model_name='sensitiveaudio',
+            name='media_obj',
+            field=models.OneToOneField(db_column='identifier', db_constraint=False, help_text='The reference to the sensitive audio.', on_delete=django.db.models.deletion.DO_NOTHING, primary_key=True, related_name='sensitive_audio', serialize=False, to='api.audio', to_field='identifier'),
+        ),
+        migrations.AlterField(
+            model_name='sensitiveimage',
+            name='media_obj',
+            field=models.OneToOneField(db_column='identifier', db_constraint=False, help_text='The reference to the sensitive image.', on_delete=django.db.models.deletion.DO_NOTHING, primary_key=True, related_name='sensitive_image', serialize=False, to='api.image', to_field='identifier'),
+        ),
+    ]

api/api/models/__init__.py

@@ -6,9 +6,9 @@
     AudioReport,
     AudioSet,
     DeletedAudio,
-    MatureAudio,
+    SensitiveAudio,
 )
-from api.models.image import DeletedImage, Image, ImageList, ImageReport, MatureImage
+from api.models.image import DeletedImage, Image, ImageList, ImageReport, SensitiveImage
 from api.models.media import (
     DEINDEXED,
     DMCA,

api/api/models/audio.py

@@ -9,10 +9,10 @@
 from api.models.media import (
     AbstractAltFile,
     AbstractDeletedMedia,
-    AbstractMatureMedia,
     AbstractMedia,
     AbstractMediaList,
     AbstractMediaReport,
+    AbstractSensitiveMedia,
 )
 from api.models.mixins import FileMixin, ForeignIdentifierMixin, MediaMixin
 from api.utils.waveform import generate_peaks
@@ -189,8 +189,8 @@ class Audio(AudioFileMixin, AbstractMedia):
     )
 
     @property
-    def mature(self) -> bool:
-        return hasattr(self, "mature_audio")
+    def sensitive(self) -> bool:
+        return hasattr(self, "sensitive_audio")
 
     @property
     def alternative_files(self):
@@ -260,7 +260,7 @@ class Meta:
         verbose_name_plural = "Deleted audio"
 
 
-class MatureAudio(AbstractMatureMedia):
+class SensitiveAudio(AbstractSensitiveMedia):
     """
     Stores all audio tracks that have been flagged as 'mature'.
 
@@ -278,7 +278,7 @@ class MatureAudio(AbstractMatureMedia):
         primary_key=True,
         db_constraint=False,
         db_column="identifier",
-        related_name="mature_audio",
+        related_name="sensitive_audio",
         help_text="The reference to the sensitive audio.",
     )
 
@@ -289,7 +289,7 @@ class Meta:
 
 class AudioReport(AbstractMediaReport):
     media_class = Audio
-    mature_class = MatureAudio
+    sensitive_class = SensitiveAudio
     deleted_class = DeletedAudio
 
     media_obj = models.ForeignKey(

api/api/models/image.py

@@ -6,10 +6,10 @@
 from api.constants.media_types import IMAGE_TYPE
 from api.models.media import (
     AbstractDeletedMedia,
-    AbstractMatureMedia,
     AbstractMedia,
     AbstractMediaList,
     AbstractMediaReport,
+    AbstractSensitiveMedia,
 )
 from api.models.mixins import FileMixin
 
@@ -53,8 +53,8 @@ class Meta(AbstractMedia.Meta):
         db_table = "image"
 
     @property
-    def mature(self) -> bool:
-        return hasattr(self, "mature_image")
+    def sensitive(self) -> bool:
+        return hasattr(self, "sensitive_image")
 
 
 class DeletedImage(AbstractDeletedMedia):
@@ -80,7 +80,7 @@ class DeletedImage(AbstractDeletedMedia):
     )
 
 
-class MatureImage(AbstractMatureMedia):
+class SensitiveImage(AbstractSensitiveMedia):
     """
     Stores all images that have been flagged as 'mature'.
 
@@ -98,7 +98,7 @@ class MatureImage(AbstractMatureMedia):
         primary_key=True,
         db_constraint=False,
         db_column="identifier",
-        related_name="mature_image",
+        related_name="sensitive_image",
         help_text="The reference to the sensitive image.",
     )
 
@@ -108,7 +108,7 @@ class Meta:
 
 class ImageReport(AbstractMediaReport):
     media_class = Image
-    mature_class = MatureImage
+    sensitive_class = SensitiveImage
     deleted_class = DeletedImage
 
     media_obj = models.ForeignKey(

api/api/models/media.py

@@ -133,15 +133,15 @@ class AbstractMediaReport(models.Model):
     """
     Generic model from which to inherit all reported media classes.
 
-    'Reported' here refers to content reports such as mature, copyright-violating or
-    deleted content. Subclasses must populate ``media_class``, ``mature_class`` and
+    'Reported' here refers to content reports such as sensitive, copyright-violating or
+    deleted content. Subclasses must populate ``media_class``, ``sensitive_class`` and
     ``deleted_class`` fields.
     """
 
     media_class: type[models.Model] = None
     """the model class associated with this media type e.g. ``Image`` or ``Audio``"""
-    mature_class: type[models.Model] = None
-    """the class storing mature media e.g. ``MatureImage`` or ``MatureAudio``"""
+    sensitive_class: type[models.Model] = None
+    """the class storing sensitive media e.g. ``SensitiveImage`` or ``SensitiveAudio``"""
     deleted_class: type[models.Model] = None
     """the class storing deleted media e.g. ``DeletedImage`` or ``DeletedAudio``"""
 
@@ -213,18 +213,18 @@ def save(self, *args, **kwargs):
         Extend the built-in ``save()`` functionality of Django with Elasticsearch
         integration to update records and refresh indices.
 
-        Media marked as mature or deleted also leads to instantiation of their
-        corresponding mature or deleted classes.
+        Media marked as sensitive or deleted also leads to instantiation of their
+        corresponding sensitive or deleted classes.
         """
 
         self.clean()
 
         super().save(*args, **kwargs)
 
         if self.status == MATURE_FILTERED:
-            # Create an instance of the mature class for this media. This will
+            # Create an instance of the sensitive class for this media. This will
             # automatically set the ``mature`` field in the ES document.
-            self.mature_class.objects.create(media_obj=self.media_obj)
+            self.sensitive_class.objects.create(media_obj=self.media_obj)
         elif self.status == DEINDEXED:
             # Create an instance of the deleted class for this media, so that we don't
             # reindex it later. This will automatically delete the ES document and the
@@ -290,7 +290,7 @@ class AbstractDeletedMedia(PerformIndexUpdateMixin, OpenLedgerModel):
     Generic model from which to inherit all deleted media classes.
 
     'Deleted' here refers to media which has been deleted at the source or intentionally
-    de-indexed by us. Unlike mature reports, this action is irreversible. Subclasses
+    de-indexed by us. Unlike sensitive reports, this action is irreversible. Subclasses
     must populate ``media_class`` and ``es_index`` fields.
     """
 
@@ -329,9 +329,9 @@ def save(self, *args, **kwargs):
         self.media_obj.delete()  # remove the actual model instance
 
 
-class AbstractMatureMedia(PerformIndexUpdateMixin, models.Model):
+class AbstractSensitiveMedia(PerformIndexUpdateMixin, models.Model):
     """
-    Generic model from which to inherit all mature media classes.
+    Generic model from which to inherit all sensitive media classes.
 
     Subclasses must populate ``media_class`` and ``es_index`` fields.
     """
@@ -350,7 +350,7 @@ class AbstractMatureMedia(PerformIndexUpdateMixin, models.Model):
         primary_key=True,
         db_constraint=False,
         db_column="identifier",
-        related_name="mature_abstract_media",
+        related_name="sensitive_abstract_media",
         help_text="The reference to the sensitive media.",
     )
     """

api/api/views/audio_views.py

@@ -50,7 +50,7 @@ class AudioViewSet(MediaViewSet):
     collection_serializer_class = AudioCollectionRequestSerializer
 
     def get_queryset(self):
-        return super().get_queryset().select_related("mature_audio", "audioset")
+        return super().get_queryset().select_related("sensitive_audio", "audioset")
 
     # Extra actions
     @creator_collection

api/api/views/image_views.py

@@ -63,7 +63,7 @@ class ImageViewSet(MediaViewSet):
     }
 
     def get_queryset(self):
-        return super().get_queryset().select_related("mature_image")
+        return super().get_queryset().select_related("sensitive_image")
 
     # Extra actions
     @creator_collection

api/test/factory/models/__init__.py

@@ -2,12 +2,12 @@
     AudioAddOnFactory,
     AudioFactory,
     AudioReportFactory,
-    MatureAudioFactory,
+    SensitiveAudioFactory,
 )
 from test.factory.models.image import (
     ImageFactory,
     ImageReportFactory,
-    MatureImageFactory,
+    SensitiveImageFactory,
 )
 from test.factory.models.oauth2 import (
     AccessTokenFactory,

api/test/factory/models/audio.py

@@ -1,20 +1,20 @@
 import factory
 from factory.django import DjangoModelFactory
 
-from api.models.audio import Audio, AudioAddOn, AudioReport, MatureAudio
+from api.models.audio import Audio, AudioAddOn, AudioReport, SensitiveAudio
 from test.factory.faker import Faker
 from test.factory.models.media import IdentifierFactory, MediaFactory
 
 
-class MatureAudioFactory(DjangoModelFactory):
+class SensitiveAudioFactory(DjangoModelFactory):
     class Meta:
-        model = MatureAudio
+        model = SensitiveAudio
 
     media_obj = factory.SubFactory("test.factory.models.audio.AudioFactory")
 
 
 class AudioFactory(MediaFactory):
-    _mature_factory = MatureAudioFactory
+    _sensitive_factory = SensitiveAudioFactory
 
     class Meta:
         model = Audio

api/test/factory/models/image.py

@@ -1,19 +1,19 @@
 import factory
 from factory.django import DjangoModelFactory
 
-from api.models.image import Image, ImageReport, MatureImage
+from api.models.image import Image, ImageReport, SensitiveImage
 from test.factory.models.media import MediaFactory, MediaReportFactory
 
 
-class MatureImageFactory(DjangoModelFactory):
+class SensitiveImageFactory(DjangoModelFactory):
     class Meta:
-        model = MatureImage
+        model = SensitiveImage
 
     media_obj = factory.SubFactory("test.factory.models.image.ImageFactory")
 
 
 class ImageFactory(MediaFactory):
-    _mature_factory = MatureImageFactory
+    _sensitive_factory = SensitiveImageFactory
 
     class Meta:
         model = Image

api/test/factory/models/media.py

@@ -37,8 +37,8 @@ class MediaFactory(DjangoModelFactory):
     )
 
     # Sub-factories must set this to their corresponding
-    # ``AbstractMatureMedia`` subclass
-    _mature_factory = None
+    # ``AbstractSensitiveMedia`` subclass
+    _sensitive_factory = None
 
     _highest_pre_existing_pk = None
 
@@ -126,7 +126,7 @@ def create(cls, *args, **kwargs) -> AbstractMedia | tuple[AbstractMedia, Hit]:
             hit = None
 
         if mature_reported:
-            cls._mature_factory.create(media_obj=model)
+            cls._sensitive_factory.create(media_obj=model)
 
         if pook_active:
             # Reactivate pook if it was active

api/test/unit/conftest.py

@@ -12,10 +12,10 @@
     DeletedAudio,
     DeletedImage,
     Image,
-    MatureAudio,
-    MatureImage,
+    SensitiveAudio,
+    SensitiveImage,
 )
-from api.models.media import AbstractDeletedMedia, AbstractMatureMedia, AbstractMedia
+from api.models.media import AbstractDeletedMedia, AbstractMedia, AbstractSensitiveMedia
 from api.serializers.audio_serializers import (
     AudioReportRequestSerializer,
     AudioSearchRequestSerializer,
@@ -67,8 +67,8 @@ class MediaTypeConfig:
     filtered_index: str
     model_factory: MediaFactory
     model_class: AbstractMedia
-    mature_factory: MediaFactory
-    mature_class: AbstractMatureMedia
+    sensitive_factory: MediaFactory
+    sensitive_class: AbstractSensitiveMedia
     search_request_serializer: MediaSearchRequestSerializer
     model_serializer: MediaSerializer
     report_serializer: MediaReportRequestSerializer
@@ -88,12 +88,12 @@ def indexes(self):
         filtered_index="image-filtered",
         model_factory=model_factories.ImageFactory,
         model_class=Image,
-        mature_factory=model_factories.MatureImageFactory,
+        sensitive_factory=model_factories.SensitiveImageFactory,
         search_request_serializer=ImageSearchRequestSerializer,
         model_serializer=ImageSerializer,
         report_serializer=ImageReportRequestSerializer,
         report_factory=model_factories.ImageReportFactory,
-        mature_class=MatureImage,
+        sensitive_class=SensitiveImage,
         deleted_class=DeletedImage,
     ),
     "audio": MediaTypeConfig(
@@ -103,12 +103,12 @@ def indexes(self):
         filtered_index="audio-filtered",
         model_factory=model_factories.AudioFactory,
         model_class=Audio,
-        mature_factory=model_factories.MatureAudioFactory,
+        sensitive_factory=model_factories.SensitiveAudioFactory,
         search_request_serializer=AudioSearchRequestSerializer,
         model_serializer=AudioSerializer,
         report_serializer=AudioReportRequestSerializer,
         report_factory=model_factories.AudioReportFactory,
-        mature_class=MatureAudio,
+        sensitive_class=SensitiveAudio,
         deleted_class=DeletedAudio,
     ),
 }