swh.deposit.api.common module

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: Dict[str, Any], collection_name: str, deposit_id: Optional[int] = None) → Dict[str, Any]

Permit the child class to enrich additional checks.

Returns

dict with ‘error’ detailing the problem.

checks(request: rest_framework.request.Request, collection_name: str, deposit_id: Optional[int] = None) → Dict[str, Any]

restrict_access(request: rest_framework.request.Request, deposit: Optional[swh.deposit.models.Deposit] = None) → Dict[str, Any]

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_id: int) → 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 DELETE 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: Dict, collection_name: str, deposit_id: Optional[int] = None) → Tuple[int, str, Dict]

Routine to deal with the deposit’s processing.

Returns

Tuple of: - response status code (200, 201, etc…) - key iri (EM_IRI, EDIT_SE_IRI, etc…) - dictionary of the processing result

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: Dict, collection_name: str, deposit_id: int) → Dict[str, Any]

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_id: int) → Dict

Routine to delete a resource.

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