arel_extensions 1.5.3 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 63ac168e55da77eacb9edfa70f025558721346a4912f225a2b35be1b7bd4eb66
-  data.tar.gz: d24d852a75734d25306326ce3068ad541155f2643990e71eeedccbe823354d2d
+  metadata.gz: fc5e8faed3431c98442763629d3e67398798d70580bdb5137f90bd1b11947d8f
+  data.tar.gz: a8b396a11006278c2d0e067750d99d61c24a07712cecd189905c064aac4f8fe1
 SHA512:
-  metadata.gz: ae560399c811449f49ad80139a244e2e8602b0e897b17ec2a58e0af3e99aa31e6e4c302fd78a32737817b03531bc86f4cfd3b929e149c2fa862af371a10b6b2a
-  data.tar.gz: 581b12e386fc04cc4fd0dd7e7ab975a40ec6f077203f9d8350b665e7f679c8bd942ab2b30c4f6225cc3bb85dc1213247743e497e059bae83fe56d541235a8eb8
+  metadata.gz: 67eb687a130704304d0c9c1a36cc0dbc9e0f41e0ae882005e5b51ea1d066988f596472fa23847364160f502ca8b9c7831bba216665256f59f52cbc292f7006bd
+  data.tar.gz: 9b73530a338a85a478fd350089976aae94c359f9d80e9e94ca8b829404475f4ed11a6dfd9fca718eef930ea3c151712cd4da757b9696f66285db55e37382838e

data/.github/workflows/ruby.yml

