awesome_jsonb_translate 0.1.2 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 19ad415ad8a191751469f688c13b7ce82f9e7730b57c05e6b06dc5259eb31484
-  data.tar.gz: ab2e26b93e28301896a0a1b3d3d789b7c13ef561d9019982a3dac6ac2d8ff5cf
+  metadata.gz: d81ced6cfae9bbcf7aaf22dd231827333f59947fbe614312940b1a58ed5ddbd9
+  data.tar.gz: e6ad24b4afff672e784204523050684eaabb8424d95f4cb7286e57bfd1483704
 SHA512:
-  metadata.gz: a15e6770ef0fca5e97905da6c0cb52410aaf63dcf813821462a51841e197256295e07b99fa25de9d784445112ddd7078210f002824f63797f9468b1ea94062c4
-  data.tar.gz: 8539b0d186c500fb2c8de017386f4acd6118cbcc726873a61e1b8b1ec4bdb2a907cb809547542a3e3be2441bc4c70339b1a66eeab62158adfe4b4832a9cae097
+  metadata.gz: e1f1c95edd20c951ef43d669e4ba8f09b439ece16fab7f9c6d3f7626bf378ada3066690fa0084d5293a4029ffd876137644f014d012b723e1b6aea557a97344b
+  data.tar.gz: 11e2c1c76892384196f9aad8ad0fec6e8f53cfe3d340a29fd87fe822cd9b660a66a801f13455822e23ee1d3d964d08dece2d8b3390c3ffb43e48757f95e3a3d9

data/README.md

@@ -1,4 +1,4 @@
-# Awesome JSONB Translate
+# Awesome JSONB Translate [![Gem Version](https://badge.fury.io/rb/awesome_jsonb_translate.svg)](https://badge.fury.io/rb/awesome_jsonb_translate)
 
 This gem uses PostgreSQL's JSONB datatype and ActiveRecord models to translate model data.
 
@@ -10,7 +10,8 @@ This gem uses PostgreSQL's JSONB datatype and ActiveRecord models to translate m
 
 ## Features
 
-- [x] `v0.1.2` It works
+- [x] `v0.2.0` Support for raw JSONB syntax in find_by queries
+- [x] `v0.1.3` Fix redundant fallbacks when translation is nil
 
 ## Requirements
 
@@ -71,10 +72,12 @@ It always falls back to default locale
 # Behavior with fallbacks enabled
 p = Page.new(title_en: 'English title')
 I18n.with_locale(:de) { p.title } # => 'English title' (falls back to English)
+p.title_de # => nil
 
 # Behavior with empty string
 p = Page.new(title_en: 'English title', title_de: '')
 I18n.with_locale(:de) { p.title } # => 'English title' (falls back since German is empty)
+p.title_de # => ''
 ```
 
 ### Assigning a Hash Directly
@@ -93,6 +96,8 @@ p.title_de = 'Aktualisierter Deutscher Titel'
 
 ### Querying by Translated Value (JSONB-aware)
 
+**Hash-based queries (recommended for most use cases):**
+
 ```ruby
 # Find records by current locale value
 Page.find_by(title_en: 'English title')
@@ -107,6 +112,35 @@ Page.find_by(title_en: 'English title', author: 'John')
 Page.where("title->>'en' = ?", 'English title').where(author: 'John')
 ```
 
+**Raw JSONB syntax queries (for advanced use cases):**
+
+You can also use raw PostgreSQL JSONB syntax directly with `find_by`:
+
+```ruby
+# Direct JSONB query syntax
+Page.find_by("title->>'en' = ?", 'English title')
+
+# Complex JSONB queries with operators
+Page.find_by("title->>'en' ILIKE ?", '%title%')
+
+# Case-insensitive search
+Page.find_by("LOWER(title->>'en') = ?", 'english title')
+```
+
+**Important:** Raw SQL string syntax is only supported with `find_by`. The methods `find_or_initialize_by` and `find_or_create_by` require hash-based syntax because they need to know which attributes to set when creating/initializing new records.
+
+For these methods, use hash syntax with translated accessors:
+```ruby
+# Correct - uses hash syntax
+Page.find_or_initialize_by(title_en: 'English title')
+Page.find_or_create_by(title_de: 'Deutscher Titel')
+
+# Incorrect - string syntax not supported
+# Page.find_or_create_by("title->>'en' = ?", 'English title')  # Will not work
+```
+
+When using raw JSONB syntax with `find_by`, the gem delegates to ActiveRecord's native query methods, giving you full access to PostgreSQL's JSONB operators and functions.
+
 ### Finding or Initializing Records
 
 ```ruby

data/lib/awesome_jsonb_translate/active_record.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 module AwesomeJsonbTranslate
+  # Extends ActiveRecord models with translation capabilities using PostgreSQL JSONB columns
   module ActiveRecord
     def translates(*attrs)
       include InstanceMethods
@@ -33,7 +34,7 @@ module AwesomeJsonbTranslate
 
     def define_translation_reader_for_locale(attr_name, locale)
       define_method("#{attr_name}_#{locale}") do
-        read_translation(attr_name, locale)
+        read_translation_without_fallback(attr_name, locale)
       end
     end
 
@@ -63,6 +64,7 @@ module AwesomeJsonbTranslate
       end
     end
 
+    # Provides instance methods for reading and writing translations
     module InstanceMethods
       def translated?(attr_name, locale = I18n.locale)
         value = read_translation_without_fallback(attr_name, locale)
@@ -110,9 +112,12 @@ module AwesomeJsonbTranslate
       end
     end
 
+    # Overrides ActiveRecord finder methods to support querying by translated attributes
     module FindByMethods
       # Override find_by to handle translated attributes
-      def find_by(attributes)
+      def find_by(attributes, *args)
+        return super unless attributes.is_a?(Hash)
+
         # Check if any of the keys represent translated attributes
         has_translated_attrs = attributes.keys.any? do |key|
           translated_accessors.include?(key.to_sym)
@@ -154,7 +159,9 @@ module AwesomeJsonbTranslate
       end
 
       # Override find_or_initialize_by to handle translated attributes
-      def find_or_initialize_by(attributes)
+      def find_or_initialize_by(attributes, &block)
+        return super unless attributes.is_a?(Hash)
+
         result = find_by(attributes)
         return result if result
 
@@ -165,7 +172,9 @@ module AwesomeJsonbTranslate
       end
 
       # Override find_or_create_by to handle translated attributes
-      def find_or_create_by(attributes)
+      def find_or_create_by(attributes, &block)
+        return super unless attributes.is_a?(Hash)
+
         result = find_by(attributes)
         return result if result
 

data/lib/awesome_jsonb_translate/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AwesomeJsonbTranslate
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

data/lib/awesome_jsonb_translate.rb

@@ -4,6 +4,6 @@ require 'active_record'
 require 'awesome_jsonb_translate/version'
 require 'awesome_jsonb_translate/active_record'
 
+# Provides PostgreSQL JSONB-based translation functionality for ActiveRecord models
 module AwesomeJsonbTranslate
-  # Just serve as a namespace
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: awesome_jsonb_translate
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Nick Ostrovsky
 bindir: bin
 cert_chain: []
-date: 2025-04-18 00:00:00.000000000 Z
+date: 2025-11-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -37,48 +37,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: pg
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 description: This gem uses PostgreSQL's JSONB datatype to store and retrieve translations
   for ActiveRecord models without extra columns or tables
 email:
@@ -108,14 +66,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.6
 specification_version: 4
 summary: ActiveRecord translations using PostgreSQL's JSONB data type
 test_files: []