smart_todo 1.4.3 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b21d53a3957ea19430b3726fd82fefeceef262330ead8eb9ef1ef087acd29bb4
-  data.tar.gz: 3927e36c7c059e90613ceec82e8d00efc8c7e6ceceb6183d05a5cd59c466086c
+  metadata.gz: c17d1471d893e5a764dda2fa9adcfc73049b5c5a45d6678feca40104879065fc
+  data.tar.gz: 85411f13bc189f060372e90a72fc1a545cd0030b6f67cf0fd75f1ff97dbeb755
 SHA512:
-  metadata.gz: f92dd70f82426b84d8a651a9963dffbf6b66017c484b25371b68c16495bf2cdb28faba9fdb31a0ab56ffbb5f848f1a877375379c4c94ca946bb16d9630d7d075
-  data.tar.gz: 69aa57c5583a6adba8320783171eeaef3814e9e758c81b3c81bbd455c3d238d72d145be44c5fa6732764d7561beac2c19181f8344462f209346572bb23f6bf3d
+  metadata.gz: bfe190ce26c9b3e65aea86f3d23e40a400c14edcac8c465b361341ac00a7ab7d59498c9c3edda92d7e180659cad96240148bce26dc3a1db77a92ee2e03575204
+  data.tar.gz: f1c0386fbb5346a74c3f9c0c3b6228a9af29a810241793a5f44db5cbe7d7873c24e9dda987b65aff0d4984193be3652bec472431a48407badb2eb7610da506d6

data/.devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/ruby
+{
+	"name": "Ruby",
+	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+	"image": "mcr.microsoft.com/devcontainers/ruby:0-3-bullseye",
+	"features": {
+		"ghcr.io/devcontainers/features/github-cli:1": {}
+	},
+
+	// Features to add to the dev container. More info: https://containers.dev/features.
+	// "features": {},
+
+	// Use 'forwardPorts' to make a list of ports inside the container available locally.
+	// "forwardPorts": [],
+
+	// Use 'postCreateCommand' to run commands after the container is created.
+	"postCreateCommand": "bundle install",
+
+	// Configure tool-specific properties.
+	// "customizations": {},
+
+	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+	// "remoteUser": "root"
+}

data/.github/workflows/build.yml

@@ -12,7 +12,7 @@ jobs:
     name: Ruby ${{ matrix.version }}
     strategy:
       matrix:
-        version: [2.5, 2.6, 2.7, 3.0]
+        version: [3.0, 3.1, 3.2]
 
     steps:
       - uses: actions/checkout@v2
@@ -24,4 +24,3 @@ jobs:
       - name: Run Tests
         run: |
           bundle exec rake test
-

data/.rubocop.yml

@@ -3,5 +3,7 @@ inherit_gem:
 
 AllCops:
   TargetRubyVersion: 3.0
+  NewCops: disable
+  SuggestExtensions: false
   Exclude:
     - vendor/**/*

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    smart_todo (1.4.3)
+    smart_todo (1.6.0)
       rexml
 
 GEM
@@ -13,30 +13,34 @@ GEM
     crack (0.4.5)
       rexml
     hashdiff (1.0.1)
+    json (2.6.3)
     minitest (5.14.4)
-    parallel (1.21.0)
-    parser (3.0.2.0)
+    parallel (1.23.0)
+    parser (3.2.2.3)
       ast (~> 2.4.1)
+      racc
     public_suffix (4.0.6)
-    rainbow (3.0.0)
+    racc (1.7.0)
+    rainbow (3.1.1)
     rake (13.0.6)
-    regexp_parser (2.1.1)
+    regexp_parser (2.8.1)
     rexml (3.2.5)
-    rubocop (1.23.0)
+    rubocop (1.52.1)
+      json (~> 2.3)
       parallel (~> 1.10)
