{"id":15679661,"url":"https://github.com/phstc/ransack_mongo","last_synced_at":"2025-07-18T16:38:23.237Z","repository":{"id":15305041,"uuid":"18034871","full_name":"phstc/ransack_mongo","owner":"phstc","description":"Query params based searching for MongoDB","archived":false,"fork":false,"pushed_at":"2015-01-27T00:07:22.000Z","size":243,"stargazers_count":11,"open_issues_count":0,"forks_count":7,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-17T05:46:03.894Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phstc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-03-23T14:19:54.000Z","updated_at":"2023-05-10T06:45:44.000Z","dependencies_parsed_at":"2022-08-25T15:22:07.621Z","dependency_job_id":null,"html_url":"https://github.com/phstc/ransack_mongo","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/phstc/ransack_mongo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phstc%2Fransack_mongo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phstc%2Fransack_mongo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phstc%2Fransack_mongo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phstc%2Fransack_mongo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phstc","download_url":"https://codeload.github.com/phstc/ransack_mongo/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phstc%2Fransack_mongo/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265793684,"owners_count":23829180,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T16:34:37.798Z","updated_at":"2025-07-18T16:38:23.215Z","avatar_url":"https://github.com/phstc.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ransack Mongo\n\n[![Build Status](https://travis-ci.org/phstc/ransack_mongo.svg)](https://travis-ci.org/phstc/ransack_mongo)\n\nRansack Mongo is based on [Ransack](https://github.com/activerecord-hackery/ransack), but for MongoDB.\n\nWith Ransack Mongo you can convert query params into Mongo queries.\n\n## Why another gem?\n\n\u003e [Given that Ransack is built on top of ARel and that ARel only works with relational databases, I don't see how we could add Mongoid support without dramatically changing everything.](https://github.com/activerecord-hackery/ransack/issues/120#issuecomment-7539851)\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n    gem 'ransack_mongo'\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install ransack_mongo\n\n## Usage\n\n```ruby\n# GET /customers?q[name_eq]=Pablo\u0026q[middle_name_or_last_name_cont]=Cantero\n\n# params[:q]\n# =\u003e { name_eq: 'Pablo', middle_name_or_last_name_cont: 'Cantero' }\n\n# RansackMongo::Query.parse(params[:q])\n# =\u003e { name: 'Pablo', '$or' =\u003e { middle_name: /Cantero/i, last_name: /Cantero/i } }\n\n# GET /customers\ndef index\n  selector = RansackMongo::Query.parse(params[:q])\n\n  # Mongo Ruby Driver\n  @customers = db['customers'].find(selector)\n\n  # Moped\n  @customers = session[:customers].find(selector)\n\n  # Mongoid\n  @customers = Customer.where(selector)\nend\n```\n\n### Available predicates\n\n* eq\n* not_eq\n* cont\n* in\n* start\n* mstart\n* gt\n* lt\n* gteq\n* lteq\n\n### OR operator\n\nYou can also combine predicates for OR queries.\n\n```ruby\nquery_param = { name_eq: 'Pablo', middle_name_or_last_name_cont: 'Cantero' }\n\nRansackMongo::Query.parse(params[:q])\n# =\u003e { name: 'Pablo', '$or' =\u003e { middle_name: /Cantero/i, last_name: /Cantero/i } }\n```\n\n### parse!\n\nYou can use `parse!` for stricter validations. This method will raise an exception if a query cannot be produced.\n\n```ruby\n # xpto isn't a valid predicate\n\nRansackMongo::Query.parse(name_xpto: 'Pablo')\n# =\u003e {}\n\nRansackMongo::Query.parse!(name_xpto: 'Pablo')\n# =\u003e RansackMongo::MatcherNotFound: No matchers found. To allow empty queries use .parse instead\n```\n\n## Contributing\n\n1. Fork it ( https://github.com/phstc/ransack_mongo/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create new Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphstc%2Fransack_mongo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphstc%2Fransack_mongo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphstc%2Fransack_mongo/lists"}