パッケージ: python3-arcp (0.2.1-4)

(Archive and Package) URI parser and generator

arcp provides functions for creating arcp_ URIs, which can be used for identifying or parsing hypermedia files packaged in an archive or package, like a ZIP file.

arcp URIs can be used to consume or reference hypermedia resources bundled inside a file archive or an application package, as well as to resolve URIs for archive resources within a programmatic framework.

This URI scheme provides mechanisms to generate a unique base URI to represent the root of the archive, so that relative URI references in a bundled resource can be resolved within the archive without having to extract the archive content on the local file system.

An arcp URI can be used for purposes of isolation (e.g. when consuming multiple archives), security constraints (avoiding “climb out” from the archive), or for externally identiyfing sub-resources referenced by hypermedia formats.

Examples:

 - ``arcp://uuid,32a423d6-52ab-47e3-a9cd-54f418a48571/doc.html``
 - ``arcp://uuid,b7749d0b-0e47-5fc4-999d-f154abe68065/pics/``
 - ``arcp://ni,sha-256;F-34D4TUeOfG0selz7REKRDo4XePkewPeQYtjL3vQs0/``
 - ``arcp://name,gallery.example.org/``

The different forms of URI authority_ in arcp URIs can be used depending on which uniqueness constraints to apply when addressing an archive. See the arcp specification (https://tools.ietf.org/html/draft-soilandreyes-arcp-02) for details.

Note that this library only provides mechanisms to

 *generate* and *parse* arcp URIs, and do *not* integrate with any

particular archive or URL handling modules like "zipfile" or "urllib.request".