swh.deposit.models module

class swh.deposit.models.Dbversion(*args, **kwargs)[source]

Bases: django.db.models.base.Model

Db version

version: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

release: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

description: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

exception DoesNotExist: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned: Bases: django.core.exceptions.MultipleObjectsReturned

objects = <django.db.models.manager.Manager object>

swh.deposit.models.DEPOSIT_STATUS = [('partial', 'partial'), ('expired', 'expired'), ('deposited', 'deposited'), ('verified', 'verified'), ('rejected', 'rejected'), ('loading', 'loading'), ('done', 'done'), ('failed', 'failed')]: Possible status and the detailed meaning.

class swh.deposit.models.DepositClient(*args, **kwargs)[source]

Bases: django.contrib.auth.models.User

Deposit client

collections: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

objects = <django.contrib.auth.models.UserManager object>

provider_url: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

domain: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

oidc_user: Optional[swh.auth.django.models.OIDCUser] = None

exception DoesNotExist: Bases: django.contrib.auth.models.User.DoesNotExist

exception MultipleObjectsReturned: Bases: django.contrib.auth.models.User.MultipleObjectsReturned

deposit_set

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

user_ptr

Accessor to the related object on the forward side of a one-to-one relation.

In the example:

class Restaurant(Model):
    place = OneToOneField(Place, related_name='restaurant')

Restaurant.place is a ForwardOneToOneDescriptor instance.

user_ptr_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

class swh.deposit.models.Deposit(*args, **kwargs)[source]

Bases: django.db.models.base.Model

Deposit reception table

id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

reception_date: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

complete_date: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

collection

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

external_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

origin_url: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

client

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

swhid: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

swhid_context: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

status: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

status_detail: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

parent

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

check_task_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

load_task_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

type: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

raw_metadata: Optional[str] = None

set_raw_metadata(raw_metadata: str) → None[source]: Set the metadata raw out of a ‘metadata’ typed deposit request. This is specifically used during listing.

exception DoesNotExist: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned: Bases: django.core.exceptions.MultipleObjectsReturned

client_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

collection_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

deposit_set

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

depositrequest_set

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

get_next_by_reception_date(*, field=<django.db.models.fields.DateTimeField: reception_date>, is_next=True, **kwargs)

get_previous_by_reception_date(*, field=<django.db.models.fields.DateTimeField: reception_date>, is_next=False, **kwargs)

get_status_display(*, field=<django.db.models.fields.TextField: status>)

get_type_display(*, field=<django.db.models.fields.CharField: type>)

objects = <django.db.models.manager.Manager object>

parent_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

swh.deposit.models.client_directory_path(instance: swh.deposit.models.DepositRequest, filename: str) → str[source]

Callable to determine the upload archive path. This defaults to: MEDIA_ROOT/client_<user_id>/%Y%m%d-%H%M%S.%f/<filename>.

The format “%Y%m%d-%H%M%S.%f” is the reception date of the associated deposit formatted using strftime.

Parameters

instance – DepositRequest concerned by the upload
filename – Filename of the uploaded file

Returns

The upload archive path.

class swh.deposit.models.DepositRequest(*args, **kwargs)[source]

Bases: django.db.models.base.Model

Deposit request associated to one deposit.

id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

deposit

Accessor to the related object on the forward side of a many-to-one or one-to-one (via ForwardOneToOneDescriptor subclass) relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Child.parent is a ForwardManyToOneDescriptor instance.

date: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

metadata: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

raw_metadata: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

archive

The descriptor for the file attribute on the model instance. Return a FieldFile when accessed so you can write code like:

>>> from myapp.models import MyModel
>>> instance = MyModel.objects.get(pk=1)
>>> instance.file.size

Assign a file object on assignment so you can do:

>>> with open('/path/to/hello.world', 'r') as f:
...     instance.file = File(f)

type: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

exception DoesNotExist: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned: Bases: django.core.exceptions.MultipleObjectsReturned

deposit_id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

get_next_by_date(*, field=<django.db.models.fields.DateTimeField: date>, is_next=True, **kwargs)

get_previous_by_date(*, field=<django.db.models.fields.DateTimeField: date>, is_next=False, **kwargs)

get_type_display(*, field=<django.db.models.fields.CharField: type>)

objects = <django.db.models.manager.Manager object>

class swh.deposit.models.DepositCollection(id, name)[source]

Bases: django.db.models.base.Model

id: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

name: A wrapper for a deferred-loading field. When the value is read from this object the first time, the query is executed.

exception DoesNotExist: Bases: django.core.exceptions.ObjectDoesNotExist

exception MultipleObjectsReturned: Bases: django.core.exceptions.MultipleObjectsReturned

deposit_set

Accessor to the related objects manager on the reverse side of a many-to-one relation.

In the example:

class Child(Model):
    parent = ForeignKey(Parent, related_name='children')

Parent.children is a ReverseManyToOneDescriptor instance.

Most of the implementation is delegated to a dynamically defined manager class built by create_forward_many_to_many_manager() defined below.

objects = <django.db.models.manager.Manager object>