how_is 24.0.0 → 25.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 929a77a2520bd87d7067b5b9e0af99199d8d45f16056f105e3cdefc9da7475b5
-  data.tar.gz: d49f3e59bc73ea1b2edd90ca0524e1c38c0e619b29795e57005973652adf8b37
+  metadata.gz: 1ac0ac76cee46ed40ee1b30ea3bc0fff1d2697c392739bee78914037db2b8363
+  data.tar.gz: e30ca45420ea7e194521ab801f783363e4e8d62f1e5dc18bffbb0f5b90876ded
 SHA512:
-  metadata.gz: 0c731eb03f270014a8b48bbeb5fa24b5cb1e5602ae700f58ba9ab72b47afee5a3fa645b9fb191717ceea5457610752510e9909c4c0feafc8383e6cedb52c56fe
-  data.tar.gz: b026dcd32d434658c9b4acfd7679d2971adbb0a72c1523198f98f8940afd9f47626f9d1b854f2670d2f7ebb458c03188494aacffce4d30676a5fead0088f975b
+  metadata.gz: 9201750e11232cb08a17f48a7a4df7b8109dc7dd0655dfdadf6860c78661b117447654dd07d67c1cbcbbd730ce318b83395140fa69d45824875dd26e4308876b
+  data.tar.gz: 27a3ba1808a832a240a65214633e1599322aca4664eb4deb36adea33596c7e6a13ccca075f0b3b8f7e46d690547ffbcac4ba7c209cc629d82c1b4d0d0fd2a288

data/.github_changelog_generator

@@ -1,3 +1,2 @@
 user=how-is
 project=how_is
-

data/.rubocop.yml

@@ -1,29 +1,30 @@
-inherit_from: .rubocop_todo.yml
-
 AllCops:
   DisplayCopNames: true
   DisplayStyleGuide: true
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.4
   Exclude:
     - 'how_is.gemspec'
     - 'bin/*'
     - '**/*~'
     - 'spec/capture_warnings.rb'
-    - 'lib/how_is/cli.rb' # FIXME: Make HowIs::CLI.parse not a disaster.
 
 # Exceptions should inherit from StandardError.
 # (RuboCop default is to inherit from RuntimeError.)
 Lint/InheritException:
   EnforcedStyle: standard_error
 
+Metrics/AbcSize:
+  Max: 17
+
 Metrics/BlockLength:
   Exclude:
     - 'spec/**/*_spec.rb'
 
 
-# The guiding principle of classes is SRP, SRP can't be accurately measured by LoC
-#Metrics/ClassLength:
-#  Max: 1500
+# Getting this back to the default of 100 would be nice,
+# but the few cases that exceed it don't seem overly concerning.
+Metrics/ClassLength:
+  Max: 130
 
 # Still try for 80, but we'll allow 110 because there's a not-insignificant
 # number of cases where we have long lines.
@@ -36,7 +37,7 @@ Metrics/LineLength:
 # Too short methods lead to extraction of single-use methods, which can make
 # the code easier to read (by naming things), but can also clutter the class
 Metrics/MethodLength:
-  Max: 20
+  Max: 25
 
 Style/Alias:
   EnforcedStyle: prefer_alias_method
@@ -77,6 +78,9 @@ Style/BlockDelimiters:
 Style/BracesAroundHashParameters:
   Enabled: false
 
+Style/ConditionalAssignment:
+  Enabled: false
+
 # Don't force use of Time or Date; DateTime is okay.
 Style/DateTime:
   Enabled: false
@@ -112,10 +116,9 @@ Style/FormatStringToken:
   EnforcedStyle: template
 
 # Freeze string literals to future-proof the code.
-# TODO: Enable this always. (Disabled due to not knowing what will happen.)
 Style/FrozenStringLiteralComment:
   Enabled: true
-  #EnforcedStyle: always
+  EnforcedStyle: always
 
 # Mixing hash styles just looks silly.
 # http://www.rubydoc.info/gems/rubocop/RuboCop/Cop/Style/HashSyntax
@@ -162,6 +165,14 @@ Style/PreferredHashMethods:
 Style/MethodCalledOnDoEndBlock:
   Enabled: true
 
+# Indent method calls relative to the receiver, e.g.:
+#   foo \
+#     .bar \
+#     .baz \
+#     .asdf
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented_relative_to_receiver
+
 # Indenting the chained dots beneath each other is not supported by this cop,
 # see https://github.com/bbatsov/rubocop/issues/1633
 Layout/MultilineOperationIndentation:
