bharat_filter_engine 0.1.1

data/spec/rule_normalizer_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+
+RSpec.describe BharatFilterEngine::RuleNormalizer do
+
+    it "keeps modern configuration unchanged" do
+
+        rule = {
+        type: :single,
+        filter_type: :string,
+        dbcolumn: :stage
+        }
+
+        expect(
+        described_class.call(rule)
+        ).to eq(rule)
+    end
+
+    it "supports legacy configuration" do
+
+        result =
+        described_class.call(
+            type: :string,
+            dbcolumn: :stage
+        )
+
+        expect(
+        result[:type]
+        ).to eq(:single)
+
+        expect(
+        result[:filter_type]
+        ).to eq(:string)
+    end
+
+    it "returns nil for nil rule" do
+        expect(
+            described_class.call(nil)
+        ).to be_nil
+    end
+
+    it "symbolizes rule keys" do
+        result = described_class.call(
+            "type" => :single,
+            "filter_type" => :string,
+            "dbcolumn" => :stage
+        )
+
+        expect(result[:type]).to eq(:single)
+        expect(result[:filter_type]).to eq(:string)
+        expect(result[:dbcolumn]).to eq(:stage)
+    end
+end

data/spec/search_builder_spec.rb

@@ -0,0 +1,157 @@
+require "spec_helper"
+
+RSpec.describe BharatFilterEngine::SearchBuilder do
+
+  let!(:client) do
+    Client.create!(
+      name: "John Doe",
+      email: "john@example.com"
+    )
+  end
+
+  let!(:lead) do
+    Lead.create!(
+      source: "google",
+      client: client
+    )
+  end
+
+  let!(:sale) do
+    Sale.create!(
+      stage: "qualified",
+      lead: lead
+    )
+  end
+
+  it "supports simple search" do
+
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [
+          :stage,
+          :"lead__source"
+        ]
+      ).apply("google")
+
+    expect(result).to contain_exactly(sale)
+  end
+
+  it "supports case insensitive search" do
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [:stage]
+      ).apply("QUAL")
+
+    expect(result).to contain_exactly(sale)
+  end
+
+  it "supports nested field search" do
+
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [
+          :"lead__client__name"
+        ]
+      ).apply(
+        "lead__client__name=John"
+      )
+
+    expect(result).to contain_exactly(sale)
+  end
+
+  it "supports multi-level association search" do
+    organization = Organization.create!(
+      name: "Acme"
+    )
+
+    client_two = Client.create!(
+      name: "Jane",
+      organization: organization
+    )
+
+    lead_two = Lead.create!(
+      source: "referral",
+      client: client_two
+    )
+
+    sale_two = Sale.create!(
+      lead: lead_two
+    )
+
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [
+          :"lead__client__organization__name"
+        ]
+      ).apply(
+        "lead__client__organization__name=Acme"
+      )
+
+    expect(result).to contain_exactly(sale_two)
+  end
+
+  it "supports OR search" do
+
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [
+          :stage,
+          :"lead__source"
+        ]
+      ).apply(
+        "stage=qualified|lead__source=google"
+      )
+
+    expect(result).to contain_exactly(sale)
+  end
+
+  it "supports combined AND and OR conditions" do
+    sale_one = Sale.create!(
+      stage: "qualified",
+      approval_status: "approved"
+    )
+
+    sale_two = Sale.create!(
+      stage: "qualified",
+      approval_status: "pending"
+    )
+
+    Sale.create!(
+      stage: "new",
+      approval_status: "approved"
+    )
+
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [
+          :stage,
+          :approval_status
+        ]
+      ).apply(
+        "stage=qualified&approval_status=approved|approval_status=pending"
+      )
+
+    expect(result).to contain_exactly(
+      sale_one,
+      sale_two
+    )
+  end
+
+  it "returns no records when the searched field is not configured" do
+    result =
+      described_class.new(
+        scope: Sale.all,
+        allowed_columns: [:stage]
+      ).apply(
+        "unknown=value"
+      )
+
+    expect(result).to be_empty
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "active_record"
+require "database_cleaner/active_record"
+require "bharat_filter_engine"
+require "sqlite3"
+
+ActiveRecord::Base.establish_connection(
+  adapter: "sqlite3",
+  database: ":memory:"
+)
+
+ActiveRecord::Schema.define do
+  create_table :organizations do |t|
+    t.string :name
+  end
+
+  create_table :clients do |t|
+    t.string :name
+    t.string :email
+    t.references :organization
+  end
+
+  create_table :leads do |t|
+    t.string :source
+    t.string :status
+    t.references :client
+    t.datetime :created_at
+  end
+
+  create_table :sales do |t|
+    t.string :stage
+    t.string :approval_status
+    t.integer :project_id
+    t.boolean :active
+    t.integer :amount
+    t.float :conversion_rate
+    t.datetime :actual_sale_date
+    t.references :lead
+  end
+end
+
+
+class Organization < ActiveRecord::Base
+  has_many :clients
+end
+
+
+class Client < ActiveRecord::Base
+  belongs_to :organization
+  has_many :leads
+end
+
+
+class Lead < ActiveRecord::Base
+  belongs_to :client
+  has_many :sales
+end
+
+
+class Sale < ActiveRecord::Base
+  belongs_to :lead
+end
+
+
+RSpec.configure do |config|
+  config.before(:suite) do
+    DatabaseCleaner.clean_with(:truncation)
+  end
+
+  config.around(:each) do |example|
+    DatabaseCleaner.strategy = :truncation
+
+    DatabaseCleaner.cleaning do
+      example.run
+    end
+  end
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: bharat_filter_engine
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Jayesh Rathore
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activemodel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.1'
+description: Configurable Rails ActiveRecord filtering engine supporting string, array,
+  boolean, numeric, date-range, nested association and AND/OR search filters.
+email:
+- jayeshrathore7024@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/bharat_filter_engine.rb
+- lib/bharat_filter_engine/association_resolver.rb
+- lib/bharat_filter_engine/dynamic_filter_values.rb
+- lib/bharat_filter_engine/engine.rb
+- lib/bharat_filter_engine/errors.rb
+- lib/bharat_filter_engine/rule_normalizer.rb
+- lib/bharat_filter_engine/search_builder.rb
+- lib/bharat_filter_engine/version.rb
+- spec/association_resolver_spec.rb
+- spec/dynamic_filter_values_spec.rb
+- spec/engine_spec.rb
+- spec/rule_normalizer_spec.rb
+- spec/search_builder_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/jayesh70240/bharat_filter_engine
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/jayesh70240/bharat_filter_engine
+  changelog_uri: https://github.com/jayesh70240/bharat_filter_engine/blob/main/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.3
+signing_key:
+specification_version: 4
+summary: A generic filtering engine for Rails ActiveRecord
+test_files: []