boltless 1.0.0

data/spec/boltless/result_row_spec.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Boltless::ResultRow do
+  let(:instance) { Boltless::Result.from(input).first }
+  let(:input) { raw_result_fixture }
+
+  describe '#[]' do
+    it 'allows direct key access to the row data (string key)' do
+      expect(instance['active']).to be_eql(true)
+    end
+
+    it 'allows direct key access to the row data (symbol key)' do
+      expect(instance[:active]).to be_eql(true)
+    end
+
+    it 'returns the expected value (name)' do
+      expect(instance[:name]).to be_eql('Bernd')
+    end
+
+    it 'returns the expected value (birthday)' do
+      expect(instance[:birthday]).to be_eql(Date.parse('1971-07-28'))
+    end
+
+    it 'returns the expected value (written_books)' do
+      expect(instance[:written_books]).to be_eql(2)
+    end
+  end
+
+  describe '#value' do
+    it 'returns the first value of the row' do
+      expect(instance.value).to be_eql(instance.values.first)
+    end
+  end
+
+  describe '#values' do
+    it 'returns all row values' do
+      expect(instance.values).to \
+        match_array(['Bernd', Date.parse('1971-07-28'), 2, true])
+    end
+  end
+
+  describe '#to_h' do
+    let(:hash) do
+      {
+        active: true,
+        birthday: Date.parse('1971-07-28'),
+        name: 'Bernd',
+        written_books: 2
+      }
+    end
+
+    it 'returns the correct hash representation' do
+      expect(instance.to_h).to match(hash)
+    end
+  end
+
+  describe '#as_json' do
+    let(:hash) do
+      {
+        'active' => true,
+        'birthday' => Date.parse('1971-07-28'),
+        'name' => 'Bernd',
+        'written_books' => 2
+      }
+    end
+
+    it 'returns the correct hash representation' do
+      expect(instance.as_json).to match(hash)
+    end
+  end
+
+  describe '#each' do
+    let(:simple_instance) do
+      Boltless::Result.from(columns: [:key], data: [{ row: ['value'] }]).first
+    end
+
+    it 'yields each cell of the row (count)' do
+      expect { |control| instance.each(&control) }.to \
+        yield_control.exactly(4).times
+    end
+
+    it 'yields each row (argument)' do
+      expect { |control| simple_instance.each(&control) }.to \
+        yield_with_args(:key, 'value')
+    end
+  end
+
+  describe '#pretty_print' do
+    let(:action) { PP.pp(instance, ''.dup) }
+    let(:input) { raw_result_fixture(:with_stats) }
+
+    it 'includes the struct name' do
+      expect(action).to include('#<Boltless::ResultRow')
+    end
+
+    it 'includes the columns' do
+      expect(action).to include('columns=[:n]')
+    end
+
+    it 'includes the values' do
+      expect(action).to include('values=[{:name=>"Klaus"}]')
+    end
+
+    it 'includes the meta' do
+      expect(action).to \
+        include('meta=[{:id=>146, :type=>"node", :deleted=>false}]')
+    end
+
+    it 'includes the graph' do
+      expect(action).to include('graph=nil')
+    end
+  end
+
+  describe '#inspect' do
+    let(:action) { instance.inspect }
+    let(:input) { raw_result_fixture }
+
+    it 'includes the struct name' do
+      expect(action).to include('#<Boltless::ResultRow')
+    end
+
+    it 'includes the columns' do
+      expect(action).to \
+        include('columns=[:name, :birthday, :written_books, :active]')
+    end
+
+    it 'includes the values' do
+      expect(action).to include('values=["Bernd",')
+    end
+
+    it 'includes the meta' do
+      expect(action).to \
+        include('meta=[nil]')
+    end
+
+    it 'includes the graph' do
+      expect(action).to include('graph=nil')
+    end
+
+    context 'with a graph result' do
+      let(:input) { raw_result_fixture(:with_graph_result) }
+
+      it 'includes the graph (key)' do
+        expect(action).to include('graph={:nodes=>')
+      end
+
+      it 'includes the graph (nodes)' do
+        expect(action).to \
+          include('[{:id=>"149", :labels=>["User"], ' \
+                  ':properties=>{:name=>"Kalle"}}]')
+      end
+
+      it 'includes the graph (relationships)' do
+        expect(action).to \
+          include(':relationships=>[]')
+      end
+    end
+  end
+end

data/spec/boltless/result_spec.rb

