gh-review-stats

command module
v0.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 6, 2022 License: Apache-2.0 Imports: 1 Imported by: 0

README

gh-review-stats - GitHub Review Stats

A command line tool for examining review statistics for GitHub repositories.

Installing

  1. Download a pre-built binary for your platform from the releases page on GitHub.
  2. Unpack the archive.
  3. Copy the binary to a directory in your $PATH (for example, ~/bin).

Configuration

The default configuration file is ~/.gh-review-stats.yml. The config-gen command can be used to create a skeleton configuration file, or to update the file if new configuration options are added.

$ gh-review-stats config-gen
Using config file: /Users/doc/.gh-review-stats.yml
wrote "/Users/doc/.gh-review-stats.yml"
github.token

The github.token is a personal access token used to access the GitHub API to increase the hourly API call limit.

reviewers.ignore

The reviewers.ignore option is a list of GitHub account names to not include in the output. This is useful for ignoring bot accounts or spammers.

reviewers:
  ignore:
    - "dependabot[bot]"

Reviewer Statistics

The reviewers sub-command generates a report showing the number of comments made across pull requests in a repository by each reviewer.

$ gh-review-stats reviewers --org sphinx-contrib --repo datatemplates
Using config file: /Users/dhellmann/.gh-review-stats.yml
...............................................

2/2: janbrohl
      1: https://github.com/sphinx-contrib/datatemplates/pull/79 [dhellmann] "docs: remove file section from inline example"
      1: https://github.com/sphinx-contrib/datatemplates/pull/77 [dhellmann] "docs: update use instructions"
2/1: dhellmann
      2: https://github.com/sphinx-contrib/datatemplates/pull/77 [dhellmann] "docs: update use instructions"
1/1: kevung
      1: https://github.com/sphinx-contrib/datatemplates/pull/77 [dhellmann] "docs: update use instructions"

The report is formatted as

<total comment count>/<total PR count>: <github name>
      <PR comment count>: <PR URL> [<PR author>] "<PR title>"

Pull Request Statistics

The pull-requests sub-command produces a CSV report with details of pull requests that can be imported into other data analysis tools for processing.

$ gh-review-stats pull-requests -o metal3-io -r metal3-docs
Using config file: /Users/dhellmann/.gh-review-stats.yml
..............................................................................................................................................................
ID,Title,State,Author,URL,Created,Closed,Days to Merge
179,Add andfasano as approver,merged,hardys,https://github.com/metal3-io/metal3-docs/pull/179,2021-04-26,2021-04-26,0
174,Update inspection API proposal status,merged,fmuyassarov,https://github.com/metal3-io/metal3-docs/pull/174,2021-04-01,2021-04-01,0
172,add feruzjon muyassarov as approver,merged,dhellmann,https://github.com/metal3-io/metal3-docs/pull/172,2021-03-19,2021-03-19,0
169,Add update strategy to Metal3DataTemplate,merged,kashifest,https://github.com/metal3-io/metal3-docs/pull/169,2021-03-16,2021-04-01,16
166,Update disabling automated cleaning proposal,merged,fmuyassarov,https://github.com/metal3-io/metal3-docs/pull/166,2021-03-04,2021-03-17,13
164,Add explicit reboot mode options,merged,rdoxenham,https://github.com/metal3-io/metal3-docs/pull/164,2021-02-10,2021-02-24,13
163,Presentations framework proposal with a sample presentation,merged,hroyrh,https://github.com/metal3-io/metal3-docs/pull/163,2021-02-08,2021-04-28,79
162,✨ Proposal: node reuse,merged,furkatgofurov7,https://github.com/metal3-io/metal3-docs/pull/162,2021-02-04,2021-03-10,34
161,design: support automatic secure boot,merged,dtantsur,https://github.com/metal3-io/metal3-docs/pull/161,2021-02-02,2021-02-12,10
155,Add proposal for supporting external introspection,merged,hardys,https://github.com/metal3-io/metal3-docs/pull/155,2021-01-06,2021-03-19,71
152,Proposal for new parameters: Disk and NIC in HWCC,merged,Ashughorla,https://github.com/metal3-io/metal3-docs/pull/152,2020-12-16,2021-03-09,83
149,Add design proposal for label sync mechanism between BMHs and K Nodes,merged,Arvinderpal,https://github.com/metal3-io/metal3-docs/pull/149,2020-11-09,2021-02-17,100
147,Support for new parameters in HWCC.,merged,Ashughorla,https://github.com/metal3-io/metal3-docs/pull/147,2020-10-30,2021-03-09,130
138,design: add sub-states,merged,dtantsur,https://github.com/metal3-io/metal3-docs/pull/138,2020-09-21,2021-02-10,141

Pull Request History

The pr-history sub-command produces a log of the events associated with the pull requests given as input. It then summarizes the events to show which users were most active and which dates had the most activity.

$ gh-review-stats pr-history -o dhellmann -r gh-review-stats 3 4
Using config file: /Users/dhellmann/.gh-review-stats.yml
Sun May  9: #3 updated by Doug Hellmann
Sun May  9: #3 opened by dhellmann "Add GitHub actions for build and test" (https://github.com/dhellmann/gh-review-stats/pull/3)
Sun May  9: #3 updated by Doug Hellmann
Sun May  9: #3 merged after 0 days "Add GitHub actions for build and test" (https://github.com/dhellmann/gh-review-stats/pull/3)
Sun May  9: #4 opened by dhellmann "add markdownlint action" (https://github.com/dhellmann/gh-review-stats/pull/4)
Sun May  9: #4 updated by Doug Hellmann
Sun May  9: #4 updated by Doug Hellmann
Sun May  9: #4 updated by Doug Hellmann
Sun May  9: #4 merged after 0 days "add markdownlint action" (https://github.com/dhellmann/gh-review-stats/pull/4)

Number of Engaged Days
Doug Hellmann: 1
dhellmann: 1

Engagement by Day
2021-05-09:   9 ************************************************************

Documentation

Overview

Copyright © 2021 Doug Hellmann <doug@doughellmann.com>

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL