swh.deposit.api.common module

class swh.deposit.api.common.ParsedRequestHeaders(content_type: str, content_length: Optional[int], in_progress: bool, content_disposition: Optional[str], content_md5sum: Optional[bytes], packaging: Optional[str], slug: Optional[str], on_behalf_of: Optional[str], metadata_relevant: Optional[str], swhid: Optional[str])

Bases: object

class swh.deposit.api.common.Receipt(deposit_id: int, deposit_date: datetime.datetime, status: str, archive: Optional[str])

Bases: object

Data computed while handling the request body that will be served in the Deposit Receipt.

swh.deposit.api.common.get_deposit_by_id(deposit_id: int, collection_name: Optional[str] = None) → swh.deposit.models.Deposit

Gets an existing Deposit object if it exists, or raises DepositError. If collection is not None, also checks the deposit belongs to the collection.

swh.deposit.api.common.get_collection_by_name(collection_name: str)

Gets an existing Deposit object if it exists, or raises DepositError.

swh.deposit.api.common.guess_deposit_origin_url(deposit: swh.deposit.models.Deposit)

Guesses an origin url for the given deposit.

swh.deposit.api.common.check_client_origin(client: swh.deposit.models.DepositClient, origin_url: str)

class swh.deposit.api.common.AuthenticatedAPIView(**kwargs)

Bases: rest_framework.views.APIView

Mixin intended as a based API view to enforce the basic authentication check

authentication_classes: Sequence[Type[rest_framework.authentication.BaseAuthentication]] = (<class 'rest_framework.authentication.BasicAuthentication'>,)

permission_classes: Sequence[Type[rest_framework.permissions.BasePermission]] = (<class 'rest_framework.permissions.IsAuthenticated'>,)

class swh.deposit.api.common.APIBase

Bases: swh.deposit.config.APIConfig, swh.deposit.api.common.AuthenticatedAPIView

Base deposit request class sharing multiple common behaviors.

additional_checks(request: rest_framework.request.Request, headers: swh.deposit.api.common.ParsedRequestHeaders, collection_name: str, deposit: Optional[swh.deposit.models.Deposit]) → Dict[str, Any]

Permit the child class to enrich additional checks.

Returns

dict with ‘error’ detailing the problem.

get_client(request) → swh.deposit.models.DepositClient

checks(request: rest_framework.request.Request, collection_name: str, deposit: Optional[swh.deposit.models.Deposit] = None) → swh.deposit.api.common.ParsedRequestHeaders

restrict_access(request: rest_framework.request.Request, headers: swh.deposit.api.common.ParsedRequestHeaders, deposit: swh.deposit.models.Deposit) → None

Allow modifications on deposit with status ‘partial’ only, reject the rest.

get(request: rest_framework.request.Request, collection_name: str, deposit_id: int) → Union[django.http.response.HttpResponse, django.http.response.FileResponse]

post(request: rest_framework.request.Request, collection_name: str, deposit_id: Optional[int] = None) → django.http.response.HttpResponse

put(request: rest_framework.request.Request, collection_name: str, deposit_id: int) → django.http.response.HttpResponse

delete(request: rest_framework.request.Request, collection_name: str, deposit_id: Optional[int] = None) → django.http.response.HttpResponse

class swh.deposit.api.common.APIGet

Bases: swh.deposit.api.common.APIBase

Mixin for class to support GET method.

get(request: rest_framework.request.Request, collection_name: str, deposit_id: int) → Union[django.http.response.HttpResponse, django.http.response.FileResponse]

Endpoint to create/add resources to deposit.

Returns

200 response when no error during routine occurred 400 if the deposit does not belong to the collection 404 if the deposit or the collection does not exist

abstract process_get(request: rest_framework.request.Request, collection_name: str, deposit: swh.deposit.models.Deposit) → Tuple[int, Any, str]

Routine to deal with the deposit’s get processing.

Returns

Tuple status, stream of content, content-type

class swh.deposit.api.common.APIPost

Bases: swh.deposit.api.common.APIBase

Mixin for class to support POST method.

post(request: rest_framework.request.Request, collection_name: str, deposit_id: Optional[int] = None) → django.http.response.HttpResponse

Endpoint to create/add resources to deposit.

Returns

204 response when no error during routine occurred. 400 if the deposit does not belong to the collection 404 if the deposit or the collection does not exist

abstract process_post(request, headers: swh.deposit.api.common.ParsedRequestHeaders, collection_name: str, deposit: Optional[swh.deposit.models.Deposit] = None) → Tuple[int, str, swh.deposit.api.common.Receipt]

Routine to deal with the deposit’s processing.

Returns

Tuple of: - response status code (200, 201, etc…) - key iri (EM_IRI, EDIT_IRI, etc…) - Receipt

class swh.deposit.api.common.APIPut

Bases: swh.deposit.api.common.APIBase

Mixin for class to support PUT method.

put(request: rest_framework.request.Request, collection_name: str, deposit_id: int) → django.http.response.HttpResponse

Endpoint to update deposit resources.

Returns

204 response when no error during routine occurred. 400 if the deposit does not belong to the collection 404 if the deposit or the collection does not exist

abstract process_put(request: rest_framework.request.Request, headers: swh.deposit.api.common.ParsedRequestHeaders, collection_name: str, deposit: swh.deposit.models.Deposit) → None

Routine to deal with updating a deposit in some way.

Returns

dictionary of the processing result

class swh.deposit.api.common.APIDelete

Bases: swh.deposit.api.common.APIBase

Mixin for class to support DELETE method.

delete(request: rest_framework.request.Request, collection_name: str, deposit_id: Optional[int] = None) → django.http.response.HttpResponse

Endpoint to delete some deposit’s resources (archives, deposit).

Returns

204 response when no error during routine occurred. 400 if the deposit does not belong to the collection 404 if the deposit or the collection does not exist

abstract process_delete(request: rest_framework.request.Request, collection_name: str, deposit: swh.deposit.models.Deposit) → None

Routine to delete a resource.

This is mostly not allowed except for the EM_IRI (cf. .api.deposit_update.APIUpdateArchive)