@@ -172,13 +183,27 @@ Layout/SpaceInsideHashLiteralBraces:
   Enabled: true
   EnforcedStyle: no_space
 
+# I find "foo > 0" more readable than "foo.positive?" personally.
+Style/NumericPredicate:
+  Enabled: false
+
+# https://www.rubydoc.info/gems/rubocop/RuboCop/Cop/Style/RegexpLiteral
+Style/RegexpLiteral:
+  Enabled: false
+
 # Use double quotes everywhere by default.
 Style/StringLiterals:
   EnforcedStyle: double_quotes
 
-# TODO: Maybe make it so you have to do [:foo, :bar] not %i[foo bar]?
+# Prefer [:foo, :bar] over %i[foo bar].
 Style/SymbolArray:
-  Enabled: false
+  Enabled: true
+  EnforcedStyle: brackets
+
+# Prefer ["foo", "bar"] over %w[foo bar].
+Style/WordArray:
+  Enabled: true
+  EnforcedStyle: brackets
 
 # Require parentheses around complex ternary conditions.
 Style/TernaryParentheses:

data/.travis.yml

@@ -1,8 +1,8 @@
 language: ruby
 rvm:
-  - 2.3.3
-  - 2.4.1
-  - 2.5.0
+  - 2.4
+  - 2.5
+  - 2.6
   - ruby-head
 
 matrix:
@@ -10,6 +10,9 @@ matrix:
     - rvm:
       - ruby-head
 
+before_install:
+  - gem install bundler
+
 # See https://bors.tech/documentation/getting-started/
 branches:
   only:

data/CHANGELOG.md

@@ -1,10 +1,66 @@
 # Change Log
 
