hg_fingerprint 0.1.1

Better archive fingerprint file composition.

The hg-fingerprint mercurial plugin does two things:

1. Enhances the archive command with options to control the .hg_archival.txt file in the following ways:

   • Adjust the file name,

   • Change the file format, and

   • Add a timestamp for when the archive was generated.

2. Provides the fingerprint command to output the archive fingerprint file without having to actually do the archive.

Project

• Homepage: https://bitbucket.org/metagriffin/hg-fingerprint

• Bugs: https://bitbucket.org/metagriffin/hg-fingerprint/issues

Supported Formats

The following formats are supported:

• text (the default):

  repo: dca7d15bf04445e0a3136d5ce5cfa034e5cfa034
  node: 6d881282ad46412ead8ad83e074ce451074ce451
  branch: default
  latesttag: blue
  latesttag: moon
  latesttagdistance: 7
  timestamp: 2009-02-13T23:31:30Z

• json (whitespace added for clarity):

  {
    "repo": "dca7d15bf04445e0a3136d5ce5cfa034e5cfa034",
    "node": "6d881282ad46412ead8ad83e074ce451074ce451",
    "branch": "default",
    "latesttags": ["blue", "moon"],
    "latesttagdistance": 7,
    "timestamp": "2009-02-13T23:31:30Z"
  }

• yaml:

  repo: dca7d15bf04445e0a3136d5ce5cfa034e5cfa034
  node: 6d881282ad46412ead8ad83e074ce451074ce451
  branch: default
  latesttags: [blue, moon]
  latesttagdistance: 7
  timestamp: '2009-02-13T23:31:30Z'

• xml (whitespace added for clarity):

  <?xml version='1.0' encoding='UTF-8'?>
  <fingerprint>
    <repo>dca7d15bf04445e0a3136d5ce5cfa034e5cfa034</repo>
    <node>6d881282ad46412ead8ad83e074ce451074ce451</node>
    <branch>default</branch>
    <latesttag>blue</latesttag>
    <latesttag>moon</latesttag>
    <latesttagdistance>7</latesttagdistance>
    <timestamp>2009-02-13T23:31:30Z</timestamp>
  </fingerprint>

Options

The fingerprint plugin adds the following new configuration section:

[fingeprint]

path                    = .hg_archival.txt
format                  = text
timestamp               = true

• path : str, default: ‘.hg_archival.txt’

  The path, within the archive, to store the fingerprint in. The results are undefined if the path already exists.

• format : str, default: ‘text’

  The file format to store the fingerprint in.

• timestamp : bool, default: true

  Whether or not to store the archive generation timestamp in the fingerprint in ISO 8601 date-time format. Note that this is the only value whose default alters the standard way the archive command works – this is because it is additive, and should therefore have no, or at most minimal, impact.