neospace 0.0.1 → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e936e5e4609c099a2a42fde44f703467581bc31fd9ae76b94278cc122ed4917
-  data.tar.gz: 10976e4fe63cb9ef934dd5d598165d7e9576705679e71cf06040086266301c1e
+  metadata.gz: b177b6457d6b9e36fff7e3c1a09658c6ab407a1dd8b3f553f193d567a331932d
+  data.tar.gz: 04d6ac4ba12e2f00dbc108c7c0e604a8991d82d9b08392fb689c19367621fe00
 SHA512:
-  metadata.gz: 0f327147fa33d788f1012a6936c349ec3649fc30b0a28d4c1d0cc6cbba693d6db82b801577dc57f6410996a193f80675dde8b53bb530cfd982cf616bc0162b57
-  data.tar.gz: 1dcce2065578da1ec5f327624c6529ceb33f72b900d8fe03618bc72b238a236e630250d213c77ee1f7340be95c9e444d9cec27b111daf25118316cdc85f78a12
+  metadata.gz: 692745aa110972108d43c3d7e2a4dd3a89a0c6b0d50b4b169fdaa872d23837b57b32da9771c24e7c706f9a62429ff5e61b2fa1e399e2fd0401a94ca33f880d92
+  data.tar.gz: d9e29143572014a334ed4fedc48e09e2758873d4f85476f549e8c5c650e9902a3abc236fcefdf627c511757caf42d513573954c42bc91b5dba54930c2d0610ba

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Heinrich Klobuczek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,88 @@
+# Neo4j::Driver
+
+home  :: https://github.com/neo4jrb/neo4j-ruby-driver
+
+This repository contains 2 implementation of a neo4j driver for ruby:
+- `neo4j-java-driver` based on official java implementation. It provides a thin wrapper over java driver (only in jruby).
+- `neo4j-ruby-driver` based on [seabolt](https://github.com/neo4j-drivers/seabolt) and [ffi](https://github.com/ffi/ffi). Available on all rubies (including jruby) and all platforms supported by seabolt.
+
+## Installation
+
+### neo4j-java-driver
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'neo4j-java-driver'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install neo4j-java-driver
+    
+### neo4j-ruby-driver
+
+As a prerequisite seabolt must be installed.
+ 
+On macOS
+
+    $ brew install michael-simons/homebrew-seabolt/seabolt 
+    
+On other systems please follow the instructions to install [seabolt](https://github.com/neo4j-drivers/seabolt) either from package or source. Make sure the libseabolt17 ends up in a system lib path e.g. /usr/local/lib
+ 
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'neo4j-ruby-driver'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install neo4j-ruby-driver
+
+## Usage
+
+Both drivers implement identical API and can be used interchangeably. The API is to highest possible degree consistent with the official java driver. 
+At this moment [The Neo4j Drivers Manual v1.7](https://neo4j.com/docs/driver-manual/1.7/) along with the ruby version of the [code fragments](https://github.com/neo4jrb/neo4j-ruby-driver/blob/master/docs/dev_manual_examples.rb) and the ruby specs provide the only documentation. 
+
+[Neo4j Java Driver 1.7 API](https://neo4j.com/docs/api/java-driver/current/) can be helpful as well..
+
+## Development
+
+This gem includes 2 different implementations: java driver based and another one using seabolt via ffi
+
+For java driver based:
+
+    $ driver=java bin/setup
+    
+FFI based same as above but with driver variable set:
+
+    $ bin/setup 
+     
+## Testing
+
+To run the tests the following tools need to be installed:
+
+    $ brew install python
+    $ pip3 install --user git+https://github.com/klobuczek/boltkit@1.3#egg=boltkit
+    $ neoctrl-install -e 4.0.2 servers
+    $ neoctrl-configure servers/neo4j-enterprise-4.0.2 dbms.directories.import= dbms.default_listen_address=::
+    $ neoctrl-set-initial-password password servers/neo4j-enterprise-4.0.2
+    $ neoctrl-start servers/neo4j-enterprise-4.0.2
+
+## Contributing
+
+Suggestions, improvements, bug reports and pull requests are welcome on GitHub at https://github.com/neo4jrb/neo4j-ruby-driver.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+

data/ffi/bolt/address.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Address
+    extend Bolt::Library
+    attach_function :create, :BoltAddress_create, %i[string string], :auto_pointer
+    attach_function :destroy, :BoltAddress_destroy, [:pointer], :void
+    attach_function :host, :BoltAddress_host, [:pointer], :strptr
+    attach_function :port, :BoltAddress_port, [:pointer], :strptr
+  end
+end

data/ffi/bolt/address_resolver.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Bolt
+  module AddressResolver
+    extend Bolt::Library
+
+    callback :address_resolver_func, %i[pointer pointer pointer], :void
+
+    attach_function :create, :BoltAddressResolver_create, %i[pointer address_resolver_func], :auto_pointer
+    attach_function :destroy, :BoltLog_destroy, %i[pointer], :void
+  end
+end

data/ffi/bolt/address_set.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Bolt
+  module AddressSet
+    extend Bolt::Library
+
+    attach_function :add,  :BoltAddressSet_add, %i[pointer pointer], :int32_t
+  end
+end

data/ffi/bolt/auth.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Auth
+    extend Bolt::Library
+    attach_function :basic, :BoltAuth_basic, %i[string string string], :auto_pointer,
+                    releaser: Bolt::Value.method(:destroy)
+    attach_function :none, :BoltAuth_none, [], :auto_pointer, releaser: Bolt::Value.method(:destroy)
+  end
+end

data/ffi/bolt/auto_releasable.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Bolt
+  module AutoReleasable
+    def attach_function(name, func, args, returns = nil, options = nil)
+      return super unless returns == :auto_pointer
+
+      super(name, func, args, :pointer, options)
+      singleton_class.prepend with_auto_releaser(name, options&.dig(:releaser))
+    end
+
+    private
+
+    def with_auto_releaser(method, releaser)
+      Module.new do
+        define_method(method) do |*args|
+          FFI::AutoPointer.new(super(*args), releaser || self.method(:destroy))
+        end
+      end
+    end
+  end
+end

data/ffi/bolt/boolean.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Boolean
+    extend Bolt::Library
+
+    attach_function :get, :BoltBoolean_get, %i[pointer], :char
+  end
+end

data/ffi/bolt/bytes.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Bytes
+    extend Bolt::Library
+
+    attach_function :get, :BoltBytes_get, %i[pointer int32], :char
+    attach_function :get_all, :BoltBytes_get_all, %i[pointer], :pointer
+  end
+end

data/ffi/bolt/config.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Config
+    extend Bolt::Library
+
+    BOLT_SCHEME_DIRECT = 0
+    BOLT_SCHEME_NEO4J = 1
+
+    typedef :int32_t, :bolt_scheme
+
+    BOLT_TRANSPORT_PLAINTEXT = 0
+    BOLT_TRANSPORT_ENCRYPTED = 1
+
+    typedef :int32_t, :bolt_transport
+
+    attach_function :create, :BoltConfig_create, [], :auto_pointer
+    attach_function :destroy, :BoltConfig_destroy, [:pointer], :void
+    attach_function :get_scheme, :BoltConfig_get_scheme, [:pointer], :bolt_scheme
+    attach_function :set_scheme, :BoltConfig_set_scheme, %i[pointer bolt_scheme], :int32_t
+    attach_function :get_transport, :BoltConfig_get_transport, [:pointer], :bolt_transport
+    attach_function :set_transport, :BoltConfig_set_transport, %i[pointer bolt_transport], :int32_t
+    attach_function :get_trust, :BoltConfig_get_trust, [:pointer], :pointer
+    attach_function :set_trust, :BoltConfig_set_trust, %i[pointer pointer], :int32_t
+    attach_function :get_user_agent, :BoltConfig_get_user_agent, [:pointer], :string
+    attach_function :set_user_agent, :BoltConfig_set_user_agent, %i[pointer string], :int32
+    attach_function :get_routing_context, :BoltConfig_get_routing_context, [:pointer], :pointer
+    attach_function :set_routing_context, :BoltConfig_set_routing_context, %i[pointer pointer], :int32_t
+    attach_function :get_address_resolver, :BoltConfig_get_address_resolver, [:pointer], :pointer
+    attach_function :set_address_resolver, :BoltConfig_set_address_resolver, %i[pointer pointer], :int32_t
+    attach_function :get_log, :BoltConfig_get_log, [:pointer], :pointer
+    attach_function :set_log, :BoltConfig_set_log, %i[pointer pointer], :int32
+    attach_function :get_max_pool_size, :BoltConfig_get_max_pool_size, [:pointer], :int32_t
+    attach_function :set_max_pool_size, :BoltConfig_set_max_pool_size, %i[pointer int32_t], :int32_t
+    attach_function :get_max_connection_life_time, :BoltConfig_get_max_connection_life_time, [:pointer], :int32_t
+    attach_function :set_max_connection_life_time, :BoltConfig_set_max_connection_life_time, %i[pointer int32_t],
+                    :int32_t
+    attach_function :get_max_connection_acquisition_time, :BoltConfig_get_max_connection_acquisition_time, [:pointer],
+                    :int32_t
+    attach_function :set_max_connection_acquisition_time, :BoltConfig_set_max_connection_acquisition_time,
+                    %i[pointer int32_t], :int32_t
+    attach_function :get_socket_options, :BoltConfig_get_socket_options, [:pointer], :pointer
+    attach_function :set_socket_options, :BoltConfig_set_socket_options, %i[pointer pointer], :int32_t
+  end
+end

data/ffi/bolt/connection.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Connection
+    extend Bolt::Library
+
+    typedef :uint64, :bolt_request
+
+    attach_function :flush, :BoltConnection_send, [:pointer], :int32
+    attach_function :fetch, :BoltConnection_fetch, %i[pointer bolt_request], :int32
+    attach_function :fetch_summary, :BoltConnection_fetch_summary, %i[pointer bolt_request], :int32
+    attach_function :clear_begin, :BoltConnection_clear_begin, %i[pointer], :int32
+    attach_function :set_begin_bookmarks, :BoltConnection_set_begin_bookmarks, %i[pointer pointer], :int32
+    attach_function :set_begin_tx_timeout, :BoltConnection_set_begin_tx_timeout, %i[pointer int64], :int32
+    attach_function :set_begin_tx_metadata, :BoltConnection_set_begin_tx_metadata, %i[pointer pointer], :int32
+    attach_function :load_begin_request, :BoltConnection_load_begin_request, %i[pointer], :int32
+    attach_function :load_commit_request, :BoltConnection_load_commit_request, %i[pointer], :int32
+    attach_function :load_rollback_request, :BoltConnection_load_rollback_request, %i[pointer], :int32
+    attach_function :clear_run, :BoltConnection_clear_run, %i[pointer], :int32
+    attach_function :set_run_bookmarks, :BoltConnection_set_run_bookmarks, %i[pointer pointer], :int32
+    attach_function :set_run_tx_timeout, :BoltConnection_set_run_tx_timeout, %i[pointer int64], :int32
+    attach_function :set_run_tx_metadata, :BoltConnection_set_run_tx_metadata, %i[pointer pointer], :int32
+    attach_function :set_run_cypher, :BoltConnection_set_run_cypher, %i[pointer string uint64 int32], :int32
+    attach_function :set_run_cypher_parameter, :BoltConnection_set_run_cypher_parameter,
+                    %i[pointer int32 string uint64], :pointer
+    attach_function :load_run_request, :BoltConnection_load_run_request, [:pointer], :int32
+    attach_function :load_discard_request, :BoltConnection_load_discard_request, %i[pointer int32], :int32
+    attach_function :load_pull_request, :BoltConnection_load_pull_request, %i[pointer int32], :int32
+    attach_function :load_reset_request, :BoltConnection_load_reset_request, [:pointer], :int32
+    attach_function :last_request, :BoltConnection_last_request, [:pointer], :bolt_request
+    attach_function :server, :BoltConnection_server, %i[pointer], :strptr
+    attach_function :id, :BoltConnection_id, %i[pointer], :strptr
+    attach_function :address, :BoltConnection_address, %i[pointer], :pointer
+    attach_function :remote_endpoint, :BoltConnection_remote_endpoint, %i[pointer], :pointer
+    attach_function :local_endpoint, :BoltConnection_local_endpoint, %i[pointer], :pointer
+    attach_function :last_bookmark, :BoltConnection_last_bookmark, %i[pointer], :strptr
+    attach_function :summary_success, :BoltConnection_summary_success, [:pointer], :int32
+    attach_function :failure, :BoltConnection_failure, [:pointer], :pointer
+    attach_function :field_names, :BoltConnection_field_names, [:pointer], :pointer
+    attach_function :field_values, :BoltConnection_field_values, [:pointer], :pointer
+    attach_function :metadata, :BoltConnection_metadata, %i[pointer], :pointer
+    attach_function :status, :BoltConnection_status, [:pointer], :pointer
+  end
+end

data/ffi/bolt/connector.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Connector
+    extend Bolt::Library
+
+    BoltAccessMode = enum(
+      :bolt_access_mode_write,
+      :bolt_access_mode_read
+    )
+
+    attach_function :create, :BoltConnector_create, %i[pointer pointer pointer], :pointer
+    attach_function :destroy, :BoltConnector_destroy, [:pointer], :void
+    attach_function :acquire, :BoltConnector_acquire, [:pointer, BoltAccessMode, :pointer], :pointer
+    attach_function :release, :BoltConnector_release, %i[pointer pointer], :void
+  end
+end

data/ffi/bolt/dictionary.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Dictionary
+    extend Bolt::Library
+
+    attach_function :key, :BoltDictionary_key, %i[pointer int32], :pointer
+    attach_function :get_key, :BoltDictionary_get_key, %i[pointer int32], :pointer
+    attach_function :get_key_size, :BoltDictionary_get_key_size, %i[pointer int32], :int32
+    attach_function :get_key_index, :BoltDictionary_get_key_index, %i[pointer string int32 int32], :int32
+    attach_function :set_key, :BoltDictionary_set_key, %i[pointer int32 string int32], :int32
+    attach_function :value, :BoltDictionary_value, %i[pointer int32], :pointer
+    attach_function :value_by_key, :BoltDictionary_value_by_key, %i[pointer string int32], :pointer
+  end
+end

data/ffi/bolt/error.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Error
+    extend Bolt::Library
+
+    # Identifies a successful operation which is defined as 0
+    BOLT_SUCCESS = 0
+    # Unknown error
+    BOLT_UNKNOWN_ERROR = 1
+    # Unsupported protocol or address family
+    BOLT_UNSUPPORTED = 2
+    # Operation interrupted
+    BOLT_INTERRUPTED = 3
+    # Connection reset by peer
+    BOLT_CONNECTION_RESET = 4
+    # No valid resolved addresses found to connect
+    BOLT_NO_VALID_ADDRESS = 5
+    # Operation timed out
+    BOLT_TIMED_OUT = 6
+    # Permission denied
+    BOLT_PERMISSION_DENIED = 7
+    # Too may open files
+    BOLT_OUT_OF_FILES = 8
+    # Out of memory
+    BOLT_OUT_OF_MEMORY = 9
+    # Too many open ports
+    BOLT_OUT_OF_PORTS = 10
+    # Connection refused
+    BOLT_CONNECTION_REFUSED = 11
+    # Network unreachable
+    BOLT_NETWORK_UNREACHABLE = 12
+    # An unknown TLS error
+    BOLT_TLS_ERROR = 13
+    # Connection closed by remote peer
+    BOLT_END_OF_TRANSMISSION = 15
+    # Server returned a FAILURE message, more info available through \ref BoltConnection_failure
+    BOLT_SERVER_FAILURE = 16
+    # Unsupported bolt transport
+    BOLT_TRANSPORT_UNSUPPORTED = 0x400
+    # Unsupported protocol usage
+    BOLT_PROTOCOL_VIOLATION = 0x500
+    # Unsupported bolt type
+    BOLT_PROTOCOL_UNSUPPORTED_TYPE = 0x501
+    # Unknown pack stream type
+    BOLT_PROTOCOL_NOT_IMPLEMENTED_TYPE = 0x502
+    # Unexpected marker
+    BOLT_PROTOCOL_UNEXPECTED_MARKER = 0x503
+    # Unsupported bolt protocol version
+    BOLT_PROTOCOL_UNSUPPORTED = 0x504
+    # Connection pool is full
+    BOLT_POOL_FULL = 0x600
+    # Connection acquisition from the connection pool timed out
+    BOLT_POOL_ACQUISITION_TIMED_OUT = 0x601
+    # Address resolution failed
+    BOLT_ADDRESS_NOT_RESOLVED = 0x700
+    # Routing table retrieval failed
+    BOLT_ROUTING_UNABLE_TO_RETRIEVE_ROUTING_TABLE = 0x800
+    # No servers to select for the requested operation
+    BOLT_ROUTING_NO_SERVERS_TO_SELECT = 0x801
+    # Connection pool construction for server failed
+    BOLT_ROUTING_UNABLE_TO_CONSTRUCT_POOL_FOR_SERVER = 0x802
+    # Routing table refresh failed
+    BOLT_ROUTING_UNABLE_TO_REFRESH_ROUTING_TABLE = 0x803
+    # Invalid discovery response
+    BOLT_ROUTING_UNEXPECTED_DISCOVERY_RESPONSE = 0x804
+    # Error set in connection
+    BOLT_CONNECTION_HAS_MORE_INFO = 0xFFE
+    # Error set in connection
+    BOLT_STATUS_SET = 0xFFF
+
+    attach_function :get_string, :BoltError_get_string, [:int32], :string
+  end
+end

data/ffi/bolt/float.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Float
+    extend Bolt::Library
+
+    attach_function :get, :BoltFloat_get, %i[pointer], :double
+  end
+end

data/ffi/bolt/integer.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Integer
+    extend Bolt::Library
+
+    attach_function :get, :BoltInteger_get, %i[pointer], :int64
+  end
+end

data/ffi/bolt/library.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Bolt
+  module Library
+    include FFI::Library
+    include Bolt::AutoReleasable
+
+    def self.extended(mod)
+      mod.ffi_lib 'libseabolt17'
+    end
+  end
+end