noiseless 0.0.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE.txt +28 -0
  3. data/README.md +214 -0
  4. data/lib/application_search.rb +15 -0
  5. data/lib/noiseless/adapter.rb +339 -0
  6. data/lib/noiseless/adapters/cluster_api.rb +18 -0
  7. data/lib/noiseless/adapters/elasticsearch.rb +30 -0
  8. data/lib/noiseless/adapters/execution_modules/elasticsearch_execution.rb +68 -0
  9. data/lib/noiseless/adapters/execution_modules/es_compatible_execution.rb +83 -0
  10. data/lib/noiseless/adapters/execution_modules/http_transport.rb +83 -0
  11. data/lib/noiseless/adapters/execution_modules/opensearch_execution.rb +209 -0
  12. data/lib/noiseless/adapters/execution_modules/pgvector_support.rb +219 -0
  13. data/lib/noiseless/adapters/execution_modules/postgresql_execution.rb +461 -0
  14. data/lib/noiseless/adapters/execution_modules/typesense_execution.rb +425 -0
  15. data/lib/noiseless/adapters/indices_api.rb +26 -0
  16. data/lib/noiseless/adapters/open_search.rb +168 -0
  17. data/lib/noiseless/adapters/postgresql.rb +171 -0
  18. data/lib/noiseless/adapters/typesense.rb +36 -0
  19. data/lib/noiseless/adapters.rb +14 -0
  20. data/lib/noiseless/ast/aggregation.rb +56 -0
  21. data/lib/noiseless/ast/bool.rb +16 -0
  22. data/lib/noiseless/ast/bulk.rb +18 -0
  23. data/lib/noiseless/ast/collapse.rb +16 -0
  24. data/lib/noiseless/ast/combined_fields.rb +33 -0
  25. data/lib/noiseless/ast/conversation.rb +29 -0
  26. data/lib/noiseless/ast/field_value_node.rb +16 -0
  27. data/lib/noiseless/ast/filter.rb +8 -0
  28. data/lib/noiseless/ast/hybrid.rb +35 -0
  29. data/lib/noiseless/ast/image_query.rb +29 -0
  30. data/lib/noiseless/ast/join.rb +31 -0
  31. data/lib/noiseless/ast/match.rb +8 -0
  32. data/lib/noiseless/ast/multi_match.rb +24 -0
  33. data/lib/noiseless/ast/paginate.rb +15 -0
  34. data/lib/noiseless/ast/prefix.rb +8 -0
  35. data/lib/noiseless/ast/range.rb +18 -0
  36. data/lib/noiseless/ast/root.rb +69 -0
  37. data/lib/noiseless/ast/search_after.rb +14 -0
  38. data/lib/noiseless/ast/sort.rb +15 -0
  39. data/lib/noiseless/ast/vector.rb +27 -0
  40. data/lib/noiseless/ast/wildcard.rb +8 -0
  41. data/lib/noiseless/ast.rb +30 -0
  42. data/lib/noiseless/bulk_importer.rb +195 -0
  43. data/lib/noiseless/callbacks.rb +138 -0
  44. data/lib/noiseless/connection_manager.rb +26 -0
  45. data/lib/noiseless/document_manager.rb +137 -0
  46. data/lib/noiseless/dsl.rb +107 -0
  47. data/lib/noiseless/generators/application_search_generator.rb +24 -0
  48. data/lib/noiseless/instrumentation.rb +174 -0
  49. data/lib/noiseless/introspection/console.rb +228 -0
  50. data/lib/noiseless/introspection/query_visualizer.rb +533 -0
  51. data/lib/noiseless/introspection.rb +221 -0
  52. data/lib/noiseless/mapping.rb +253 -0
  53. data/lib/noiseless/mapping_definition_processor.rb +231 -0
  54. data/lib/noiseless/model.rb +111 -0
  55. data/lib/noiseless/model_registry.rb +77 -0
  56. data/lib/noiseless/multi_search.rb +244 -0
  57. data/lib/noiseless/pagination.rb +375 -0
  58. data/lib/noiseless/query_builder.rb +284 -0
  59. data/lib/noiseless/railtie.rb +35 -0
  60. data/lib/noiseless/response/aggregations.rb +46 -0
  61. data/lib/noiseless/response/empty.rb +20 -0
  62. data/lib/noiseless/response/records.rb +94 -0
  63. data/lib/noiseless/response/results.rb +110 -0
  64. data/lib/noiseless/response/suggestions.rb +55 -0
  65. data/lib/noiseless/response.rb +98 -0
  66. data/lib/noiseless/response_factory.rb +32 -0
  67. data/lib/noiseless/runtime_reset_middleware.rb +15 -0
  68. data/lib/noiseless/search_index_update_job.rb +84 -0
  69. data/lib/noiseless/test_case.rb +230 -0
  70. data/lib/noiseless/test_helper.rb +295 -0
  71. data/lib/noiseless/version.rb +2 -2
  72. data/lib/noiseless.rb +146 -2
  73. data/lib/tasks/benchmark.rake +35 -0
  74. data/lib/tasks/release.rake +22 -0
  75. data/lib/tasks/test.rake +11 -0
  76. metadata +265 -14
