Skip to content

Clarify file name precedence for archive, sdist, and wheel specifications in pylock.toml #2018

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

Merged
woodruffw merged 10 commits into from
Apr 20, 2026
Merged

Clarify file name precedence for archive, sdist, and wheel specifications in pylock.toml #2018

Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
c326e30
Clarify file name precedence for archive, sdist, and wheel specificat…
brettcannon Mar 13, 2026
5271c1f
Clarify precedence of archive path and URL
brettcannon Mar 18, 2026
18ca3fc
Fix reference to wheels URL and path in pylock-toml
brettcannon Mar 18, 2026
8d30a0d
Merge branch 'main' into pylock-file-name-priority
brettcannon Mar 18, 2026
28f94d0
Merge branch 'main' into pylock-file-name-priority
woodruffw Apr 15, 2026
aee1973
Update references from Travis to GitHub Actions
brettcannon Apr 15, 2026
debe3e1
Replace Travis CI with GitHub Actions in documentation
brettcannon Apr 15, 2026
6616a37
Remove Travis mentions
brettcannon Apr 15, 2026
1379de2
Merge branch 'main' into pylock-file-name-priority
brettcannon Apr 20, 2026
f9c4c87
Merge branch 'main' into pylock-file-name-priority
brettcannon Apr 20, 2026
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
4 changes: 2 additions & 2 deletions source/guides/supporting-windows-using-appveyor.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ can be a challenge, because setting up a suitable Windows test environment is
non-trivial, and may require buying software licenses.

The Appveyor service is a continuous integration service, much like the
better-known `Travis`_ service that is commonly used for testing by projects
better-known `GitHub Actions`_ service that is commonly used for testing by projects
hosted on `GitHub`_. However, unlike Travis, the build workers on Appveyor are
Windows hosts and have the necessary compilers installed to build Python
extensions.
Comment thread
brettcannon marked this conversation as resolved.
Outdated
Expand Down Expand Up @@ -237,6 +237,6 @@ For reference, the SDK setup support script is listed here:
:linenos:

.. _Appveyor: https://www.appveyor.com/
.. _Travis: https://travis-ci.com/
.. _GitHub: https://github.com
.. _GitHub Actions: https://docs.github.com/en/actions
.. _Bitbucket: https://bitbucket.org/
20 changes: 18 additions & 2 deletions source/specifications/pylock-toml.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -449,15 +449,26 @@ See :ref:`pylock-packages-vcs-subdirectory`.
``packages.archive.url``
''''''''''''''''''''''''

See :ref:`pylock-packages-vcs-url`.
- **Type**: string
- **Required?**: if :ref:`pylock-packages-archive-path` is not specified
- **Inspiration**: :ref:`direct-url-data-structure-archive`
- The URL_ to the archive.


.. _pylock-packages-archive-path:

``packages.archive.path``
'''''''''''''''''''''''''

See :ref:`pylock-packages-vcs-path`.
- **Type**: string
- **Required?**: if :ref:`pylock-packages-archive-url` is not specified
- **Inspiration**: :ref:`direct-url-data-structure-archive`
- The path to the archive.
- If a relative path is used it MUST be relative to the location of this file.
- If the path is relative it MAY use POSIX-style path separators explicitly
for portability.
- If :ref:`pylock-packages-archive-url` is also specified, the filename as
specified by this key takes precedence.


.. _pylock-packages-archive-size:
Expand Down Expand Up @@ -554,6 +565,8 @@ See :ref:`pylock-packages-vcs-subdirectory`.
the same value
- **Inspiration**: PDM_, Poetry_, uv_
- The file name of the :ref:`source-distribution-format-sdist` file.
- If specified, this key's value takes precedence over the file name found in
either :ref:`pylock-packages-sdist-url` or :ref:`pylock-packages-sdist-path`.


.. _pylock-packages-sdist-upload-time:
Expand Down Expand Up @@ -623,6 +636,8 @@ See :ref:`pylock-packages-archive-hashes`.
the same value
- **Inspiration**: PDM_, Poetry_, uv_
- The file name of the :ref:`binary-distribution-format` file.
- If specified, this key's value takes precedence over the file name found in
either :ref:`pylock-packages-wheels-url` or :ref:`pylock-packages-wheels-path`.


.. _pylock-packages-wheels-upload-time:
Expand Down Expand Up @@ -826,6 +841,7 @@ History
-------

- April 2025: Initial version, approved via :pep:`751`.
- March 2026: Clarify file name precedence for archives, sdists, and wheels.


.. _Content-Length: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Length
Expand Down