mongoid 7.6.0 → 8.0.1

data/lib/mongoid/errors/eager_load.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Errors
-
-    # This error is raised when attempting to eager load a many to many
-    # association.
-    #
-    # @deprecated No longer used by Mongoid per MONGOID-4841.
-    class EagerLoad < MongoidError
-
-      # Create the new eager load error.
-      #
-      # @example Create the new eager load error.
-      #   EagerLoad.new(:preferences)
-      #
-      # @param [ Symbol ] name The name of the association.
-      def initialize(name)
-        super(compose_message("eager_load", { name: name }))
-      end
-    end
-  end
-end

data/lib/mongoid/errors/invalid_value.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module Mongoid
-  module Errors
-
-    # This error is raised when trying to set an attribute with an invalid value.
-    # For example when try to set an Array value to a Hash attribute.
-    #
-    class InvalidValue < MongoidError
-      def initialize(field_class, value_class)
-        super(
-          compose_message("invalid_value", { value_class: value_class, field_class: field_class  })
-        )
-      end
-    end
-  end
-end

data/spec/mongoid/errors/eager_load_spec.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-require "spec_helper"
-
-describe Mongoid::Errors::EagerLoad do
-
-  describe "#message" do
-
-    let(:error) do
-      described_class.new(:ratable)
-    end
-
-    it "contains the problem in the message" do
-      expect(error.message).to include(
-        "Eager loading :ratable is not supported since it is a polymorphic"
-      )
-    end
-
-    it "contains the summary in the message" do
-      expect(error.message).to include(
-        "Mongoid cannot currently determine the classes it needs to eager"
-      )
-    end
-
-    it "contains the resolution in the message" do
-      expect(error.message).to include(
-        "Don't attempt to perform this action and have patience"
-      )
-    end
-  end
-end

data/spec/shared/CANDIDATE.md

