Refactor file upload tests to remove hardcoded start_cursor and improve maintainability (#294)

* - Added several `file_upload_id` entries in `tests\conftest.py` to simplify file upload tests in `tests\test_endpoints.py`
- Resolved hardcoded value issue in `test_file_uploads_list_with_start_cursor`

* - Added several `file_upload_id` entries in `tests\conftest.py`

* - Added new test YAML files under `tests\cassettes`

* - Further simplified `uploaded_file_id` configuration

* - Renamed and standardized the `part_uploaded_file_upload_id` function name for consistency

* - ruff

* - ruff

* - Added `setup_file_uploads_for_start_cursor` function with `scope="module"` and `autouse=True` to ensure it runs once before the first test in the module, facilitating `test_file_uploads_list`

* - Updated the decorator for `pending_multi_file_upload_id(client):`
  - Removed `scope="module"` and `autouse=True`
  - Changed to `scope="function"`

Author: tsinglinrain

tests/cassettes/test_file_uploads_complete.yaml

@@ -22,7 +22,7 @@ interactions:
     uri: https://api.notion.com/v1/file_uploads
   response:
     body:
-      string: '{"object":"file_upload","id":"28399f72-bada-810b-97ac-00b20c865368","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-810b-97ac-00b20c865368/send","archived":false,"status":"pending","filename":"test_file.txt","content_type":"text/plain","content_length":null,"request_id":"8cc5f342-bcf1-45e2-a16e-713101606e3f"}'
+      string: '{"object":"file_upload","id":"29a99f72-bada-81bb-8c36-00b230f59df7","created_time":"2025-10-28T10:43:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-28T10:43:00.000Z","expiry_time":"2025-10-28T11:43:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29a99f72-bada-81bb-8c36-00b230f59df7/send","archived":false,"status":"pending","filename":"test_file.txt","content_type":"text/plain","content_length":null,"request_id":"df9fbd92-fae9-4cac-81f9-ca5a60c549e9"}'
     headers:
       Content-Type:
       - application/json; charset=utf-8

tests/cassettes/test_file_uploads_create.yaml

@@ -22,7 +22,7 @@ interactions:
     uri: https://api.notion.com/v1/file_uploads
   response:
     body:
-      string: '{"object":"file_upload","id":"28399f72-bada-8128-81d9-00b274d4d59a","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-8128-81d9-00b274d4d59a/send","archived":false,"status":"pending","filename":"test_file.pdf","content_type":"application/pdf","content_length":null,"request_id":"ad3f2fb2-302d-4468-a80d-6e02616bb04c"}'
+      string: '{"object":"file_upload","id":"29a99f72-bada-81ad-bd79-00b24375f304","created_time":"2025-10-28T10:43:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-28T10:43:00.000Z","expiry_time":"2025-10-28T11:43:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29a99f72-bada-81ad-bd79-00b24375f304/send","archived":false,"status":"pending","filename":"test_file.pdf","content_type":"application/pdf","content_length":null,"request_id":"52d46278-ca95-48fa-bfb9-531a4678731f"}'
     headers:
       Content-Type:
       - application/json; charset=utf-8

tests/cassettes/test_file_uploads_create_external.yaml

@@ -22,7 +22,7 @@ interactions:
     uri: https://api.notion.com/v1/file_uploads
   response:
     body:
-      string: '{"object":"file_upload","id":"28399f72-bada-817a-94b2-00b20d820231","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-817a-94b2-00b20d820231/send","archived":false,"status":"pending","filename":"large_file.pdf","content_type":"application/pdf","content_length":null,"number_of_parts":{"total":3,"sent":0},"request_id":"1efdf66b-bf89-47ed-b9ea-55bb68b10835"}'
+      string: '{"object":"file_upload","id":"29a99f72-bada-819c-b0ed-00b228b34c37","created_time":"2025-10-28T10:43:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-28T10:43:00.000Z","expiry_time":"2025-10-28T11:43:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29a99f72-bada-819c-b0ed-00b228b34c37/send","archived":false,"status":"pending","filename":"large_file.pdf","content_type":"application/pdf","content_length":null,"number_of_parts":{"total":3,"sent":0},"request_id":"2e7de576-9b2d-4376-aef0-fd8167447725"}'
     headers:
       Content-Type:
       - application/json; charset=utf-8

tests/cassettes/test_file_uploads_create_multipart.yaml

@@ -1,4 +1,68 @@
 interactions:
+- request:
+    body: '{"mode":"single_part","filename":"cursor_test_0.txt","content_type":"text/plain"}'
+    headers:
+      accept:
+      - '*/*'
+      accept-encoding:
+      - gzip, deflate
+      authorization:
+      - ntn_...
+      connection:
+      - keep-alive
+      content-length:
+      - '81'
+      content-type:
+      - application/json
+      host:
+      - api.notion.com
+      notion-version:
+      - '2025-09-03'
+    method: POST
+    uri: https://api.notion.com/v1/file_uploads
+  response:
+    body:
+      string: '{"object":"file_upload","id":"29c99f72-bada-8120-9729-00b2bfd68811","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-8120-9729-00b2bfd68811/send","archived":false,"status":"pending","filename":"cursor_test_0.txt","content_type":"text/plain","content_length":null,"request_id":"579d24de-a4c0-4831-9866-c9b94298857d"}'
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      content-length:
+      - '534'
+    status:
+      code: 200
+      message: OK
+- request:
+    body: '{"mode":"single_part","filename":"cursor_test_1.txt","content_type":"text/plain"}'
+    headers:
+      accept:
+      - '*/*'
+      accept-encoding:
+      - gzip, deflate
+      authorization:
+      - ntn_...
+      connection:
+      - keep-alive
+      content-length:
+      - '81'
+      content-type:
+      - application/json
+      host:
+      - api.notion.com
+      notion-version:
+      - '2025-09-03'
+    method: POST
+    uri: https://api.notion.com/v1/file_uploads
+  response:
+    body:
+      string: '{"object":"file_upload","id":"29c99f72-bada-8111-959f-00b2e2eb917d","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-8111-959f-00b2e2eb917d/send","archived":false,"status":"pending","filename":"cursor_test_1.txt","content_type":"text/plain","content_length":null,"request_id":"20a47eb8-3406-420e-9ddb-6e9b10c36a8e"}'
+    headers:
+      Content-Type:
+      - application/json; charset=utf-8
+      content-length:
+      - '534'
+    status:
+      code: 200
+      message: OK
 - request:
     body: ''
     headers:
@@ -18,12 +82,12 @@ interactions:
     uri: https://api.notion.com/v1/file_uploads?page_size=5
   response:
     body:
-      string: '{"object":"list","results":[{"object":"file_upload","id":"28399f72-bada-8173-bcc5-00b242881503","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-8173-bcc5-00b242881503/send","archived":false,"status":"pending","filename":"retrieve_test.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"28399f72-bada-8128-81d9-00b274d4d59a","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","archived":false,"status":"uploaded","filename":"test_file.pdf","content_type":"application/pdf","content_length":13264,"file_import_result":{"type":"success","success":{},"imported_time":"2025-10-05T10:55:29.000+00:00"}},{"object":"file_upload","id":"28399f72-bada-817a-94b2-00b20d820231","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-817a-94b2-00b20d820231/send","archived":false,"status":"pending","filename":"large_file.pdf","content_type":"application/pdf","content_length":null,"number_of_parts":{"total":3,"sent":0}},{"object":"file_upload","id":"28399f72-bada-810b-97ac-00b20c865368","created_time":"2025-10-05T10:55:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:55:00.000Z","expiry_time":"2025-10-05T11:55:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/28399f72-bada-810b-97ac-00b20c865368/send","archived":false,"status":"pending","filename":"test_file.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"28399f72-bada-8148-b990-00b29e88cfee","created_time":"2025-10-05T10:36:00.000Z","created_by":{"id":"5b8183bd-8984-4417-b2a6-7dc8e439e679","type":"bot"},"last_edited_time":"2025-10-05T10:36:00.000Z","expiry_time":"2025-10-05T11:36:00.000Z","archived":false,"status":"uploaded","filename":"large_test.pdf","content_type":"application/pdf","content_length":41943040,"number_of_parts":{"total":4,"sent":4}}],"next_cursor":"28399f72-bada-8131-97ec-00b26410a571","has_more":true,"type":"file_upload","file_upload":{},"request_id":"90d91ae3-33f4-4d57-a058-b111b3deb594"}'
+      string: '{"object":"list","results":[{"object":"file_upload","id":"29c99f72-bada-8111-959f-00b2e2eb917d","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-8111-959f-00b2e2eb917d/send","archived":false,"status":"pending","filename":"cursor_test_1.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"29c99f72-bada-8120-9729-00b2bfd68811","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-8120-9729-00b2bfd68811/send","archived":false,"status":"pending","filename":"cursor_test_0.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"29c99f72-bada-813a-a2ab-00b2a164ba9e","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-813a-a2ab-00b2a164ba9e/send","archived":false,"status":"pending","filename":"cursor_test_1.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"29c99f72-bada-813b-adc3-00b2837681f9","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-813b-adc3-00b2837681f9/send","archived":false,"status":"pending","filename":"cursor_test_0.txt","content_type":"text/plain","content_length":null},{"object":"file_upload","id":"29c99f72-bada-8106-bdae-00b2d1438d51","created_time":"2025-10-30T12:38:00.000Z","created_by":{"id":"13b9509e-d081-40e9-ba54-a469aacab8c8","type":"bot"},"last_edited_time":"2025-10-30T12:38:00.000Z","expiry_time":"2025-10-30T13:38:00.000Z","upload_url":"https://api.notion.com/v1/file_uploads/29c99f72-bada-8106-bdae-00b2d1438d51/send","archived":false,"status":"pending","filename":"cursor_test_1.txt","content_type":"text/plain","content_length":null}],"next_cursor":"29c99f72-bada-81d2-bcae-00b2f97e7efe","has_more":true,"type":"file_upload","file_upload":{},"request_id":"f0fcf13b-554b-4fb8-9b52-692b99c96bf2"}'
     headers:
       Content-Type:
       - application/json; charset=utf-8
       content-length:
-      - '2598'
+      - '2603'
     status:
       code: 200
       message: OK