activecypher 0.8.2 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e809c6bea007b6a318d5edd2ccdace438cd005be107fe57c46e6502ef3070d5
-  data.tar.gz: 6579d0009293f0a496b951a705d4752d6e85b1eb94105f1296f53b642ee77638
+  metadata.gz: 2b70a7612e29fd973054f654ad63f28b6fe965d993073ffd39aefcdf10798326
+  data.tar.gz: c23ad33676db0a63bb389bb8edc597eaa4eb6f8cdcfbf44eb32e0eb4c640c1fd
 SHA512:
-  metadata.gz: ec67f5ba393f56c92c72473cad34afb2b6f05b77e5a0037333537b1c043b81588c08d5e2264cdc994f1e82a7326c50150be2429403d99d0bb69dc7f8c6d0d388
-  data.tar.gz: f690ef297c01518b540aadc5e258ce5e8ca2370026caff714259a26cc4db8178dc8ba0de2d0b20cf2e10c11d99aa65df5324cdb75376625d9ceaea1c5031fa42
+  metadata.gz: 3688ca19c11ee45562da2a6ccd6d65be740d4ba838802ec8dc52e8453ee80e42fbd771585e31b21ab857b6acb7abc449423debbae9cd2d86a5f9207009cc847d
+  data.tar.gz: f86b0d54cea7d36aa2d9093d37d0a816ab4fed6485b3697bc31c9a76abda329cae4adb5c33845baccaa5e86153c36aa4996146150b224b2eb7dec927fa43a8f2

data/lib/active_cypher/model/querying.rb

@@ -67,6 +67,30 @@ module ActiveCypher
                 "#{name} with internal_id=#{internal_db_id.inspect} not found. Perhaps it's in another castle, or just being 'graph'-ty."
         end
 
+        # Find the first node matching the given attributes, or return nil and question your life choices
+        # @param attributes [Hash] Attributes to match
+        # @return [Object, nil] The first matching record or nil
+        # Because apparently typing .where(attrs).limit(1).first was giving people RSI
+        def find_by(attributes = {})
+          return nil if attributes.blank?
+          where(attributes).limit(1).first
+        end
+
+        # Find the first node matching the given attributes or throw a tantrum
+        # @param attributes [Hash] Attributes to match
+        # @return [Object] The first matching record
+        # @raise [ActiveCypher::RecordNotFound] When no record is found
+        # For when nil isn't dramatic enough and you need your code to scream at you
+        def find_by!(attributes = {})
+          # Format attributes nicely for the error message
+          formatted_attrs = attributes.map { |k, v| "#{k}: #{v.inspect}" }.join(", ")
+          
+          find_by(attributes) || raise(ActiveCypher::RecordNotFound,
+                                       "Couldn't find #{name} with #{formatted_attrs}. " \
+                                       "Perhaps it's hiding in another graph, or maybe it never existed. " \
+                                       "Who can say in this vast, uncaring universe of nodes and relationships?")
+        end
+
         # Instantiates and immediately saves a new record. YOLO mode.
         # @param attrs [Hash] Attributes for the new record
         # @return [Object] The new, possibly persisted record

data/lib/active_cypher/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module ActiveCypher
-  VERSION = '0.8.2'
+  VERSION = '0.9.0'
 
   def self.gem_version
     Gem::Version.new VERSION

data/lib/cyrel/clause/set.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require 'cyrel/expression'
-require 'cyrel/expression/property_access'
-
 module Cyrel
   module Clause
     # Represents a SET clause in a Cypher query.

data/lib/cyrel/expression/base.rb

@@ -86,10 +86,7 @@ module Cyrel
 
       # Add more operators as needed (e.g., IN, STARTS WITH, CONTAINS, ENDS WITH)
       # These might be better represented as specific Comparison or FunctionCall types.
-
-      # NOTE: `coerce` method moved to the Expression module itself.
     end
-    require_relative 'alias' # Explicitly require the Alias class
 
     # Creates an aliased version of this expression.
     # @param alias_name [Symbol, String] The alias to assign.

data/lib/cyrel/expression/case.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative '../expression'
-
 module Cyrel
   module Expression
     # Represents a CASE expression in Cypher.

data/lib/cyrel/expression/exists.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-# Dependencies are autoloaded by Zeitwerk based on constant usage.
-# Explicit requires removed.
-
 module Cyrel
   module Expression
     # Represents an EXISTS { pattern } predicate in Cypher.

data/lib/cyrel/expression/pattern_comprehension.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-require_relative '../expression'
-require_relative '../pattern' # Need Path
-
 module Cyrel
   module Expression
     # Represents a Pattern Comprehension in Cypher.

data/lib/cyrel/expression/property_access.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative 'base'
-
 module Cyrel
   module Expression
     # Represents accessing a property on a variable (node or relationship alias).

data/lib/cyrel/expression.rb

@@ -1,8 +1,5 @@
 # frozen_string_literal: true
 
-# Subclasses are autoloaded by Zeitwerk based on constant usage.
-# Explicit requires removed.
-
 module Cyrel
   # Namespace for classes representing expressions in Cypher queries.
   # Expressions are parts of a query that evaluate to a value or condition.

data/lib/cyrel/pattern/relationship.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require_relative '../direction'
-
 module Cyrel
   module Pattern
     class Relationship

data/lib/cyrel/query.rb

@@ -1,11 +1,5 @@
 # frozen_string_literal: true
 
-# Base DSL components
-require 'cyrel/parameterizable'
-require 'cyrel/logging'
-
-# Require all clause types for DSL methods
-
 module Cyrel
   # Error raised when merging queries with conflicting alias definitions.
   # Because even in graphs, two things can't have the same name without drama.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activecypher
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.9.0
 platform: ruby
 authors:
 - Abdelkader Boudih
@@ -265,7 +265,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: OpenCypher Adapter ala ActiveRecord
 test_files: []