-      parser (>= 3.0.0.0)
+      parser (>= 3.2.2.3)
       rainbow (>= 2.2.2, < 4.0)
       regexp_parser (>= 1.8, < 3.0)
-      rexml
-      rubocop-ast (>= 1.12.0, < 2.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.28.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.13.0)
-      parser (>= 3.0.1.1)
-    rubocop-shopify (2.3.0)
-      rubocop (~> 1.22)
-    ruby-progressbar (1.11.0)
-    unicode-display_width (2.1.0)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.29.0)
+      parser (>= 3.2.1.0)
+    rubocop-shopify (2.14.0)
+      rubocop (~> 1.51)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (2.4.2)
     webmock (3.11.2)
       addressable (>= 2.3.6)
       crack (>= 0.3.2)

data/bin/rubocop

@@ -9,8 +9,10 @@
 #
 
 require "pathname"
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../../Gemfile",
-  Pathname.new(__FILE__).realpath)
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path(
+  "../../Gemfile",
+  Pathname.new(__FILE__).realpath,
+)
 
 bundle_binstub = File.expand_path("../bundle", __FILE__)
 

data/exe/smart_todo

@@ -9,4 +9,4 @@ if ENV["ENABLE_SMART_TODO"] && !ARGV.include?("--dispatcher")
   ARGV << "--dispatcher" << "slack"
 end
 
-SmartTodo::CLI.new.run
+exit SmartTodo::CLI.new.run

data/lib/smart_todo/cli.rb

@@ -9,21 +9,35 @@ module SmartTodo
   class CLI
     def initialize
       @options = {}
+      @errors = []
     end
 
     # @param args [Array<String>]
     def run(args = ARGV)
       paths = define_options.parse!(args)
       validate_options!
+
       paths << "." if paths.empty?
 
       paths.each do |path|
         normalize_path(path).each do |file|
           parse_file(file)
 
-          STDOUT.print(".")
-          STDOUT.flush
+          $stdout.print(".")
+          $stdout.flush
+        end
+      end
+
+      if @errors.empty?
+        0
+      else
+        $stderr.puts "There were errors while checking for TODOs:\n"
+
+        @errors.each do |error|
+          $stderr.puts error
         end
+
+        1
       end
     end
 
@@ -71,8 +85,17 @@ module SmartTodo
         event_message = nil
         event_met = todo_node.metadata.events.find do |event|
           event_message = Events.public_send(event.method_name, *event.arguments)
+        rescue => e
+          message = "Error while parsing #{file} on event `#{event.method_name}` with arguments #{event.arguments}: " \
+            "#{e.message}"
+
+          @errors << message
+
+          nil
         end
 
+        @errors.concat(todo_node.metadata.errors)
+
         dispatcher.new(event_message, todo_node, file, @options).dispatch if event_met
       end
     end

data/lib/smart_todo/dispatchers/base.rb

@@ -3,29 +3,31 @@
 module SmartTodo
   module Dispatchers
     class Base
-      # Factory pattern to retrive the right dispatcher class.
-      #
-      # @param dispatcher [String]
-      #
-      # @return [Class]
-      def self.class_for(dispatcher)
-        case dispatcher
-        when "slack"
-          Slack
-        when nil, "output"
-          Output
+      class << self
+        # Factory pattern to retrieve the right dispatcher class.
+        #
+        # @param dispatcher [String]
+        #
+        # @return [Class]
+        def class_for(dispatcher)
+          case dispatcher
+          when "slack"
+            Slack
+          when nil, "output"
+            Output
+          end
         end
-      end
 
-      # Subclasses should define what options from the CLI they need in order
-      # to properly deliver the message. For instance the Slack dispatcher
-      # requires an API key.
-      #
-      # @param _options [Hash]
-      #
-      # @return void
-      def self.validate_options!(_options)
-        raise(NotImplemetedError, "subclass responsability")
+        # Subclasses should define what options from the CLI they need in order
+        # to properly deliver the message. For instance the Slack dispatcher
+        # requires an API key.
+        #
+        # @param _options [Hash]
+        #
+        # @return void
+        def validate_options!(_options)
+          raise(NotImplemetedError, "subclass responsability")
+        end
       end
 
       # @param event_message [String] the success message associated

data/lib/smart_todo/dispatchers/output.rb

@@ -4,7 +4,9 @@ module SmartTodo
   module Dispatchers
     # A simple dispatcher that will output the reminder.
     class Output < Base
-      def self.validate_options!(_); end
+      class << self
+        def validate_options!(_); end
+      end
 
       # @return void
       def dispatch

data/lib/smart_todo/dispatchers/slack.rb

@@ -5,10 +5,12 @@ module SmartTodo
     # Dispatcher that sends TODO reminders on Slack. Assignees can be either individual
     # (using the associated slack email address) or a channel.
     class Slack < Base
-      def self.validate_options!(options)
-        options[:slack_token] ||= ENV.fetch("SMART_TODO_SLACK_TOKEN") { raise(ArgumentError, "Missing :slack_token") }
+      class << self
+        def validate_options!(options)
+          options[:slack_token] ||= ENV.fetch("SMART_TODO_SLACK_TOKEN") { raise(ArgumentError, "Missing :slack_token") }
 
-        options.fetch(:fallback_channel) { raise(ArgumentError, "Missing :fallback_channel") }
+          options.fetch(:fallback_channel) { raise(ArgumentError, "Missing :fallback_channel") }
+        end
       end
 
       # Make a Slack API call to dispatch the message to each assignee
@@ -35,7 +37,7 @@ module SmartTodo
 
         client.post_message(user.dig("user", "id"), slack_message(user, assignee))
       rescue SlackClient::Error => error
-        if ["users_not_found", "channel_not_found"].include?(error.error_code)
+        if ["users_not_found", "channel_not_found", "is_archived"].include?(error.error_code)
           user = { "user" => { "id" => @options[:fallback_channel] }, "fallback" => true }
         else
           raise(error)

data/lib/smart_todo/events/date.rb

@@ -6,20 +6,22 @@ module SmartTodo
   module Events
     # An event that check if the passed date is passed
     class Date
-      # @param on_date [String] a string parsable by Time.parse
-      # @return [String, false]
-      def self.met?(on_date)
-        if Time.now >= Time.parse(on_date)
-          message(on_date)
-        else
-          false
+      class << self
+        # @param on_date [String] a string parsable by Time.parse
+        # @return [String, false]
+        def met?(on_date)
+          if Time.now >= Time.parse(on_date)
+            message(on_date)
+          else
+            false
+          end
         end
-      end
 
-      # @param on_date [String]
-      # @return [String]
-      def self.message(on_date)
-        "We are past the *#{on_date}* due date and your TODO is now ready to be addressed."
+        # @param on_date [String]
+        # @return [String]
+        def message(on_date)
+          "We are past the *#{on_date}* due date and your TODO is now ready to be addressed."
+        end
       end
     end
   end

data/lib/smart_todo/events/issue_close.rb

@@ -11,6 +11,11 @@ module SmartTodo
     # If the Pull Request or Issue is on a private repository, exporting a token
     # with the `repos` scope in the +SMART_TODO_GITHUB_TOKEN+ environment variable
     # is required.
+    #
+    # You can also set a per-org or per-repo token by exporting more specific environment variables:
+    # +SMART_TODO_GITHUB_TOKEN__<ORG>+ and +SMART_TODO_GITHUB_TOKEN__<ORG>__<REPO>+
+    # The +<ORG>+ and +<REPO>+ parts should be uppercased and use underscores.
+    # For example, +Shopify/my-repo+ would become +SMART_TODO_GITHUB_TOKEN__SHOPIFY__MY_REPO=...+.
     class IssueClose
       TOKEN_ENV = "SMART_TODO_GITHUB_TOKEN"
 
