Revision#
- GET /browse/revision/(sha1_git)/#
HTML view to browse a revision. It notably shows the revision date and message but also offers links to get more details on:
its author
its parent revisions
the history log reachable from it
The view also enables to navigate in the source tree associated to the revision and browse its content.
Last but not least, the view displays the list of file changes introduced in the revision but also the diffs of each changed files.
- Parameters:
sha1_git (string) – hexadecimal representation for the sha1_git identifier of a revision
- Query Parameters:
origin_url (string) – used internally to associate an origin url (e.g. user/repo) to the revision
timestamp (string) – an ISO 8601 datetime string to parse in order to find the closest visit.
visit_id (int) – specify a visit id instead of using the provided timestamp
path (string) – optional relative path from the revision root directory
- Status Codes:
200 OK – no error
404 Not Found – requested revision cannot be found in the archive
Examples:
https://archive.softwareheritage.org/browse/revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/ https://archive.softwareheritage.org/browse/revision/d1aa2b3f607b35dc5dbf613b2334b6d243ec2bda/
- GET /browse/revision/(sha1_git)/log/#
HTML view that displays the list of revisions heading to a given one. In other words, it shows a commit log. The following data are displayed for each log entry:
link to browse the revision
author of the revision
date of the revision
message associated to the revision
commit date of the revision
By default, the revisions are ordered in reverse chronological order of their commit date.
N log entries are displayed per page (default is 100). In order to navigate in a large history, two buttons are present at the bottom of the view:
Newer: fetch and display if available the N more recent log entries than the ones currently displayed
Older: fetch and display if available the N older log entries than the ones currently displayed
- Parameters:
sha1_git (string) – hexadecimal representation for the sha1_git identifier of a revision
- Query Parameters:
per_page (int) – the number of log entries to display per page
offset (int) – the number of revisions to skip before returning those to display
revs_ordering (str) – specify the revisions ordering, possible values are
committer_date,dfs,dfs_postandbfs
- Status Codes:
200 OK – no error
404 Not Found – requested revision cannot be found in the archive
Examples:
https://archive.softwareheritage.org/browse/revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/log/ https://archive.softwareheritage.org/browse/revision/d1aa2b3f607b35dc5dbf613b2334b6d243ec2bda/log/