mongoid_includes 3.0.3 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48e36bb9b9e6b5ad9bef681c5ea1b2fbc041d87cc24beacb65a6fafc3454d435
-  data.tar.gz: 361559262111d541da7f085b20ad2bf4d305e7f5d65cd5d6a511c9501c467883
+  metadata.gz: 83db65c1adea9fd5ce752f9867989788d8859ffd1e1b1a9fe859ebe83fcd4846
+  data.tar.gz: 4d8cc4f621f9f8f44bf76f33fcdb8d69be082e971d1cc961a8e430af526d4359
 SHA512:
-  metadata.gz: bd46468001e42037d5364e5e4e08aad6f8758381d57f128244e61b92ff9b562b98414d17c4a95fad8cc1a51bcfac6623c064596a7bfdd9d405bd63b1ec721616
-  data.tar.gz: 3ba71596e0ae09549469a0bbae88b5a3b4d8824fe64f7ce0e5d89946e917ff5631c0c7fd1d163ac7d5aaaadef5e456d8c9125f6cd8d72d8b354a42d9230261ce
+  metadata.gz: dbb0d5ffb72235011a22273a55acf1bbd127ac94fedb985336eecad14caf9e0b75d850e9f1e086160bac8270b1a6332cb3c4e10afa8d521766213d3171c42d83
+  data.tar.gz: cbd607eb7b26276e115880af07fc1b179401ed1d334a4ccb76322ebc28452ab1b2e5c983392c90eb4d2e501ac342dfc7617dd63ec709393aa62cbdf93405d481

data/README.md

@@ -1,12 +1,11 @@
-Mongoid::Includes
-=====================
+# Mongoid::Includes
 
 [![Gem Version](https://badge.fury.io/rb/mongoid_includes.svg)](https://rubygems.org/gems/mongoid_includes)
-[![Build Status](https://github.com/cacheventures/mongoid_includes/workflows/ci/badge.svg)](https://github.com/cacheventures/mongoid_includes/actions)
+[![Build Status](https://github.com/cacheventures/mongoid_includes/workflows/CI/badge.svg)](https://github.com/cacheventures/mongoid_includes/actions)
 
 `Mongoid::Includes` improves eager loading in Mongoid, supporting polymorphic associations, and nested eager loading.
 
-### Usage
+## Usage
 
 ```ruby
 Album.includes(:songs).includes(:musicians, from: :band)
@@ -19,8 +18,10 @@ released_only = ->(albums) { albums.where(released: true) }
 Musician.includes(:band, with: ->(bands) { bands.limit(2).includes(:albums, with: released_only) })
 ```
 
-### Pro Tip
+## Pro Tip
+
 Since you can modify the queries for the associations, you can use `only` and make your queries even faster:
+
 ```ruby
 Band.includes :musicians, with: ->(musicians) { musicians.only(:id, :name) }
 ```
@@ -36,10 +37,10 @@ Band.includes :musicians, with: ->(musicians) { musicians.only(:id, :name) }
 Add this line to your application's Gemfile and run `bundle install`:
 
 ```ruby
-  gem 'mongoid_includes'
+gem 'mongoid_includes'
 ```
 
-Or install it yourself running:
+Or install it yourself by running:
 
 ```sh
 gem install mongoid_includes
@@ -48,3 +49,61 @@ gem install mongoid_includes
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Running tests
+
+To run the full test suite locally:
+
+```sh
+bundle install
+bundle exec rspec
+# or use the bundled binary
+bin/rspec
+```
+
+To run the tests against the Mongoid 8 matrix (this project provides a separate Gemfile at `gemfiles/mongoid8.gemfile`), set `BUNDLE_GEMFILE` to that file before installing or running the suite:
+
+```sh
+# install gems for the mongoid8 Gemfile
+BUNDLE_GEMFILE=gemfiles/mongoid8.gemfile bundle install
+
+# run the specs using that Gemfile
+BUNDLE_GEMFILE=gemfiles/mongoid8.gemfile bundle exec rspec
+# or
+BUNDLE_GEMFILE=gemfiles/mongoid8.gemfile bin/rspec
+```
+
+If you only need to run a single spec file while using the alternate Gemfile, pass the path to `rspec` as usual, for example:
+
+```sh
+BUNDLE_GEMFILE=gemfiles/mongoid8.gemfile bundle exec rspec spec/mongoid/includes/criteria_spec.rb
+```
+
+## Contributing
+
+Contributions are welcome. If you'd like to report a bug, suggest an improvement, or submit a patch, please follow these steps:
+
+1. Fork the repository on GitHub.
+2. Create a feature branch from `master` (or from the branch you're targeting):
+
+   ```sh
+   git switch -c my-feature-branch
+   ```
+
+3. Make your changes. Add or update tests when appropriate.
+4. Run the test suite locally to ensure everything passes:
+
+   ```sh
+   bundle install
+   bundle exec rspec
+   ```
+
+5. Commit your changes with a clear message and push your branch to your fork:
+
+   ```sh
+   git add -A
+   git commit -m "Short, descriptive message"
+   git push origin my-feature-branch
+   ```
+
+6. Open a Pull Request against the `master` branch of this repository. In your PR description, explain the problem, what you changed, and any notes about compatibility or required steps.

data/lib/mongoid/includes/inclusion.rb

@@ -54,6 +54,7 @@ module Mongoid
       # Returns an Inclusion that can be eager loaded as usual.
       def for_class_name(class_name)
         Inclusion.new metadata.clone.instance_eval { |relation_metadata|
+          @options = @options.dup
           @options[:class_name] = @class_name = class_name
           @options[:polymorphic], @options[:as], @polymorphic, @klass = nil
           self

data/lib/mongoid/includes/version.rb

@@ -1,10 +1,5 @@
-# Mongoid is an ODM (Object Document Mapper) Framework for MongoDB, written in Ruby.
 module Mongoid
-  # Improves eager loading in Mongoid, supporting polymorphic associations,
-  # and up to two-levels of eager loading.
   module Includes
-
-    # Public: This library will attempt to follow semantic versioning (whatever that's supposed to be).
-    VERSION = '3.0.3'
+    VERSION = '4.0.0'.freeze
   end
 end