danger 8.0.4

data/lib/danger/danger_core/plugins/dangerfile_local_only_plugin.rb

@@ -0,0 +1,42 @@
+require "danger/plugin_support/plugin"
+
+# Danger
+module Danger
+  # Handles interacting with local only plugin inside a Dangerfile.
+  # It is support pluggin for dry_run command and does not expose any methods.
+  # But you can still use other plugins like git
+  #
+  # @example Check that added lines contains agreed form of words 
+  #
+  #       git.diff.each do |chunk|
+  #         chunk.patch.lines.grep(/^\+/).each do |added_line|
+  #           if added_line.gsub!(/(?<cancel>cancel)(?<rest>[^l[[:space:]][[:punct:]]]+)/i, '>>\k<cancel>-l-\k<rest><<')
+  #             fail "Single 'L' for cancellation-alike words in '#{added_line}'" 
+  #           end
+  #         end
+  #       end
+  #
+  # @see  danger/danger
+  # @tags core, local_only
+  #
+  class DangerfileLocalOnlyPlugin < Plugin
+    # So that this init can fail.
+    def self.new(dangerfile)
+      return nil if dangerfile.env.request_source.class != Danger::RequestSources::LocalOnly
+      super
+    end
+
+    def initialize(dangerfile)
+      super(dangerfile)
+
+      @local_repo = dangerfile.env.request_source
+    end
+
+    # The instance name used in the Dangerfile
+    # @return [String]
+    #
+    def self.instance_name
+      "local_repo"
+    end
+  end
+end

data/lib/danger/danger_core/plugins/dangerfile_messaging_plugin.rb

