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:

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_post and bfs

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/revision/f1b94134a4b879bc55c3dacdb496690c8ebdc03f/log/
https://archive.softwareheritage.org/browse/revision/d1aa2b3f607b35dc5dbf613b2334b6d243ec2bda/log/