Class ChannelSerializer

apps/channels/serializers.py:371–742

# Channel
#
class ChannelSerializer(serializers.ModelSerializer):
    # Show nested group data, or ID
    # Ensure channel_number is explicitly typed as FloatField and properly validated
    channel_number = serializers.FloatField(
        allow_null=True,
        required=False,
        error_messages={"invalid": "Channel number must be a valid decimal number."},
    )
    channel_group_id = serializers.PrimaryKeyRelatedField(
        queryset=ChannelGroup.objects.all(), source="channel_group", required=False
    )
    epg_data_id = serializers.PrimaryKeyRelatedField(
        queryset=EPGData.objects.all(),
        source="epg_data",
        required=False,
        allow_null=True,
    )

    stream_profile_id = serializers.PrimaryKeyRelatedField(
        queryset=StreamProfile.objects.all(),
        source="stream_profile",
        allow_null=True,
        required=False,
    )

    streams = serializers.PrimaryKeyRelatedField(
        queryset=Stream.objects.all(), many=True, required=False
    )

    logo_id = serializers.PrimaryKeyRelatedField(
        queryset=Logo.objects.all(),
        source="logo",
        allow_null=True,
        required=False,
    )

    auto_created_by_name = serializers.SerializerMethodField()
    override = ChannelOverrideSerializer(
        required=False,
        allow_null=True,
        help_text=(
            "Per-field overrides for an auto-created channel. "
            'Send {"override": {"name": "ESPN"}} to upsert the listed '
            'fields, {"override": {"name": null}} to clear specific fields '
            'while leaving others, or {"override": null} to delete the '
            "override row entirely. Omitting the key leaves any existing "
            "override unchanged. Only valid for auto_created=True channels. "
            "Duplicate channel_number values across channels are permitted; "
            "downstream client behavior on duplicates varies by client."
        ),
    )
    source_stream = serializers.SerializerMethodField()
    # Effective fields coalesce override over channel column. Consumers
    # display these; raw fields remain in the response so the edit form
    # can show them as "Provider: X" subtext.
    effective_name = serializers.SerializerMethodField()
    effective_channel_number = serializers.SerializerMethodField()
    effective_channel_group_id = serializers.SerializerMethodField()