meta-edc 0.3.39__py3-none-any.whl → 1.4.0__py3-none-any.whl

meta_prn/migrations/0068_alter_dmreferral_referral_note_and_more.py

@@ -0,0 +1,235 @@
+# Generated by Django 5.2.6 on 2025-09-29 21:51
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("meta_prn", "0067_alter_offschedule_managers_and_more"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="dmreferral",
+            name="referral_note",
+            field=models.TextField(
+                default="",
+                verbose_name="Please provide a brief history of the diabetes diagnosis that lead to this referral",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="endofstudy",
+            name="clinical_withdrawal_investigator_decision",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If withdrawl was an 'investigator decision', please explain ...",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="endofstudy",
+            name="clinical_withdrawal_reason_other",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If withdrawn for 'other' condition, please explain",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="endofstudy",
+            name="comment",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="Please provide further details if possible",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="endofstudy",
+            name="other_offstudy_reason",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If OTHER, please specify",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="endofstudy",
+            name="toxicity_withdrawal_reason_other",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If 'other toxicity', please specify ...",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaldmreferral",
+            name="referral_note",
+            field=models.TextField(
+                default="",
+                verbose_name="Please provide a brief history of the diabetes diagnosis that lead to this referral",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalendofstudy",
+            name="clinical_withdrawal_investigator_decision",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If withdrawl was an 'investigator decision', please explain ...",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalendofstudy",
+            name="clinical_withdrawal_reason_other",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If withdrawn for 'other' condition, please explain",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalendofstudy",
+            name="comment",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="Please provide further details if possible",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalendofstudy",
+            name="other_offstudy_reason",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If OTHER, please specify",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalendofstudy",
+            name="toxicity_withdrawal_reason_other",
+            field=models.TextField(
+                blank=True,
+                default="",
+                max_length=500,
+                verbose_name="If 'other toxicity', please specify ...",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicallosstofollowup",
+            name="comment",
+            field=models.TextField(
+                default="",
+                verbose_name="Please give details of the circumstances that have led to this decision.",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicallosstofollowup",
+            name="home_visit_detail",
+            field=models.TextField(
+                default="",
+                verbose_name="If YES, provide any further details of the home visit",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaloffstudymedication",
+            name="comment",
+            field=models.TextField(
+                blank=True, default="", verbose_name="Any additional comments"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicaloffstudymedication",
+            name="reason_other",
+            field=models.TextField(
+                blank=True, default="", verbose_name="If other, please specify ..."
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalpregnancynotification",
+            name="unconfirmed_details",
+            field=models.TextField(
+                blank=True, default="", verbose_name="If no, please provide details"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="historicalprotocolincident",
+            name="action_required_old",
+            field=models.CharField(
+                choices=[
+                    ("remain_on_study", "Participant to remain on trial"),
+                    ("to_be_withdrawn", "Participant to be withdrawn from trial"),
+                    (
+                        "remain_on_study_modified",
+                        "Patient remains on study but data analysis will be modified",
+                    ),
+                ],
+                default="",
+                max_length=45,
+            ),
+        ),
+        migrations.AlterField(
+            model_name="losstofollowup",
+            name="comment",
+            field=models.TextField(
+                default="",
+                verbose_name="Please give details of the circumstances that have led to this decision.",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="losstofollowup",
+            name="home_visit_detail",
+            field=models.TextField(
+                default="",
+                verbose_name="If YES, provide any further details of the home visit",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="offstudymedication",
+            name="comment",
+            field=models.TextField(
+                blank=True, default="", verbose_name="Any additional comments"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="offstudymedication",
+            name="reason_other",
+            field=models.TextField(
+                blank=True, default="", verbose_name="If other, please specify ..."
+            ),
+        ),
+        migrations.AlterField(
+            model_name="pregnancynotification",
+            name="unconfirmed_details",
+            field=models.TextField(
+                blank=True, default="", verbose_name="If no, please provide details"
+            ),
+        ),
+        migrations.AlterField(
+            model_name="protocolincident",
+            name="action_required_old",
+            field=models.CharField(
+                choices=[
+                    ("remain_on_study", "Participant to remain on trial"),
+                    ("to_be_withdrawn", "Participant to be withdrawn from trial"),
+                    (
+                        "remain_on_study_modified",
+                        "Patient remains on study but data analysis will be modified",
+                    ),
+                ],
+                default="",
+                max_length=45,
+            ),
+        ),
+    ]

meta_prn/migrations/0069_alter_historicaloffstudymedication_singleton_field_and_more.py

@@ -0,0 +1,37 @@
+# Generated by Django 5.2.7 on 2025-10-01 14:33
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("meta_prn", "0068_alter_dmreferral_referral_note_and_more"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="historicaloffstudymedication",
+            name="singleton_field",
+            field=models.CharField(
+                db_index=True,
+                default="",
+                editable=False,
+                help_text="auto updated for unique constraint",
+                max_length=50,
+                verbose_name="subject identifier",
+            ),
+        ),
+        migrations.AlterField(
+            model_name="offstudymedication",
+            name="singleton_field",
+            field=models.CharField(
+                default="",
+                editable=False,
+                help_text="auto updated for unique constraint",
+                max_length=50,
+                unique=True,
+                verbose_name="subject identifier",
+            ),
+        ),
+    ]

meta_prn/models/__init__.py

@@ -21,3 +21,23 @@ from .signals import (
     update_urine_pregnancy_on_pregnancy_notification_on_post_save,
 )
 from .subject_transfer import SubjectTransfer
+
+__all__ = [
+    "DmReferral",
+    "EndOfStudy",
+    "LossToFollowup",
+    "OffSchedule",
+    "OffScheduleDmReferral",
+    "OffSchedulePostnatal",
+    "OffSchedulePregnancy",
+    "OffStudyMedication",
+    "OnSchedule",
+    "OnScheduleDmReferral",
+    "OnSchedulePostnatal",
+    "OnSchedulePregnancy",
+    "PregnancyNotification",
+    "ProtocolIncident",
+    "SubjectTransfer",
+    "update_schedule_on_pregnancy_notification_post_save",
+    "update_urine_pregnancy_on_pregnancy_notification_on_post_save",
+]

meta_prn/models/dm_referral.py

@@ -1,3 +1,4 @@
+from clinicedc_constants import NULL_STRING
 from django.db import models
 from edc_action_item.models import ActionModelMixin
 from edc_identifier.model_mixins import UniqueSubjectIdentifierFieldMixin
@@ -14,7 +15,6 @@ class DmReferral(
     UniqueSubjectIdentifierFieldMixin,
     BaseUuidModel,
 ):
-
     action_name = DM_REFFERAL_ACTION
 
     report_datetime = models.DateTimeField(
@@ -30,7 +30,7 @@ class DmReferral(
             "Please provide a brief history of the "
             "diabetes diagnosis that lead to this referral"
         ),
-        null=True,
+        default=NULL_STRING,
         blank=False,
     )
 

meta_prn/models/end_of_study.py

@@ -1,16 +1,17 @@
-from django.db import models
-from edc_action_item.models import ActionModelMixin
-from edc_constants.choices import YES_NO_NA
-from edc_constants.constants import (
+from clinicedc_constants import (
     DEAD,
     DELIVERY,
     DIABETES,
+    LTFU,
     NOT_APPLICABLE,
+    NULL_STRING,
     OTHER,
     PREGNANCY,
     TOXICITY,
 )
-from edc_ltfu.constants import LOST_TO_FOLLOWUP
+from django.db import models
+from edc_action_item.models import ActionModelMixin
+from edc_constants.choices import YES_NO_NA
 from edc_model.models import BaseUuidModel
 from edc_model.validators import date_not_future
 from edc_offstudy.constants import (
@@ -26,18 +27,18 @@ from edc_transfer.constants import TRANSFERRED
 from meta_lists.models import OffstudyReasons
 
 from ..choices import CLINICAL_WITHDRAWAL_REASONS, TOXICITY_WITHDRAWAL_REASONS
+from ..constants import CLINICAL_WITHDRAWAL, COMPLETED_FOLLOWUP_48
 
 # TODO: confirm all appointments are either new, incomplete or done
 # TODO: take off study meds but coninue followup (WITHDRAWAL)
 # TODO: follow on new schedule, if permanently off drug (Single 36m visit)
-from ..constants import CLINICAL_WITHDRAWAL
+
+# TODO: add label for "End of followup as per protocol FEB2026"
 
 
 class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidModel):
     action_name = END_OF_STUDY_ACTION
 
-    tracking_identifier_prefix = "ST"
-
     last_seen_date = models.DateField(
         verbose_name="Date patient was last seen",
         validators=[date_not_future],
@@ -52,24 +53,28 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
         null=True,
         limit_choices_to={
             "name__in": [
-                CLINICAL_WITHDRAWAL,
                 COMPLETED_FOLLOWUP,
-                DEAD,
-                DELIVERY,
+                COMPLETED_FOLLOWUP_48,
                 DIABETES,
-                LATE_EXCLUSION,
-                LOST_TO_FOLLOWUP,
-                OTHER,
+                DELIVERY,
                 PREGNANCY,
+                CLINICAL_WITHDRAWAL,
+                DEAD,
+                LTFU,
                 TOXICITY,
                 TRANSFERRED,
                 WITHDRAWAL,
+                LATE_EXCLUSION,
+                OTHER,
             ]
         },
     )
 
     other_offstudy_reason = models.TextField(
-        verbose_name="If OTHER, please specify", max_length=500, blank=True, null=True
+        verbose_name="If OTHER, please specify",
+        max_length=500,
+        blank=True,
+        default=NULL_STRING,
     )
 
     # TODO: 6m off drug and duration ?? See SOP
@@ -95,8 +100,9 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
         blank=True,
         null=True,
         help_text=(
-            "A UPT CRF must be on file and participant not on the delivery schedule. "
-            "Use UPT date or, if UPT not needed, use report date on last UPT CRF."
+            "A UPT CRF must be on file and participant not on the "
+            "delivery schedule. Use UPT date or, if UPT not needed, "
+            "use report date on last UPT CRF."
         ),
     )
 
@@ -113,8 +119,7 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
 
     clinical_withdrawal_reason = models.CharField(
         verbose_name=(
-            "If the patient was withdrawn on CLINICAL grounds, "
-            "please specify PRIMARY reason"
+            "If the patient was withdrawn on CLINICAL grounds, please specify PRIMARY reason"
         ),
         max_length=25,
         choices=CLINICAL_WITHDRAWAL_REASONS,
@@ -125,14 +130,14 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
         verbose_name="If withdrawn for 'other' condition, please explain",
         max_length=500,
         blank=True,
-        null=True,
+        default=NULL_STRING,
     )
 
     clinical_withdrawal_investigator_decision = models.TextField(
         verbose_name="If withdrawl was an 'investigator decision', please explain ...",
         max_length=500,
         blank=True,
-        null=True,
+        default=NULL_STRING,
     )
 
     toxicity_withdrawal_reason = models.CharField(
@@ -146,7 +151,7 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
         verbose_name="If 'other toxicity', please specify ...",
         max_length=500,
         blank=True,
-        null=True,
+        default=NULL_STRING,
     )
 
     transfer_date = models.DateField(
@@ -168,7 +173,7 @@ class EndOfStudy(ActionModelMixin, SiteModelMixin, OffstudyModelMixin, BaseUuidM
         verbose_name="Please provide further details if possible",
         max_length=500,
         blank=True,
-        null=True,
+        default=NULL_STRING,
     )
 
     class Meta(OffstudyModelMixin.Meta):

meta_prn/models/loss_to_followup.py

@@ -1,8 +1,8 @@
+from clinicedc_constants import NULL_STRING, OTHER
 from django.db import models
 from edc_action_item.models.action_model_mixin import ActionModelMixin
 from edc_constants.choices import YES_NO
-from edc_constants.constants import OTHER
-from edc_identifier.model_mixins import NonUniqueSubjectIdentifierFieldMixin
+from edc_identifier.model_mixins import UniqueSubjectIdentifierFieldMixin
 from edc_ltfu.constants import LTFU_ACTION
 from edc_model.models import BaseUuidModel, OtherCharField
 from edc_sites.model_mixins import SiteModelMixin
@@ -19,13 +19,11 @@ LOSS_CHOICES = (
 class LossToFollowup(
     ActionModelMixin,
     SiteModelMixin,
-    NonUniqueSubjectIdentifierFieldMixin,
+    UniqueSubjectIdentifierFieldMixin,
     BaseUuidModel,
 ):
     action_name = LTFU_ACTION
 
-    tracking_identifier_prefix = "LF"
-
     report_datetime = models.DateTimeField(
         verbose_name="Report Date and Time", default=get_utcnow
     )
@@ -50,7 +48,7 @@ class LossToFollowup(
 
     home_visit_detail = models.TextField(
         verbose_name="If YES, provide any further details of the home visit",
-        null=True,
+        default=NULL_STRING,
         blank=False,
     )
 
@@ -66,13 +64,13 @@ class LossToFollowup(
         verbose_name=(
             "Please give details of the circumstances that have led to this decision."
         ),
-        null=True,
+        default=NULL_STRING,
         blank=False,
     )
 
     class Meta(BaseUuidModel.Meta):
         verbose_name = "Loss to Follow Up"
         verbose_name_plural = "Loss to Follow Up"
-        indexes = [
-            models.Index(fields=["subject_identifier", "action_identifier", "site", "id"])
-        ]
+        indexes = (
+            models.Index(fields=("subject_identifier", "action_identifier", "site", "id")),
+        )

meta_prn/models/off_study_medication.py

@@ -1,8 +1,10 @@
+from clinicedc_constants import NULL_STRING
 from django.db import models
 from edc_action_item.models import ActionModelMixin
-from edc_identifier.model_mixins import NonUniqueSubjectIdentifierFieldMixin
+from edc_identifier.model_mixins import UniqueSubjectIdentifierFieldMixin
 from edc_model.models import BaseUuidModel
 from edc_pharmacy.models import Medication
+from edc_prn.models import SingletonPrnModelMixin
 from edc_sites.model_mixins import SiteModelMixin
 from edc_utils import get_utcnow
 
@@ -13,9 +15,10 @@ from ..constants import OFFSTUDY_MEDICATION_ACTION
 
 
 class OffStudyMedication(
-    NonUniqueSubjectIdentifierFieldMixin,
+    UniqueSubjectIdentifierFieldMixin,
     SiteModelMixin,
     ActionModelMixin,
+    SingletonPrnModelMixin,
     BaseUuidModel,
 ):
     action_name = OFFSTUDY_MEDICATION_ACTION
@@ -44,13 +47,13 @@ class OffStudyMedication(
 
     reason_other = models.TextField(
         verbose_name="If other, please specify ...",
-        null=True,
+        default=NULL_STRING,
         blank=True,
     )
 
     comment = models.TextField(
         verbose_name="Any additional comments",
-        null=True,
+        default=NULL_STRING,
         blank=True,
     )
 

meta_prn/models/offschedule.py

@@ -11,7 +11,7 @@ from ..constants import (
 )
 
 
-class OffSchedule(SiteModelMixin, ActionModelMixin, OffScheduleModelMixin, BaseUuidModel):
+class OffSchedule(SiteModelMixin, OffScheduleModelMixin, ActionModelMixin, BaseUuidModel):
     action_name = OFFSCHEDULE_ACTION
     offschedule_compare_dates_as_datetimes = False
 
@@ -21,7 +21,7 @@ class OffSchedule(SiteModelMixin, ActionModelMixin, OffScheduleModelMixin, BaseU
 
 
 class OffSchedulePregnancy(
-    SiteModelMixin, ActionModelMixin, OffScheduleModelMixin, BaseUuidModel
+    SiteModelMixin, OffScheduleModelMixin, ActionModelMixin, BaseUuidModel
 ):
     action_name = OFFSCHEDULE_PREGNANCY_ACTION
 
@@ -31,7 +31,7 @@ class OffSchedulePregnancy(
 
 
 class OffSchedulePostnatal(
-    SiteModelMixin, ActionModelMixin, OffScheduleModelMixin, BaseUuidModel
+    SiteModelMixin, OffScheduleModelMixin, ActionModelMixin, BaseUuidModel
 ):
     action_name = OFFSCHEDULE_POSTNATAL_ACTION
 
@@ -41,7 +41,7 @@ class OffSchedulePostnatal(
 
 
 class OffScheduleDmReferral(
-    SiteModelMixin, ActionModelMixin, OffScheduleModelMixin, BaseUuidModel
+    SiteModelMixin, OffScheduleModelMixin, ActionModelMixin, BaseUuidModel
 ):
     action_name = OFFSCHEDULE_DM_REFERRAL_ACTION
 

meta_prn/models/pregnancy_notification.py

@@ -1,7 +1,7 @@
+from clinicedc_constants import NULL_STRING, YES
 from django.db import models
 from edc_action_item.models import ActionModelMixin
 from edc_constants.choices import YES_NO, YES_NO_UNSURE
-from edc_constants.constants import YES
 from edc_identifier.model_mixins import NonUniqueSubjectIdentifierFieldMixin
 from edc_model.models import BaseUuidModel
 from edc_sites.model_mixins import SiteModelMixin
@@ -24,8 +24,6 @@ class PregnancyNotification(
 ):
     action_name = PREGNANCY_NOTIFICATION_ACTION
 
-    tracking_identifier_prefix = "PN"
-
     report_datetime = models.DateTimeField(
         verbose_name="Report Date and Time", default=get_utcnow
     )
@@ -46,7 +44,7 @@ class PregnancyNotification(
 
     unconfirmed_details = models.TextField(
         verbose_name="If no, please provide details",
-        null=True,
+        default=NULL_STRING,
         blank=True,
     )
 
@@ -99,4 +97,4 @@ class PregnancyNotification(
     class Meta(BaseUuidModel.Meta):
         verbose_name = "Pregnancy Notification"
         verbose_name_plural = "Pregnancy Notifications"
-        unique_together = ["subject_identifier", "edd"]
+        unique_together = ("subject_identifier", "edd")

meta_prn/models/protocol_incident.py

@@ -1,3 +1,4 @@
+from clinicedc_constants import NULL_STRING
 from django.db import models
 from edc_action_item.models import ActionItem, ActionModelMixin
 from edc_identifier.model_mixins import NonUniqueSubjectIdentifierFieldMixin
@@ -26,10 +27,12 @@ class ProtocolIncident(
         related_name="meta_prn_action_item",
     )
 
-    action_required_old = models.CharField(max_length=45, choices=ACTION_REQUIRED, null=True)
+    action_required_old = models.CharField(
+        max_length=45, choices=ACTION_REQUIRED, default=NULL_STRING
+    )
 
     def natural_key(self):
-        return (self.action_identifier,)  # noqa
+        return (self.action_identifier,)
 
     class Meta(ProtocolIncidentModelMixin.Meta, BaseUuidModel.Meta):
         pass