chelsea 0.0.28 → 0.0.33

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d6bcb375015c64ae7e452f93e38b10cfabb4ecbc9425fad0121e926a0148efa
-  data.tar.gz: f1a171d3a72a0bf910ac4e22258cee6a0d6c3e8181307856a34a5b22ca0435c7
+  metadata.gz: e55c549e9821f6a1f72a2dd5104a3d94c9d6acf2e0ba811161dfa6130cd6ac68
+  data.tar.gz: 23c18257b6393cc3071879aed9ca9469ecc19a616622ba0aa24a48e575319364
 SHA512:
-  metadata.gz: decb1e4e8a54798161b2e888e1694d9558ba0bbacd6708c6cf32d4b71b32cb05520f017733a18e90dab99c0e2e2be500d3c8b8701b1ff464041ad63ab89ffa74
-  data.tar.gz: 94f91e9b3f248d7a3c494fdba567f832edf38b2e91e75f791ac1d9dace17b285e89d09c43bae25d6faacd0b2a76e5a4bb211acb3153dfc57ea4b581243f5d8d1
+  metadata.gz: 2fc7059979d959e6bb92d87623f6d1c263e5b3ff6d754785de69078d3d13e15436e8298600b788b7df7cf130795021f6e9a1007c6c1f155d18ed1d3bc009ec3f
+  data.tar.gz: 92dce470a6ac4affb76140428d8ae1d03f0ab730055b8e7a69bd6a679c8ad5aba9c9b164d8489242d59c934a3cad2cc65cdedda83de22e94f642914fc1508992

data/.circleci/config.yml

@@ -87,7 +87,7 @@ jobs:
           command: git config --global user.email "$GITHUB_EMAIL"
       - run:
           name: Set git upstream
-          command: git branch -u origin/master
+          command: git branch -u origin/main
       - run:
           name: Bump version
           command: gem bump -v patch --tag --skip-ci --push
@@ -107,4 +107,4 @@ workflows:
           filters:
             branches:
               only: 
-                - master
+                - main

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    chelsea (0.0.27)
+    chelsea (0.0.32)
       bundler (>= 1.2.0, < 3)
       ox (~> 2.13.2)
       pastel (~> 0.7.2)
@@ -14,7 +14,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     ast (2.4.2)
     byebug (11.1.2)
@@ -23,31 +23,31 @@ GEM
     diff-lcs (1.3)
     domain_name (0.5.20190701)
       unf (>= 0.0.5, < 1.0.0)
-    equatable (0.6.1)
+    equatable (0.7.0)
     hashdiff (1.0.1)
-    http-cookie (1.0.3)
+    http-cookie (1.0.4)
       domain_name (~> 0.5)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
-    mime-types-data (3.2020.0512)
-    necromancer (0.6.0)
+    mime-types-data (3.2021.0225)
+    necromancer (0.7.0)
     netrc (0.11.0)
     ox (2.13.4)
     parallel (1.20.1)
-    parser (3.0.0.0)
+    parser (3.0.1.0)
       ast (~> 2.4.1)
     pastel (0.7.4)
       equatable (~> 0.6)
       tty-color (~> 0.5)
-    public_suffix (4.0.3)
+    public_suffix (4.0.6)
     rainbow (3.0.0)
     rake (12.3.3)
-    regexp_parser (2.0.3)
+    regexp_parser (2.1.1)
     rest-client (2.0.2)
       http-cookie (>= 1.0.2, < 2.0)
       mime-types (>= 1.16, < 4.0)
       netrc (~> 0.8)
-    rexml (3.2.4)
+    rexml (3.2.5)
     rspec (3.9.0)
       rspec-core (~> 3.9.0)
       rspec-expectations (~> 3.9.0)
@@ -63,7 +63,7 @@ GEM
     rspec-support (3.9.2)
     rspec_junit_formatter (0.4.1)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.9.0)
