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_type (string) – used internally to associate a software origin type (possible values are git, svn, hg, deb, pypi, ftp or deposit) to the revision
  • origin_url (string) – used internally to associate an origin url (e.g. https://github.com/user/repo) to the revision
  • timestamp (string) – used internally to associate an origin visit to the revision, must be a date string (any format parsable by dateutil.parser.parse) or Unix timestamp to parse in order to find the closest visit.
  • visit_id (int) – used internally to specify a visit id instead of using the provided timestamp
  • path (string) – used internally when navigating in the source tree associated to the revision
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/