@@ -10,20 +10,16 @@ This document specifies a JSON-serializable abstract data structure that can rep
10
10
URLs to python projects and distribution artifacts such as VCS source trees, local
11
11
source trees, source distributions and wheels.
12
12
13
- The representation of the components of this data structure as a :rfc: `1738 ` URL
14
- is not formally specified at time of writing. A common representation is the pip URL
15
- format. Other examples are provided in the :ref: `Version specifier specification <version-specifiers >`.
16
-
17
-
18
13
Specification
19
14
=============
20
15
21
16
The Direct URL Data Structure MUST be a dictionary, serializable to JSON according to
22
17
:rfc: `8259 `.
23
18
24
19
It MUST contain at least two fields. The first one is ``url ``, with
25
- type ``string ``. Depending on what ``url `` refers to, the second field MUST be
26
- one of ``vcs_info `` (if ``url `` is a VCS reference), ``archive_info `` (if
20
+ type ``string ``. Its content must be a valid URL according to the
21
+ `WHATWG URL Standard <whatwg-url-standard _>`_. Depending on what ``url `` refers to,
22
+ the second field MUST be one of ``vcs_info `` (if ``url `` is a VCS reference), ``archive_info `` (if
27
23
``url `` is a source archives or a wheel), or ``dir_info `` (if ``url `` is a
28
24
local directory). These info fields have a (possibly empty) subdictionary as
29
25
value, with the possible keys defined below.
@@ -396,3 +392,4 @@ History
396
392
397
393
398
394
.. _archive-info-hashes : https://discuss.python.org/t/22299
395
+ .. _whatwg-url-standard : https://url.spec.whatwg.org/
0 commit comments