+## [v25.0.0](https://github.com/how-is/how_is/tree/v25.0.0) (2019-04-26)
+[Full Changelog](https://github.com/how-is/how_is/compare/v24.0.0...v25.0.0)
+
+**Closed issues:**
+
+- Image example of report.html [\#260](https://github.com/how-is/how_is/issues/260)
+- Add ReportCollection\#save\_all [\#257](https://github.com/how-is/how_is/issues/257)
+- Show progress while generating reports [\#255](https://github.com/how-is/how_is/issues/255)
+- Use config file instead of env vars [\#253](https://github.com/how-is/how_is/issues/253)
+- Include new contributors in reports [\#248](https://github.com/how-is/how_is/issues/248)
+- Alternative to "Issues Per Label" section [\#245](https://github.com/how-is/how_is/issues/245)
+- Remove "Issues per Label" section. [\#244](https://github.com/how-is/how_is/issues/244)
+- Refactor how\_is/cli.rb [\#243](https://github.com/how-is/how_is/issues/243)
+- Refactor Sources::Github.basic\_auth [\#241](https://github.com/how-is/how_is/issues/241)
+- Travis CI: Configure HOWIS\_BASIC\_AUTH et al [\#240](https://github.com/how-is/how_is/issues/240)
+- "Issues per label" missing issues. [\#230](https://github.com/how-is/how_is/issues/230)
+- resolve codeclimate issues [\#227](https://github.com/how-is/how_is/issues/227)
+-  no implicit conversion of nil into String \(TypeError\) [\#222](https://github.com/how-is/how_is/issues/222)
+- Document PR process [\#198](https://github.com/how-is/how_is/issues/198)
+- Better visualization of 'Issues Per Label' section [\#152](https://github.com/how-is/how_is/issues/152)
+- Exporting to HTML file returns HTML partial [\#151](https://github.com/how-is/how_is/issues/151)
+- Track data over time [\#111](https://github.com/how-is/how_is/issues/111)
+- group Issues Per Label by category type [\#71](https://github.com/how-is/how_is/issues/71)
+- Use authentication [\#6](https://github.com/how-is/how_is/issues/6)
+
+**Merged pull requests:**
+
+- Version bump to v25.0.0. [\#269](https://github.com/how-is/how_is/pull/269) ([duckinator](https://github.com/duckinator))
+- Multi repo configs [\#268](https://github.com/how-is/how_is/pull/268) ([duckinator](https://github.com/duckinator))
+- Remove dead code. [\#266](https://github.com/how-is/how_is/pull/266) ([duckinator](https://github.com/duckinator))
+- yay documentation! [\#265](https://github.com/how-is/how_is/pull/265) ([duckinator](https://github.com/duckinator))
+- Add caching mechanism to speed up duplicate runs [\#263](https://github.com/how-is/how_is/pull/263) ([jules2689](https://github.com/jules2689))
+- README: Add screenshot [\#261](https://github.com/how-is/how_is/pull/261) ([olleolleolle](https://github.com/olleolleolle))
+- Clean up reports [\#259](https://github.com/how-is/how_is/pull/259) ([duckinator](https://github.com/duckinator))
+- Refactor; support config files. [\#254](https://github.com/how-is/how_is/pull/254) ([duckinator](https://github.com/duckinator))
+- HowIs::CLI refactor [\#252](https://github.com/how-is/how_is/pull/252) ([duckinator](https://github.com/duckinator))
+- update build-debug.rb script [\#251](https://github.com/how-is/how_is/pull/251) ([duckinator](https://github.com/duckinator))
+- update supported Ruby versions [\#250](https://github.com/how-is/how_is/pull/250) ([duckinator](https://github.com/duckinator))
+- Misc cleanup [\#249](https://github.com/how-is/how_is/pull/249) ([duckinator](https://github.com/duckinator))
+- Refactor GitHub authentication [\#247](https://github.com/how-is/how_is/pull/247) ([duckinator](https://github.com/duckinator))
+- Document PR and issue management processes. [\#246](https://github.com/how-is/how_is/pull/246) ([duckinator](https://github.com/duckinator))
+- Skip tests that require an access token if running as a PR build. [\#242](https://github.com/how-is/how_is/pull/242) ([duckinator](https://github.com/duckinator))
+- README: fix typo [\#239](https://github.com/how-is/how_is/pull/239) ([olleolleolle](https://github.com/olleolleolle))
+- Enable the executable flag \(chmod +x\) for bin/setup [\#238](https://github.com/how-is/how_is/pull/238) ([olleolleolle](https://github.com/olleolleolle))
+- Only throw errors for undefined env vars if they're used. [\#237](https://github.com/how-is/how_is/pull/237) ([duckinator](https://github.com/duckinator))
+- README: Drop Gemnasium badge [\#236](https://github.com/how-is/how_is/pull/236) ([olleolleolle](https://github.com/olleolleolle))
+- Rubocop-related cleanup [\#235](https://github.com/how-is/how_is/pull/235) ([duckinator](https://github.com/duckinator))
+- Refactor cli [\#234](https://github.com/how-is/how_is/pull/234) ([duckinator](https://github.com/duckinator))
+- Refactor 2 [\#233](https://github.com/how-is/how_is/pull/233) ([duckinator](https://github.com/duckinator))
+- Fix Rubocop warnings. [\#232](https://github.com/how-is/how_is/pull/232) ([duckinator](https://github.com/duckinator))
+- Refactor [\#231](https://github.com/how-is/how_is/pull/231) ([duckinator](https://github.com/duckinator))
+- Miscellaneous cleanup. [\#229](https://github.com/how-is/how_is/pull/229) ([duckinator](https://github.com/duckinator))
+- CLI Refactor [\#228](https://github.com/how-is/how_is/pull/228) ([duckinator](https://github.com/duckinator))
+- \[WIP\] Collect CI information. [\#226](https://github.com/how-is/how_is/pull/226) ([duckinator](https://github.com/duckinator))
+
 ## [v24.0.0](https://github.com/how-is/how_is/tree/v24.0.0) (2018-03-17)
 [Full Changelog](https://github.com/how-is/how_is/compare/v23.0.0...v24.0.0)
 
 **Merged pull requests:**
 
+- bump version to v24.0.0; add json dependency; add future\_changelog Rake task [\#225](https://github.com/how-is/how_is/pull/225) ([duckinator](https://github.com/duckinator))
 - Improve error output; update README. [\#224](https://github.com/how-is/how_is/pull/224) ([duckinator](https://github.com/duckinator))
 - update .travis.yml. [\#223](https://github.com/how-is/how_is/pull/223) ([duckinator](https://github.com/duckinator))
 

data/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# How to contribute
+
+Want to contribute to HowIs? This document has the information you need
+to make sure the process goes smoothly.
+
+By contributing to this project, you agree to follow our
+[Code of Conduct](https://github.com/how-is/how_is/blob/master/CODE_OF_CONDUCT.md).
+
+## Guidelines
+
+2. New features should be paired with tests.
+3. Ensure your code follows our general code style.
+   * Run `bundle exec rubocop` to check for any violations.
+4. Don't modify the CHANGELOG or version number.
+5. If you need feedback or assistance, feel free to join us on Slack
+   (http://slack.bundler.io/) or open an issue on GitHub
+   (https://github.com/how-is/how_is).
+
+## Getting started
+
+```
+$ bundle install
+$ bundle exec rake test
+```
+
+Then, to run how_is commands, simply run `bundle exec how_is <args>`.
+
+## Issues
+
+HowIs uses the GitHub issue tracker for tracking bugs and feature
+requests.
+
+For more details, including information on the various labels we use, see
+[ISSUES.md](https://github.com/how-is/how_is/blob/master/ISSUES.md).

data/Gemfile

@@ -2,10 +2,14 @@
 
 source "https://rubygems.org"
 
-# how_is only supports Ruby versions receiving general bug fixes ("normal
-# maintenance"). This should be updated when a Ruby version goes into security
-# maintenance. Ruby maintenance: https://www.ruby-lang.org/en/downloads/branches/
-ruby "~> 2.3"
+# how_is only supports Ruby versions under "normal maintenance".
+# This number should be updated when a Ruby version goes into security
+# maintenance.
+#
+# Ruby maintenance info: https://www.ruby-lang.org/en/downloads/branches/
+#
+# NOTE: Update how_is.gemspec when this is updated!
+ruby "~> 2.4"
 
 # Specify your gem's dependencies in how_is.gemspec
 gemspec

data/ISSUES.md

@@ -1,86 +1,62 @@
 # Issue Management
 
-The goal of issue management is to organize the work that needs to be
-done when working on a project, by allowing users to report bugs,
-request features or documentation, and start discussions.
+This document explains what labels on a given issue mean, or to help you
+choose labels for new/updated issues.
 
-To simplify that task, issues have _labels_. The purpose of labels is to
-group issues in ways developers find useful. The obvious examples being
-bug reports and feature requests.
-
-This document is intended as a guide to help you understand what labels
-on a given issue mean, or to help you choose labels for a new issue.
-
-Labels on this repository are grouped, using the section before the
-first colon in an issue name.
-
-Issue groups:
-
-* [(ungrouped)](#ungrouped)
-* [category](#categories)
-* [closed](#closed)
-* [size](#size)
-* [status](#status)
-* [type](#type)
+We use an issue tracker to organize and prioritize work by allowing users
+to report bugs, request features or documentation, and start discussions.
 
 ---
 
-## (ungrouped)
-
-### blocked
-
-An issue which can't be worked on until some other work is finished.
-If an issue has this label, it _should_ (but, unfortunately, may not)
-have an explanation of what other work needs to be done before it can be
-worked on.
-
-### duplicate
+## high priority
 
-A duplicate issue.
+An issue that should be resolved as soon as possible.
 
-### in progress
+## in progress
 
 An issue which is currently being worked on. This should be added when
 someone begins work on an issue.
 
-### ready
+## ready
 
 An issue which is ready to be worked on. This should be removed when
 someone begins work on an issue.
 
-## categories
+## size: large
 
-### category: export
+An issue which is expected to take a large amount of effort to resolve.
 
-Issues relating to exporting reports.
+## size: small
 
-## size
+An issue which is expected to be relatively simple to resolve.
 
-### size: small
+## type: bug report
 
-An issue which should, at least in theory, be relatively simple to
-resolve.
+A bug report.
 
-### size: large
+## type: documentation
 
-An issue which is expected to take a large amount of effort to resolve.
+A request for additional or updated documentation.
 
-### size: here be dragons
+## type: feature request
 
-An issue which is extremely difficult, possibly impossible, to determine
-the actual difficulty of. It could be resolved quickly, or it could grow
-significantly.
+A request for a new feature to be added.
 
-## type
+## type: question/discussion
 
-### type: bug report
+A question or discussion. Issues with this label are likely to not have
+any immediately-actionable tasks.
 
-A bug report.
+When any tasks do arise from an issue with this label, more specific
+issues will likely be opened to replace it.
 
-### type: feature request
+## type: refactoring
 
-A request for a new feature to be added.
+A request for a particular section of code to be refactored.
+
+Including concrete suggestions for smaller areas will likely get these
+issues resolved more quickly.
 
-### type: question
+## type: tests
 
-An issue which is a question or discussion.
+A request for new or improved tests addressing specific situations.

data/README.md

@@ -2,9 +2,9 @@
 [![Travis](https://img.shields.io/travis/how-is/how_is.svg)](https://travis-ci.org/how-is/how_is)
 [![Code Climate](https://img.shields.io/codeclimate/github/how-is/how_is.svg)](https://codeclimate.com/github/how-is/how_is)
 [![Gem](https://img.shields.io/gem/v/how_is.svg)](https://rubygems.org/gems/how_is)
-[![Gemnasium](https://img.shields.io/gemnasium/how-is/how_is.svg)](https://gemnasium.com/github.com/how-is/how_is)
+[Documentation](https://how-is.github.io)
 
-# How is [your repo]?
+# How is [your project]?
 
 `how_is` is tool for generating summaries of the health of a codebase hosted on GitHub. It uses information available from issues and pull requests to provide an overview of a repository and highlight problem areas of the codebase.
 
@@ -18,10 +18,8 @@ If you want to contribute or discuss how_is, you can [join Bundler's slack](http
 
 ## Configuration
 
-HowIs can hit the default API limits for GitHub for even small reports.
-
 To avoid errors due to hitting rate limits, HowIs requires a Personal
-Access Token, which GitHub provides with higher rate limits.
+Access Token for GitHub.
 
 ### Acquiring A Personal Access Token
 
@@ -37,30 +35,27 @@ To acquire a personal access token:
 
 #### Using The Token
 
-You now need to define the `HOWIS_GITHUB_TOKEN` and `HOWIS_BASIC_AUTH`
-variables.
-
-An example of how to do so for the Bash shell is provided below.
-
-Make sure to replaceall instances of `<TOKEN>` with the actual token,
-and `<USERNAME>` with your GitHub username.
+Create a file in `~/.config/how_is/config.yml`:
 
-```bash
-export HOWIS_GITHUB_TOKEN=<TOKEN>
-export HOWIS_BASIC_AUTH="<USERNAME>:<TOKEN>"
+```
+sources/github:
+  username: <USERNAME>
+  token:    <TOKEN>
 ```
 
+Make sure to replace `<TOKEN>` with the actual token, and `<USERNAME>`
+with your GitHub username.
 
 ## Usage
 
 ### Command Line
 
-    $ how_is REPOSITORY DATE [--output OUTPUT_FILENAME]
+    $ how_is --repository REPOSITORY --date DATE [--output OUTPUT_FILENAME]
     # OUTPUT_FILENAME defaults to ./report.html.
 
 or
 
-    $ how_is REPOSITORY --config CONFIG_FILENAME
+    $ how_is --date DATE --config CONFIG_FILENAME
 
 #### Example \#1
 
@@ -72,85 +67,15 @@ December 01 2016, and saves it as `./report-2016-12-01.html`.
 
 #### Example \#2
 
-    $ how_is 2016-12-01 --config some-config.yml
+    $ how_is --date 2016-12-01 --config some-config.yml
 
-Generates the report(s) specified in the config file, for the period
+This generates the report(s) specified in the config file, for the period
 from November 01 2016 to December 01 2016, and saves them in the
 locations specified in the config file.
 
-#### Generating reports from a config file
-
-You can also create a config file and run
-`how_is --config YAML_CONFIG_FILE_PATH`.
-
-E.g., if the config file is `how_is.yml`, you would run
-`how_is --config how_is.yml`.
-
-Below is an example config file, [from the how-is/manual-reports
-repository](https://raw.githubusercontent.com/how-is/manual-reports/gh-pages/how-is-configs/01-rubygems-rubygems.yml).
-
-```yaml
-repository: rubygems/rubygems
-reports:
-  html:
-    directory: rubygems/_posts
-    frontmatter:
-      title: "%{date} Report"
-      layout: default
-    filename: "%{date}-report.html"
-  json:
-    directory: json/rubygems
-    filename: "%{date}.json"
-```
+#### Screenshot
 
-The config file is a YAML file. The two root keys are `repository`
-and `reports`.
-
-`reports` is a hash of key/value pairs, with the keys being the type of report
-("html" or "json") and the values being another hash.
-
-That hash can have the following keys: `directory` (the directory to place the
-report in), `filename` (the format string for filenames), and (optionally)
-`frontmatter`.
-
-`frontmatter` is a set of key/value pairs specifying frontmatter as used by
-various blog engines (e.g. Jekyll), so you can set the title, layout, etc of
-the page.
-
-Every value under `reports` is a format string, so you can do e.g.
-`filename: "%{date}-report.html"` or (under `frontmatter`)
-`title: "%{date} Report"`.
-
-### Ruby API
-
-```ruby
-# Generate an HTML report for rubygems/rubygems, for December 01
-# 2017, and save it to report.html:
-report = HowIs.new("rubygems/rubygems", "2017-12-01").to_html
-report.save_as("report.html")
-
-# Generate a report from a config Hash.
-reports = HowIs.from_config({
-  repository: 'rubygems/rubygems',
-  reports: {
-    html: {
-      directory: '_posts',
-      frontmatter: {
-        title: '%{date} Report',
-        layout: 'default'
-      },
-      filename: "%{date}-report.html"
-    },
-    json: {
-      directory: 'json',
-      filename: '%{date}.json'
-    }
-  }
-}, "2017-12-01")
-# Save all of the rports.
-# This assumes all of the directories the files go in already exist!
-reports.map {|file, report| File.write(file, report) }
-```
+![image](https://user-images.githubusercontent.com/211/55504154-89284180-5650-11e9-9a13-e03e9b83c749.png)
 
 ## Development
 

data/Rakefile

@@ -59,9 +59,9 @@ end
 namespace :generate_reports do
   desc "Generate example HTML reports."
   task :html do
-    %w[
-      how-is/example-repository
-      how-is/example-empty-repository
+    [
+      "how-is/example-repository",
+      "how-is/example-empty-repository",
     ].each do |repo|
       HelperFunctions.generate_report(repo, "html")
     end
@@ -74,31 +74,3 @@ namespace :generate_reports do
 
   task :all => [:html, :json]
 end
-
-desc "List new contributors. Lists committers with no earlier commits then "\
-  "given start_date (as %Y-%m-%d). Defaults to first of current month."
-task :new_contributors, [:user, :repo, :start_date] => [] do |_t, args|
-  require "how_is/contributions"
-  user = args[:user] || "how-is"
-  repo = args[:repo] || "how_is"
-  start_date = args[:start_date] || Time.now.strftime("%Y-%m-01")
-
-  contributions = HowIs::Contributions.new(start_date: start_date,
-                                           user: user,
-                                           repo: repo)
-
-  puts "New committers:"
-  puts contributions.summary
-  puts contributions.new_contributors
-end
-
-desc "Display duration of latest CI build. CI builds supported include Travis."
-task :test_execution_time, [:user, :repo] => [] do |_t, args|
-  require "how_is/builds"
-  user = args[:user] || "how-is"
-  repo = args[:repo] || "how_is"
-  builds = HowIs::Builds.new(user: user, repo: repo)
-
-  puts "Test execution information:"
-  puts builds.summary
-end

data/bin/prerelease-generate-changelog

@@ -8,7 +8,7 @@ SCRIPT_DIR="$(dirname $(readlink -f $0))" # Directory this script is in.
 cd "$SCRIPT_DIR/.."
 
 LAST_RELEASE="$(git tag --list | cut -d 'v' -f 2 | sort -n | tail -n 1)"
-NEXT_RELEASE=$(cat lib/$PROJECT/version.rb | grep '^\s*VERSION\s*' | cut -d '"' -f 2)
+NEXT_RELEASE=$(cat lib/$PROJECT/version.rb | grep '^\s*VERSION\s*=\s*' | cut -d '"' -f 2)
 
 if [ -z "$LAST_RELEASE" ]; then
   echo "error: Could not find latest release using \`git tag --list\`"

data/build-debug.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+
+# frozen_string_literal: true
+
+require "bundler/setup" # to avoid having to do `bundle exec ...`
+require "how_is/sources/ci/travis"
+require "how_is/sources/ci/appveyor"
+require "pp"
+
+travis = HowIs::Sources::CI::Travis.new("rubygems/rubygems", "2018-12-01", "2019-02-01")
+builds = travis.builds
+puts "Number of builds: #{builds.length}"
+puts "First build:      #{builds.first['html_url']} (#{builds.first['started_at'].rfc3339})"
+puts "Last build:       #{builds.last['html_url']} (#{builds.last['started_at'].rfc3339})"
+
+appveyor = HowIs::Sources::CI::Appveyor.new("rubygems/rubygems", "2018-12-01", "2019-02-01")
+builds = appveyor.builds
+puts "Number of builds: #{builds.length}"
+puts "First build:      #{builds.first['html_url']} (#{builds.first['started_at'].rfc3339})"
+puts "Last build:       #{builds.last['html_url']} (#{builds.last['started_at'].rfc3339})"