mensa 0.6.14 → 0.6.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3d23dc5f37173fea8736de1271cd1c55f192f9bf28df2b2df7bc6d5c8e0d922
-  data.tar.gz: 190e32dd6e3d9b8e8cd3fb34875535dc494873a923895a6306289df521a17ae3
+  metadata.gz: 0a88070a879c44aa30934fd328a74c21546c2517999731ad033dc10022d2a4ee
+  data.tar.gz: 3940bc3931ce9f0a0aad748c378cbd7c3231616cedea960f7c24ab7bdc974cf2
 SHA512:
-  metadata.gz: 9b5913385d0de9990422c6a897631d8a3f119e025f48a994f976a30c94f7655f04874da6626e02d4aa6e88f4f45d952089b87784fb8228e2f24c14030342f950
-  data.tar.gz: ef17f02b50efaa802a7dbdbfe0fde4f8463da3c8c16fd3aa87b5344c2bbfcd21d52a36a072515a43d34caa21894bd3d4f7c75e6ac71ee613264d5692299c43c5
+  metadata.gz: 77fe83cd050e611f24086db47cd0a0f9330459289390df37361a97f82950819a0b22a0d6573a094be0cf4d7f6455624ccf08c44fd4f7d8c1c4398077df3fb192
+  data.tar.gz: a5485bbe47e59950753d270fde0ffc7618ec760837b3c2f435fa4b9f798c81822e514dab1e9688a090b2d31cc13929b2ecdd4fe3038ec57db6581eecb61b18aa

data/.shipkit.yml

@@ -1,2 +1,2 @@
 ---
-previous_version: 0.6.13
+previous_version: 0.6.15

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.6.16
+
+- Custom filter `scope` blocks can take the operator as a second argument,
+  e.g. `scope ->(value, operator) { ... }`, so they can handle `isnt`,
+  `is_empty` and the other operators. Existing `->(value) { ... }` scopes keep
+  working unchanged.
+
+## 0.6.15
+
+- Custom filter `scope` blocks now work. Applied filters are built from the
+  column's `filter do ... end` definition (`scope`, `operators`, `multiple`,
+  `collection`, `having`, ...) with the requested `value` and `operator`
+  layered on top, and `Mensa::Filter#scope` returns the proc instead of
+  calling it without arguments. Host apps can remove workarounds that patch
+  `Mensa::Base#active_filters` or `Mensa::Filter#scope`.
+- Only `value` and `operator` are taken from the request for applied filters;
+  other filter options come from the column definition.
+- Exports are refused (403) for tables with `exportable false`, instead of
+  being created and failing in `Mensa::ExportJob`.
+
 ## 0.6.12
 
 - Tables built with `params` (`table :name, params: {...}`) now work in filters,

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mensa (0.6.13)
+    mensa (0.6.15)
       csv
       importmap-rails
       pagy (>= 43)

data/README.md

@@ -118,6 +118,59 @@ You can show your tables on the page using the following:
 Custom views are views not defined by the developer (SystemViews) but by the end-user by adding/removing filters.
 When you enable these, they are stored in the database and can be used across sessions, by the user who created them.
 
+### Filters
+
+Add `filter` to a column to let users filter on it. By default Mensa compares the
+column's attribute with the chosen value, using operators that fit the column type.
+The filter block takes these options:
+
+```ruby
+column(:role) do
+  filter do
+    collection -> { User::ROLES }  # Values to choose from (array or proc)
+    multiple true                  # Allow choosing several values
+    operators [:is, :isnt]         # Limit the operators users can pick
+    operator :isnt                 # Default operator
+    having true                    # Filter with HAVING, for aggregate attributes
+  end
+end
+```
+
+The operators are `is`, `isnt`, `matches`, `does_not_match`, `gt`, `gteq`, `lt`,
+`lteq`, `is_duplicate`, `is_current`, `is_empty` and `isnt_empty`.
+
+#### Custom filter scopes
+
+When comparing the attribute isn't enough, give the filter a `scope`. It runs on the
+table's scope and receives the chosen value, an array when `multiple` is set:
+
+```ruby
+column(:account_names) do
+  attribute %((SELECT STRING_AGG(accounts.name, ', ') FROM accounts WHERE accounts.id = ANY(containers.account_ids)))
+  filter do
+    collection -> { Account.order(:name).pluck(:name) }
+    multiple true
+    operators [:is]
+    scope ->(value) { where("containers.account_ids && ARRAY[:ids]::uuid[]", ids: Account.where(name: Array(value)).pluck(:id)) }
+  end
+end
+```
+
+To support more operators, accept the operator (a symbol) as a second argument:
+
+```ruby
+filter do
+  operators [:is, :isnt, :is_empty]
+  scope ->(value, operator) {
+    case operator
+    when :isnt then where.not(account_id: value)
+    when :is_empty then where(account_id: nil)
+    else where(account_id: value)
+    end
+  }
+end
+```
+
 ### Grouping
 
 Rows can be shown in groups, each with a header that shows the group's value and