@@ -1,28 +0,0 @@
-# Candidate Tasks
-
-When using the `candidate` rake tasks, you must make sure:
-
-1. You are using at least `git` version 2.49.0.
-2. You have the `gh` CLI tool installed.
-3. You are logged into `gh` with an account that has collaborator access to the repository.
-4. You have run `gh repo set-default` from the root of your local checkout to set the default repository to the canonical MongoDB repo.
-5. The `origin` remote for your local checkout is set to your own fork.
-6. The `upstream` remote for your local checkout is set to the canonical
-   MongoDB repo.
-
-Once configured, you can use the following commands:
-
-1. `rake candidate:prs` - This will list all pull requests that will be included in the next release. Any with `[?]` are unlabelled (or are not labelled with a recognized label). Otherwise, `[b]` means `bug`, `[f]` means `feature`, and `[x]` means `bcbreak`.
-2. `rake candidate:preview` - This will generate and display the release notes for the next release, based on the associated pull requests.
-3. `rake candidate:create` - This will create a new PR against the default repository, using the generated release notes as the description. The new PR will be given the `release-candidate` label.
-
-Then, after the release candidate PR is approved and merged, the release process will automatically bundle, sign, and release the new version.
-
-Once you've merged the PR, you can switch to the "Actions" tab for the repository on GitHub and look for the "Release" workflow (might be named differently), which should have triggered automatically. You can monitor the progress of the release there. If there are any problems, the workflow is generally safe to re-run after you've addressed them.
-
-Things to do after the release succeeds:
-
-1. Copy the release notes from the PR and create a new release announcement on the forums (https://www.mongodb.com/community/forums/c/announcements/driver-releases/110).
-2. If the release was not automatically announced in #ruby, copy a link to the GitHub release or MongoDB forum post there.
-3. Close the release in Jira.
-

data/spec/shared/lib/mrss/release/candidate.rb

@@ -1,281 +0,0 @@
-# frozen_string_literal: true
-
-require 'json'
-
-require_relative 'product_data'
-
-module Mrss
-  module Release
-    class Candidate
-      # Release note section titles, by pr type
-      SECTION_TITLE = {
-        bcbreak: "Breaking Changes",
-        feature: "New Features",
-        bug: "Bug Fixes",
-      }.freeze
-
-      # GitHub labels
-      BCBREAK = 'bcbreak'
-      FEATURE = 'feature'
-      BUG = 'bug'
-      PATCH = 'patch'
-
-      def self.instance
-        @instance ||= new
-
-        yield @instance if block_given?
-
-        @instance
-      end
-
-      def product
-        @product ||= ProductData.new
-      end
-
-      def bump_version
-        product.bump_version(release_type)
-      end
-
-      def bump_version!
-        product.bump_version!(release_type)
-      end
-
-      def branch_name
-        @branch_name ||= "rc-#{product.version}"
-      end
-
-      # return a string of commit names since the last release
-      def pending_changes
-        @changes ||= begin
-                       range = product.tag_exists? ? "#{product.tag_name}.." : ""
-                       `git log --pretty=format:"%s" #{range}`
-                     end
-      end
-
-      # return a list of PR numbers since the last release
-      def pending_pr_numbers
-        @pending_pr_numbers ||= pending_changes.
-          lines.
-          map { |line| line.match(/\(#(\d+)\)$/).then { |m| m && m[1] } }.
-          compact.
-          sort.reverse
-      end
-
-      # return a JSON string of PR data
-      def pending_pr_dump
-        @pending_pr_dump ||= `gh pr list --state all --limit 256 --json number,title,labels,url,body --jq 'map(select([.number] | inside([#{pending_pr_numbers.join(',')}]))) | sort_by(.number)'`
-      end
-
-      # return a list of PR data since the last release
-      def pending_prs
-        @pending_prs ||= JSON.parse(pending_pr_dump)
-      end
-
-      # return a list of pending prs with additional attributes (summary,
-      # short title, jira issue number).
-      def decorated_prs
-        @decorated_prs ||= pending_prs.map do |pr|
-                             jira_issue, pr_title = split_pr_title(pr)
-                             summary = extract_summary(pr)
-                             type = pr_type(pr)
-                             type_code = pr_type_code(type)
-                             patch_flag = pr_patch_flag?(pr)
-
-                             pr.merge('jira' => jira_issue,
-                                      'short-title' => pr_title,
-                                      'summary' => summary,
-                                      'type' => type,
-                                      'type-code' => type_code,
-                                      'patch' => patch_flag)
-                           end
-      end
-
-      # return a hash of decorated prs grouped by :bcbreak, :feature, or :bug
-      def prs_by_type
-        @prs_by_type ||= decorated_prs.group_by { |pr| pr['type'] }
-      end
-
-      # returns 'major', 'minor', or 'patch', depending on the presence of
-      # (respectively) :bcbreak, :feature, or :bug labels.
-      #
-      # If the RELEASE environment variable is set, its value will be used
-      # directly, ignoring whatever PR labels might exist.
-      def release_type
-        @release_type ||= if ENV['RELEASE']
-                            ENV['RELEASE']
-                          elsif prs_by_type[:bcbreak]
-                            'major'
-                          elsif prs_by_type[:feature] && prs_by_type[:feature].any? { |pr| !pr['patch'] }
-                            'minor'
-                          else
-                            'patch'
-                          end
-      end
-
-      # returns the generated release notes as a string
-      def release_notes
-        @release_notes ||= release_notes_intro +
-          %i[ bcbreak feature bug ].
-            flat_map { |type| release_notes_for_type(type) }.join("\n")
-      end
-
-      private
-
-      # returns an array of strings, each string representing a single line
-      # in the release notes for the PR's of the given type.
-      def release_notes_for_type(type)
-        return [] unless prs_by_type[type]
-
-        [].tap do |lines|
-          lines << "\# #{SECTION_TITLE[type]}"
-          lines << ''
-
-          prs = prs_by_type[type]
-          summarized, unsummarized = prs.partition { |pr| pr['summary'] }
-
-          summarized.each do |pr|
-            header = [ '### ' ]
-            header << "[#{pr['jira']}](#{jira_url(pr['jira'])}) " if pr['jira']
-            header << "#{pr['short-title']} ([PR](#{pr['url']}))"
-            lines << header.join
-            lines << ''
-            lines << pr['summary']
-            lines << ''
-          end
-
-          if summarized.any? && unsummarized.any?
-            lines << ''
-            lines << [ '### Other ', SECTION_TITLE[type] ].join
-            lines << ''
-          end
-
-          unsummarized.each do |pr|
-            line = [ '* ' ]
-            line << "[#{pr['jira']}](#{jira_url(pr['jira'])}) " if pr['jira']
-            line << "#{pr['short-title']} ([PR](#{pr['url']}))"
-
-            lines << line.join
-          end
-
-          lines << ''
-        end
-      end
-
-      # returns the URL of for the given jira issue
-      def jira_url(issue)
-        "https://jira.mongodb.org/browse/#{issue}"
-      end
-
-      # assumes a pr title in the format of "JIRA-1234 PR Title (#1234)",
-      # returns a tuple of [ jira-issue, title ], where jira-issue may be
-      # blank (if no jira issue is in the title).
-      def split_pr_title(pr)
-        title = pr['title'].gsub(/\(#\d+\)/, '').strip
-
-        if title =~ /^(\w+-\d+) (.*)$/
-          [ $1, $2 ]
-        else
-          [ nil, title ]
-        end
-      end
-
-      # extracts the summary section from the pr and returns it (or returns nil
-      # if no summary section is detected)
-      def extract_summary(pr)
-        summary = []
-        accumulating = false
-        level = nil
-
-        pr['body'].lines.each do |line|
-          # a header of any level titled "summary" will begin the summary
-          if !accumulating && line =~ /^(\#+)\s+summary\s+$/i
-            accumulating = true
-            level = $1.length
-
-          # a header of any level less than or equal to the summary header's
-          # level will end the summary
-          elsif accumulating && line =~ /^\#{1,#{level}}\s+/
-            break
-
-          # otherwise, the line is part of the summary
-          elsif accumulating
-            summary << line
-          end
-        end
-
-        summary.any? ? summary.join.strip : nil
-      end
-
-      # Returns a symbol (:bcbreak, :feature, or :bug) that identifies the
-      # type of this PR that would most strongly influence what type of release
-      # it requires.
-      def pr_type(pr)
-        if pr['labels'].any? { |l| l['name'] == BCBREAK }
-          :bcbreak
-        elsif pr['labels'].any? { |l| l['name'] == FEATURE }
-          :feature
-        elsif pr['labels'].any? { |l| l['name'] == BUG }
-          :bug
-        else
-          nil
-        end
-      end
-
-      # `true` if the `patch` label is applied to the PR. This is used to
-      # indicate that a "feature" PR should be treated as a patch, for
-      # determining the release type only.
-      def pr_patch_flag?(pr)
-        pr['labels'].any? { |l| l['name'] == PATCH }
-      end
-
-      def pr_type_code(type)
-        case type
-        when :bcbreak then 'x'
-        when :feature then 'f'
-        when :bug     then 'b'
-        else '?'
-        end
-      end
-
-      def series
-        major, minor, = product.version_parts
-
-        case release_type
-        when 'minor' then 
-          "#{major}.x"
-        when 'patch' then
-          "#{major}.#{minor}.x"
-        end
-      end
-
-      # Return a string containing the markdown-formatted intro block for
-      # the release notes of this candidate.
-      def release_notes_intro
-        release_description = case release_type
-                              when 'major' then 'major release'
-                              when 'minor' then "minor release in the #{series} series"
-                              when 'patch' then "patch release in the #{series} series"
-                              end
-
-        <<~INTRO
-          The MongoDB Ruby team is pleased to announce version #{product.version} of the `#{product.package}` gem - #{product.description}. This is a new #{release_description} of #{product.name}.
-
-          Install this release using [RubyGems](https://rubygems.org/) via the command line as follows: 
-
-          ~~~
-          gem install -v #{product.version} #{product.package}
-          ~~~
-
-          Or simply add it to your `Gemfile`:
-
-          ~~~
-          gem '#{product.package}', '#{product.version}'
-          ~~~
-
-          Have any feedback? Click on through to MongoDB's JIRA and [open a new ticket](#{product.jira_project_url}) to let us know what's on your mind 🧠.
-
-        INTRO
-      end
-    end
-  end
-end

data/spec/shared/lib/mrss/release/product_data.rb

@@ -1,144 +0,0 @@
-# frozen_string_literal: true
-
-require 'yaml'
-
-module Mrss
-  module Release
-    class ProductData
-      FILE_PATH = 'product.yml'
-
-      def self.init!
-        if File.exist?(FILE_PATH)
-          raise "#{FILE_PATH} already exists; refusing to overwrite it"
-        end
-
-        initial_data = {
-          'name' => 'Product Name',
-          'description' => 'a very short description of the product',
-          'package' => 'product_package',
-          'jira' => 'https://url.to.jira/project',
-          'version' => { 'number' => '1.0.0',
-                         'file' => 'path/to/version.rb' }
-        }
-
-        File.write(FILE_PATH, initial_data.to_yaml)
-      end
-
-      def initialize
-        @hash = YAML.load_file(FILE_PATH)
-      end
-
-      def save_product_file!
-        File.write(FILE_PATH, @hash.to_yaml)
-      end
-
-      def rewrite_version_file!
-        version_module = File.read(version_file)
-        new_module = version_module.
-          sub(/^(\s*)(VERSION\s*=\s*).*$/) { "#{$1}#{$2}#{quoted_version}" }
-        File.write(version_file, new_module)
-      end
-
-      def version
-        @hash['version']['number']
-      end
-
-      def quoted_version
-        if version.include?("'")
-          version.inspect
-        else
-          "'#{version}'"
-        end
-      end
-
-      def version=(number)
-        @hash['version']['number'] = number
-      end
-
-      # returns an array of [ major, minor, patch, suffix ].
-      #
-      # each element will be returned as a String.
-      def version_parts
-        version.split(/\./, 4)
-      end
-
-      # bump the version according to the given release type:
-      #
-      #  'major' -> increment major component, zero the others
-      #  'minor' -> increment minor component, zero the patch
-      #  'patch' -> increment the patch component
-      def bump_version(release)
-        major, minor, patch, suffix = version_parts
-
-        case release
-        when 'major' then
-          major = major.to_i + 1
-          minor = patch = 0
-        when 'minor'
-          minor = minor.to_i + 1
-          patch = 0
-        when 'patch'
-          patch = patch.to_i + 1
-        else
-          raise ArgumentError, "invalid release type: #{release.inspect}"
-        end
-
-        self.version = [ major, minor, patch ].join('.')
-      end
-
-      # Invokes `#bump_version`, and then saves the new version to the
-      # product.yml file and to the version.rb file.
-      def bump_version!(release)
-        bump_version(release)
-        save_product_file!
-        rewrite_version_file!
-      end
-
-      def version_file
-        @hash['version']['file']
-      end
-
-      def name
-        @hash['name']
-      end
-
-      # The description is intended to be used in places where it can be
-      # appended to the end of a sentence, e.g.
-      #
-      #   "We just released #{product.name} - #{product.description}!"
-      #
-      # Markdown formatting is allowed (even expected).
-      def description
-        @hash['description']
-      end
-
-      def package
-        @hash['package']
-      end
-
-      def jira_project_url
-        @hash['jira']
-      end
-
-      def tag_name
-        "v#{version}"
-      end
-
-      def tag_exists?(tag = tag_name)
-        `git tag -l #{tag}`.strip == tag
-      end
-
-      def branch_exists?(branch)
-        `git branch -l #{branch}`.strip == branch
-      end
-
-      def base_branch
-        @base_branch ||= begin
-                           major, minor, = version_parts
-                           branch = "#{major}.#{minor}-stable"
-                           branch_exists?(branch) ? branch : 'master'
-                         end
-      end
-    end
-  end
-end

data/spec/shared/lib/tasks/candidate.rake

@@ -1,64 +0,0 @@
-# frozen_string_literal: true
-
-require_relative '../mrss/release/candidate'
-
-namespace :candidate do
-  desc 'Initialize a new product.yml file'
-  task :init do
-    Mrss::Release::ProductData.init!
-    puts "product.yml file created"
-  end
-
-  desc 'Print the release notes for the next candidate release'
-  task :preview do
-    Mrss::Release::Candidate.instance do |candidate|
-      # load the pending changes before bumping the version, since it
-      # depends on the value of the current version.
-      candidate.pending_changes
-      candidate.bump_version
-      puts candidate.release_notes
-    end
-  end
-
-  desc 'List the pull requests to be included in the next release'
-  task :prs do
-    Mrss::Release::Candidate.instance.decorated_prs.each do |pr|
-      print "\##{pr['number']}[#{pr['type-code']}] "
-      print "#{pr['jira']} " if pr['jira']
-      puts pr['short-title']
-    end
-  end
-
-  desc 'Create a new branch and pull request for the candidate'
-  task create: :check_branch_status do
-    Mrss::Release::Candidate.instance do |candidate|
-      origin = `git config get remote.origin.url`
-      match = origin.match(/:(.*?)\//) or raise "origin url is not in expected format: #{origin.inspect}"
-      user = match[1]
-
-      puts 'gathering candidate info and bumping version...'
-      candidate.bump_version!
-
-      puts 'writing release notes to /tmp/pr-body.md...'
-      File.write('/tmp/pr-body.md', candidate.release_notes)
-
-      sh 'git', 'checkout', '-b', candidate.branch_name
-      sh 'git', 'commit', '-am', "Bump version to #{candidate.product.version}"
-      sh 'git', 'push', 'origin', candidate.branch_name
-
-      sh 'gh', 'pr', 'create',
-           '--head', "#{user}:#{candidate.branch_name}",
-           '--base', candidate.product.base_branch,
-           '--title', "Release candidate for #{candidate.product.version}",
-           '--label', 'release-candidate',
-           '--body-file', '/tmp/pr-body.md'
-    end
-  end
-
-  # Ensures the current branch is up-to-date with no uncommitted changes
-  task :check_branch_status do
-    sh 'git pull >/dev/null', verbose: false
-    changes = `git status --short --untracked-files=no`.strip
-    abort "There are uncommitted changes. Commit (or revert) the changes and try again." if changes.length > 0
-  end
-end