@@ -24,10 +24,20 @@ jobs:
       matrix:
         versions:
           [
+            { ruby: "3.4", rails: 8_1, arelx: 2 },
+            { ruby: "3.4", rails: 8, arelx: 2 },
+            { ruby: "3.4", rails: 7_2, arelx: 2 },
+            { ruby: "3.4", rails: 7_1, arelx: 2 },
+            { ruby: "3.4", rails: 7, arelx: 2 },
+            { ruby: "3.4", rails: 6_1, arelx: 2 },
+            { ruby: "3.3", rails: 8_1, arelx: 2 },
+            { ruby: "3.3", rails: 8, arelx: 2 },
             { ruby: "3.3", rails: 7_2, arelx: 2 },
             { ruby: "3.3", rails: 7_1, arelx: 2 },
             { ruby: "3.3", rails: 7, arelx: 2 },
             { ruby: "3.3", rails: 6_1, arelx: 2 },
+            { ruby: "3.2", rails: 8_1, arelx: 2 },
+            { ruby: "3.2", rails: 8, arelx: 2 },
             { ruby: "3.2", rails: 7_2, arelx: 2 },
             { ruby: "3.2", rails: 7_1, arelx: 2 },
             { ruby: "3.2", rails: 7, arelx: 2 },
@@ -46,11 +56,6 @@ jobs:
             { ruby: "2.7", rails: 6_1, arelx: 2 },
             { ruby: "2.7", rails: 6, arelx: 2 },
             { ruby: "2.7", rails: 5_2, arelx: 1 },
-            { ruby: "2.7", rails: 4_2, arelx: 1 },
-            { ruby: "2.5", rails: 6_1, arelx: 2 },
-            { ruby: "2.5", rails: 6, arelx: 2 },
-            { ruby: "2.5", rails: 5_2, arelx: 1 },
-            { ruby: "2.5", rails: 4_2, arelx: 1 },
             { ruby: jruby-9.2, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.2, rails: 6, arelx: 2 },
             { ruby: jruby-9.2, rails: 5_2, arelx: 1 },
@@ -88,10 +93,20 @@ jobs:
       matrix:
         versions:
           [
+            { ruby: "3.4", rails: 8_1, arelx: 2 },
+            { ruby: "3.4", rails: 8, arelx: 2 },
+            { ruby: "3.4", rails: 7_2, arelx: 2 },
+            { ruby: "3.4", rails: 7_1, arelx: 2 },
+            { ruby: "3.4", rails: 7, arelx: 2 },
+            { ruby: "3.4", rails: 6_1, arelx: 2 },
+            { ruby: "3.3", rails: 8_1, arelx: 2 },
+            { ruby: "3.3", rails: 8, arelx: 2 },
             { ruby: "3.3", rails: 7_2, arelx: 2 },
             { ruby: "3.3", rails: 7_1, arelx: 2 },
             { ruby: "3.3", rails: 7, arelx: 2 },
             { ruby: "3.3", rails: 6_1, arelx: 2 },
+            { ruby: "3.2", rails: 8_1, arelx: 2 },
+            { ruby: "3.2", rails: 8, arelx: 2 },
             { ruby: "3.2", rails: 7_2, arelx: 2 },
             { ruby: "3.2", rails: 7_1, arelx: 2 },
             { ruby: "3.2", rails: 7, arelx: 2 },
@@ -110,15 +125,9 @@ jobs:
             { ruby: "2.7", rails: 6_1, arelx: 2 },
             { ruby: "2.7", rails: 6, arelx: 2 },
             { ruby: "2.7", rails: 5_2, arelx: 1 },
-            { ruby: "2.7", rails: 4_2, arelx: 1 },
-            { ruby: "2.5", rails: 6_1, arelx: 2 },
-            { ruby: "2.5", rails: 6, arelx: 2 },
-            { ruby: "2.5", rails: 5_2, arelx: 1 },
-            { ruby: "2.5", rails: 4_2, arelx: 1 },
             { ruby: jruby-9.2, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.2, rails: 6, arelx: 2 },
             { ruby: jruby-9.2, rails: 5_2, arelx: 1 },
-            { ruby: jruby-9.2, rails: 4_2, arelx: 1 },
             { ruby: jruby-9.3, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.3, rails: 6, arelx: 2 },
             { ruby: jruby-9.3, rails: 5_2, arelx: 1 },
@@ -152,10 +161,20 @@ jobs:
       fail-fast: false
       matrix:
         versions: [
+            { ruby: "3.4", rails: 8_1, arelx: 2 },
+            { ruby: "3.4", rails: 8, arelx: 2 },
+            { ruby: "3.4", rails: 7_2, arelx: 2 },
+            { ruby: "3.4", rails: 7_1, arelx: 2 },
+            { ruby: "3.4", rails: 7, arelx: 2 },
+            { ruby: "3.4", rails: 6_1, arelx: 2 },
+            { ruby: "3.3", rails: 8_1, arelx: 2 },
+            { ruby: "3.3", rails: 8, arelx: 2 },
             { ruby: "3.3", rails: 7_2, arelx: 2 },
             { ruby: "3.3", rails: 7_1, arelx: 2 },
             { ruby: "3.3", rails: 7, arelx: 2 },
             { ruby: "3.3", rails: 6_1, arelx: 2 },
+            { ruby: "3.2", rails: 8_1, arelx: 2 },
+            { ruby: "3.2", rails: 8, arelx: 2 },
             { ruby: "3.2", rails: 7_2, arelx: 2 },
             { ruby: "3.2", rails: 7_1, arelx: 2 },
             { ruby: "3.2", rails: 7, arelx: 2 },
@@ -174,15 +193,9 @@ jobs:
             { ruby: "2.7", rails: 6_1, arelx: 2 },
             { ruby: "2.7", rails: 6, arelx: 2 },
             { ruby: "2.7", rails: 5_2, arelx: 1 },
-            { ruby: "2.7", rails: 4_2, arelx: 1 },
-            { ruby: "2.5", rails: 6_1, arelx: 2 },
-            { ruby: "2.5", rails: 6, arelx: 2 },
-            { ruby: "2.5", rails: 5_2, arelx: 1 },
-            { ruby: "2.5", rails: 4_2, arelx: 1 },
             { ruby: jruby-9.2, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.2, rails: 6, arelx: 2 },
             { ruby: jruby-9.2, rails: 5_2, arelx: 1 },
-            { ruby: jruby-9.2, rails: 4_2, arelx: 1 },
             { ruby: jruby-9.3, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.3, rails: 6, arelx: 2 },
             { ruby: jruby-9.3, rails: 5_2, arelx: 1 },
@@ -241,10 +254,20 @@ jobs:
       fail-fast: false
       matrix:
         versions: [
+            { ruby: "3.4", rails: 8_1, arelx: 2 },
+            { ruby: "3.4", rails: 8, arelx: 2 },
+            { ruby: "3.4", rails: 7_2, arelx: 2 },
+            { ruby: "3.4", rails: 7_1, arelx: 2 },
+            { ruby: "3.4", rails: 7, arelx: 2 },
+            { ruby: "3.4", rails: 6_1, arelx: 2 },
+            { ruby: "3.3", rails: 8_1, arelx: 2 },
+            { ruby: "3.3", rails: 8, arelx: 2 },
             { ruby: "3.3", rails: 7_2, arelx: 2 },
             { ruby: "3.3", rails: 7_1, arelx: 2 },
             { ruby: "3.3", rails: 7, arelx: 2 },
             { ruby: "3.3", rails: 6_1, arelx: 2 },
+            { ruby: "3.2", rails: 8_1, arelx: 2 },
+            { ruby: "3.2", rails: 8, arelx: 2 },
             { ruby: "3.2", rails: 7_2, arelx: 2 },
             { ruby: "3.2", rails: 7_1, arelx: 2 },
             { ruby: "3.2", rails: 7, arelx: 2 },
@@ -263,35 +286,56 @@ jobs:
             { ruby: "2.7", rails: 6_1, arelx: 2 },
             { ruby: "2.7", rails: 6, arelx: 2 },
             { ruby: "2.7", rails: 5_2, arelx: 1 },
-            { ruby: "2.7", rails: 4_2, arelx: 1 },
-            { ruby: "2.5", rails: 6_1, arelx: 2 },
-            { ruby: "2.5", rails: 6, arelx: 2 },
-            { ruby: "2.5", rails: 5_2, arelx: 1 },
-            { ruby: "2.5", rails: 4_2, arelx: 1 },
             { ruby: jruby-9.2, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.2, rails: 6, arelx: 2 },
             { ruby: jruby-9.2, rails: 5_2, arelx: 1 },
-            { ruby: jruby-9.2, rails: 4_2, arelx: 1 },
             { ruby: jruby-9.3, rails: 6_1, arelx: 2 },
             { ruby: jruby-9.3, rails: 6, arelx: 2 },
             { ruby: jruby-9.3, rails: 5_2, arelx: 1 },
           ]
-    services:
-      mysql:
-        image: mysql:5.7
-        env:
-          MYSQL_ALLOW_EMPTY_PASSWORD: true
-          MYSQL_USERNAME: root
-          MYSQL_DATABASE: arelx_test
-        ports:
-          - 3306:3306
-        options: >-
-          --health-cmd="mysqladmin ping"
-          --health-interval=10s
-          --health-timeout=5s
-          --health-retries=3
+    # TODO: restore the service. it's far simpler, but since we're testing old
+    # mysql, and we want utf-8 by default, we're currently forced to avoid the
+    # service, and do it as a step. Maybe there's a better solution, who knows?
+    #
+    # services:
+    #   mysql:
+    #     image: mysql:5.7
+    #     env:
+    #       MYSQL_ALLOW_EMPTY_PASSWORD: true
+    #       MYSQL_USERNAME: root
+    #       MYSQL_DATABASE: arelx_test
+    #     ports:
+    #       - 3306:3306
+    #     options: >-
+    #       --health-cmd="mysqladmin ping"
+    #       --health-interval=10s
+    #       --health-timeout=5s
+    #       --health-retries=3
+    #
     steps:
       - uses: actions/checkout@v2
+
+      - name: Start MySQL with UTF-8
+        run: |
+          docker run -d \
+            --name mysql \
+            -e MYSQL_ALLOW_EMPTY_PASSWORD=true \
+            -e MYSQL_DATABASE=arelx_test \
+            -p 3306:3306 \
+            --health-cmd="mysqladmin ping" \
+            --health-interval=10s \
+            --health-timeout=5s \
+            --health-retries=3 \
+            mysql:5.7 \
+            --character-set-server=utf8mb4
+
+      - name: Wait for MySQL
+        run: |
+          until docker exec mysql mysqladmin ping --silent; do
+            echo 'Waiting for MySQL...'
+            sleep 2
+          done
+
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -325,10 +369,21 @@ jobs:
       fail-fast: false
       matrix:
         versions: [
+            { ruby: "3.4", rails: 8_1, arelx: 2 },
+            { ruby: "3.4", rails: 8, arelx: 2 },
+            { ruby: "3.4", rails: 7_2, arelx: 2 },
+            { ruby: "3.4", rails: 7_1, arelx: 2 },
+            { ruby: "3.4", rails: 7, arelx: 2 },
+            { ruby: "3.4", rails: 6_1, arelx: 2 },
+            { ruby: "3.3", rails: 8_1, arelx: 2 },
+            { ruby: "3.3", rails: 8, arelx: 2 },
+            { ruby: "3.3", rails: 7_2, arelx: 2 },
             { ruby: "3.3", rails: 7_1, arelx: 2 },
             { ruby: "3.3", rails: 7, arelx: 2 },
             { ruby: "3.3", rails: 6_1, arelx: 2 },
             { ruby: "3.3", rails: 6, arelx: 2 },
+            { ruby: "3.2", rails: 8_1, arelx: 2 },
+            { ruby: "3.2", rails: 8, arelx: 2 },
             { ruby: "3.2", rails: 7_1, arelx: 2 },
             { ruby: "3.2", rails: 7, arelx: 2 },
             { ruby: "3.2", rails: 6_1, arelx: 2 },
@@ -343,15 +398,9 @@ jobs:
             { ruby: "2.7", rails: 6_1, arelx: 2 },
             { ruby: "2.7", rails: 6, arelx: 2 },
             { ruby: "2.7", rails: 5_2, arelx: 1 },
-            { ruby: "2.7", rails: 4_2, arelx: 1 },
-            { ruby: "2.5", rails: 6_1, arelx: 2 },
-            { ruby: "2.5", rails: 6, arelx: 2 },
-            { ruby: "2.5", rails: 5_2, arelx: 1 },
-            { ruby: "2.5", rails: 4_2, arelx: 1 },
             # {ruby: jruby-9.2,   rails: 6_1, arelx: 2},
             # {ruby: jruby-9.2,   rails: 6,   arelx: 2},
             { ruby: jruby-9.2, rails: 5_2, arelx: 1 },
-            { ruby: jruby-9.2, rails: 4_2, arelx: 1 },
             # See comments on 9.4 to understand why these are disabled for now.
             # {ruby: jruby-9.3,   rails: 6_1, arelx: 2},
             # {ruby: jruby-9.3,   rails: 6,   arelx: 2},

data/.gitignore

@@ -1,7 +1,8 @@
 *.DS_Store
+*.jar
+*.lock
 *.swp
 .bundle
-Gemfile.lock
 config/database.yml
 coverage/*
 debug.log

data/.rubocop.yml

@@ -1,7 +1,26 @@
+plugins:
+  - rubocop-performance
+
 AllCops:
-  DisabledByDefault: true
+  NewCops: enable
+  TargetRubyVersion: 2.7
+  SuggestExtensions: false
+  # TODO: enable for tests.
   Exclude:
-  - "vendor/**/*"
+    - vendor/**/*
+    - dev/**/*
+    - test/**/*
+
+# TODO: enable.
+Gemspec/RequireMFA:
+  Enabled: false
+
+# TODO: enable.
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
+Layout/ArgumentAlignment:
+  Enabled: false
 
 Layout/EndOfLine:
   Enabled: true
@@ -15,6 +34,9 @@ Layout/IndentationWidth:
 Layout/LineLength:
   Enabled: false
 
+Layout/MultilineMethodCallIndentation:
+  EnforcedStyle: indented
+
 Layout/SpaceAfterComma:
   Enabled: true
 
@@ -28,15 +50,66 @@ Layout/SpaceInsideHashLiteralBraces:
   Enabled: true
   EnforcedStyle: no_space
 
+Lint/BinaryOperatorWithIdenticalOperands:
+  Enabled: true
+  Exclude:
+    - test/with_ar/all_agnostic_test.rb
+
+# TODO: should we enable it? It's complaining about things like (1*2+3)
+Lint/AmbiguousOperatorPrecedence:
+  Enabled: false
+
 Layout/TrailingEmptyLines:
   Enabled: true
 
+# TODO: enable.
+Metrics/AbcSize:
+  Enabled: false
+
+# TODO: enable.
 Metrics/BlockLength:
   Enabled: false
 
+Metrics/BlockNesting:
+  Enabled: false
+
+# TODO: enable.
+Metrics/MethodLength:
+  Enabled: false
+
+Metrics/ModuleLength:
+  Enabled: false
+
+# TODO: enable.
+Metrics/CyclomaticComplexity:
+  Enabled: false
+
+# TODO: enable.
+Metrics/PerceivedComplexity:
+  Enabled: false
+
+Naming/AsciiIdentifiers:
+  Enabled: true
+  Exclude:
+    - lib/arel_extensions/boolean_functions.rb
+
+Naming/MethodName:
+  Exclude:
+    - lib/arel_extensions/boolean_functions.rb
+
+# TODO: enable.
+Naming/MethodParameterName:
+  Enabled: false
+
 Naming/FileName:
   Enabled: true
 
+Style/BlockDelimiters:
+  Enabled: false
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
 Style/CollectionMethods:
   Enabled: true
 
@@ -49,12 +122,33 @@ Style/CommentAnnotation:
 Style/ConditionalAssignment:
   Enabled: true
 
+# TODO: enable.
+Style/Documentation:
+  Enabled: false
+
+Style/EachWithObject:
+  Enabled: false
+
 Style/EmptyElse:
   Enabled: true
 
 Style/Encoding:
   Enabled: true
 
+Style/FormatString:
+  Enabled: false
+
+# TODO: enable.
+Style/GlobalVars:
+  Enabled: false
+
+# TODO: enable.
+Style/GuardClause:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
 Style/HashSyntax:
   Enabled: true
   EnforcedStyle: ruby19
@@ -65,9 +159,23 @@ Style/MethodCallWithArgsParentheses:
 Style/MethodCallWithoutArgsParentheses:
   Enabled: true
 
+Style/MultipleComparison:
+  Enabled: true
+  Exclude:
+    - lib/arel_extensions/boolean_functions.rb
+
 Style/NegatedIf:
   Enabled: false
 
+Style/NegatedIfElseCondition:
+  Enabled: false
+
+Style/NegatedWhile:
+  Enabled: false
+
+Style/NestedTernary:
+  Enabled: false
+
 Style/NumericLiterals:
   Enabled: true
 
@@ -80,10 +188,19 @@ Style/RedundantRegexpCharacterClass:
 Style/RedundantReturn:
   Enabled: true
 
+# TODO: enable.
+# We have some `... rescue nil` going on, let's keep it this way for now.
+Style/RescueModifier:
+  Enabled: false
+
 # Even when conservative, this is unsafe.
-#Style/StringConcatenation:
-#  Enabled: true
-#  Mode: 'conservative'
+# Style/StringConcatenation:
+#   Enabled: true
+#   Mode: 'conservative'
+
+# This detects User.at[:id] + '1' as string concatenation, so never enable.
+Style/StringConcatenation:
+  Enabled: false
 
 Style/StringLiterals:
   Enabled: true
@@ -91,9 +208,18 @@ Style/StringLiterals:
 Style/SymbolArray:
   Enabled: true
 
+Style/UnlessElse:
+  Enabled: false
+
+Style/WhileUntilDo:
+  Enabled: false
+
 Style/WordArray:
   Enabled: true
 
+Style/YodaCondition:
+  Enabled: false
+
 # Performance cops have been transferred to rubocop-performance gem.
 require: rubocop-performance
 

data/Makefile

@@ -0,0 +1,48 @@
+COMPOSE_FILE := dev/compose.yaml
+DC := docker compose -f $(COMPOSE_FILE)
+
+.PHONY: all clean down install lint publish rebuild shell test up
+
+all: clean install
+
+clean:
+	rm -rf .bundle Gemfile.lock vendor
+
+down:
+	$(DC) down
+
+install:
+	bundle install
+
+lint:
+	bundle exec rubocop --config .rubocop.yml --require rubocop-performance
+
+lint-fix:
+	bundle exec rubocop --config .rubocop.yml -a
+
+local-%:
+	@version="$*"; \
+	file="gemfiles/rails$${version//./_}.gemfile"; \
+	if [ ! -f "$$file" ]; then \
+		echo "No such Gemfile: $$file"; \
+		exit 1; \
+	fi; \
+	echo "Using $$file"; \
+	bundle config set --local gemfile "$$file"
+
+publish:
+	./bin/publish
+
+rebuild:
+	$(DC) build --no-cache
+
+# Jump into the container
+shell: up
+	$(DC) exec arelx bash
+
+test:
+	bundle exec rake test
+
+# Boot everything and keep it running (daemon mode)
+up:
+	$(DC) up -d

data/NEWS.md

@@ -2,6 +2,28 @@
 
 ## [unreleased]
 
+## Release v2.5.0/v1.7.0 (02-09-2026)
+
+- Fix a typo preventing optimizer hints from being applied on SELECT in MySQL.
+- Fix a bug (crash) in Group Concat of MSSQL.
+- Fix a crash when building a JSON document from numeric literal values (e.g. `Arel.json(col => 1)`), on sqlite and mssql.
+- MS SQL: string casts and MD5 input now use `varchar(MAX)`, so long strings are
+  no longer truncated at 30 characters (the default when only `varchar` is specified).
+- PostgreSQL: JSON creation from non-JSON text now encodes it (`to_jsonb` instead of a
+  bare `::jsonb` cast), and `json.set(key, nil)` sets the JSON null member instead of the db's NULL.
+- PostgreSQL: an empty JSON array (`Arel.json([])`) is now rendered as `'[]'::jsonb`
+  instead of `to_jsonb(array[])`.
+- JSON: Booleans (`true`/`false`) are now supported as JSON values, whether as literals
+  (`Arel.json({ col => true })`) or boolean columns (`Arel.json({ col => bool_col })`).
+- String slicing: the `[range..]` syntax, and calls to `substring` now behave exactly as in Ruby and MySQL, notably handling negative and beginless/endless indices.
+
+## Release v2.4.0/v1.6.0 (23-12-2025)
+
+- Drop supoprt for Ruby < 2.7.
+- Drop support for Rails < 5.2.
+- Add support for Rails 8 and 8.1.
+- Add `byte_size` and `char_length`. They should replace all uses of `length` because it's inconsistent across vendors; it can surprise you and give you byte size when you expect string length.
+
 ## Release v2.3.3/v1.5.3 (11-02-2025)
 
 - Fix the `&` operator which does `find_in_set` for mysql and postgres, accepting strings and integers.

data/README.md

@@ -31,7 +31,7 @@ Most of the features will work just by adding the gem to your Gemfiles. To make
 ArelExtensions::CommonSqlFunctions.new(ActiveRecord::Base.connection).add_sql_functions()
 ```
 
-It will add common SQL features in your DB to align ti with current routines. Technically, it will execute SQL scripts from init folder.
+It will add common SQL features in your DB to align it with current routines. Technically, it will execute SQL scripts from init folder.
 
 
 ## Examples
@@ -195,7 +195,7 @@ by the RDBMS.
 Warning:
 
 - ⚠️ Time Zone names are specific to each RDBMS. While `PostgreSQL` and `MySQL`
-  have overlaping names (the ones prefixed with `posix`), you should always
+  have overlapping names (the ones prefixed with `posix`), you should always
   read your vendor's documentation. `SQL Server` is a black sheep and has its
   own conventions.
 - ⚠️ Daylight saving is managed by the RDBMS vendor. Choose the approptiate time
@@ -345,7 +345,7 @@ User.connection.execute(insert_manager.to_sql)
     <td class="ok">✔</td>
   </tr>
   <tr>
-    <th class="tg-ffjm" rowspan="17"><div>String functions</div></th>
+    <th class="tg-ffjm" rowspan="21"><div>String functions</div></th>
     <td class="tg-yw4l">CONCAT<br>column + "string"</td>
     <td class="ok">✔</td>
     <td class="ok">✔</td>
@@ -373,7 +373,25 @@ User.connection.execute(insert_manager.to_sql)
     <td class="tg-j6lv">LOWER() LIKE LOWER()</td>
   </tr>
   <tr>
-    <td class="tg-yw4l">LENGTH<br>column.length</td>
+    <td class="tg-yw4l">LENGTH<br>column.char_length</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="tg-j6lv">✔</td>
+    <td class="ok">not implemented</td>
+  </tr>
+  <tr>
+    <td class="tg-yw4l">LENGTH (aka octet_length)<br>column.byte_size</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="tg-j6lv">✔</td>
+    <td class="ok">not implemented</td>
+  </tr>
+  <tr>
+    <td class="tg-yw4l">LENGTH<br>column.length<br>⚠️ not portable, prefer char_length or byte_size</td>
     <td class="ok">✔</td>
     <td class="ok">✔</td>
     <td class="ok">✔</td>
@@ -472,7 +490,7 @@ User.connection.execute(insert_manager.to_sql)
     <td class="ok">✔</td>
   </tr>
   <tr>
-    <td class="tg-yw4l">SUBSTRING<br/>column[1..2]<br/>column.substring(1)<br/>column.substring(1, 1)</td>
+    <td class="tg-yw4l">SUBSTRING (start/length)<br/>column.substring(1)<br/>column.substring(1, 1)<br/>column[1]<br/>column[0, 2]</td>
     <td class="ok">✔</td>
     <td class="tg-j6lv">SUBSTR()</td>
     <td class="tg-j6lv">SUBSTR()</td>
@@ -480,6 +498,15 @@ User.connection.execute(insert_manager.to_sql)
     <td class="ok">✔</td>
     <td class="ok">✔</td>
   </tr>
+  <tr>
+    <td class="tg-yw4l">SUBSTRING (Ruby range slicing)<br/>column[1..2]<br/>column[-2..]<br/>column[..2]<br/>⚠️ empty-string results read as NULL on Oracle</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="ok">✔</td>
+    <td class="tg-j6lv">not implemented</td>
+  </tr>
   <tr>
     <td class="tg-yw4l">TRIM (leading)<br>column.trim("LEADING","M")</td>
     <td class="ok">✔</td>

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler'
 Bundler::GemHelper.install_tasks name: 'arel_extensions'
 
@@ -51,7 +53,7 @@ end
 
 # Useful shorthands.
 namespace :test do
-  task :sql => :to_sql
-  task :pg => :postgresql
-  task :postgres => :postgresql
+  task sql: :to_sql
+  task pg: :postgresql
+  task postgres: :postgresql
 end

data/arel_extensions.gemspec

@@ -1,4 +1,6 @@
-$:.push File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+$LOAD_PATH.push File.expand_path('lib', __dir__)
 require 'arel_extensions/version'
 
 Gem::Specification.new do |s|
@@ -17,11 +19,7 @@ Gem::Specification.new do |s|
 
   # Manifest
   s.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.require_paths = ['lib']
 
   s.add_dependency('arel', '>= 6.0')
-
-  s.add_development_dependency('minitest', '~> 5.9')
-  s.add_development_dependency('rake', '~> 12.3.3')
 end