+    rubocop (1.12.1)
       parallel (~> 1.10)
       parser (>= 3.0.0.0)
       rainbow (>= 2.2.2, < 4.0)
@@ -82,7 +82,7 @@ GEM
       unicode-display_width (~> 1.5)
       unicode_utils (~> 1.4)
     strings-ansi (0.2.0)
-    tty-color (0.5.2)
+    tty-color (0.6.0)
     tty-cursor (0.7.1)
     tty-font (0.5.0)
     tty-screen (0.8.1)
@@ -117,4 +117,4 @@ DEPENDENCIES
   webmock (~> 3.8.3)
 
 BUNDLED WITH
-   2.1.4
+   2.2.22

data/README.md

@@ -17,12 +17,12 @@
 -->
 
 <p align="center">
-    <img src="https://github.com/sonatype-nexus-community/chelsea/blob/master/docs/images/chelsea.png" width="350"/>
+    <img src="https://github.com/sonatype-nexus-community/chelsea/blob/main/docs/images/chelsea.png" width="350" alt="chelsea-icon"/>
 </p>
 <p align="center">
-    <a href="https://rubygems.org/gems/chelsea"><img src="https://img.shields.io/gem/v/chelsea" /></a>
-    <a href="https://gitter.im/sonatype-nexus-community/chelsea?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge"><img src="https://badges.gitter.im/sonatype-nexus-community/chelsea.svg" /></a>
-    <a href="https://circleci.com/gh/sonatype-nexus-community/chelsea"><img src="https://circleci.com/gh/sonatype-nexus-community/chelsea.svg?style=shield" /></a>
+    <a href="https://rubygems.org/gems/chelsea"><img src="https://img.shields.io/gem/v/chelsea" alt="chelsea-gem"/></a>
+    <a href="https://gitter.im/sonatype-nexus-community/chelsea?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge"><img src="https://badges.gitter.im/sonatype-nexus-community/chelsea.svg" alt="chelsea-gitter"/></a>
+    <a href="https://circleci.com/gh/sonatype-nexus-community/chelsea"><img src="https://circleci.com/gh/sonatype-nexus-community/chelsea.svg?style=shield" alt="chelsea-ci"/></a>
 </p>
 
 # Chelsea
