# Change Log ## Unreleased ### Added * Support Mongoid 5. PR [#636](https://github.com/activerecord-hackery/ransack/pull/636), commit [9e5faf4](https://github.com/activerecord-hackery/ransack/commit/9e5faf4). *Josef Šimánek* * Added optional block argument for the `sort_link` method. PR [#604](https://github.com/activerecord-hackery/ransack/pull/604), commit [997b856](https://github.com/activerecord-hackery/ransack/commit/997b856). *Andrea Dal Ponte* * Added `ransack_alias` to allow users to customize the names for long ransack field names. PR [#623](https://github.com/activerecord-hackery/ransack/pull/623), commit [e712ff1](https://github.com/activerecord-hackery/ransack/commit/e712ff1). *Ray Zane* * Added support for searching on attributes that have been added to Active Record models with `alias_attribute` (Rails >= 4 only). PR [#592](https://github.com/activerecord-hackery/ransack/pull/592), commit [549342a](https://github.com/activerecord-hackery/ransack/commit/549342a). *Marten Schilstra* * Add ability to globally hide sort link order indicator arrows with `Ransack.configure#hide_sort_order_indicators = true`. PR [#577](https://github.com/activerecord-hackery/ransack/pull/577), commit [95d4591](https://github.com/activerecord-hackery/ransack/commit/95d4591). *Josh Hunter*, *Jon Atack* * Add failing tests to facilitate work on issue [#566](https://github.com/activerecord-hackery/ransack/issues/566) of passing boolean values to search scopes. PR [#575](https://github.com/activerecord-hackery/ransack/pull/575). *Marcel Eeken* * Add Brazilian Portuguese i18n locale file (`pt-BR.yml`). PR [#581](https://github.com/activerecord-hackery/ransack/pull/581). *Diego Henrique Domingues* * Add Indonesian (Bahasa) i18n locale file (`id.yml`). PR [#612](https://github.com/activerecord-hackery/ransack/pull/612). *Adam Pahlevi Baihaqi* * Add Japanese i18n locale file (`ja.yml`). PR [#622](https://github.com/activerecord-hackery/ransack/pull/622). *Masanobu Mizutani* ### Fixed * Fix using aliased attributes in association searches, and add a failing spec. PR [#602](https://github.com/activerecord-hackery/ransack/pull/602). *Marten Schilstra* * Replace Active Record `table_exists?` API that was deprecated [here](https://github.com/rails/rails/commit/152b85f) in Rails 5. Commit [c9d2297](https://github.com/activerecord-hackery/ransack/commit/c9d2297). *Jon Atack* * Adapt to changes in Rails 5 where AC::Parameters composes a HWIA instead of inheriting from Hash starting from Rails commit rails/rails@14a3bd5. Commit [ceafc05](https://github.com/activerecord-hackery/ransack/commit/ceafc05). *Jon Atack* * Fix test `#sort_link with hide order indicator set to true` to fail properly ([4f65b09](https://github.com/activerecord-hackery/ransack/commit/4f65b09)). This spec, added in [#473](https://github.com/activerecord-hackery/ransack/pull/473), tested the presence of the attribute name instead of the absence of the order indicators and did not fail when it should. *Josh Hunter*, *Jon Atack* * Revert [f858dd6](https://github.com/activerecord-hackery/ransack/commit/f858dd6). Fixes [#553](https://github.com/activerecord-hackery/ransack/issues/553) performance regression with the SQL Server adapter. *sschwing3* * Fix invalid Chinese I18n locale file name by replacing "zh" with "zh-CN". PR [#590](https://github.com/activerecord-hackery/ransack/pull/590). *Ethan Yang* ### Changed * Memory/speed perf improvement: Freeze strings in array global constants and move from using global string constants to frozen strings ([381a83c](https://github.com/activerecord-hackery/ransack/commit/381a83c) and [ce114ec](https://github.com/activerecord-hackery/ransack/commit/ce114ec)). *Jon Atack* * Escape underscore `_` wildcard characters with PostgreSQL and MySQL. PR [#584](https://github.com/activerecord-hackery/ransack/issues/584). *Igor Dobryn* ## Version 1.7.0 - 2015-08-20 ### Added * Add Mongoid support for referenced/embedded relations. PR [#498](https://github.com/activerecord-hackery/ransack/pull/498). TODO: Missing spec coverage! Add documentation! *Penn Su* * Add German i18n locale file (`de.yml`). PR [#537](https://github.com/activerecord-hackery/ransack/pull/537). *Philipp Weissensteiner* ### Fixed * Fix [#499](https://github.com/activerecord-hackery/ransack/issues/499) and [#549](https://github.com/activerecord-hackery/ransack/issues/549). Ransack now loads only Active Record if both Active Record and Mongoid are running to avoid the two adapters overriding each other. This clarifies that Ransack currently knows how to work with only one database adapter active at a time. PR [#541](https://github.com/activerecord-hackery/ransack/pull/541). *ASnow (Большов Андрей)* * Fix [#299](https://github.com/activerecord-hackery/ransack/issues/299) `attribute_method?` parsing for attribute names containing `_and_` and `_or_`. Attributes named like `foo_and_bar` or `foo_or_bar` are recognized now instead of running failing checks for `foo` and `bar`. PR [#562](https://github.com/activerecord-hackery/ransack/pull/562). *Ryohei Hoshi* * Fix a time-dependent test failure. When the database has `default_timezone = :local` (system time) and the `Time.zone` is set to elsewhere, then `Date.current` does not match what the query produces for the stored timestamps. Resolved by setting everything to UTC. PR [#561](https://github.com/activerecord-hackery/ransack/pull/561). *Andrew Vit* * Avoid overwriting association conditions with default scope in Rails 3. When a model with default scope was associated with conditions (`has_many :x, conditions: ...`), the default scope would overwrite the association conditions. This patch ensures that both sources of conditions are applied. Avoid selecting records from joins that would normally be filtered out if they were selected from the base table. Only applies to Rails 3, as this issue was fixed since Rails 4. PR [#560](https://github.com/activerecord-hackery/ransack/pull/560). *Andrew Vit* * Fix RSpec `its` method deprecation warning: "Use of rspec-core's its method is deprecated. Use the rspec-its gem instead" ([c09aa17](https://github.com/activerecord-hackery/ransack/commit/c09aa17)). * Fix deprecated RSpec syntax in `grouping_spec.rb` ([ba92a0b](https://github.com/activerecord-hackery/ransack/commit/ba92a0b)). *Jon Atack* ### Changed * Upgrade gemspec dependencies: MySQL2 from '0.3.14' to '0.3.18', and RSpec from '~> 2.14.0' to '~> 2' which loads 2.99 ([000cd22](https://github.com/activerecord-hackery/ransack/commit/000cd22)). * Upgrade spec suite to RSpec 3 `expect` syntax backward compatible with RSpec 2.9 ([87cd36d](https://github.com/activerecord-hackery/ransack/commit/87cd36d) and [d296caa](https://github.com/activerecord-hackery/ransack/commit/d296caa)). * Various FormHelper refactorings ([17dd97a](https://github.com/activerecord-hackery/ransack/commit/17dd97a) and [29a73b9](https://github.com/activerecord-hackery/ransack/commit/29a73b9)). * Various documentation updates. *Jon Atack* ## Version 1.6.6 - 2015-04-05 ### Added * Add the Ruby version to the the header message that shows the database, Active Record and Arel versions when running tests. * Add Code Climate analysis. *Jon Atack* ### Fixed * An improved fix for the "undefined method `model_name` for Ransack::Search" issue [#518](https://github.com/activerecord-hackery/ransack/issues/518) affecting Rails 4.2.1 and 5.0.0. This fix allows us to remove the ActionView patch in Ransack version 1.6.4. *Gleb Mazovetskiy* * Fix an erroneous reference in `ActiveRecord::Associations::JoinDependency` to a version-dependent Active Record reference, and replace it with a better, more reliable one defined in Polyamorous. As this class lives inside an `ActiveRecord` module, the reference needs to be absolute in order to properly point to the AR class. *Nahuel Cuesta Luengo* * Fix RubyGems YARD rendering of the README docs. *Jon Atack* ### Changed * Upgrade Polyamorous dependency to version 1.2.0, which uses `Module#prepend` instead of `alias_method` for hooking into Active Record (with Ruby 2.x). *Jon Atack* ## Version 1.6.5 - 2015-03-28 - Rails 5.0.0 update ### Added * [WIP/experimental] Add compatibility with Rails 5/master and Arel 7. * Update the [Contributing Guide](CONTRIBUTING.md) with detailed steps for contributing to Ransack. * Broaden the test suite database options in `schema.rb` and add code documentation. * Improve the header message when running tests. *Jon Atack* * Allow `:wants_array` to be set to `false` in the predicate options ([#32](https://github.com/activerecord-hackery/ransack/issues/32)). *Michael Pavling* * Add a failing spec for issue [#374](https://github.com/activerecord-hackery/ransack/issues/374). *Jamie Davidson*, *Jon Atack* ### Fixed * Stop relying on `Active Record::relation#where_values` which are deprecated in Rails 5. * Make the test for passing search arguments to a ransacker (`ransacker_args`) work correctly with Sqlite3. *Jon Atack* ### Changed * Stop CI testing for Rails 3.0 to reduce the size of the Travis test matrix. *Jon Atack* ## Version 1.6.4 - 2015-03-20 - Rails 4.2.1 update * ActionView patch to maintain compatibility with Rails 4.2.1 released today. *Jon Atack* * Enable scoping I18n by 'ransack.models' ([#514](https://github.com/activerecord-hackery/ransack/pull/514)). *nagyt234* * Add ransacker arguments ([#513](https://github.com/activerecord-hackery/ransack/pull/513)). *Denis Tataurov*, *Jon Atack* ## Version 1.6.3 - 2015-01-21 * Fix a regression ([#496](https://github.com/activerecord-hackery/ransack/issues/496)) caused by [ee571fe](https://github.com/activerecord-hackery/ransack/commit/ee571fe) where passing a multi-parameter attribute (like `date_select`) raised `RuntimeError: can't add a new key into hash during iteration`, and add a regression spec for the issue. *Nate Berkopec*, *Jon Atack* * Update travis-ci to no longer test Rails 3.1 with Ruby 2.2 and speed up the test matrix. * Refactor Nodes::Condition. *Jon Atack* ## Version 1.6.2 - 2015-01-14 * Fix a regression ([#494](https://github.com/activerecord-hackery/ransack/issues/494)) where passing an array of routes to `search_form_for` no longer worked, and add a failing/passing test that would have caught the issue. *Daniel Rikowski*, *Jon Atack* ## Version 1.6.1 - 2015-01-14 * Fix a regression with using `in` predicates caused by PR [#488](https://github.com/activerecord-hackery/ransack/pull/488)) and add a test. * README improvements to clarify `sort_link` syntax with associations and Ransack#search vs #ransack. * Default the Gemfile to Rails 4-2-stable. *Jon Atack* ## Version 1.6.0 - 2015-01-12 ### Added * Add support for using Ransack with `Mongoid 4.0` without associations ([PR #407](https://github.com/activerecord-hackery/ransack/pull/407)). *Zhomart Mukhamejanov* * Add support and tests for passing stringy booleans for ransackable scopes ([PR #460](https://github.com/activerecord-hackery/ransack/pull/460)). *Josh Kovach* * Add an sort_link option to not display sort order indicator arrows ([PR #473](https://github.com/activerecord-hackery/ransack/pull/473)). *Fred Bergman* * Numerous documentation improvements to the README, Contributing Guide and wiki. *Jon Atack* ### Fixed * Fix passing arrays to ransackers with Rails 4.2 / Arel 6.0 (pull requests [#486](https://github.com/activerecord-hackery/ransack/pull/486) and [#488](https://github.com/activerecord-hackery/ransack/pull/488)). *Idean Labib* * Make `search_form_for`'s default `:as` option respect the custom search key if it has been set ([PR #470](https://github.com/activerecord-hackery/ransack/pull/470)). Prior to this change, if you set a custom `search_key` option in the Ransack initializer file, you'd have to also pass an `as: :whatever` option to all of the search forms. Fixes [#92](https://github.com/activerecord-hackery/ransack/issues/92). *Robert Speicher* * Fix sorting on polymorphic associations (missing downcase) ([PR #467](https://github.com/activerecord-hackery/ransack/pull/467)). *Eugen Neagoe* * Fix Rails 5 / Arel 5 compatibility after the Arel and Active Record API changed. * Fix and add tests for sort_link `default_order` parsing if the option is set as a string instead of symbol. * Fix and add a test to handle `nil` in options passed to sort_link. * Fix #search method name conflicts in the README. *Jon Atack* ### Changed * Refactor and DRY up FormHelper#SortLink. Encapsulate parsing into a Plain Old Ruby Object with few public methods and small, private functional methods. Limit mutations to explicit methods and mutate no ivars. * Numerous speed improvements by using more specific Ruby methods like: - `Hash#each_key` instead of `Hash#keys.each` - `#none?` instead of `select#empty?` - `#any?` instead of `#select` followed by `#any?` - `#flat_map` instead of `#flatten` followed by `#map` - `!include?` instead of `#none?` * Replace `string#freeze` instances with top level constants to reduce string allocations in Ruby < 2.1. * Remove unneeded `Ransack::` namespacing on most of the constants. * In enumerable methods, pass a symbol as an argument instead of a block. * Update Travis-ci for Rails 5.0.0 and 4-2-stable. * Update the Travis-ci tests and the Gemfile for Ruby 2.2. * Replace `#search` with `#ransack` class methods in the README and wiki code examples. Enabling the `#search` alias by default may possibly be deprecated in the next major release (Ransack v.2.0.0) to address [#369](https://github.com/activerecord-hackery/ransack/issues/369). *Jon Atack* ## Version 1.5.1 - 2014-10-30 ### Added * Add base specs for search on fields with `_start` and `_end`. * Add a failing spec for detecting attribute fields containing `_and_` that needs to be fixed. Attribute names containing `_and_` and `_or_` are still not parsed/detected correctly. *Jon Atack* ### Fixed * Fix a regression caused by incorrect string constants in `context.rb`. *Kazuhiro Nishiyama* ### Changed * Remove duplicate code in `spec/support/schema.rb`. *Jon Atack* ## Version 1.5.0 - 2014-10-26 ### Added * Add support for multiple sort fields and default orders in Ransack `sort_link` helpers ([PR #438](https://github.com/activerecord-hackery/ransack/pull/438)). *Caleb Land*, *James u007* * Add tests for `lteq`, `lt`, `gteq` and `gt` predicates. They are also tested in Arel, but testing them in Ransack has proven useful to detect issues. *Jon Atack* * Add tests for unknown attribute names. *Joe Yates* * Add tests for attribute names containing `_or_` and `_and_`. *Joe Yates*, *Jon Atack* * Add tests for attribute names ending with `_start` and `_end``. *Jon Atack*, *Timo Schilling* * Add tests for `start`, `not_start`, `end` and `not_end` predicates, with emphasis on cases when attribute names end with `_start` and `_end`. *Jon Atack* ### Fixed * Fix a regression where form labels for attributes through a `belongs_to` association without a translation for the attribute in the locales file would cause a "no implicit conversion of nil into Hash" crash instead of falling back on the attribute name. Added test coverage. *John Dell*, *Jon Atack*, *jasdeepgosal* * Fix the `form_helper date_select` spec that was failing with Rails 4.2 and master. *Jon Atack* * Improve `attribute_method?` parsing for attribute names containing `_and_` and `_or_`. Attributes named like `foo_and_bar` or `foo_or_bar` are recognized now instead of running failing checks for `foo` and `bar`. CORRECTION October 28, 2014: this feature is still not working! *Joe Yates* * Improve `attribute_method?` parsing for attribute names ending with a predicate like `_start` and `_end`. For instance, a `foo_start` attribute is now recognized instead of raising a NoMethodError. *Timo Schilling*, *Jon Atack* ### Changed * Reduce object allocations and memory footprint (with a slight speed gain as well) by extracting commonly used strings into top level constants and replacing calls to `#try` methods with simple nil checking. *Jon Atack* ## Version 1.4.1 - 2014-09-23 * Fix README markdown so RubyGems documentation picks up the formatting correctly. *Jon Atack* ## Version 1.4.0 - 2014-09-23 ### Added * Add support for Rails 4.2.0! Let us know if you encounter any issues. *Xiang Li* * Add `not_true` and `not_false` predicates and update the "Basic Searching" wiki. Fixes #123, #353. *Pedro Chambino* * Add Romanian i18n locale file (`ro.yml`). *Andreas Philippi* * Add new documentation in the README explaining how to group queries by `OR` instead of the default `AND` using the `m: 'or'` combinator. * Add new documentation in the README and in the source code comments explaining in detail how to handle whitelisting/authorization of attributes, associations, sorts and scopes. * Add new documentation in the README explaining in more detail how to use scopes for searching with Ransack. * Begin a CHANGELOG. *Jon Atack* ### Fixed * Fix singular/plural Active Record attribute translations. *Andreas Philippi* * Fix the params hash being modified by `Search.new` and the Ransack scope. *Daniel Rikowski* * Apply default scope conditions for association joins (fix for Rails 3). Avoid selecting records from joins that would normally be filtered out if they were selected from the base table. Only applies to Rails 3, as this issue was fixed in Rails 4. *Andrew Vit* * Fix incoherent code examples in the README Associations section that sometimes used `@q` and other times `@search`. *Jon Atack* ### Changed * Refactor Ransack::Translate. * Rewrite much of the Ransack README documentation, including the Associations section code examples and the Authorizations section detailing how to whitelist attributes, associations, sorts and scopes. *Jon Atack* ## Version 1.3.0 - 2014-08-23 ### Added * Add search scopes by popular demand. Using `ransackable_scopes`, users can define whitelists for allowed model scopes on a parent table. Not yet implemented for associated models' scopes; scopes must be defined on the parent table. *Gleb Mazovetskiy*, *Andrew Vit*, *Sven Schwyn* * Add `JOINS` merging. * Add `OR` grouping on base search. * Allow authorizing/whitelisting attributes, associations, sorts and scopes. * Improve boolean predicates’ handling of `false` values. * Allow configuring Ransack to raise on instead of ignore unknown search conditions. * Allow passing blank values to search without crashing. * Add wildcard escaping compatibility for SQL Server databases. * Add various I18n translations.