<html><head><meta http-equiv="Content-Type" content="text/html charset=us-ascii"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Aug 9, 2014, at 4:26 AM, Paul Moore <<a href="mailto:p.f.moore@gmail.com" class="">p.f.moore@gmail.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class="">On 8 August 2014 22:53, Donald Stufft <<a href="mailto:donald@stufft.io" class="">donald@stufft.io</a>> wrote:<br class=""><blockquote type="cite" class="">Direct references<br class="">=================<br class=""><br class="">Some automated tools may permit the use of a direct reference as an<br class="">alternative to a normal version specifier. A direct reference consists of<br class="">the specifier ``@`` and an explicit URL.<br class=""><br class="">Whether or not direct references are appropriate depends on the specific<br class="">use case for the version specifier. Automated tools SHOULD at least issue<br class="">warnings and MAY reject them entirely when direct references are used<br class="">inappropriately.<br class=""><br class="">Public index servers SHOULD NOT allow the use of direct references in<br class="">uploaded distributions. Direct references are intended as a tool for<br class="">software integrators rather than publishers.<br class=""><br class="">Depending on the use case, some appropriate targets for a direct URL<br class="">reference may be a valid ``source_url`` entry (see PEP 426), an sdist, or<br class="">a wheel binary archive. The exact URLs and targets supported will be tool<br class="">dependent.<br class=""><br class="">For example, a local source archive may be referenced directly::<br class=""><br class=""> pip @ <a href="file:///localbuilds/pip-1.3.1.zip" class="">file:///localbuilds/pip-1.3.1.zip</a><br class=""><br class="">Alternatively, a prebuilt archive may also be referenced::<br class=""><br class=""> pip @ <a href="file:///localbuilds/pip-1.3.1-py33-none-any.whl" class="">file:///localbuilds/pip-1.3.1-py33-none-any.whl</a><br class=""></blockquote><br class="">One very minor question. Is URL format required here? I guess so. On<br class="">Windows, file URLs are confusing and annoying to type - use of /<br class="">rather than \ makes tab-completion useless, it's difficult to remember<br class="">how many slashes go at the start and where the drive letter goes, and<br class="">do UNC paths need 157 or 158 slashes at the start (:-)), and the<br class="">documentation is inconsistent and hard to find.<br class=""><br class="">Allowing a pathname here would be convenient for users, but it's 100%<br class="">not important enough to need a new version of the spec. A<br class="">clarification (presumably, that a URL is required) with a pointer to a<br class="">document that explains the relevant filename->URL translation<br class="">algorithm, would be good, though.<br class=""><br class="">Paul<br class=""></div></blockquote></div><div class=""><br class=""></div><div class=""><div class="">To be clear, the direct reference is mostly for use in the install_requires. On</div><div class="">the CLI pip can still just take a path to a file or whatever. This feature is</div><div class="">intended to replace dependency_links in a way that people can use them for</div><div class="">private packages but that they won't be allowed on PyPI or the like.</div></div><br class=""><div apple-content-edited="true" class="">
<div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div class="">---</div><div class="">Donald Stufft</div><div class="">PGP: 7C6B 7C5D 5E2B 6356 A926 F04F 6E3C BCE9 3372 DCFA</div></div></div>
</div>
<br class=""></body></html>