/// <param name="max">Max number of entries to read.</param> /// <returns>All reflog entries in reverse order.</returns> /// <exception cref="IOException"></exception> public IList <Entry> getReverseEntries(int max) { byte[] log; try { log = IO.ReadFully(_logName); } catch (DirectoryNotFoundException) { return(new List <Entry>()); } catch (FileNotFoundException) { return(new List <Entry>()); } int rs = RawParseUtils.prevLF(log, log.Length); var ret = new List <Entry>(); while (rs >= 0 && max-- > 0) { rs = RawParseUtils.prevLF(log, rs); Entry entry = new Entry(log, rs < 0 ? 0 : rs + 2); ret.Add(entry); } return(ret); }
/// <summary> /// Parse the footer lines (e.g. "Signed-off-by") for machine processing. /// <para /> /// This method splits all of the footer lines out of the last paragraph of /// the commit message, providing each line as a key-value pair, ordered by /// the order of the line's appearance in the commit message itself. /// <para /> /// A footer line's key must match the pattern {@code ^[A-Za-z0-9-]+:}, while /// the value is free-form, but must not contain an LF. Very common keys seen /// in the wild are: /// <ul> /// <li>{@code Signed-off-by} (agrees to Developer Certificate of Origin)</li> /// <li>{@code Acked-by} (thinks change looks sane in context)</li> /// <li>{@code Reported-by} (originally found the issue this change fixes)</li> /// <li>{@code Tested-by} (validated change fixes the issue for them)</li> /// <li>{@code CC}, {@code Cc} (copy on all email related to this change)</li> /// <li>{@code Bug} (link to project's bug tracking system)</li> /// </ul> /// </summary> /// <returns> /// Ordered list of footer lines; empty list if no footers found. /// </returns> public IList <FooterLine> GetFooterLines() { byte[] raw = _buffer; int ptr = raw.Length - 1; while (raw[ptr] == '\n') // trim any trailing LFs, not interesting { ptr--; } int msgB = RawParseUtils.commitMessage(raw, 0); var r = new List <FooterLine>(4); Encoding enc = Encoding; while (true) { ptr = RawParseUtils.prevLF(raw, ptr); if (ptr <= msgB) { break; // Don't parse commit headers as footer lines. } int keyStart = ptr + 2; if (raw[keyStart] == '\n') { break; // Stop at first paragraph break, no footers above it. } int keyEnd = RawParseUtils.endOfFooterLineKey(raw, keyStart); if (keyEnd < 0) { continue; // Not a well formed footer line, skip it. } // Skip over the ': *' at the end of the key before the value. // int valStart = keyEnd + 1; while (valStart < raw.Length && raw[valStart] == ' ') { valStart++; } // Value ends at the LF, and does not include it. // int valEnd = RawParseUtils.nextLF(raw, valStart); if (raw[valEnd - 1] == '\n') { valEnd--; } r.Add(new FooterLine(raw, enc, keyStart, keyEnd, valStart, valEnd)); } r.Reverse(); return(r); }