@@ -0,0 +1,35 @@
1
+ # frozen_string_literal: true
2
+
3
+ namespace :benchmark do
4
+ desc "Benchmark search performance across Elasticsearch, OpenSearch, and PostgreSQL"
5
+ task search: :environment do
6
+ require "benchmark/ips"
7
+ require "async"
8
+
9
+ # Use configured connections from Rails
10
+ engines = {
11
+ elasticsearch: :primary,
12
+ opensearch: :secondary,
13
+ postgresql: :postgresql
14
+ }
15
+
16
+ puts "=" * 80
17
+ puts "MULTI-ENGINE SEARCH BENCHMARK"
18
+ puts "=" * 80
19
+ puts "Records: 10k benchmark articles"
20
+ puts "Engines: #{engines.keys.join(', ')}"
21
+ puts "=" * 80
22
+
23
+ # Load PostgreSQL data
24
+ puts "\n📊 Loading PostgreSQL..."
25
+ Article.delete_all
26
+ fixtures_path = Rails.root.join("../../test/fixtures")
27
+ ActiveRecord::FixtureSet.create_fixtures(fixtures_path, ["benchmark_articles"])
28
+ puts "✅ Loaded #{Article.count} records"
29
+
30
+ # Register PostgreSQL model
31
+ Noiseless.connections.client(:postgresql).register_model(Article, index_name: "articles")
32
+
33
+ puts "\n🚀 Benchmark ready. Run with: bundle exec rake benchmark:search"
34
+ end
35
+ end
@@ -0,0 +1,22 @@
1
+ # frozen_string_literal: true
2
+
3
+ namespace :release do
4
+ desc "Run lightweight release checks without booting the dummy app"
5
+ task :check do
6
+ require "shellwords"
7
+
8
+ spec = Gem::Specification.load("noiseless.gemspec")
9
+ raise "Failed to load noiseless.gemspec" unless spec
10
+
11
+ version_path = File.expand_path("../../lib/noiseless/version", __dir__)
12
+ require version_path
13
+
14
+ if spec.version.to_s != Noiseless::VERSION
15
+ raise "Version mismatch: gemspec=#{spec.version} lib=#{Noiseless::VERSION}"
16
+ end
17
+
18
+ ruby = Shellwords.escape(RbConfig.ruby)
19
+ sh "#{ruby} -Ilib -e 'require \"noiseless\"; abort(\"version mismatch\") unless Noiseless::VERSION == \"#{Noiseless::VERSION}\"'"
20
+ sh "gem build noiseless.gemspec"
21
+ end
22
+ end
@@ -0,0 +1,11 @@
1
+ # frozen_string_literal: true
2
+
3
+ namespace :test do
4
+ desc "Prepare test database"
5
+ task :prepare do
6
+ require_relative "../../test/dummy/config/environment"
7
+ ActiveRecord::Tasks::DatabaseTasks.create_current("test")
8
+ ActiveRecord::Base.establish_connection(:test)
9
+ ActiveRecord::Migration.maintain_test_schema!
10
+ end
11
+ end
metadata CHANGED
@@ -1,18 +1,199 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: noiseless
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.0
4
+ version: 0.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Abdelkader Boudih
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2025-07-10 00:00:00.000000000 Z
12
- dependencies: []
13
- description: Noiseless is an ActiveRecord-style search adapter for Ruby. Supports
14
- multiple backends (Elasticsearch, OpenSearch, Typesense), async querying, and a
15
- clean DSL.
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: activesupport
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '8.1'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '8.1'
26
+ - !ruby/object:Gem::Dependency
27
+ name: async
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '2.20'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '2.20'
40
+ - !ruby/object:Gem::Dependency
41
+ name: async-http
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '0.80'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '0.80'
54
+ - !ruby/object:Gem::Dependency
55
+ name: async-pool
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '0.8'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '0.8'
68
+ - !ruby/object:Gem::Dependency
69
+ name: railties
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: '8.1'
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: '8.1'
82
+ - !ruby/object:Gem::Dependency
83
+ name: zeitwerk
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - "~>"
87
+ - !ruby/object:Gem::Version
88
+ version: '2.7'
89
+ type: :runtime
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - "~>"
94
+ - !ruby/object:Gem::Version
95
+ version: '2.7'
96
+ - !ruby/object:Gem::Dependency
97
+ name: async-safe
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - "~>"
101
+ - !ruby/object:Gem::Version
102
+ version: '0.5'
103
+ type: :development
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - "~>"
108
+ - !ruby/object:Gem::Version
109
+ version: '0.5'
110
+ - !ruby/object:Gem::Dependency
111
+ name: minitest
112
+ requirement: !ruby/object:Gem::Requirement
113
+ requirements:
114
+ - - "~>"
115
+ - !ruby/object:Gem::Version
116
+ version: '5.27'
117
+ type: :development
118
+ prerelease: false
119
+ version_requirements: !ruby/object:Gem::Requirement
120
+ requirements:
121
+ - - "~>"
122
+ - !ruby/object:Gem::Version
123
+ version: '5.27'
124
+ - !ruby/object:Gem::Dependency
125
+ name: sqlite3
126
+ requirement: !ruby/object:Gem::Requirement
127
+ requirements:
128
+ - - "~>"
129
+ - !ruby/object:Gem::Version
130
+ version: '2.9'
131
+ type: :development
132
+ prerelease: false
133
+ version_requirements: !ruby/object:Gem::Requirement
134
+ requirements:
135
+ - - "~>"
136
+ - !ruby/object:Gem::Version
137
+ version: '2.9'
138
+ - !ruby/object:Gem::Dependency
139
+ name: vcr
140
+ requirement: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - "~>"
143
+ - !ruby/object:Gem::Version
144
+ version: '6.4'
145
+ type: :development
146
+ prerelease: false
147
+ version_requirements: !ruby/object:Gem::Requirement
148
+ requirements:
149
+ - - "~>"
150
+ - !ruby/object:Gem::Version
151
+ version: '6.4'
152
+ - !ruby/object:Gem::Dependency
153
+ name: webmock
154
+ requirement: !ruby/object:Gem::Requirement
155
+ requirements:
156
+ - - "~>"
157
+ - !ruby/object:Gem::Version
158
+ version: '3.26'
159
+ type: :development
160
+ prerelease: false
161
+ version_requirements: !ruby/object:Gem::Requirement
162
+ requirements:
163
+ - - "~>"
164
+ - !ruby/object:Gem::Version
165
+ version: '3.26'
166
+ - !ruby/object:Gem::Dependency
167
+ name: sus
168
+ requirement: !ruby/object:Gem::Requirement
169
+ requirements:
170
+ - - "~>"
171
+ - !ruby/object:Gem::Version
172
+ version: '0.35'
173
+ type: :development
174
+ prerelease: false
175
+ version_requirements: !ruby/object:Gem::Requirement
176
+ requirements:
177
+ - - "~>"
178
+ - !ruby/object:Gem::Version
179
+ version: '0.35'
180
+ - !ruby/object:Gem::Dependency
181
+ name: sus-fixtures-benchmark
182
+ requirement: !ruby/object:Gem::Requirement
183
+ requirements:
184
+ - - "~>"
185
+ - !ruby/object:Gem::Version
186
+ version: '0.2'
187
+ type: :development
188
+ prerelease: false
189
+ version_requirements: !ruby/object:Gem::Requirement
190
+ requirements:
191
+ - - "~>"
192
+ - !ruby/object:Gem::Version
193
+ version: '0.2'
194
+ description: Noiseless is a Rails-focused, ActiveRecord-style search abstraction supporting
195
+ Elasticsearch, OpenSearch, Typesense, and PostgreSQL with asynchronous querying
196
+ and a chainable DSL.
16
197
  email:
17
198
  - terminale@gmail.com
18
199
  executables: []
@@ -21,13 +202,84 @@ extra_rdoc_files: []
21
202
  files:
22
203
  - LICENSE.txt
23
204
  - README.md
205
+ - lib/application_search.rb
24
206
  - lib/noiseless.rb
207
+ - lib/noiseless/adapter.rb
208
+ - lib/noiseless/adapters.rb
209
+ - lib/noiseless/adapters/cluster_api.rb
210
+ - lib/noiseless/adapters/elasticsearch.rb
211
+ - lib/noiseless/adapters/execution_modules/elasticsearch_execution.rb
212
+ - lib/noiseless/adapters/execution_modules/es_compatible_execution.rb
213
+ - lib/noiseless/adapters/execution_modules/http_transport.rb
214
+ - lib/noiseless/adapters/execution_modules/opensearch_execution.rb
215
+ - lib/noiseless/adapters/execution_modules/pgvector_support.rb
216
+ - lib/noiseless/adapters/execution_modules/postgresql_execution.rb
217
+ - lib/noiseless/adapters/execution_modules/typesense_execution.rb
218
+ - lib/noiseless/adapters/indices_api.rb
219
+ - lib/noiseless/adapters/open_search.rb
220
+ - lib/noiseless/adapters/postgresql.rb
221
+ - lib/noiseless/adapters/typesense.rb
222
+ - lib/noiseless/ast.rb
223
+ - lib/noiseless/ast/aggregation.rb
224
+ - lib/noiseless/ast/bool.rb
225
+ - lib/noiseless/ast/bulk.rb
226
+ - lib/noiseless/ast/collapse.rb
227
+ - lib/noiseless/ast/combined_fields.rb
228
+ - lib/noiseless/ast/conversation.rb
229
+ - lib/noiseless/ast/field_value_node.rb
230
+ - lib/noiseless/ast/filter.rb
231
+ - lib/noiseless/ast/hybrid.rb
232
+ - lib/noiseless/ast/image_query.rb
233
+ - lib/noiseless/ast/join.rb
234
+ - lib/noiseless/ast/match.rb
235
+ - lib/noiseless/ast/multi_match.rb
236
+ - lib/noiseless/ast/paginate.rb
237
+ - lib/noiseless/ast/prefix.rb
238
+ - lib/noiseless/ast/range.rb
239
+ - lib/noiseless/ast/root.rb
240
+ - lib/noiseless/ast/search_after.rb
241
+ - lib/noiseless/ast/sort.rb
242
+ - lib/noiseless/ast/vector.rb
243
+ - lib/noiseless/ast/wildcard.rb
244
+ - lib/noiseless/bulk_importer.rb
245
+ - lib/noiseless/callbacks.rb
246
+ - lib/noiseless/connection_manager.rb
247
+ - lib/noiseless/document_manager.rb
248
+ - lib/noiseless/dsl.rb
249
+ - lib/noiseless/generators/application_search_generator.rb
250
+ - lib/noiseless/instrumentation.rb
251
+ - lib/noiseless/introspection.rb
252
+ - lib/noiseless/introspection/console.rb
253
+ - lib/noiseless/introspection/query_visualizer.rb
254
+ - lib/noiseless/mapping.rb
255
+ - lib/noiseless/mapping_definition_processor.rb
256
+ - lib/noiseless/model.rb
257
+ - lib/noiseless/model_registry.rb
258
+ - lib/noiseless/multi_search.rb
259
+ - lib/noiseless/pagination.rb
260
+ - lib/noiseless/query_builder.rb
261
+ - lib/noiseless/railtie.rb
262
+ - lib/noiseless/response.rb
263
+ - lib/noiseless/response/aggregations.rb
264
+ - lib/noiseless/response/empty.rb
265
+ - lib/noiseless/response/records.rb
266
+ - lib/noiseless/response/results.rb
267
+ - lib/noiseless/response/suggestions.rb
268
+ - lib/noiseless/response_factory.rb
269
+ - lib/noiseless/runtime_reset_middleware.rb
270
+ - lib/noiseless/search_index_update_job.rb
271
+ - lib/noiseless/test_case.rb
272
+ - lib/noiseless/test_helper.rb
25
273
  - lib/noiseless/version.rb