@@ -78,8 +83,30 @@ module SmartTodo
       # @return [Hash]
       def default_headers
         { "Accept" => "application/vnd.github.v3+json" }.tap do |headers|
-          headers["Authorization"] = "token #{ENV[TOKEN_ENV]}" if ENV[TOKEN_ENV]
+          token = authorization_token
+          headers["Authorization"] = "token #{token}" if token
+        end
+      end
+
+      # @return [String, nil]
+      def authorization_token
+        # Will look in order for:
+        # SMART_TODO_GITHUB_TOKEN__ORG__REPO
+        # SMART_TODO_GITHUB_TOKEN__ORG
+        # SMART_TODO_GITHUB_TOKEN
+        parts = [
+          TOKEN_ENV,
+          @organization.upcase.gsub(/[^A-Z0-9]/, "_"),
+          @repo.upcase.gsub(/[^A-Z0-9]/, "_"),
+        ]
+
+        (parts.size - 1).downto(0).each do |i|
+          key = parts[0..i].join("__")
+          token = ENV[key]
+          return token unless token.nil? || token.empty?
         end
+
+        nil
       end
     end
   end

data/lib/smart_todo/events/ruby_version.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module SmartTodo
+  module Events
+    # An event that checks the currently installed ruby version.
+    # @example
+    #   RubyVersion.new(['>= 2.3', '< 3'])
+    class RubyVersion
+      def initialize(requirements)
+        @requirements = Gem::Requirement.new(requirements)
+      end
+
+      # @param requirements [Array<String>] a list of version specifiers
+      # @return [String, false]
+      def met?
+        if @requirements.satisfied_by?(Gem::Version.new(installed_ruby_version))
+          message(installed_ruby_version)
+        else
+          false
+        end
+      end
+
+      # @param installed_ruby_version [String], requirements [String]
+      # @return [String]
+      def message(installed_ruby_version)
+        "The currently installed version of Ruby #{installed_ruby_version} is #{@requirements}."
+      end
+
+      private
+
+      def installed_ruby_version
+        RUBY_VERSION
+      end
+    end
+  end
+end

data/lib/smart_todo/events.rb

@@ -66,5 +66,13 @@ module SmartTodo
     def pull_request_close(organization, repo, pr_number)
       IssueClose.new(organization, repo, pr_number, type: "pulls").met?
     end
+
+    # Check if the installed ruby version meets requirements.
+    #
+    # @param requirements [Array<String>] a list of version specifiers
+    # @return [false, String]
+    def ruby_version(*requirements)
+      RubyVersion.new(requirements).met?
+    end
   end
 end

data/lib/smart_todo/parser/metadata_parser.rb

@@ -18,10 +18,12 @@ module SmartTodo
 
     # This class is used to parse the ruby TODO() comment.
     class MetadataParser < Ripper
-      # @param source [String] the actual Ruby code
-      def self.parse(source)
-        sexp = new(source).parse
-        Visitor.new.tap { |v| v.process(sexp) }
+      class << self
+        # @param source [String] the actual Ruby code
+        def parse(source)
+          sexp = new(source).parse
+          Visitor.new.tap { |v| v.process(sexp) }
+        end
       end
 
       # @return [Array] an Array of Array
@@ -35,7 +37,7 @@ module SmartTodo
       # @param args [Array]
       # @return [Array, MethodNode]
       def on_method_add_arg(method, args)
-        if method == "TODO"
+        if method.start_with?(/TODO\W?/)
           args
         else
           MethodNode.new(method, args)
@@ -78,11 +80,12 @@ module SmartTodo
     end
 
     class Visitor
-      attr_reader :events, :assignees
+      attr_reader :events, :assignees, :errors
 
       def initialize
         @events = []
         @assignees = []
+        @errors = []
       end
 
       # Iterate over each tokens returned from the parser and call
