activecypher 0.8.2 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e809c6bea007b6a318d5edd2ccdace438cd005be107fe57c46e6502ef3070d5
-  data.tar.gz: 6579d0009293f0a496b951a705d4752d6e85b1eb94105f1296f53b642ee77638
+  metadata.gz: cee43c77d5c77240791bd23a3ea08410ae58034f29f86d4bd0ec35bc65640b43
+  data.tar.gz: 9a5947493ac00f596f11a3ae6e5ceba5c1bb145b56a203c38e27f9c011790fdb
 SHA512:
-  metadata.gz: ec67f5ba393f56c92c72473cad34afb2b6f05b77e5a0037333537b1c043b81588c08d5e2264cdc994f1e82a7326c50150be2429403d99d0bb69dc7f8c6d0d388
-  data.tar.gz: f690ef297c01518b540aadc5e258ce5e8ca2370026caff714259a26cc4db8178dc8ba0de2d0b20cf2e10c11d99aa65df5324cdb75376625d9ceaea1c5031fa42
+  metadata.gz: 8465c9e97cd9ce106b7a77e252714c72ac0fcb5470b35eccc0315e9277830402157ef07671b3a1cc757f757be0719f7475781a515322113bf23c698c88bd473c
+  data.tar.gz: fbb7585d26ac13eda94bad3e72a7511d133d80ba4b4840c3c9001f323d818f6d6c61d45f26916a1e40ef93555bb1a75e6d4240e776f1d31f22412023faf9dbd3

data/lib/active_cypher/model/querying.rb

@@ -67,6 +67,31 @@ 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/relationship.rb

@@ -159,6 +159,21 @@ module ActiveCypher
         new(attrs, from_node: from_node, to_node: to_node).tap(&:save)
       end
 
+      # Bang version of create - raises exception if save fails
+      # For when you want your relationship failures to be as dramatic as your breakups
+      def create!(attrs = {}, from_node:, to_node:)
+        relationship = create(attrs, from_node: from_node, to_node: to_node)
+        if relationship.persisted?
+          relationship
+        else
+          error_msgs = relationship.errors.full_messages.join(', ')
+          error_msgs = 'Validation failed' if error_msgs.empty?
+          raise ActiveCypher::RecordNotSaved,
+                "#{name} could not be saved: #{error_msgs}. " \
+                "Perhaps the nodes aren't ready for this kind of commitment?"
+        end
+      end
+
       # Instantiate from DB row, marking the instance as persisted.
       def instantiate(attributes, from_node: nil, to_node: nil)
         instance = allocate
@@ -168,6 +183,82 @@ module ActiveCypher
                       to_node: to_node)
         instance
       end
+
+      # -- Querying methods ----------------------------------------
+      # Find the first relationship matching the given attributes
+      # Like finding a needle in a haystack, if the haystack was made of graph edges
+      def find_by(attributes = {})
+        return nil if attributes.blank?
+
+        rel_type = relationship_type
+
+        # Build WHERE conditions for the attributes
+        conditions = []
+        params = {}
+
+        attributes.each_with_index do |(key, value), index|
+          param_name = :"p#{index + 1}"
+          conditions << "r.#{key} = $#{param_name}"
+          params[param_name] = value
+        end
+
+        where_clause = conditions.join(' AND ')
+
+        # Determine ID function based on adapter type
+        adapter_class = connection.class
+        id_func = adapter_class.const_defined?(:ID_FUNCTION) ? adapter_class::ID_FUNCTION : 'id'
+
+        cypher = <<~CYPHER
+          MATCH ()-[r:#{rel_type}]-()
+          WHERE #{where_clause}
+          RETURN r, #{id_func}(r) as rid, startNode(r) as from_node, endNode(r) as to_node
+          LIMIT 1
+        CYPHER
+
+        result = connection.execute_cypher(cypher, params, 'Find Relationship By')
+        row = result.first
+
+        return nil unless row
+
+        # Extract relationship data and instantiate
+        rel_data = row[:r] || row['r']
+        rid = row[:rid] || row['rid']
+
+        # Extract properties from the relationship data
+        # Memgraph returns relationships wrapped as [type_code, [actual_data]]
+        attrs = {}
+
+        if rel_data.is_a?(Array) && rel_data.length == 2
+          # Extract the actual relationship data from the second element
+          actual_data = rel_data[1]
+
+          if actual_data.is_a?(Array) && actual_data.length >= 5
+            # Format: [rel_id, start_id, end_id, type, properties, ...]
+            props = actual_data[4]
+            attrs = props.is_a?(Hash) ? props : {}
+          end
+        elsif rel_data.is_a?(Hash)
+          attrs = rel_data
+        end
+
+        # Convert string keys to symbols for attributes
+        attrs = attrs.transform_keys(&:to_sym)
+        attrs[:internal_id] = rid if rid
+
+        instantiate(attrs)
+      end
+
+      # Find the first relationship or raise an exception
+      # For when nil just isn't dramatic enough for your data access needs
+      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}. " \
+                                     'Maybe these nodes were never meant to be connected? ' \
+                                     'Or perhaps their relationship status is... complicated?')
+      end
     end
 
     # --------------------------------------------------------------
@@ -232,6 +323,21 @@ module ActiveCypher
     # --------------------------------------------------------------
     private
 
+    # Initialize from database attributes, marking as persisted
+    def init_with_attributes(attributes, from_node: nil, to_node: nil)
+      # Initialize the model first to set up attributes
+      initialize({}, from_node: from_node, to_node: to_node)
+
+      # Now we're not a new record
+      @new_record = false
+
+      # Assign the attributes from the database
+      assign_attributes(attributes) if attributes
+
+      # Clear any change tracking
+      clear_changes_information
+    end
+
     def create_relationship
       raise 'Source node must be persisted' unless from_node&.persisted?
       raise 'Target node must be persisted' unless to_node&.persisted?

data/lib/active_cypher/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module ActiveCypher
-  VERSION = '0.8.2'
+  VERSION = '0.10.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.10.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: []