@@ -0,0 +1,127 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Boltless::Result do
+  let(:instance) { described_class.from(input) }
+  let(:input) { raw_result_fixture }
+
+  describe '.from' do
+    let(:action) { described_class.from(input) }
+
+    it 'returns a Boltless::Result' do
+      expect(action).to be_a(described_class)
+    end
+
+    it 'allows to access the shared result columns' do
+      expect(action.columns).to \
+        match_array(%i[active birthday name written_books])
+    end
+
+    it 'returns the correct count of rows (via reader)' do
+      expect(action.rows.count).to be_eql(2)
+    end
+
+    it 'returns the correct count of rows (directly)' do
+      expect(action.count).to be_eql(2)
+    end
+
+    context 'with statistics' do
+      let(:input) { raw_result_fixture(:with_stats) }
+
+      it 'allows to access the result statistics' do
+        expect(action.stats).to include(nodes_created: 1)
+      end
+    end
+  end
+
+  describe '#each' do
+    it 'yields each row (count)' do
+      expect { |control| instance.each(&control) }.to yield_control.twice
+    end
+
+    it 'yields each row (argument)' do
+      instance.rows.pop
+      expect { |control| instance.each(&control) }.to \
+        yield_with_args(instance.rows.first)
+    end
+  end
+
+  describe '#to_a' do
+    it 'returns the rows' do
+      expect(instance.to_a).to be(instance.rows)
+    end
+  end
+
+  describe '#value' do
+    it 'returns the correct value' do
+      expect(instance.value).to be_eql('Bernd')
+    end
+  end
+
+  describe '#values' do
+    let(:mapped) do
+      [
+        {
+          name: 'Bernd',
+          birthday: Date.parse('1971-07-28'),
+          written_books: 2,
+          active: true
+        },
+        {
+          name: 'Klaus',
+          birthday: Date.parse('1998-01-03'),
+          written_books: 0,
+          active: false
+        }
+      ]
+    end
+
+    it 'returns the correct array' do
+      expect(instance.values).to match_array(mapped)
+    end
+  end
+
+  describe '#pretty_print' do
+    let(:action) { PP.pp(instance, ''.dup) }
+    let(:input) { raw_result_fixture(:with_stats) }
+
+    it 'includes the struct name' do
+      expect(action).to include('#<Boltless::Result')
+    end
+
+    it 'includes the columns' do
+      expect(action).to include('columns=[:n]')
+    end
+
+    it 'includes the rows' do
+      expect(action).to include('rows=[#<Boltless::ResultRow')
+    end
+
+    it 'includes the stats' do
+      expect(action).to include('stats={:contains_updates=>true')
+    end
+  end
+
+  describe '#inspect' do
+    let(:action) { instance.inspect }
+    let(:input) { raw_result_fixture }
+
+    it 'includes the struct name' do
+      expect(action).to include('#<Boltless::Result')
+    end
+
+    it 'includes the columns' do
+      expect(action).to \
+        include('columns=[:name, :birthday, :written_books, :active]')
+    end
+
+    it 'includes the rows' do
+      expect(action).to include('rows=[#<Boltless::ResultRow')
+    end
+
+    it 'includes the stats' do
+      expect(action).to include('stats=nil')
+    end
+  end
+end

data/spec/boltless/statement_collector_spec.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe Boltless::StatementCollector do
+  let(:instance) { described_class.new }
+
+  describe 'delegations' do
+    it 'allows to access the #build_cypher utility' do
+      expect(instance.respond_to?(:build_cypher)).to be_eql(true)
+    end
+  end
+
+  describe '#add' do
+    let(:action) { -> { instance.add('cypher', param_a: 1) } }
+
+    it 'returns itself for chaining' do
+      expect(action.call).to be(instance)
+    end
+
+    it 'collects the given statements' do
+      action.call
+      action.call
+      expect(instance.statements.count).to be_eql(2)
+    end
+
+    it 'calls Request.statement_payload to prepare the statement' do
+      expect(Boltless::Request).to \
+        receive(:statement_payload).with('cypher', param_a: 1).once
+      action.call
+    end
+  end
+
+  describe '#statements' do
+    let(:action) { instance.statements }
+
+    before { instance.add('cypher', param_a: 1) }
+
+    it 'returns the mapped statements' do
+      expect(action.first).to \
+        match(statement: 'cypher',
+              parameters: { param_a: 1 })
+    end
+  end
+end