@@ -104,9 +107,11 @@ module SmartTodo
       # @param method_node [MethodNode]
       # @return [void]
       def on_todo_event(method_node)
-        return unless method_node.is_a?(MethodNode)
-
-        events << method_node
+        if method_node.is_a?(MethodNode)
+          events << method_node
+        else
+          errors << "Incorrect `:on` event format: #{method_node}"
+        end
       end
 
       # @param assignee [String]

data/lib/smart_todo/slack_client.rb

@@ -82,7 +82,7 @@ module SmartTodo
       slack_response!(response)
     end
 
-    # Chech if the response to Slack was a 200 and the Slack API request was successful
+    # Check if the response to Slack was a 200 and the Slack API request was successful
     #
     # @param response [Net::HTTPResponse] a net Net::HTTPResponse subclass
     #   (Net::HTTPOK, Net::HTTPNotFound ...)
@@ -92,6 +92,7 @@ module SmartTodo
     # @raise [SlackClient::Error] in case Slack returns a { ok: false } in the body
     def slack_response!(response)
       raise(Net::HTTPError.new("Request to slack failed", response)) unless response.code_type < Net::HTTPSuccess
+
       body = JSON.parse(response.body)
 
       if body["ok"]

data/lib/smart_todo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SmartTodo
-  VERSION = "1.4.3"
+  VERSION = "1.6.0"
 end

data/lib/smart_todo.rb

@@ -18,6 +18,7 @@ module SmartTodo
     autoload :GemBump,                "smart_todo/events/gem_bump"
     autoload :GemRelease,             "smart_todo/events/gem_release"
     autoload :IssueClose,             "smart_todo/events/issue_close"
+    autoload :RubyVersion,            "smart_todo/events/ruby_version"
   end
 
   module Dispatchers

data/lib/smart_todo_cop.rb

@@ -18,8 +18,12 @@ module RuboCop
         def investigate(processed_source)
           processed_source.comments.each do |comment|
             next unless /^#\sTODO/ =~ comment.text
+
             metadata = metadata(comment.text)
-            if !smart_todo?(metadata)
+
+            if metadata.errors.any?
+              add_offense(comment, message: "Invalid TODO format: #{metadata.errors.join(", ")}. #{HELP}")
+            elsif !smart_todo?(metadata)
               add_offense(comment)
             elsif (methods = invalid_event_methods(metadata.events)).any?
               add_offense(comment, message: "Invalid event method(s): #{methods.join(", ")}. #{HELP}")

data/smart_todo.gemspec

@@ -24,6 +24,8 @@ Gem::Specification.new do |spec|
   spec.metadata["changelog_uri"] = spec.homepage + "/releases"
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
 
+  spec.required_ruby_version = ">= 3.0.0"
+
   spec.files = Dir.chdir(File.expand_path("..", __FILE__)) do
     %x(git ls-files -z).split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smart_todo
 version: !ruby/object:Gem::Version
-  version: 1.4.3
+  version: 1.6.0
 platform: ruby
 authors:
 - Shopify
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-10 00:00:00.000000000 Z
+date: 2023-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rexml
@@ -91,6 +91,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".devcontainer/devcontainer.json"
 - ".github/workflows/build.yml"
 - ".github/workflows/cla.yml"
 - ".github/workflows/rubocop.yml"
@@ -117,6 +118,7 @@ files:
 - lib/smart_todo/events/gem_bump.rb
 - lib/smart_todo/events/gem_release.rb
 - lib/smart_todo/events/issue_close.rb
+- lib/smart_todo/events/ruby_version.rb
 - lib/smart_todo/parser/comment_parser.rb
 - lib/smart_todo/parser/metadata_parser.rb
 - lib/smart_todo/parser/todo_node.rb
@@ -142,14 +144,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.4.16
 signing_key: 
 specification_version: 4
 summary: Enhance todo's comments in your codebase.