Overview
This web application aims to provide HTML views to easily navigate in the Software Heritage archive. This is an ongoing developmentand new features and improvements will be progressively added over time.
URI scheme
The current URI scheme of that web application is described below and depends on the type of Software Heritage object to browse. Its exhaustive documentation can be consulted from the official Software Heritage development documentation
Context-independent browsing
Context-independent URLs provide information about objects (e.g., revisions, directories, contents, persons, …), independently of the contexts where they have been found (e.g., specific software origins, branches, commits, …).
Below are some examples of endpoints used to just render the corresponding information for user consumption:
- Display a content from its checksum: /browse/content/sha1:4dfc4478b1d5f7388b298fdfc06802485bdeae0c/
- Display a directory from its sha1_git identifier: /browse/directory/977fc4b98c0e85816348cebd3b12026407c368b6/
(see the documentation to get more details about how it is computed) - Display information about a revision from its sha1_git identifier: /browse/revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/
(see the documentation to get more details about how it is computed) - Display information about a snapshot from its sha1 identifier: /browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/
(see the documentation to get more details about how it is computed)
Where hyperlinks are created when browsing these kind of endpoints, they always point to other context-independent browsing URLs.
Context-dependent browsing
Context-dependent URLs provide information about objects, limited to specific contexts where the objects have been found.
Currently, browsing the Software Heritage objects in the context of an origin is available. Below are some examples of such endpoints:
- Display information about the visits of a software origin:
- Display the latest archived snapshot for a software origin:
- Display a content from an origin: /browse/origin/content/?origin_url=https://github.com/git/git&path=git.c
- Display a directory from an origin: /browse/origin/directory/?origin_url=https://github.com/torvalds/linux&path=net/ethernet
- Display the revision history (aka the commit log) from an origin: /browse/origin/log/?origin_url=https://github.com/Kitware/CMake
