8000 PEP 694: Abstract file upload mechanisms by ewdurbin · Pull Request #4431 · python/peps · GitHub
[go: up one dir, main page]
Skip to content

PEP 694: Abstract file upload mechanisms #4431

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 31 commits into
base: main
Choose a base branch
from
+565 −593
Open

PEP 694: Abstract file upload mechanisms #4431

Changes from 1 commit
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
d569693
PEP 694: Abstract file upload mechanisms
ewdurbin May 21, 2025
8e98c9b
lint
ewdurbin May 21, 2025
daf06f4
no warnings allowed
ewdurbin May 21, 2025
5ef177e
refinements
ewdurbin May 22, 2025
7f1e741
Update peps/pep-0694.rst
ewdurbin May 28, 2025
f8469cf
remove reference to a specific URL for PyPI
ewdurbin May 30, 2025
05d7fc2
clarify that resumable/parallel uploads are supported but not defined…
ewdurbin May 30, 2025
2ef077c
attempt to specify http-post-application-octet-stream mechanism
ewdurbin May 30, 2025
a2bfb56
if attestations are going to be uploaded, do it before completion of …
ewdurbin May 30, 2025
442d37f
i'm in it now
ewdurbin May 30, 2025
924a27d
try to un-wonk content-type per feedback
ewdurbin May 30, 2025
7f0798b
lint
ewdurbin May 30, 2025
3effee2
clarify file upload mechanism details
ewdurbin May 30, 2025
c053242
Fix typo
ewdurbin May 30, 2025
847b2bd
address general content feedback from review
ewdurbin Jun 11, 2025
64fdafc
bubble content-type handling up so that it can be assumed througouth
ewdurbin Jun 11, 2025
2d634d7
restructure document to un-twist Upload Sessions and File Upload Sess…
ewdurbin Jun 11, 2025
6fea5f9
naming things
ewdurbin Jun 11, 2025
86710f1
flatten the `mechanism` value of the file upload session response
ewdurbin Jun 11, 2025
5fbf005
Rename "Upload Session" to "Publishing Session"
ewdurbin Jun 11, 2025
4139377
re-flow the doc into (mostly) lines <100
ewdurbin Jun 11, 2025
b7d8ac5
Merge branch 'main' into file_upload_mechanisms
warsaw Jul 11, 2025
98e7929
Apply suggestions from code review
ewdurbin Jul 11, 2025
1ff2415
re-order response codes in session status
ewdurbin Jul 11, 2025
e946d41
Update peps/pep-0694.rst
warsaw Jul 11, 2025
191c9fe
Update verbiage in rationale section.
ewdurbin Jul 25, 2025
dcb682b
specify that Retry-After header should be used to manage polling of t…
ewdurbin Jul 25, 2025
acbc1b1
stage previews are optionally supported by this PEP, and thus are not…
ewdurbin Jul 25, 2025
fd0e6f5
valid-for -> expires-at
ewdurbin Jul 25, 2025
472a796
clarify who owns what version specifiers
ewdurbin Jul 25, 2025
9010030
lint
ewdurbin Jul 25, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
flatten the mechanism value of the file upload session response
  • Loading branch information
@ewdurbin
ewdurbin committed Jun 11, 2025
commit 86710f1e5c89c27c6ae6046f90609a0c6fd24f40
13 changes: 7 additions & 6 deletions peps/pep-0694.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -635,10 +635,9 @@ The successful response includes the following:
"status": "pending",
"valid-for": 3600,
"mechanism": {
"http-post-bytes": {
"file_url": "..."
"attestations_url": "..."
}
"identifier": "http-post-bytes",
"file_url": "...",
"attestations_url": "..."
}
}

Expand All @@ -651,8 +650,10 @@ the following keys:
the details of which are provided below.

``mechanism``
A mapping containing the supported mechanism identifier negotiated by the client and server,
to a mapping containing details necessary to execute the mechanism.
A mapping containing the necessary details for the supported mechanism
as negotiated by the client and server.
This mapping **MUST** contain a key ``identifier`` which maps to
the identifier string for the File Upload Mechanism.

.. _file-upload-session-links:

Expand Down
0