contract_serializers

ContractContactSerializer

Bases: CommonModelSerializer

Model serializer for ContractContact

Source code in src/apps/core/serializers/contract_serializers.py

class ContractContactSerializer(CommonModelSerializer):
    """Model serializer for ContractContact"""

    email = serializers.EmailField()

    class Meta:
        list_serializer_class = CommonListSerializer
        model = ContractContact
        fields = ("name", "email", "phone")

ContractServiceSerializer

Bases: CommonModelSerializer

Model serializer for ContractService

Source code in src/apps/core/serializers/contract_serializers.py

class ContractServiceSerializer(CommonModelSerializer):
    """Model serializer for ContractService"""

    class Meta:
        list_serializer_class = CommonListSerializer
        model = ContractService
        fields = ("identifier", "name")

ContractOrganizationSerializer

Bases: CommonModelSerializer

Contract organization serializer. Should be used with source="*".

Source code in src/apps/core/serializers/contract_serializers.py

class ContractOrganizationSerializer(CommonModelSerializer):
    """Contract organization serializer. Should be used with source="*"."""

    class Meta:
        model = Contract
        fields = ("name", "organization_identifier")
        extra_kwargs = {"name": {"source": "organization_name"}}

ContractValiditySerializer

Bases: CommonModelSerializer

Contract validity serializer. Should be used with source="*".

Source code in src/apps/core/serializers/contract_serializers.py

class ContractValiditySerializer(CommonModelSerializer):
    """Contract validity serializer. Should be used with source="*"."""

    class Meta:
        model = Contract
        fields = ("start_date", "end_date")
        extra_kwargs = {
            "start_date": {"source": "validity_start_date"},
            "end_date": {"source": "validity_end_date"},
        }

ContractModelSerializer

Bases: CommonNestedModelSerializer

Model serializer for Contract

Source code in src/apps/core/serializers/contract_serializers.py

class ContractModelSerializer(CommonNestedModelSerializer):
    """Model serializer for Contract"""

    # One-to-one objects included in the contract model
    organization = ContractOrganizationSerializer(source="*")
    validity = ContractValiditySerializer(source="*")

    # To-many relations
    contact = ContractContactSerializer(many=True, min_length=1)
    related_service = ContractServiceSerializer(many=True, min_length=1)

    class Meta:
        model = Contract
        fields = (
            "id",
            "contract_identifier",
            "title",
            "description",
            "quota",
            "created",
            "modified",
            "organization",
            "validity",
            "contact",
            "related_service",
            "removed",
        )
        extra_kwargs = {"removed": {"read_only": True}}

LegacyContractJSONSerializer

Bases: ContractModelSerializer

Serializer for legacy contract_json.

Used as part of LegacyContractSerializer.

Source code in src/apps/core/serializers/contract_serializers.py

class LegacyContractJSONSerializer(ContractModelSerializer):
    """Serializer for legacy contract_json.

    Used as part of LegacyContractSerializer.
    """

    title = serializers.CharField()
    description = serializers.CharField(required=False)
    identifier = serializers.CharField(source="contract_identifier")

    def to_internal_value(self, data):
        # From legacy to V3 dict
        data = super().to_internal_value(data)
        data["title"] = {"und": data["title"]}
        if description := data.get("description"):
            data["description"] = {"und": description}
        return data

    def to_representation(self, instance):
        # From V3 instance to legacy
        rep = super().to_representation(instance)
        rep["title"] = single_translation(instance.title)
        if instance.description:
            rep["description"] = single_translation(instance.description)
        return rep

    def save(self, **kwargs):
        # Contract identifier should be unique for non-removed Contracts
        data = self._validated_data
        if not data["removed"]:
            validator = validators.UniqueValidator(queryset=Contract.available_objects.all())
            try:
                validator(
                    value=data["contract_identifier"],
                    serializer_field=self.fields["identifier"],
                )
            except serializers.ValidationError as err:
                raise serializers.ValidationError({"contact_json": {"identifier": err.detail}})
        return super().save(**kwargs)

    class Meta:
        model = Contract
        fields = (
            *(
                f
                for f in ContractModelSerializer.Meta.fields
                if f not in {"id", "contract_identifier"}
            ),
            "identifier",
        )

LegacyContractSerializer

Bases: ContractModelSerializer

Serializer for legacy contract to V3 conversion.

Deserializers legacy contract into V3 contract. Because most legacy data is in contact_json, this is essentially a wrapper for LegacyContractJSONSerializer.

Source code in src/apps/core/serializers/contract_serializers.py

class LegacyContractSerializer(ContractModelSerializer):
    """Serializer for legacy contract to V3 conversion.

    Deserializers legacy contract into V3 contract. Because
    most legacy data is in contact_json, this is essentially
    a wrapper for LegacyContractJSONSerializer.
    """

    id = serializers.IntegerField(source="legacy_id")
    date_created = serializers.DateTimeField(source="record_created")
    date_modified = serializers.DateTimeField(source="record_modified")
    date_removed = serializers.DateTimeField(required=False, allow_null=True)
    removed = serializers.BooleanField(default=False)
    service_created = NoopField()
    service_modified = NoopField()
    user_created = NoopField()
    user_modified = NoopField()

    # Use source="*" so the nested serializer gets the entire Contract object
    # and operates on the same internal value as this serializer.
    contract_json = LegacyContractJSONSerializer(source="*")

    class Meta:
        model = Contract
        fields = [
            "id",
            "date_created",
            "date_modified",
            "service_created",
            "service_modified",
            "user_created",
            "user_modified",
            "contract_json",
            "date_removed",
            "removed",
        ]

    def to_internal_value(self, data):
        data = super().to_internal_value(data)

        # Combine date_removed and removed into one value
        date_removed = data.pop("date_removed", None)
        if data.get("removed"):
            data["removed"] = date_removed
        else:
            data["removed"] = None

        return data

    @property
    def _readable_fields(self):
        for field in super()._readable_fields:
            # date_removed is handled manually in to_representation
            if field.field_name != "date_removed":
                yield field

    def to_representation(self, instance: Contract):
        rep = super().to_representation(instance)
        rep["date_removed"] = instance.removed
        return rep

    def save(self):
        data = self._validated_data

        # Use LegacyContractJSONSerializer for saving to get nested fields saved correctly
        serializer = self.fields["contract_json"]
        serializer._validated_data = data
        serializer._errors = []
        serializer.instance = self.instance
        self.instance = serializer.save()
        return self.instance