still_active 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a57769b549262b76ee15993dd903d607864d5a1cb4cefec348c4a0d2f2892b44
+  data.tar.gz: 11212c25c8c4897b8883401e9a6d21f5c76f3275c79d76f48c36dc47c09c2037
+SHA512:
+  metadata.gz: cec9d044f6e894659ae8bb30883fc98e6829d31a87612b0fc8660e2e56165deaeae606e1927fa7e60c6fc51ccd068998444543f9d89f50b2f910f4cc4410dc93
+  data.tar.gz: 5d082234f0e9491b8498b93dd3134546342297869218fe8e9b6d1ca913226aca5e00ad4b6299015f8f11747f59956153804de4b19730107b73a0b08d51e1dc8a

data/.github/workflows/main.yml

@@ -0,0 +1,16 @@
+name: Ruby
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0.2
+        bundler-cache: true
+    - name: Run the default task
+      run: bundle exec rake

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,8 @@
+AllCops:
+  TargetRubyVersion: 3.0.2
+
+inherit_gem:
+  rubocop-shopify: rubocop.yml
+
+Layout/LineLength:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2021-11-06
+
+- Initial release

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in still_active.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+
+gem "rspec", "~> 3.0"

data/Gemfile.lock

@@ -0,0 +1,124 @@
+PATH
+  remote: .
+  specs:
+    still_active (0.1.0)
+      async
+      gems
+      github_api
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    ast (2.4.2)
+    async (1.30.1)
+      console (~> 1.10)
+      nio4r (~> 2.3)
+      timers (~> 4.1)
+    console (1.13.1)
+      fiber-local
+    debug (1.3.4)
+      irb (>= 1.3.6)
+      reline (>= 0.2.7)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.4.4)
+    faraday (1.8.0)
+      faraday-em_http (~> 1.0)
+      faraday-em_synchrony (~> 1.0)
+      faraday-excon (~> 1.1)
+      faraday-httpclient (~> 1.0.1)
+      faraday-net_http (~> 1.0)
+      faraday-net_http_persistent (~> 1.1)
+      faraday-patron (~> 1.0)
+      faraday-rack (~> 1.0)
+      multipart-post (>= 1.2, < 3)
+      ruby2_keywords (>= 0.0.4)
+    faraday-em_http (1.0.0)
+    faraday-em_synchrony (1.0.0)
+    faraday-excon (1.1.0)
+    faraday-httpclient (1.0.1)
+    faraday-net_http (1.0.1)
+    faraday-net_http_persistent (1.2.0)
+    faraday-patron (1.0.0)
+    faraday-rack (1.0.0)
+    fiber-local (1.0.0)
+    gems (1.2.0)
+    github_api (0.19.0)
+      addressable (~> 2.4)
+      descendants_tracker (~> 0.0.4)
+      faraday (>= 0.8, < 2)
+      hashie (~> 3.5, >= 3.5.2)
+      oauth2 (~> 1.0)
+    hashie (3.6.0)
+    io-console (0.5.9)
+    irb (1.3.7)
+      reline (>= 0.2.7)
+    jwt (2.3.0)
+    multi_json (1.15.0)
+    multi_xml (0.6.0)
+    multipart-post (2.1.1)
+    nio4r (2.5.8)
+    oauth2 (1.4.7)
+      faraday (>= 0.8, < 2.0)
+      jwt (>= 1.0, < 3.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    parallel (1.21.0)
+    parser (3.0.2.0)
+      ast (~> 2.4.1)
+    public_suffix (4.0.6)
+    rack (2.2.3)
+    rainbow (3.0.0)
+    rake (13.0.6)
+    regexp_parser (2.1.1)
+    reline (0.2.7)
+      io-console (~> 0.5)
+    rexml (3.2.5)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.1)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.3)
+    rubocop (1.22.3)
+      parallel (~> 1.10)
+      parser (>= 3.0.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml
+      rubocop-ast (>= 1.12.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.12.0)
+      parser (>= 3.0.1.1)
+    rubocop-shopify (2.3.0)
+      rubocop (~> 1.22)
+    ruby-progressbar (1.11.0)
+    ruby2_keywords (0.0.5)
+    thread_safe (0.3.6)
+    timers (4.3.3)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  x86_64-darwin-21
+
+DEPENDENCIES
+  debug
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop
+  rubocop-shopify
+  still_active!
+
+BUNDLED WITH
+   2.2.22

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Sean Floyd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,90 @@
+# StillActive
+
+Identify which of your dependencies are no longer under active development.
+
+## Installation
+
+```bash
+gem install still_active
+```
+
+## Usage
+
+The most important flag is the GitHub OAuth token, without which you will most certainly get rate limited.
+
+```text
+Usage: still_active [options]
+
+        all flags are optional
+
+        --gemfile=GEMFILE            path to gemfile
+        --gems=GEM,GEM2,...          Gem(s)
+        --markdown                   Prints output in markdown format
+        --json                       Prints output in JSON format
+        --github-oauth-token=TOKEN   GitHub OAuth token to make API calls
+        --safe-range-end=YEARS       maximum number of years since last activity to be considered safe
+        --warning-range-start=YEARS  minimum number of years since last activity to be considered worrying
+        --warning-range-end=YEARS    maximum number of years since last activity to be considered worrying
+        --critical-warning-emoji=EMOJI
+        --futurist-emoji=EMOJI
+        --success-emoji=EMOJI
+        --unsure-emoji=EMOJI
+        --warning-emoji=EMOJI
+    -h, --help                       Show this message
+    -v, --version                    Show version
+```
+
+### Examples
+
+```bash
+still_active --json --gems=rails,nokogiri
+```
+
+Will output:
+
+```json
+{"rails":{"latest_version":"6.1.4.1","latest_version_release_date":"2021-08-19 16:27:05 UTC","latest_pre_release_version":"7.0.0.alpha2","latest_pre_release_version_release_date":"2021-09-15 23:16:26 UTC","repository_url":"https://github.com/rails/rails","last_commit_date":"2021-11-06 09:16:40 UTC","ruby_gems_url":"https://rubygems.org/gems/rails"},"nokogiri":{"latest_version":"1.12.5","latest_version_release_date":"2021-09-27 19:03:57 UTC","latest_pre_release_version":"1.12.0.rc1","latest_pre_release_version_release_date":"2021-07-09 20:00:11 UTC","repository_url":"https://github.com/sparklemotion/nokogiri","last_commit_date":"2021-11-06 16:44:55 UTC","ruby_gems_url":"https://rubygems.org/gems/nokogiri"}}
+```
+
+```bash
+# for this gem
+stll_active --github-oauth-token=my-token-here
+```
+
+Outputs:
+
+| gem activity old? | up to date? | name                                                           | version used                                                      | release date | latest version                                                    | release date | latest pre-release version                                           | release date | last commit date                                       |
+| ----------------- | ----------- | -------------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | ----------------------------------------------------------------- | ------------ | -------------------------------------------------------------------- | ------------ | ------------------------------------------------------ |
+|                   | ✅           | [debug](https://github.com/ruby/debug)                         | [1.3.4](https://rubygems.org/gems/debug/versions/1.3.4)           | 2021/10      | [1.3.4](https://rubygems.org/gems/debug/versions/1.3.4)           | 2021/10      | [1.0.0.rc2](https://rubygems.org/gems/debug/versions/1.0.0.rc2)      | 2021/09      | [2021/11](https://github.com/ruby/debug)               |
+|                   | ✅           | [rake](https://github.com/ruby/rake)                           | [13.0.6](https://rubygems.org/gems/rake/versions/13.0.6)          | 2021/07      | [13.0.6](https://rubygems.org/gems/rake/versions/13.0.6)          | 2021/07      | [13.0.0.pre.1](https://rubygems.org/gems/rake/versions/13.0.0.pre.1) | 2019/09      | [2021/07](https://github.com/ruby/rake)                |
+| ⚠️                 | ✅           | [rspec](https://github.com/rspec/rspec)                        | [3.10.0](https://rubygems.org/gems/rspec/versions/3.10.0)         | 2020/10      | [3.10.0](https://rubygems.org/gems/rspec/versions/3.10.0)         | 2020/10      | [3.6.0.beta2](https://rubygems.org/gems/rspec/versions/3.6.0.beta2)  | 2016/12      | [2021/10](https://github.com/rspec/rspec)              |
+|                   | ✅           | [rubocop](https://github.com/rubocop/rubocop)                  | [1.22.3](https://rubygems.org/gems/rubocop/versions/1.22.3)       | 2021/10      | [1.22.3](https://rubygems.org/gems/rubocop/versions/1.22.3)       | 2021/10      | ❓                                                                    | ❓            | [2021/11](https://github.com/rubocop/rubocop)          |
+|                   | ✅           | [rubocop-shopify](https://github.com/Shopify/ruby-style-guide) | [2.3.0](https://rubygems.org/gems/rubocop-shopify/versions/2.3.0) | 2021/10      | [2.3.0](https://rubygems.org/gems/rubocop-shopify/versions/2.3.0) | 2021/10      | ❓                                                                    | ❓            | [2021/11](https://github.com/Shopify/ruby-style-guide) |
+| ❓                 | ❓           | still_active                                                   | 0.1.0                                                             | ❓            | ❓                                                                 | ❓            | ❓                                                                    | ❓            | ❓                                                      |
+
+### Configuration options
+
+- `gemfile_path` uses bundler to detect the Gemfile in your working directory
+- `output_format` is markdown, can be configured to be JSON
+- `critical_warning_emoji` 🚩
+- `futurist_emoji` 🔮
+- `success_emoji` ✅
+- `unsure_emoji` ❓
+- `warning_emoji` ⚠️
+- `safe_range_end` 1 (safe range is by default [0..1])
+- `warning_range_start`  2 (warning range is by default [2..3])
+- `warning_range_end`  3
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: [:spec, :rubocop]

data/bin/console

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "still_active"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require "debug"
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/still_active

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), "../lib"))
+
+require "still_active/cli"
+require "still_active"
+
+StillActive::CLI.new.run(ARGV)

data/lib/helpers/bundler_helper.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module StillActive
+  module BundlerHelper
+    extend self
+
+    def gemfile_dependencies(gemfile_path: StillActive.config.gemfile_path)
+      Bundler::SharedHelpers.set_env("BUNDLE_GEMFILE", File.expand_path(gemfile_path))
+      gemfile_gems = Bundler.definition.dependencies.map(&:name)
+      Bundler
+        .definition
+        .locked_gems
+        .specs
+        .select { |spec| gemfile_gems.include?(spec.name) }
+        .each_with_object([]) { |spec, array| array << { name: spec.name, version: spec.version.version } }
+    end
+  end
+end

data/lib/helpers/emoji_helper.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module StillActive
+  module EmojiHelper
+    extend self
+    def inactive_gem_emoji(result_hash)
+      most_recent_activity = [result_hash.dig(:version_used_release_date), result_hash.dig(:latest_version_release_date),
+                              result_hash.dig(:latest_pre_release_version_release_date),].compact.sort.last
+      return "❓" if most_recent_activity.nil?
+
+      case ((Time.now - most_recent_activity) / ONE_YEAR_IN_SECONDS).ceil
+      when 0..1
+        ""
+      when 2..3
+        "\u26A0\uFE0F"
+      else
+        "\u{1F6A9}"
+      end
+    end
+
+    def using_latest_emoji(using_last_release:, using_last_pre_release:)
+      if using_last_release.nil? && using_last_pre_release.nil?
+        "❓"
+      elsif using_last_release
+        "✅"
+      elsif using_last_pre_release
+        "🔮"
+      else
+        "⚠️"
+      end
+    end
+
+    ONE_YEAR_IN_SECONDS = 3.154e+7
+  end
+end

data/lib/helpers/markdown_helper.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module StillActive
+  module MarkdownHelper
+    extend self
+    def markdown_table_header_line
+      "| gem activity old? | up to date? | name | version used | release date | latest version | release date | latest pre-release version  | release date | last commit date |\n" \
+        "| ----------------- | ----------- | ---- | ------------ | ------------ | -------------- | ------------ | --------------------------- | ------------ | ---------------- |"
+    end
+
+    def markdown_table_body_line(gem_name:, data:)
+      repository_url = data[:repository_url]
+      ruby_gems_url = data[:ruby_gems_url]
+
+      version_used = data.dig(:version_used)
+      version_used_url =
+        if version_used && ruby_gems_url
+          "#{ruby_gems_url}/versions/#{version_used}"
+        end
+      version_used_release_date = data.dig(:version_used_release_date)
+
+      latest_version = data[:latest_version]
+      latest_version_url =
+        if latest_version && ruby_gems_url
+          "#{ruby_gems_url}/versions/#{latest_version}"
+        end
+      latest_version_release_date = data.dig(:latest_version_release_date)
+
+      latest_version_prerelease = data.dig(:latest_pre_release_version)
+      latest_version_prerelease_url =
+        if latest_version_prerelease && ruby_gems_url
+          "#{ruby_gems_url}/versions/#{latest_version_prerelease}"
+        end
+      latest_version_prerelease_date = data.dig(:latest_pre_release_version_release_date)
+
+      last_commit_date = data.dig(:last_commit_date)
+      last_commit_url = repository_url
+
+      inactive_repository_emoji = data.dig(:up_to_date_emoji)
+      using_latest_version_emoji = data.dig(:last_activity_worrying_emoji)
+
+      formatted_name = markdown_url(text: gem_name, url: repository_url)
+
+      formatted_version_used = markdown_url(text: version_used, url: version_used_url)
+      formatted_version_used_date = year_month(version_used_release_date)
+
+      formatted_latest_release_version = markdown_url(text: latest_version, url: latest_version_url)
+      formatted_latest_release_date = year_month(latest_version_release_date)
+
+      formatted_latest_pre_release_version = markdown_url(text: latest_version_prerelease,
+        url: latest_version_prerelease_url)
+      formatted_latest_pre_release_date = year_month(latest_version_prerelease_date)
+
+      formatted_last_commit_date = markdown_url(text: year_month(last_commit_date), url: last_commit_url)
+
+      formatted_markdown_table_line =
+        [
+          inactive_repository_emoji || StillActive.config.unsure_emoji,
+          using_latest_version_emoji || StillActive.config.unsure_emoji,
+          formatted_name,
+          formatted_version_used,
+          formatted_version_used_date || StillActive.config.unsure_emoji,
+          formatted_latest_release_version || StillActive.config.unsure_emoji,
+          formatted_latest_release_date || StillActive.config.unsure_emoji,
+          formatted_latest_pre_release_version || StillActive.config.unsure_emoji,
+          formatted_latest_pre_release_date || StillActive.config.unsure_emoji,
+          formatted_last_commit_date || StillActive.config.unsure_emoji,
+        ]
+          .join(" | ")
+
+      "| #{formatted_markdown_table_line} |"
+    end
+
+    private
+
+    def markdown_url(text:, url:)
+      return text if url.nil?
+
+      "[#{text}](#{url})"
+    end
+
+    def year_month(time_object)
+      return if time_object.nil?
+
+      time_object.strftime("%Y/%m")
+    end
+  end
+end

data/lib/helpers/version_helper.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module StillActive
+  module VersionHelper
+    def find_version(versions:, version_string: nil, pre_release: false)
+      if !version_string.nil?
+        versions.find { |v| v["number"] == version_string }
+      else
+        versions.find { |v| v["prerelease"] == pre_release }
+      end
+    end
+
+    def up_to_date?(version_used:, latest_version: nil, latest_pre_release_version: nil)
+      return nil if latest_version.nil? && latest_pre_release_version.nil?
+
+      version_used = if version_used.is_a?(String)
+        version_used
+      else
+        gem_version(version_hash: version_used)
+      end
+
+      latest_version = if latest_version.is_a?(String)
+        latest_version
+      else
+        gem_version(version_hash: latest_version)
+      end
+      latest_pre_release_version = if latest_pre_release_version.is_a?(String)
+        latest_pre_release_version
+      else
+        gem_version(version_hash: latest_pre_release_version)
+      end
+
+      [latest_version, latest_pre_release_version].include?(version_used)
+    end
+
+    def gem_version(version_hash:)
+      version_hash&.dig("number")
+    end
+
+    def release_date(version_hash:)
+      release_date = version_hash&.dig("created_at")
+
+      Time.parse(release_date) unless release_date.nil?
+    end
+  end
+end

data/lib/still_active/cli.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative "options"
+require_relative "../helpers/bundler_helper"
+require_relative "../helpers/emoji_helper"
+require_relative "../helpers/markdown_helper"
+require_relative "../helpers/version_helper"
+require_relative "workflow"
+require "debug"
+# require "cli/ui"
+
+module StillActive
+  class CLI
+    include VersionHelper
+    def run(args)
+      options = Options.new.parse!(args)
+      if options[:provided_gems]
+        StillActive.config.gems.map! { |gem| { name: gem } }
+      else
+        StillActive.config.gems = BundlerHelper.gemfile_dependencies
+      end
+
+      result = Workflow.call
+      case StillActive.config.output_format
+      when :json
+        puts result.to_json
+      when :markdown
+        puts MarkdownHelper.markdown_table_header_line
+        result.keys.sort.each do |name|
+          result[name].merge!({
+            up_to_date_emoji: EmojiHelper.inactive_gem_emoji(result[name]),
+            last_activity_worrying_emoji: EmojiHelper.using_latest_emoji(
+              using_last_release: up_to_date?(
+                version_used: result[name].dig(:version_used), latest_version: result[name].dig(:latest_version)
+              ),
+              using_last_pre_release: up_to_date?(
+                version_used: result[name].dig(:version_used), latest_version: result[name].dig(:latest_pre_release_version)
+              ),
+            ),
+          })
+
+          puts MarkdownHelper.markdown_table_body_line(gem_name: name, data: result[name])
+        end
+      end
+    end
+  end
+end

data/lib/still_active/config.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "bundler"
+
+module StillActive
+  class Config
+    attr_accessor :critical_warning_emoji, :futurist_emoji, :gemfile_path, :gems, :github_oauth_token, :output_format,
+      :safe_range_end, :safe_range_start, :success_emoji, :unsure_emoji, :warning_emoji, :warning_range_end,
+      :warning_range_start
+
+    def initialize
+      @gemfile_path = Bundler.default_gemfile.to_s
+      @gems = []
+
+      @output_format = :markdown
+
+      @critical_warning_emoji = "🚩"
+      @futurist_emoji = "🔮"
+      @success_emoji = "✅"
+      @unsure_emoji = "❓"
+      @warning_emoji = "⚠️"
+
+      @safe_range_start = 0
+      @safe_range_end = 1
+
+      @warning_range_start = 2
+      @warning_range_end = 3
+    end
+
+    def github_client
+      @github_client ||=
+        Github.new(oauth_token: github_oauth_token)
+    end
+  end
+end

data/lib/still_active/gemfile.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler"
+
+module StillActive
+  module Gemfile
+    extend self
+
+    def dependencies(gemfile_path:)
+      Bundler::SharedHelpers.set_env("BUNDLE_GEMFILE", File.expand_path(gemfile_path))
+      Bundler.definition.dependencies.map(&:name)
+    end
+  end
+end

data/lib/still_active/options.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module StillActive
+  class Options
+    attr_accessor :options, :options_parser
+
+    def initialize
+      @options = {}
+      @options_parser = OptionParser.new do |opts|
+        add_banner(opts)
+        add_tail_options(opts)
+        add_gemfile_option(opts)
+        add_gems_option(opts)
+        add_output_options(opts)
+        add_token_options(opts)
+        add_range_options(opts)
+        add_emoji_options(opts)
+      end
+    end
+
+    def parse!(args)
+      options_parser.parse!(args)
+      validate_options
+      options
+    end
+
+    private
+
+    def validate_options
+      raise ArgumentError, "provide gemfile or gems, not both" if options[:provided_gemfile] && options[:provided_gems]
+    end
+
+    def add_gemfile_option(opts)
+      opts.on("--gemfile=GEMFILE", String, "path to gemfile") do |value|
+        options[:provided_gemfile] = true
+        StillActive.config { |config| config.gemfile_path = value }
+      end
+    end
+
+    def add_gems_option(opts)
+      opts.on("--gems=GEM,GEM2,...", Array, "Gem(s)") do |value|
+        options[:provided_gems] = true
+        StillActive.config { |config| config.gems = value }
+      end
+    end
+
+    def add_output_options(opts)
+      opts.on("--markdown", "Prints output in markdown format") { StillActive.config { |config| config.output_format = :markdown } }
+      opts.on("--json", "Prints output in JSON format") { StillActive.config { |config| config.output_format = :json } }
+    end
+
+    def add_token_options(opts)
+      opts.on("--github-oauth-token=TOKEN", String, "GitHub OAuth token to make API calls") do |value|
+        StillActive.config { |config| config.github_oauth_token = value }
+      end
+    end
+
+    def add_range_options(opts)
+      opts.on("--safe-range-end=YEARS", Integer,
+        "maximum number of years since last activity to be considered safe") do |value|
+        StillActive.config { |config| config.safe_range_end = value }
+      end
+      opts.on("--warning-range-start=YEARS", Integer,
+        "minimum number of years since last activity to be considered worrying") do |value|
+        StillActive.config { |config| config.warning_range_start = value }
+      end
+      opts.on("--warning-range-end=YEARS", Integer,
+        "maximum number of years since last activity to be considered worrying") do |value|
+        StillActive.config { |config| config.warning_range_end = value }
+      end
+    end
+
+    def add_emoji_options(opts)
+      opts.on("--critical-warning-emoji=EMOJI") { |value| StillActive.config { |config| config.critical_warning_emoji = value } }
+      opts.on("--futurist-emoji=EMOJI") { |value| StillActive.config { |config| config.futurist_emoji = value } }
+      opts.on("--success-emoji=EMOJI") { |value| StillActive.config { |config| config.success_emoji = value } }
+      opts.on("--unsure-emoji=EMOJI") { |value| StillActive.config { |config| config.unsure_emoji = value } }
+      opts.on("--warning-emoji=EMOJI") { |value| StillActive.config { |config| config.warning_emoji = value } }
+    end
+
+    def add_banner(opts)
+      opts.banner = <<-BANNER.gsub(/\A\s{8}/, "")
+        Usage: #{opts.program_name} [options]
+
+        all flags are optional
+
+      BANNER
+    end
+
+    def add_tail_options(opts)
+      opts.on_tail("-h", "--help", "Show this message") do
+        puts opts
+        exit
+      end
+      opts.on_tail("-v", "--version", "Show version") do
+        puts StillActive::VERSION
+        exit
+      end
+    end
+  end
+end

data/lib/still_active/repository.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module StillActive
+  module Repository
+    GITHUB_REGEX = %r{(http(?:s)?://(?:www\.)?(github)\.com/((?:\w|_|-)+)/((?:\w|_|-)+))}i
+    GITLAB_REGEX = %r{(http(?:s)?://(?:www\.)?(gitlab)\.com/((?:\w|_|-)+)/((?:\w|_|-)+))}i
+
+    extend self
+
+    def valid?(url:)
+      [GITHUB_REGEX, GITLAB_REGEX].any? do |regex|
+        !url.scan(regex)&.first.nil?
+      end
+    end
+
+    def url_with_owner_and_name(url:)
+      [GITHUB_REGEX, GITLAB_REGEX].each do |regex|
+        values = url&.scan(regex)&.first
+        next if values.nil? || values.empty?
+
+        return [:url, :source, :owner, :name].zip(values).to_h
+      end
+      { source: :unhandled, owner: nil, name: nil }
+    end
+  end
+end

data/lib/still_active/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module StillActive
+  VERSION = "0.1.0"
+end

data/lib/still_active/workflow.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require_relative "repository"
+require_relative "../helpers/version_helper"
+require "async"
+require "async/barrier"
+require "gems"
+require "github_api"
+
+module StillActive
+  module Workflow
+    extend self
+    include VersionHelper
+
+    def call
+      task = Async do
+        barrier = Async::Barrier.new
+        result_object = {}
+        StillActive.config.gems.each_with_object(result_object) do |gem, hash|
+          barrier.async do
+            gem_info(gem_name: gem[:name], result_object: hash, gem_version: gem.dig(:version))
+          end
+        end
+        barrier.wait
+        result_object
+      end
+      task.wait
+    end
+
+    private
+
+    def gem_info(gem_name:, result_object:, gem_version: nil)
+      result_object[gem_name] = {}
+      result_object[gem_name].merge!({
+        version_used: gem_version,
+      }) if gem_version
+
+      vs = versions(gem_name: gem_name)
+      repo_info = repository_info(gem_name: gem_name, versions: vs)
+      last_commit_date = last_commit_date(source: repo_info[:source], repository_owner: repo_info[:owner],
+        repository_name: repo_info[:name])
+      last_release = find_version(versions: vs, pre_release: false)
+      last_pre_release = find_version(versions: vs, pre_release: true)
+      result_object[gem_name].merge!({
+        latest_version: gem_version(version_hash: last_release),
+        latest_version_release_date: release_date(version_hash: last_release),
+
+        latest_pre_release_version: gem_version(version_hash: last_pre_release),
+        latest_pre_release_version_release_date: release_date(version_hash: last_pre_release),
+
+        repository_url: repo_info[:url],
+        last_commit_date: last_commit_date,
+      })
+
+      unless vs.empty?
+        result_object[gem_name].merge!({ ruby_gems_url: "https://rubygems.org/gems/#{gem_name}" })
+      end
+
+      if gem_version
+        version_used = find_version(versions: vs, version_string: gem_version)
+        result_object[gem_name].merge!({
+          # global_warning: global_warning,
+          up_to_date:
+            up_to_date?(
+              version_used: version_used,
+              latest_version: last_release,
+              latest_pre_release_version: last_pre_release
+            ),
+
+          version_used_release_date: release_date(version_hash: version_used),
+        })
+      end
+    rescue StandardError => e
+      puts "error occured for #{gem_name}: #{e.class}\n\t#{e.message}"
+    end
+
+    # makes network request
+    def versions(gem_name:)
+      Gems.versions(gem_name)
+    rescue Gems::NotFound
+      []
+    end
+
+    def repository_info(gem_name:, versions:)
+      # binding.break # if gem_name == "still_active"
+      valid_repository_url =
+        installed_gem_urls(gem_name: gem_name).find { |url| Repository.valid?(url: url) } ||
+        rubygems_versions_repository_url(versions: versions).find { |url| Repository.valid?(url: url) } ||
+        rubygems_gem_repository_url(gem_name: gem_name).find { |url| Repository.valid?(url: url) }
+      Repository.url_with_owner_and_name(url: valid_repository_url)
+    end
+
+    # does not make network requests
+    def installed_gem_urls(gem_name:)
+      info = Gem::Dependency.new(gem_name).matching_specs.first
+      return [] if info.nil?
+
+      [
+        info&.metadata&.dig("source_code_uri"),
+        info&.homepage,
+      ].compact.uniq
+    end
+
+    # does not make network requests
+    def rubygems_versions_repository_url(versions:)
+      versions
+        .map { |version| version.dig("metadata", "source_code_uri") }
+        .compact
+        .uniq
+    end
+
+    # makes network request
+    def rubygems_gem_repository_url(gem_name:)
+      info = Gems.info(gem_name)
+      return [] if info.nil?
+
+      [
+        info["homepage_uri"],
+        info["source_code_uri"],
+      ].compact.uniq
+    rescue Gems::NotFound
+      []
+    end
+
+    # makes network request
+    def last_commit(source:, repository_owner:, repository_name:)
+      case source.to_sym
+      when :github
+        StillActive.config.github_client.repos.commits.all(repository_owner, repository_name, per_page: 1)&.first
+        # when :gitlab
+        #   Gitlab.commits(name, per_page: 1)
+      end
+    end
+
+    # makes network request
+    def last_commit_date(source:, repository_owner:, repository_name:)
+      commit = last_commit(source: source, repository_owner: repository_owner, repository_name: repository_name)
+      case source.to_sym
+      when :github
+        commit&.dig("commit", "author", "date").then { |date| Time.parse(date) unless date.nil? }
+        # when :gitlab
+        #   commit
+      end
+    end
+  end
+end

data/lib/still_active.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "still_active/version"
+require_relative "still_active/config"
+require_relative "still_active/cli"
+
+module StillActive
+  class Error < StandardError; end
+
+  class << self
+    def config
+      @config ||= Config.new
+      if block_given?
+        yield @config
+      else
+        @config
+      end
+    end
+
+    def reset
+      @config = Config.new
+    end
+  end
+end

data/still_active.gemspec

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require_relative "lib/still_active/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "still_active"
+  spec.version       = StillActive::VERSION
+  spec.authors       = ["Sean Floyd"]
+  spec.email         = ["contact@seanfloyd.dev"]
+
+  spec.summary       = "Check if gems are under active development."
+  spec.description   = "Obtain last release, pre-release, and last commit date to determine if a gem is still under active development."
+  spec.homepage      = "https://github.com/SeanLF/still_active."
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.4.0"
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to 'https://mygemserver.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.metadata["source_code_uri"]}/blob/main/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    %x(git ls-files -z).split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{\Abin/still_active}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # For more information and examples about making a new gem, checkout our
+  # guide at: https://bundler.io/guides/creating_gem.html
+  spec.add_development_dependency("debug")
+  spec.add_development_dependency("rubocop")
+  spec.add_development_dependency("rubocop-shopify")
+
+  spec.add_runtime_dependency("async")
+  # spec.add_runtime_dependency("cli-ui")
+  # spec.add_runtime_dependency("async-http")
+  spec.add_runtime_dependency("gems")
+  spec.add_runtime_dependency("github_api")
+  # spec.add_runtime_dependency("gitlab")
+  # spec.add_runtime_dependency("tty-progressbar")
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: still_active
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Sean Floyd
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-11-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-shopify
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gems
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: github_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Obtain last release, pre-release, and last commit date to determine if
+  a gem is still under active development.
+email:
+- contact@seanfloyd.dev
+executables:
+- still_active
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- bin/still_active
+- lib/helpers/bundler_helper.rb
+- lib/helpers/emoji_helper.rb
+- lib/helpers/markdown_helper.rb
+- lib/helpers/version_helper.rb
+- lib/still_active.rb
+- lib/still_active/cli.rb
+- lib/still_active/config.rb
+- lib/still_active/gemfile.rb
+- lib/still_active/options.rb
+- lib/still_active/repository.rb
+- lib/still_active/version.rb
+- lib/still_active/workflow.rb
+- still_active.gemspec
+homepage: https://github.com/SeanLF/still_active.
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/SeanLF/still_active.
+  source_code_uri: https://github.com/SeanLF/still_active.
+  changelog_uri: https://github.com/SeanLF/still_active./blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.30
+signing_key:
+specification_version: 4
+summary: Check if gems are under active development.
+test_files: []