data/app/controllers/mensa/tables/exports_controller.rb

@@ -21,6 +21,8 @@ module Mensa
       # Creates a new export for the current user and enqueues the job that
       # generates and attaches the CSV.
       def create
+        return head :forbidden unless table.exportable?
+
         export = Mensa::Export.new(
           table_name: params[:table_id],
           table_view_id: params[:table_view_id].presence,
@@ -108,6 +110,12 @@ module Mensa
         @table_params ||= Mensa::TableParams.from_request(params)
       end
 
+      def table
+        @table ||= Mensa.for_name(params[:table_id], params: table_params).tap do |table|
+          table.original_view_context = helpers
+        end
+      end
+
       def list_stream
         turbo_stream.replace(Mensa::Export.list_dom_id(params[:table_id], current_mensa_user, params: table_params),
           partial: "mensa/exports/list", locals: list_locals)

data/app/tables/mensa/base.rb

@@ -107,12 +107,15 @@ module Mensa
       columns.any?(&:filter?)
     end
 
-    # Returns the active filters, skipping any whose column no longer exists.
     def active_filters
       (config[:filters] || {}).filter_map do |column_name, filter_config|
         col = column(column_name)
         next unless col
-        Mensa::Filter.new(column: col, config: filter_config, table: self)
+
+        definition = config.dig(:columns, col.name, :filter)
+        definition = {} unless definition.is_a?(Hash)
+        requested = (filter_config || {}).to_h.symbolize_keys.slice(:value, :operator)
+        Mensa::Filter.new(column: col, config: definition.merge(requested), table: self)
       end
     end
 

data/app/tables/mensa/filter.rb

@@ -10,7 +10,7 @@ module Mensa
 
     config_reader :operator, cast: :to_sym
     config_reader :value
-    config_reader :scope
+    config_reader :scope, call: false
     config_reader :multiple
     config_reader :having?
 
@@ -80,7 +80,7 @@ module Mensa
 
     def filter_scope(record_scope)
       if scope
-        record_scope.instance_exec(normalize(value), &scope)
+        record_scope.instance_exec(*scope_arguments, &scope)
       else
         return apply_duplicate_filter(record_scope) if operator == :is_duplicate
 
@@ -88,7 +88,7 @@ module Mensa
         return record_scope if value.is_a?(Array) && value.compact_blank.empty?
 
         query, hash = query_and_hash_for_operator
-        record_scope = (column.filter.having? ? record_scope.having(query, hash) : record_scope.where(query, hash)) if query.present?
+        record_scope = (having? ? record_scope.having(query, hash) : record_scope.where(query, hash)) if query.present?
         record_scope
       end
     end
@@ -182,6 +182,17 @@ module Mensa
       end
     end
 
+    # Arguments for a custom filter scope: the value and the operator. Lambdas
+    # only get as many as they declare, so `->(value) { ... }` keeps working
+    # next to `->(value, operator) { ... }`. Plain procs ignore extra arguments.
+    def scope_arguments
+      args = [normalize(value), operator]
+      return args unless scope.lambda?
+      return args if scope.parameters.any? { |type, _| type == :rest }
+
+      args.first(scope.parameters.count { |type, _| type == :req || type == :opt })
+    end
+
     def label_for_value(selected_value, options)
       option = options.find { |_label, value| value.to_s == selected_value.to_s }
       option ? option.first : selected_value

data/lib/mensa/version.rb

@@ -1,3 +1,3 @@
 module Mensa
-  VERSION = "0.6.14"
+  VERSION = "0.6.16"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mensa
 version: !ruby/object:Gem::Version
-  version: 0.6.14
+  version: 0.6.16
 platform: ruby
 authors:
 - Tom de Grunt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-10-10 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails