pulp.app.serializers¶
All serializers documented here should be imported directly from the pulp.app.serializers
namespace.
pulpcore.app.serializers
¶
pulp.app.serializers.base¶
pulpcore.app.serializers.base
¶
HrefPrnFieldMixin
¶
A mixin to configure related fields to generate relative hrefs and accept PRNs.
IdentityField
¶
Bases: HrefPrnFieldMixin
, HyperlinkedIdentityField
IdentityField for use in the pulp_href field of non-Master/Detail Serializers.
When using this field on a serializer, it will serialize the related resource as a relative URL.
RelatedField
¶
Bases: HrefPrnFieldMixin
, HyperlinkedRelatedField
RelatedField when relating to non-Master/Detail models
When using this field on a serializer, it will serialize the related resource as a relative URL.
PRNField(**kwargs)
¶
Bases: StringRelatedField
A special IdentityField that shows any object's PRN.
RelatedResourceField
¶
Bases: RelatedField
RelatedResourceField when relating a Resource object models.
This field should be used to relate a list of non-homogeneous resources. e.g.: CreatedResource and ExportedResource models that store relationships to arbitrary resources.
Specific implementation requires the model to be defined in the Meta:.
DetailIdentityField(view_name=None, view_name_pattern=None, **kwargs)
¶
Bases: _DetailFieldMixin
, HyperlinkedIdentityField
IdentityField for use in the pulp_href field of Master/Detail Serializers
When using this field on a Serializer, it will automatically cast objects to their Detail type base on the Serializer's Model before generating URLs for them.
Subclasses must indicate the Master model they represent by declaring a queryset
in their class body, usually
DetailRelatedField(view_name=None, view_name_pattern=None, **kwargs)
¶
Bases: _DetailFieldMixin
, HyperlinkedRelatedField
RelatedField for use when relating to Master/Detail models
When using this field on a Serializer, relate it to the Master model in a Master/Detail relationship, and it will automatically cast objects to their Detail type before generating URLs for them.
Subclasses must indicate the Master model they represent by declaring a queryset
in their class body, usually
use_pk_only_optimization()
¶
If the lookup field is pk
, DRF substitutes a PKOnlyObject as an optimization. This
optimization breaks with Detail fields like this one which need access to their Meta
class to get the relevant view_name
.
NestedIdentityField
¶
Bases: HrefPrnFieldMixin
, NestedHyperlinkedIdentityField
NestedIdentityField for use with nested resources.
When using this field in a serializer, it serializes the resource as a relative URL.
NestedRelatedField
¶
Bases: HrefPrnFieldMixin
, NestedHyperlinkedRelatedField
NestedRelatedField for use when relating to nested resources.
When using this field in a serializer, it serializes the related resource as a relative URL.
ValidateFieldsMixin
¶
A mixin for validating unknown serializers' fields.
HiddenFieldsMixin
¶
Bases: Serializer
Adds a list field of hidden (write only) fields and whether their values are set
so clients can tell if they are overwriting an existing value.
For example this could be any sensitive information such as a password, name or token.
The list contains dictionaries with keys name
and is_set
.
GetOrCreateSerializerMixin
¶
A mixin that provides a get_or_create with validation in the serializer
DomainUniqueValidator
¶
Bases: UniqueValidator
Special UniqueValidator for Models with pulp_domain relations.
filter_queryset(value, queryset, field_name)
¶
Filter by domain first to limit unique check to that domain.
ModelSerializer
¶
Bases: ValidateFieldsMixin
, QueryFieldsMixin
, HyperlinkedModelSerializer
Base serializer for use with [pulpcore.app.models.Model][]
This ensures that all Serializers provide values for the 'pulp_href` field.
The class provides a default for the ref_name
attribute in the
ModelSerializers's Meta
class. This ensures that the OpenAPI definitions
of plugins are namespaced properly.
AsyncOperationResponseSerializer
¶
Bases: Serializer
Serializer for asynchronous operations.
TaskGroupOperationResponseSerializer
¶
Bases: Serializer
Serializer for asynchronous operations that return a task group.
SetLabelSerializer
¶
Bases: Serializer
Serializer for synchronously setting a label.
UnsetLabelSerializer
¶
Bases: Serializer
Serializer for synchronously setting a label.
validate_unknown_fields(initial_data, defined_fields)
¶
This will raise a ValidationError
if a serializer is passed fields that are unknown.
The csrfmiddlewaretoken
field is silently ignored.
pulp.app.serializers.fields¶
pulpcore.app.serializers.fields
¶
JSONDictField
¶
Bases: JSONField
A JSONField accepting dicts, specifying as type 'object' in the openapi.
JSONListField
¶
Bases: JSONField
A JSONField accepting lists, specifying as type 'array' in the openapi.
SingleContentArtifactField
¶
Bases: RelatedField
A serializer field for the '_artifacts' ManyToManyField on the Content model (single-artifact).
get_attribute(instance)
¶
Returns the field from the instance that should be serialized using this serializer field.
This serializer looks up the list of artifacts and returns only one, if any exist. If more than one exist, it throws and exception because this serializer is being used in an improper context.
Returns:
-
–
A single Artifact model related to the instance of Content.
ContentArtifactChecksumField(*args, **kwargs)
¶
Bases: CharField
A serializer field for the artifact checksum Content model (single-artifact).
get_attribute(instance)
¶
Returns the field from the instance that should be serialized using this serializer field.
This serializer looks up the checksum for single artifact content
Returns:
-
–
A string of the checksum or None.
Raises:
-
[rest_framework.exceptions.ValidationError][]
–When more than one Artifacts exist.
ContentArtifactsField
¶
Bases: DictField
A serializer field for the '_artifacts' ManyToManyField on the Content model.
run_validation(data)
¶
Validates 'data' dict.
Validates that all keys of 'data' are relative paths. Validates that all values of 'data' are URLs for an existing Artifact.
Parameters:
-
data
(dict
) –A dict mapping relative paths inside the Content to the corresponding Artifact URLs.
Returns:
-
–
A dict mapping relative paths inside the Content to the corresponding Artifact instances.
Raises:
-
[rest_framework.exceptions.ValidationError][]
–When one of the Artifacts does not exist or one of the paths is not a relative path or the field is missing.
get_attribute(instance)
¶
Returns the field from the instance that should be serialized using this serializer field.
This serializer field serializes a ManyToManyField that is actually stored as a ContentArtifact model. Instead of returning the field, this method returns all the ContentArtifact models related to this Content.
Returns:
-
–
A list of ContentArtifact models related to the instance of Content.
to_representation(value)
¶
Serializes list of ContentArtifacts.
Returns a dict mapping relative paths inside the Content to the corresponding Artifact URLs.
Parameters:
-
value
(list of [pulpcore.app.models.ContentArtifact][]
) –A list of all the ContentArtifacts related to the Content model being serialized.
Returns:
-
–
A dict where keys are relative path of the artifact inside the Content and values are Artifact URLs.
LatestVersionField(*args, **kwargs)
¶
Bases: RepositoryVersionRelatedField
Unfortunately you can't just set read_only=True on the class. It has to be done explicitly in the kwargs to init, or else DRF complains.
get_attribute(instance)
¶
Parameters:
-
instance
(Repository
) –a repository that has been matched by the current ViewSet.
Returns:
- –
BaseURLField
¶
Bases: CharField
Serializer Field for the base_url field of the Distribution.
TaskGroupStatusCountField(state, *args, **kwargs)
¶
Bases: IntegerField
, ReadOnlyField
Serializer field for counting the tasks on a task group in a given state.
pulp_labels_validator(value)
¶
A validator designed for the pulp_labels field.
pulp.app.serializers.content¶
pulpcore.app.serializers.content
¶
NoArtifactContentSerializer
¶
Bases: ModelSerializer
get_artifacts(validated_data)
¶
Extract artifacts from validated_data.
This function is supposed to extract the information about content artifacts from validated_data and return a dictionary with artifacts and relative paths as keys.
retrieve(validated_data)
¶
Retrieve existing content unit if it exists, else return None.
This method is plugin-specific and implementing it for a specific content type allows for uploading already existing content units of that type.
validate(data)
¶
Validate that we have an Artifact or can create one.
create(validated_data)
¶
Create the content and associate it with its Artifacts, or retrieve the existing content.
Parameters:
-
validated_data
(dict
) –Data to save to the database
SingleArtifactContentSerializer(*args, **kwargs)
¶
ContentChecksumSerializer
¶
Bases: Serializer
Provide a serializer with artifact checksum fields for single artifact content.
If you use this serializer, it's recommended that you prefetch artifacts:
Content.objects.prefetch_related("_artifacts").all()
ArtifactSerializer
¶
Bases: ModelSerializer
validate(data)
¶
Validate file by size and by all checksums provided.
Raises:
-
[rest_framework.exceptions.ValidationError][]
–When the expected file size or any of the checksums don't match their actual values.
SigningServiceSerializer
¶
pulp.app.serializers.repository¶
pulpcore.app.serializers.repository
¶
RemoteSerializer
¶
Bases: ModelSerializer
, HiddenFieldsMixin
Every remote defined by a plugin should have a Remote serializer that inherits from this
class. Please import from pulpcore.plugin.serializers
rather than from this module directly.
validate_url(url)
¶
Check if the 'url' is a file://
path, and if so, ensure it's an ALLOWED_IMPORT_PATH.
The ALLOWED_IMPORT_PATH is specified as a Pulp setting.
Parameters:
-
url
–The user-provided value for 'url' to be validated.
Raises:
-
ValidationError
–When the url starts with
file://
, but is not a subfolder of a path in the ALLOWED_IMPORT_PATH setting.
Returns:
-
–
The validated value.
validate_proxy_url(value)
¶
Check, that the proxy_url does not contain credentials.
validate(data)
¶
Check, that proxy credentials are only provided completely and if a proxy is configured.
ContentSummarySerializer
¶
Bases: Serializer
Serializer for the RepositoryVersion content summary