8000 PEP 778: Supporting Symlinks in Wheels by emmatyping · Pull Request #3786 · python/peps · GitHub
[go: up one dir, main page]

Skip to content

PEP 778: Supporting Symlinks in Wheels #3786

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.

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
merged 13 commits into from
Jul 9, 2025
Prev Previous commit
Next Next commit
Mark PEP 778 deferred
  • Loading branch information
emmatyping committed Jul 3, 2025
commit 1ed60b5f156865185269e903dd2dc1cfc6006cdf
21 changes: 19 additions & 2 deletions peps/pep-0778.rst
Original file line number Diff line number Diff line change
@@ -1,13 +1,15 @@
PEP: 778
Title: Supporting Symlinks in Wheels
Author: Ethan Smith <ethan@ethanhs.me>
Author: Emma Harper Smith <emma@python.org>
Sponsor: Barry Warsaw <barry@python.org>
PEP-Delegate: Paul Moore <p.f.moore@gmail.com>
Status: Draft
Discussions-To: https://discuss.python.org/t/pep-778-supporting-symlinks-in-wheels/53824
Status: Deferred
Type: Standards Track
Topic: Packaging
Requires: 777
Created: 18-May-2024
Post-History: `10-Oct-2024 <https://discuss.python.org/t/pep-778-supporting-symlinks-in-wheels/53824>`__

Abstract
========
Expand All @@ -17,6 +19,21 @@ installed. To properly handle distributing libraries in wheels, we propose a new
metadata file to handle symlinks in a platform portable manner. This specification requires
a new wheel major version, discussed in :pep:`777`.

PEP Defferal
============

This PEP has been deferred until a better compatibility story for major changes to the wheel
format is established. Once a compatibility story is established for wheels which allows backwards
incompatible behavior in an unobtrusive way, the following points should be addressed in this PEP:

- Re-focus topic to just symliinks for shared libraries on Unix platforms. Perhaps tie to
platform tags?
- Should the symlinks be materialized as file attributes in the archive or a ``LINKS`` file?
Could it be encoded in ``RECORD``?
- Clarify that this PEP is insufficient to be useful for PEP 660 editable installs since it will no
longer be cross platform.
- Describe fallback behavior in instances where symlinks are unavailable on Unix platforms.

Motivation
==========

Expand Down
0