@@ -140,7 +140,7 @@ We suggest using [rbenv](https://github.com/rbenv/rbenv) to setup a reliable rub
 Follow the [installation steps](https://github.com/rbenv/rbenv#installation). 
 For macos (10.15.7), there was a problem with step 2, with: `$ rbenv init`. The command 
 printed suggested editing `~/.bashrc`; however, this did not work in our case (even after an OS reboot),
-and we had to instead edit `~/bash_profile`. To sanity check your installation, you should see the 
+and we had to instead edit `~/.bash_profile`. To sanity check your installation, you should see the 
 `.rbenv` directory early in your PATH, e.g.:
 ```
 $ echo $PATH
@@ -161,6 +161,19 @@ Install dependencies:
 ```
 bundle install
 ```
+  * Misc weirdness:
+    I was running into errors like the one below:
+    ```shell
+    $ bundle install
+    Fetching gem metadata from https://rubygems.org/.........
+    chelsea-0.0.32 requires ruby version >= 2.6.6, which is incompatible with the current version, ruby 2.6.3p62
+    ```
+    This was solved by following the steps described [here](https://stackoverflow.com/questions/42306116/ruby-version-x-is-incompatible-with-current-version).
+    ```shell
+    gem install bundler
+    eval "$(rbenv init -)"
+    bundle install
+    ```
 
 Run tests:
 ```
@@ -171,14 +184,275 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ### Release Process
 
-Chelsea is automatically released after a commit to the `master` branch.
+Chelsea is automatically released after a commit to the `main` branch.
 
-To avoid performing a release after a commit to the `master` branch, be sure your commit message includes `[skip ci] `.
+To avoid performing a release after a commit to the `main` branch, be sure your commit message includes `[skip ci] `.
 
 ## Why Chelsea?
 
 One of the awesome developers at Sonatype was thinking of names, and came upon the [Chelsea filter](https://en.wikipedia.org/wiki/Chelsea_filter). A Chelsea filter is used to separate gemstones, helping gemologists distinguish between real emeralds, and just regular green glass. We felt this tool helps you do something very similar, looking at your RubyGems, and seeing which are pristine, and which are less than ok at the moment.
 
+## How to Fix Vulnerabilities
+
+So you've found a vulnerability. Now what? The best case is to upgrade the vulnerable component to a newer/non-vulnerable
+version. However, it is likely the vulnerable component is not a direct dependency, but instead is a transitive dependency
+(a dependency of a dependency, of a dependency, wash-rinse-repeat). In such a case, the first step is to figure out which
+direct dependency (and sub-dependencies) depend on the vulnerable component. 
+
+The `gem dependency` command will show a dependency tree for all gems from the current Gemfile with their dependencies.
+The `bundle outdated` command will show a list of all gems which have newer versions. 
+
+As an example, suppose we've learned that component `rexml`, version 3.2.4 is vulnerable (CVE-2021-28965). 
+Use the following command to determine which components depend on `rexml`.
+```shell
+$ gem dependency -R rexml
+Gem rexml-3.1.9
+  bundler (>= 0, development)
+  rake (>= 0, development)
+  Used by
+    rubocop-1.9.0 (rexml (>= 0))
+
+Gem rexml-3.2.4
+  bundler (>= 0, development)
+  rake (>= 0, development)
+  Used by
+    rubocop-1.9.0 (rexml (>= 0))
+```
+
+There are a number of approaches to resolving the vulnerability, but no matter which approach you choose, you should 
+probably make sure all the tests are passing before making any dependency changes.
+```shell
+bundle exec rspec
+...
+Finished in 0.1411 seconds (files took 0.67222 seconds to load)
+22 examples, 0 failures
+```
+
+One approach is to upgrade everything to the latest version available. This solution might make people nervous about
+introducing breaking changes. (You have unit tested everything right? ;) )
+<details>
+  <summary>Click to expand output of command:
+
+```shell
+$ bundle update 
+```
+  </summary>
+
+```shell
+  $ bundle update
+Fetching gem metadata from https://rubygems.org/.........
+Fetching gem metadata from https://rubygems.org/.
+Resolving dependencies...
+Using rake 12.3.3
+Using public_suffix 4.0.6 (was 4.0.3)
+Using addressable 2.7.0
+Using ast 2.4.2
+Using bundler 2.1.4
+Using byebug 11.1.3 (was 11.1.2)
+Using ox 2.13.4
+Using equatable 0.7.0 (was 0.6.1)
+Using tty-color 0.6.0 (was 0.5.2)
+Using pastel 0.7.4
+Using unf_ext 0.0.7.7
+Using unf 0.1.4
+Using domain_name 0.5.20190701
+Using http-cookie 1.0.3
+Using mime-types-data 3.2021.0225 (was 3.2020.0512)
+Using mime-types 3.3.1
+Using netrc 0.11.0
+Using rest-client 2.0.2
+Using slop 4.8.2
+Using tty-font 0.5.0
+Using tty-cursor 0.7.1
+Using tty-spinner 0.9.3
+Using necromancer 0.7.0 (was 0.6.0)
+Using strings-ansi 0.2.0
+Using unicode-display_width 1.7.0
+Using unicode_utils 1.4.0
+Using strings 0.1.8
+Using tty-screen 0.8.1
+Using tty-table 0.11.0
+Using chelsea 0.0.28 (was 0.0.27) from source at `.`
+Using rexml 3.2.5 (was 3.2.4)
+Using crack 0.4.5 (was 0.4.3)
+Using diff-lcs 1.4.4 (was 1.3)
+Using hashdiff 1.0.1
+Using parallel 1.20.1
+Using parser 3.0.1.0 (was 3.0.0.0)
+Using rainbow 3.0.0
+Using regexp_parser 2.1.1 (was 2.0.3)
+Using rspec-support 3.10.2 (was 3.9.2)
+Using rspec-core 3.10.1 (was 3.9.1)
+Using rspec-expectations 3.10.1 (was 3.9.1)
+Using rspec-mocks 3.10.2 (was 3.9.1)
+Using rspec 3.10.0 (was 3.9.0)
+Using rspec_junit_formatter 0.4.1
+Using rubocop-ast 1.4.1
+Using ruby-progressbar 1.11.0
+Using rubocop 1.12.1 (was 1.9.0)
+Using webmock 3.8.3
+Bundle updated!
+Gems in the group production were not updated.
+```
+</details>
+
+Perhaps a more palatable approach would be to upgrade to a newer version of the "Used by" component, meaning you upgrade
+the direct dependency (`rubocop`) to a version that does not depend on a vulnerable version of the transitive dependency
+(`rexml`). This approach will make fewer changes overall.
+
+In some cases, no such upgrade of the direct dependency exists that avoids a dependence on the vulnerable component. 
+In such a case, the next step is to file an issue with the direct dependency project for them to update the vulnerable
+sub-dependencies. Be sure to read and follow any vulnerability reporting instructions published by the project: Look for
+a `SECURITY.md` file, or other instructions on how to report vulnerabilities. Some projects may prefer you not report 
+the vulnerability publicly.
+
+In our example, there is a newer version of the direct dependency available:
+```shell
+  $ bundle outdated | grep rubocop
+  * rubocop (newest 1.12.1, installed 1.9.0) in group "default"
+```
+Now we can update the `rubocop` component as follows:
+<details>
+  <summary>Click to expand output of command:
+
+```shell
+$ bundle update rubocop
+```
+  </summary>
+
+```shell
+$ bundle update rubocop
+Fetching gem metadata from https://rubygems.org/.........
+Fetching gem metadata from https://rubygems.org/.
+Resolving dependencies...
+Using rake 12.3.3
+Fetching public_suffix 4.0.3
+Installing public_suffix 4.0.3
+Using addressable 2.7.0
+Using ast 2.4.2
+Using bundler 2.1.4
+Fetching byebug 11.1.2
+Installing byebug 11.1.2 with native extensions
+Using ox 2.13.4
+Using equatable 0.6.1
+Using tty-color 0.5.2
+Using pastel 0.7.4
+Using unf_ext 0.0.7.7
+Using unf 0.1.4
+Using domain_name 0.5.20190701
+Using http-cookie 1.0.3
+Using mime-types-data 3.2020.0512
+Using mime-types 3.3.1
+Using netrc 0.11.0
+Using rest-client 2.0.2
+Using slop 4.8.2
+Using tty-font 0.5.0
+Using tty-cursor 0.7.1
+Using tty-spinner 0.9.3
+Using necromancer 0.6.0
+Using strings-ansi 0.2.0
+Using unicode-display_width 1.7.0
+Using unicode_utils 1.4.0
+Using strings 0.1.8
+Using tty-screen 0.8.1
+Using tty-table 0.11.0
+Using chelsea 0.0.28 from source at `.`
+Using safe_yaml 1.0.5
+Fetching crack 0.4.3
+Installing crack 0.4.3
+Fetching diff-lcs 1.3
+```
+</details>
+
+Yet another alternative approach is to upgrade the transitive dependency (`rexml` in our example). 
+
+Use the command below to determine if there is a newer version of the vulnerable component.
+```shell
+  $ bundle outdated | grep rexml
+  * rexml (newest 3.2.5, installed 3.2.4)
+```
+Now we can update the `rexml` component as follows:
+<details>
+  <summary>Click to expand output of command:
+
+```shell
+$ bundle update rexml
+```
+  </summary>
+
+```shell
+$ bundle update rexml
+Fetching gem metadata from https://rubygems.org/.........
+Fetching gem metadata from https://rubygems.org/.
+Resolving dependencies...
+Using rake 12.3.3
+Using public_suffix 4.0.3
+Using addressable 2.7.0
+Using ast 2.4.2
+Using bundler 2.1.4
+Using byebug 11.1.2
+Using ox 2.13.4
+Using equatable 0.7.0 (was 0.6.1)
+Using tty-color 0.6.0 (was 0.5.2)
+Using pastel 0.7.4
+Using unf_ext 0.0.7.7
+Using unf 0.1.4
+Using domain_name 0.5.20190701
+Using http-cookie 1.0.3
+Using mime-types-data 3.2021.0225 (was 3.2020.0512)
+Using mime-types 3.3.1
+Using netrc 0.11.0
+Using rest-client 2.0.2
+Using slop 4.8.2
+Using tty-font 0.5.0
+Using tty-cursor 0.7.1
+Using tty-spinner 0.9.3
+Using necromancer 0.7.0 (was 0.6.0)
+Using strings-ansi 0.2.0
+Using unicode-display_width 1.7.0
+Using unicode_utils 1.4.0
+Using strings 0.1.8
+Using tty-screen 0.8.1
+Using tty-table 0.11.0
+Using chelsea 0.0.28 (was 0.0.27) from source at `.`
+Using safe_yaml 1.0.5
+Using crack 0.4.3
+Using diff-lcs 1.3
+Using hashdiff 1.0.1
+Using parallel 1.20.1
+Using parser 3.0.0.0
+Using rainbow 3.0.0
+Using regexp_parser 2.0.3
+Using rexml 3.2.5 (was 3.2.4)
+Using rspec-support 3.9.2
+Using rspec-core 3.9.1
+Using rspec-expectations 3.9.1
+Using rspec-mocks 3.9.1
+Using rspec 3.9.0
+Using rspec_junit_formatter 0.4.1
+Using rubocop-ast 1.4.1
+Using ruby-progressbar 1.11.0
+Using rubocop 1.9.0
+Using webmock 3.8.3
+Bundle updated!
+Gems in the group production were not updated.
+```
+</details>
+
+Regardless of which approach you choose, you should verify the tests pass after you upgrade dependencies.
+```shell
+bundle exec rspec
+...
+Finished in 0.12826 seconds (files took 0.5069 seconds to load)
+22 examples, 0 failures
+```
+Full disclosure, it turns out that after upgrading `rubocop` (via: `bundle update rubocop`),
+a `# rubocop:disable Layout/LineLength` was no longer needed. 
+Happily, the CI test suite failed and pointed quickly to the fix (just needed to remove `# rubocop`
+disable/enable comments).
+
+Victory! Commit the changes, and we're done. (see [PR: #44](https://github.com/sonatype-nexus-community/chelsea/pull/44))
+
 ## Contributing
 
 We care a lot about making the world a safer place, and that's why we created `chelsea`. If you as well want to speed up the pace of software development by working on this project, jump on in! Before you start work, create a new issue, or comment on an existing issue, to let others know you are!
@@ -187,7 +461,7 @@ This project is intended to be a safe, welcoming space for collaboration, and co
 
 ## Code of Conduct
 
-Everyone interacting in the Chelsea project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/sonatype-nexus-community/chelsea/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Chelsea project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/sonatype-nexus-community/chelsea/blob/main/CODE_OF_CONDUCT.md).
 
 ## The Fine Print
 

data/lib/chelsea/version.rb

@@ -17,5 +17,5 @@
 #
 
 module Chelsea
-  VERSION = '0.0.28'
+  VERSION = '0.0.33'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chelsea
 version: !ruby/object:Gem::Version
-  version: 0.0.28
+  version: 0.0.33
 platform: ruby
 authors:
 - Allister Beharry
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-29 00:00:00.000000000 Z
+date: 2021-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler