Skip to content

test_preservation#

preservation_dataset_json#

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
10
11
12
13
14
15
16
17
18
19
20
21
@pytest.fixture
def preservation_dataset_json(dataset_a_json, contract_a):
    dataset = {
        **dataset_a_json,
        "preservation": {
            "contract": contract_a.json()["id"],
            "state": 0,
            "description": {"en": "Test preservation description"},
            "reason_description": "Test preservation reason description",
        },
    }
    return dataset

preservation_dataset#

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
24
25
26
27
28
@pytest.fixture
def preservation_dataset(admin_client, preservation_dataset_json):
    return admin_client.post(
        "/v3/datasets", preservation_dataset_json, content_type="application/json"
    ).json()

test_create_dataset_preservation#

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
31
32
33
34
35
36
37
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_create_dataset_preservation(admin_client, preservation_dataset_json):
    resp = admin_client.post(
        "/v3/datasets", preservation_dataset_json, content_type="application/json"
    )
    assert resp.status_code == 201
    assert_nested_subdict(preservation_dataset_json["preservation"], resp.json()["preservation"])

test_create_dataset_preservation_without_contract#

Try updating preservation state without including a valid contract; this should fail.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
40
41
42
43
44
45
46
47
48
49
50
51
52
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_create_dataset_preservation_without_contract(admin_client, preservation_dataset_json):
    """
    Try updating preservation state without including a valid contract;
    this should fail.
    """
    data = preservation_dataset_json.copy()
    del data["preservation"]["contract"]
    resp = admin_client.post("/v3/datasets", data, content_type="application/json")
    assert resp.status_code == 400
    assert resp.json()["preservation"]["contract"] == [
        "Dataset in preservation process must have a contract."
    ]

test_update_dataset_preservation_state#

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_update_dataset_preservation_state(
    admin_client, preservation_dataset, dataset_signal_handlers
):
    resp = admin_client.patch(
        f"/v3/datasets/{preservation_dataset['id']}/preservation",
        {"state": 20},
        content_type="application/json",
    )
    assert resp.status_code == 200

    data = resp.json()
    assert data["id"] == preservation_dataset["preservation"]["id"]
    assert data["state"] == 20
    dataset_signal_handlers.assert_call_counts(created=0, updated=1)

test_update_dataset_preservation_state_remove_contract_error#

Try updating a dataset to remove the contract while retaining the current preservation state. This should fail.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_update_dataset_preservation_state_remove_contract_error(
    admin_client, preservation_dataset
):
    """
    Try updating a dataset to remove the contract while retaining the current
    preservation state. This should fail.
    """
    resp = admin_client.patch(
        f"/v3/datasets/{preservation_dataset['id']}/preservation",
        {"contract": None},
        content_type="application/json",
    )
    assert resp.status_code == 400
    assert resp.json()["contract"] == ["Dataset in preservation process must have a contract."]

test_update_dataset_reset_preservation#

Try updating a dataset to reset the preservation process by clearing the preservation state and removing the contract

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_update_dataset_reset_preservation(admin_client, preservation_dataset):
    """
    Try updating a dataset to reset the preservation process by clearing
    the preservation state and removing the contract
    """
    resp = admin_client.patch(
        f"/v3/datasets/{preservation_dataset['id']}/preservation?include_nulls=true",
        {"state": -1, "contract": None},
        content_type="application/json",
    )
    assert resp.status_code == 200
    data = resp.json()

    assert data["id"]
    assert data["state"] == -1
    assert data["contract"] is None

test_query_datasets_preservation_state#

Query datasets that have the given preservation state

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_query_datasets_preservation_state(admin_client, preservation_dataset):
    """
    Query datasets that have the given preservation state
    """
    # One dataset with state 0
    resp = admin_client.get("/v3/datasets", {"preservation__state": ["10", "0"]})
    assert resp.status_code == 200
    assert resp.json()["count"] == 1
    assert resp.json()["results"][0]["id"] == preservation_dataset["id"]

    # No datasets with these preservation states
    resp = admin_client.get("/v3/datasets", {"preservation__state": ["10", "20"]})
    assert resp.status_code == 200
    assert resp.json()["count"] == 0

test_delete_dataset_with_preservation#

Delete a dataset containing preservation data

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
125
126
127
128
129
130
131
132
133
134
135
136
137
138
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_delete_dataset_with_preservation(admin_client, preservation_dataset):
    """
    Delete a dataset containing preservation data
    """
    resp = admin_client.delete(f"/v3/datasets/{preservation_dataset['id']}")
    assert resp.status_code == 204

    resp = admin_client.get(f"/v3/datasets/{preservation_dataset['id']}")
    assert resp.status_code == 404

    # Contract is NOT deleted
    resp = admin_client.get(f"/v3/contracts/{preservation_dataset['preservation']['contract']}")
    assert resp.status_code == 200

test_update_dataset_preservation_indirect#

Try updating dataset's preservation state via the /v3/datasets/<id> endpoint and ensure preservation data must be complete in order to be accepted

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_update_dataset_preservation_indirect(admin_client, preservation_dataset):
    """
    Try updating dataset's preservation state via the `/v3/datasets/<id>` endpoint
    and ensure preservation data must be complete in order to be accepted
    """
    preservation_dataset = {
        "id": preservation_dataset["id"],
        "preservation": preservation_dataset["preservation"],
    }

    # Attempt to patch only preservation state; this will fail
    resp = admin_client.patch(
        f"/v3/datasets/{preservation_dataset['id']}",
        {"id": preservation_dataset["id"], "preservation": {"state": 50}},
        content_type="application/json",
    )
    assert resp.status_code == 400
    assert resp.json() == {
        "preservation": {"contract": ["Dataset in preservation process must have a contract."]}
    }

    preservation = preservation_dataset["preservation"]

    # Provide both mandatory fields; update should now succeed
    resp = admin_client.patch(
        f"/v3/datasets/{preservation_dataset['id']}",
        {
            "id": preservation_dataset["id"],
            "preservation": {"state": 50, "contract": preservation["contract"]},
        },
        content_type="application/json",
    )
    assert resp.status_code == 200
    data = resp.json()

    assert data["preservation"]["state"] == 50
    assert data["preservation"]["contract"] == preservation["contract"]

test_delete_dataset_preservation#

Try deleting dataset preservation using the endpoint.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
181
182
183
184
185
186
187
188
189
190
191
192
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_delete_dataset_preservation(admin_client, preservation_dataset):
    """Try deleting dataset preservation using the endpoint."""
    resp = admin_client.delete(
        f"/v3/datasets/{preservation_dataset['id']}/preservation", content_type="application/json"
    )
    assert resp.status_code == 204

    resp = admin_client.get(
        f"/v3/datasets/{preservation_dataset['id']}/preservation", content_type="application/json"
    )
    assert resp.status_code == 404

test_get_dataset_preservation_anonymous#

Try retrieving dataset preservation as an anonymous user.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
195
196
197
198
199
200
201
202
203
204
205
206
207
208
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_get_dataset_preservation_anonymous(client, preservation_dataset):
    """Try retrieving dataset preservation as an anonymous user."""
    resp = client.get(
        f"/v3/datasets/{preservation_dataset['id']}/preservation", content_type="application/json"
    )
    assert resp.status_code == 200

    # Nested endpoint of should not be visible if dataset is not visible
    Dataset.objects.filter(id=preservation_dataset["id"]).update(state="draft")
    resp = client.get(
        f"/v3/datasets/{preservation_dataset['id']}/preservation", content_type="application/json"
    )
    assert resp.status_code == 404

test_patch_dataset_nonexisting_preservation#

Try patching preservation object that does not exist yet.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
211
212
213
214
215
216
217
218
219
220
221
222
223
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_patch_dataset_nonexisting_preservation(admin_client, dataset_a_json):
    """Try patching preservation object that does not exist yet."""
    dataset = admin_client.post(
        "/v3/datasets", dataset_a_json, content_type="application/json"
    ).json()

    resp = admin_client.patch(
        f"/v3/datasets/{dataset['id']}/preservation",
        {"state": 20},
        content_type="application/json",
    )
    assert resp.status_code == 404

test_put_dataset_nonexisting_preservation#

Try creating preservation object using put.

Source code in tests/unit/apps/core/api/dataset/test_preservation.py 
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
@pytest.mark.usefixtures("data_catalog", "reference_data")
def test_put_dataset_nonexisting_preservation(
    admin_client, dataset_a_json, dataset_signal_handlers
):
    """Try creating preservation object using put."""
    dataset = admin_client.post(
        "/v3/datasets", dataset_a_json, content_type="application/json"
    ).json()

    dataset_signal_handlers.reset()
    resp = admin_client.put(
        f"/v3/datasets/{dataset['id']}/preservation",
        {"state": -1},
        content_type="application/json",
    )
    assert resp.status_code == 200
    dataset_signal_handlers.assert_call_counts(created=0, updated=1)