@@ -0,0 +1,218 @@
+require "danger/danger_core/messages/violation"
+require "danger/danger_core/messages/markdown"
+require "danger/plugin_support/plugin"
+
+module Danger
+  # Provides the feedback mechanism for Danger. Danger can keep track of
+  # messages, warnings, failure and post arbitrary markdown into a comment.
+  #
+  # The message within which Danger communicates back is amended on each run in a session.
+  #
+  # Each of `message`, `warn` and `fail` have a `sticky` flag, `false` by default, which
+  # when `true` means that the message will be crossed out instead of being removed.
+  # If it's not called again on subsequent runs.
+  #
+  # Each of `message`, `warn`, `fail` and `markdown` support multiple passed arguments
+  # @example
+  #
+  # message 'Hello', 'World', file: "Dangerfile", line: 1
+  # warn ['This', 'is', 'warning'], file: "Dangerfile", line: 1
+  # failure 'Ooops', 'bad bad error', sticky: false
+  # markdown '# And', '# Even', '# Markdown', file: "Dangerfile", line: 1
+  #
+  # By default, using `failure` would fail the corresponding build. Either via an API call, or
+  # via the return value for the danger command. Older code examples use `fail` which is an alias
+  # of `failure`, but the default Rubocop settings would have an issue with it.
+  #
+  # You can optionally add `file` and `line` to provide inline feedback on a PR in GitHub, note that
+  # only feedback inside the PR's diff will show up inline. Others will appear inside the main comment.
+  #
+  # It is possible to have Danger ignore specific warnings or errors by writing `Danger: Ignore "[warning/error text]"`.
+  #
+  # Sidenote: Messaging is the only plugin which adds functions to the root of the Dangerfile.
+  #
+  # @example Failing a build
+  #
+  #          failure "This build didn't pass tests"
+  #          failure "Ooops!", "Something bad happened"
+  #          failure ["This is example", "with array"]
+  #
+  # @example Failing a build, and note that on subsequent runs
+  #
+  #          failure("This build didn't pass tests", sticky: true)
+  #
+  # @example Passing a warning
+  #
+  #          warn "This build didn't pass linting"
+  #          warn "Hm...", "This is not really good"
+  #          warn ["Multiple warnings", "via array"]
+  #
+  # @example Displaying a markdown table
+  #
+  #          message = "### Proselint found issues\n\n"
+  #          message << "Line | Message | Severity |\n"
+  #          message << "| --- | ----- | ----- |\n"
+  #          message << "20 | No documentation | Error \n"
+  #          markdown message
+  #
+  #          markdown "### First issue", "### Second issue"
+  #          markdown ["### First issue", "### Second issue"]
+  #
+  # @example Adding an inline warning to a file
+  #
+  #          warn("You shouldn't use puts in your Dangerfile", file: "Dangerfile", line: 10)
+  #
+  #
+  # @see  danger/danger
+  # @tags core, messaging
+  #
+
+  class DangerfileMessagingPlugin < Plugin
+    def initialize(dangerfile)
+      super(dangerfile)
+
+      @warnings = []
+      @errors = []
+      @messages = []
+      @markdowns = []
+    end
+
+    # The instance name used in the Dangerfile
+    # @return [String]
+    #
+    def self.instance_name
+      "messaging"
+    end
+
+    # @!group Core
+    # Print markdown to below the table
+    #
+    # @param    [String, Array<String>] message
+    #           The markdown based message to be printed below the table
+    # @param    [String] file
+    #           Optional. Path to the file that the message is for.
+    # @param    [String] line
+    #           Optional. The line in the file to present the message in.
+    # @return   [void]
+    #
+    def markdown(*markdowns, **options)
+      file = options.fetch(:file, nil)
+      line = options.fetch(:line, nil)
+
+      markdowns.flatten.each do |markdown|
+        @markdowns << Markdown.new(markdown, file, line)
+      end
+    end
+
+    # @!group Core
+    # Print out a generate message on the PR
+    #
+    # @param    [String, Array<String>] message
+    #           The message to present to the user
+    # @param    [Boolean] sticky
+    #           Whether the message should be kept after it was fixed,
+    #           defaults to `false`.
+    # @param    [String] file
+    #           Optional. Path to the file that the message is for.
+    # @param    [String] line
+    #           Optional. The line in the file to present the message in.
+    # @return   [void]
+    #
+    def message(*messages, **options)
+      sticky = options.fetch(:sticky, false)
+      file = options.fetch(:file, nil)
+      line = options.fetch(:line, nil)
+
+      messages.flatten.each do |message|
+        @messages << Violation.new(message, sticky, file, line, type: :message) if message
+      end
+    end
+
+    # @!group Core
+    # Specifies a problem, but not critical
+    #
+    # @param    [String, Array<String>] message
+    #           The message to present to the user
+    # @param    [Boolean] sticky
+    #           Whether the message should be kept after it was fixed,
+    #           defaults to `false`.
+    # @param    [String] file
+    #           Optional. Path to the file that the message is for.
+    # @param    [String] line
+    #           Optional. The line in the file to present the message in.
+    # @return   [void]
+    #
+    def warn(*warnings, **options)
+      sticky = options.fetch(:sticky, false)
+      file = options.fetch(:file, nil)
+      line = options.fetch(:line, nil)
+
+      warnings.flatten.each do |warning|
+        next if should_ignore_violation(warning)
+        @warnings << Violation.new(warning, sticky, file, line, type: :warning) if warning
+      end
+    end
+
+    # @!group Core
+    # Declares a CI blocking error
+    #
+    # @param    [String, Array<String>] message
+    #           The message to present to the user
+    # @param    [Boolean] sticky
+    #           Whether the message should be kept after it was fixed,
+    #           defaults to `false`.
+    # @param    [String] file
+    #           Optional. Path to the file that the message is for.
+    # @param    [String] line
+    #           Optional. The line in the file to present the message in.
+    # @return   [void]
+    #
+    def fail(*failures, **options)
+      sticky = options.fetch(:sticky, false)
+      file = options.fetch(:file, nil)
+      line = options.fetch(:line, nil)
+
+      failures.flatten.each do |failure|
+        next if should_ignore_violation(failure)
+        @errors << Violation.new(failure, sticky, file, line, type: :error) if failure
+      end
+    end
+
+    alias_method :failure, :fail
+
+    # @!group Reporting
+    # A list of all messages passed to Danger, including
+    # the markdowns.
+    #
+    # @visibility hidden
+    # @return     [Hash]
+    def status_report
+      {
+        errors: @errors.map(&:message).clone.freeze,
+        warnings: @warnings.map(&:message).clone.freeze,
+        messages: @messages.map(&:message).clone.freeze,
+        markdowns: @markdowns.clone.freeze
+      }
+    end
+
+    # @!group Reporting
+    # A list of all violations passed to Danger, we don't
+    # anticipate users of Danger needing to use this.
+    #
+    # @visibility hidden
+    # @return     [Hash]
+    def violation_report
+      {
+        errors: @errors.clone.freeze,
+        warnings: @warnings.clone.freeze,
+        messages: @messages.clone.freeze
+      }
+    end
+
+    private
+
+    def should_ignore_violation(message)
+      env.request_source.ignored_violations.include? message
+    end
+  end
+end