274
+ - lib/tasks/benchmark.rake
275
+ - lib/tasks/release.rake
276
+ - lib/tasks/test.rake
26
277
  homepage: https://github.com/seuros/noiseless
27
278
  licenses:
28
- - MIT
29
- metadata: {}
30
- post_install_message:
279
+ - BSD-3-Clause
280
+ metadata:
281
+ rubygems_mfa_required: 'true'
282
+ source_code_uri: https://github.com/seuros/noiseless
31
283
  rdoc_options: []
32
284
  require_paths:
33
285
  - lib
@@ -35,15 +287,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
35
287
  requirements:
36
288
  - - ">="
37
289
  - !ruby/object:Gem::Version
38
- version: '3.2'
290
+ version: '3.4'
39
291
  required_rubygems_version: !ruby/object:Gem::Requirement
40
292
  requirements:
41
293
  - - ">="
42
294
  - !ruby/object:Gem::Version
43
295
  version: '0'
44
296
  requirements: []
45
- rubygems_version: 3.4.19
46
- signing_key:
297
+ rubygems_version: 4.0.10
47
298
  specification_version: 4
48
- summary: Universal Ruby search abstraction with async and multi-backend support
299
+ summary: Async-first Rails search abstraction with multi-backend support
49
300
  test_files: []