activecypher 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b70a7612e29fd973054f654ad63f28b6fe965d993073ffd39aefcdf10798326
-  data.tar.gz: c23ad33676db0a63bb389bb8edc597eaa4eb6f8cdcfbf44eb32e0eb4c640c1fd
+  metadata.gz: cee43c77d5c77240791bd23a3ea08410ae58034f29f86d4bd0ec35bc65640b43
+  data.tar.gz: 9a5947493ac00f596f11a3ae6e5ceba5c1bb145b56a203c38e27f9c011790fdb
 SHA512:
-  metadata.gz: 3688ca19c11ee45562da2a6ccd6d65be740d4ba838802ec8dc52e8453ee80e42fbd771585e31b21ab857b6acb7abc449423debbae9cd2d86a5f9207009cc847d
-  data.tar.gz: f86b0d54cea7d36aa2d9093d37d0a816ab4fed6485b3697bc31c9a76abda329cae4adb5c33845baccaa5e86153c36aa4996146150b224b2eb7dec927fa43a8f2
+  metadata.gz: 8465c9e97cd9ce106b7a77e252714c72ac0fcb5470b35eccc0315e9277830402157ef07671b3a1cc757f757be0719f7475781a515322113bf23c698c88bd473c
+  data.tar.gz: fbb7585d26ac13eda94bad3e72a7511d133d80ba4b4840c3c9001f323d818f6d6c61d45f26916a1e40ef93555bb1a75e6d4240e776f1d31f22412023faf9dbd3

data/lib/active_cypher/model/querying.rb

@@ -73,6 +73,7 @@ module ActiveCypher
         # 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
 
@@ -83,12 +84,12 @@ module ActiveCypher
         # 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(", ")
-          
+          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?")
+                                       'Who can say in this vast, uncaring universe of nodes and relationships?')
         end
 
         # Instantiates and immediately saves a new record. YOLO mode.

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.9.0'
+  VERSION = '0.10.0'
 
   def self.gem_version
     Gem::Version.new VERSION

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activecypher
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Abdelkader Boudih