data/lib/danger/danger_core/plugins/dangerfile_vsts_plugin.rb

@@ -0,0 +1,191 @@
+# coding: utf-8
+
+require "danger/plugin_support/plugin"
+
+module Danger
+  # Handles interacting with VSTS inside a Dangerfile. Provides a few functions which wrap `pr_json` and also
+  # through a few standard functions to simplify your code.
+  #
+  # @example Warn when a PR is classed as work in progress
+  #
+  #          warn "PR is classed as Work in Progress" if vsts.pr_title.include? "[WIP]"
+  #
+  # @example Declare a PR to be simple to avoid specific Danger rules
+  #
+  #          declared_trivial = (vsts.pr_title + vsts.pr_body).include?("#trivial")
+  #
+  # @example Ensure there is a summary for a PR
+  #
+  #          failure "Please provide a summary in the Pull Request description" if vsts.pr_body.length < 5
+  #
+  # @example Only accept PRs to the develop branch
+  #
+  #          failure "Please re-submit this PR to develop, we may have already fixed your issue." if vsts.branch_for_base != "develop"
+  #
+  # @example Highlight when a celebrity makes a pull request
+  #
+  #          message "Welcome, Danger." if vsts.pr_author == "dangermcshane"
+  #
+  # @example Ensure that all PRs have an assignee
+  #
+  #          warn "This PR does not have any assignees yet." unless vsts.pr_json["reviewers"].length == 0
+  #
+  # @example Send a message with links to a collection of specific files
+  #
+  #          if git.modified_files.include? "config/*.js"
+  #            config_files = git.modified_files.select { |path| path.include? "config/" }
+  #            message "This PR changes #{ vsts.markdown_link(config_files) }"
+  #          end
+  #
+  # @example Highlight with a clickable link if a Package.json is changed
+  #
+  #         warn "#{vsts.markdown_link("Package.json")} was edited." if git.modified_files.include? "Package.json"
+  #
+  # @example Note an issue with a particular line on a file using the #L[num] syntax, e.g. `#L23`
+  #
+  #         linter_json = `my_linter lint "file"`
+  #         results = JSON.parse linter_json
+  #         unless results.empty?
+  #           file, line, warning = result.first
+  #           warn "#{vsts.markdown_link("#{file}#L#{line}")} has linter issue: #{warning}."
+  #         end
+  #
+  #
+  # @see  danger/danger
+  # @tags core, vsts
+  #
+  class DangerfileVSTSPlugin < Plugin
+    # So that this init can fail.
+    def self.new(dangerfile)
+      return nil if dangerfile.env.request_source.class != Danger::RequestSources::VSTS
+      super
+    end
+
+    # The instance name used in the Dangerfile
+    # @return [String]
+    #
+    def self.instance_name
+      "vsts"
+    end
+
+    def initialize(dangerfile)
+      super(dangerfile)
+      @source = dangerfile.env.request_source
+    end
+
+    # @!group VSTS Misc
+    # The hash that represents the PR's JSON. For an example of what this looks like
+    # see the [Danger Fixture'd one](https://raw.githubusercontent.com/danger/danger/master/spec/fixtures/vsts_api/pr_response.json).
+    # @return [Hash]
+    def pr_json
+      @source.pr_json
+    end
+
+    # @!group PR Metadata
+    # The title of the Pull Request.
+    # @return [String]
+    #
+    def pr_title
+      @source.pr_json[:title].to_s
+    end
+
+    # @!group PR Metadata
+    # The body text of the Pull Request.
+    # @return [String]
+    #
+    def pr_description
+      @source.pr_json[:description].to_s
+    end
+    alias pr_body pr_description
+
+    # @!group PR Metadata
+    # The username of the author of the Pull Request.
+    # @return [String]
+    #
+    def pr_author
+      @source.pr_json[:createdBy][:displayName].to_s
+    end
+
+    # @!group PR Commit Metadata
+    # The branch to which the PR is going to be merged into.
+    # @return [String]
+    #
+    def branch_for_base
+      branch_name(:targetRefName)
+    end
+
+    # @!group PR Commit Metadata
+    # A href that represents the current PR
+    # @return [String]
+    #
+    def pr_link
+      repo_path = @source.pr_json[:repository][:remoteUrl].to_s
+      pull_request_id = @source.pr_json[:pullRequestId].to_s
+
+      "#{repo_path}/pullRequest/#{pull_request_id}"
+    end
+
+    # @!group PR Commit Metadata
+    # The branch to which the PR is going to be merged from.
+    # @return [String]
+    #
+    def branch_for_head
+      branch_name(:sourceRefName)
+    end
+
+    # @!group PR Commit Metadata
+    # The base commit to which the PR is going to be merged as a parent.
+    # @return [String]
+    #
+    def base_commit
+      @source.pr_json[:lastMergeTargetCommit][:commitId].to_s
+    end
+
+    # @!group PR Commit Metadata
+    # The head commit to which the PR is requesting to be merged from.
+    # @return [String]
+    #
+    def head_commit
+      @source.pr_json[:lastMergeSourceCommit][:commitId].to_s
+    end
+
+    # @!group VSTS Misc
+    # Returns a list of Markdown links for a file, or files in the head repository.
+    # It returns a string of multiple links if passed an array.
+    # @param    [String or Array<String>] paths
+    #           A list of strings to convert to Markdown links
+    # @param    [Bool] full_path
+    #           Shows the full path as the link's text, defaults to `true`.
+    #
+    # @return [String]
+    #
+    def markdown_link(paths, full_path: true)
+      paths = [paths] unless paths.kind_of?(Array)
+      commit = head_commit
+      repo = pr_json[:repository][:remoteUrl].to_s
+
+      paths = paths.map do |path|
+        path, line = path.split("#L")
+        url_path = path.start_with?("/") ? path : "/#{path}"
+        text = full_path ? path : File.basename(path)
+        url_path.gsub!(" ", "%20")
+        line_ref = line ? "&line=#{line}" : ""
+        create_markdown_link("#{repo}/commit/#{commit}?path=#{url_path}&_a=contents#{line_ref}", text)
+      end
+
+      return paths.first if paths.count < 2
+      paths.first(paths.count - 1).join(", ") + " & " + paths.last
+    end
+
+    private
+
+    def create_markdown_link(href, text)
+      "[#{text}](#{href})"
+    end
+
+    def branch_name(key)
+      repo_matches = @source.pr_json[key].to_s.match(%r{refs\/heads\/(.*)})
+      repo_matches[1] unless repo_matches.nil?
+    end
+  end
+end