LeadTime

Evaluate the lead time of changes - targeted specifically at git commit lead times from commit to deployment time.

Usage

You supply

IEnumerable<(GitCommitHash changeHash, DateTimeOffset shipDate)> In English: a collection of changes and when each shipped. You do not need to supply in-between changes or anything like that, just a set of commit hashes + when that hash was deployed.

Example: You deploy tag-1 on Jan 1, tag-2 on Jan 5, and tag-3 on Jan 10. You supply:

• {tag-1 commit hash}, Jan 1
• {tag-2 commit hash}, Jan 3
• {tag-3 commit hash}, Jan 10

We do

The library handles finding all the changes in between those, collecting them into groups of changes deployed on each date, figuring out when each change was committed and how long it had been between commit and deployment, and creating histograms for each day/week/month.

Code

using (var repository = new Repository(@"c:\MyRepositoryPath")) // From LibGit2Sharp
{
    var all = GitLeadTimeCalculator.Calculate(
        new[]
        {
            // From your deployment history
            ((GitCommitHash) "00000000000000000000000000000000deadbeef", DateTimeOffset.Parse("01/01/2010")),
            ((GitCommitHash) "0000000000000000000000000000000000badbed", DateTimeOffset.Parse("01/10/2010")),
        },
        // How long to group histograms by (depends on your view requirements. Hint - if you want a month use 30.475 days)
        TimeSpan.FromDays(1),
        // In this example, just telling it to snap to days (by using .Date to drop the time part) DateTimeOffset.Parse("01/01/2001") would be a good value as well and if I make any wrapping libraries, will likely be the default
        DateTimeOffset.Now.Date,
        repository);
    
    var orderedDateRanges = all.OrderBy(kvp => kvp.Key);
    foreach (var dateRangeAndHistogram in orderedDateRanges)
    {
        var dateRange = dateRangeAndHistogram.Key;
        var histogram = dateRangeAndHistogram.Value;

        // // [1/21/2020 12:00:00 AM +00:00, 1/22/2020 12:00:00 AM +00:00): [11.16:13:19.7169758 - 11.16:13:19.7169758 - 11.16:13:19.7169758]
        Console.WriteLine($"{dateRange}: {histogram}");
    }
}

Implementation details

Especially if you're trying to modify/reuse the code for non-git purposes or otherwise extend it, it's useful to have a diagram...

Icon

duration designed by Goh H Chin from The Noun Project.