arcadedb 0.3.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e052fea79d83b5cd35961dcc01af0ba617e80c3e0c26d058c5b69a3733a8edc
-  data.tar.gz: 92ef4c2900fee458959b01becf8fc2789fce5e87fb39e1cfc25b0f0df1e08d20
+  metadata.gz: 7d7f1f29472b0fb31734654c9456ec5bdfb31cd42fd46b658139ac840691c6f6
+  data.tar.gz: 4c1c95707c8e2c528654f2a7509b1b6943ef9615fe203c81cd421d52636dcac7
 SHA512:
-  metadata.gz: f74869fa3afe8f87250e94358b2b18a1fdcfdfa092ec0ef5a0293f970f1976b755463f070f0224aa276f4df3acd5555500d800b389c8463889347f8ef2d10ee7
-  data.tar.gz: a16c82bf62d9e30898de4e439a7fca37f470944cb92293fa11e4847146eac3a5c066447c1293d3fc73d1a078b348bdcdac21b44b10308ba9c10f141d793f17e2
+  metadata.gz: f54746f04760ebfbc8c1588e66fb0bb52e820eef83df564e3563e37219835ff86c93e5b3d2e2a7617452218938c30a5aabff099361d0fd829890e2ac83411fc8
+  data.tar.gz: 0f8bf3623302c5204ca56552fb41694bfd506c493dc72463b8000e66c82aacddb7f42188f41508c84e9fc5bf93fa78e42e4235ed904982b97d38a4a5c8d4ff40

data/CHANGELOG.md

@@ -12,4 +12,22 @@ All notable changes to this project will be documented in this file.
 - Support for embedded Dokuments and Maps
 - iruby support 
 
-
+## 0.4.0 - 2023.10.28
+- completely remove pg-stuff
+- substitute typhoreous with  HTTPX
+
+## 0.4.1 - 2023.10.31
+- redesign of transactions. 
+- Type.execute performs non idempotent queries  in a (nested) transaction
+- Type.transmit performs non idempotent queries 
+- Type.query performs idempotent queries 
+- Type.create returns a rid
+- Type.insert returns a type-object
+- Vertex.nodes supports conditions on edges
+- Vertex.in, Vertex.out Vertex.inE, Vertex.outE support depth as second parameter
+- IRuby-Support. Formatted output for Base-Objects
+
+## 0.5.0 - 2023-12-12
+- Arcade::Match simple match-statement generator
+- return to Arcade::QueryError messages instead of HTTPX::HTTPError
+- The ProjectRoot Const is used to read configuration files (Changed from Arcade::ProjectRoot)

data/Gemfile

@@ -5,17 +5,12 @@ source "https://rubygems.org"
 #git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
 gemspec
 gem 'sdoc'
-gem  'dry-configurable'
- gem  'pry'
-#gem  'sequel'
-
-#gem  'mini_sql' #, path: '../mini_sql/'
 group :development, :test do
 	gem "awesome_print"
   gem 'pastel'
   gem 'zeitwerk'
   gem 'terminal-table'
-  gem 'rubocop'
+ # gem 'rubocop'
 	gem "rspec"
 	gem 'rspec-legacy_formatters'
 	gem 'rspec-its'
@@ -26,5 +21,5 @@ group :development, :test do
 	gem 'guard'#, :platforms => :ruby
 	gem 'guard-rspec'
 	gem 'rb-inotify'
-	gem 'pry'
+#	gem 'pry'
 end

data/Gemfile.lock

@@ -1,56 +1,56 @@
 PATH
   remote: .
   specs:
-    arcadedb (0.3.2)
+    arcadedb (0.4.1)
+      dry-configurable
       dry-core
       dry-schema
       dry-struct
-      typhoeus
+      httpx
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
     awesome_print (1.9.2)
     coderay (1.1.3)
-    concurrent-ruby (1.1.10)
+    concurrent-ruby (1.2.2)
     diff-lcs (1.5.0)
-    dry-configurable (0.15.0)
+    dry-configurable (1.1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-core (1.0.1)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.6)
-    dry-container (0.11.0)
-      concurrent-ruby (~> 1.0)
-    dry-core (0.7.1)
-      concurrent-ruby (~> 1.0)
-    dry-inflector (0.3.0)
+      zeitwerk (~> 2.6)
+    dry-inflector (1.0.0)
     dry-initializer (3.1.1)
-    dry-logic (1.2.0)
+    dry-logic (1.5.0)
       concurrent-ruby (~> 1.0)
-      dry-core (~> 0.5, >= 0.5)
-    dry-schema (1.10.6)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-schema (1.13.3)
       concurrent-ruby (~> 1.0)
-      dry-configurable (~> 0.13, >= 0.13.0)
-      dry-core (~> 0.5, >= 0.5)
+      dry-configurable (~> 1.0, >= 1.0.1)
+      dry-core (~> 1.0, < 2)
       dry-initializer (~> 3.0)
-      dry-logic (~> 1.2)
-      dry-types (~> 1.5)
-    dry-struct (1.4.0)
-      dry-core (~> 0.5, >= 0.5)
-      dry-types (~> 1.5)
+      dry-logic (>= 1.4, < 2)
+      dry-types (>= 1.7, < 2)
+      zeitwerk (~> 2.6)
+    dry-struct (1.6.0)
+      dry-core (~> 1.0, < 2)
+      dry-types (>= 1.7, < 2)
       ice_nine (~> 0.11)
-    dry-types (1.5.1)
+      zeitwerk (~> 2.6)
+    dry-types (1.7.1)
       concurrent-ruby (~> 1.0)
-      dry-container (~> 0.3)
-      dry-core (~> 0.5, >= 0.5)
-      dry-inflector (~> 0.1, >= 0.1.2)
-      dry-logic (~> 1.0, >= 1.0.2)
-    ethon (0.16.0)
-      ffi (>= 1.15.0)
-    ffi (1.15.5)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
+    ffi (1.16.3)
     formatador (1.1.0)
     given_core (3.8.2)
       sorcerer (>= 0.3.7)
-    guard (2.18.0)
+    guard (2.18.1)
       formatador (>= 0.2.4)
       listen (>= 2.7, < 4.0)
       lumberjack (>= 1.0.12, < 2.0)
@@ -64,44 +64,44 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
+    http-2-next (1.0.1)
+    httpx (1.1.0)
+      http-2-next (>= 1.0.1)
     ice_nine (0.11.2)
-    listen (3.7.1)
+    listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    lumberjack (1.2.8)
+    lumberjack (1.2.9)
     method_source (1.0.0)
     nenv (0.3.0)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    parallel (1.22.1)
-    parser (3.1.2.0)
-      ast (~> 2.4.1)
     pastel (0.8.0)
       tty-color (~> 0.5)
-    pry (0.14.1)
+    pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    rainbow (3.1.1)
+    psych (5.1.1.1)
+      stringio
     rake (13.0.6)
-    rb-fsevent (0.11.1)
+    rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rdoc (6.3.3)
-    regexp_parser (2.4.0)
-    rexml (3.2.5)
-    rspec (3.11.0)
-      rspec-core (~> 3.11.0)
-      rspec-expectations (~> 3.11.0)
-      rspec-mocks (~> 3.11.0)
-    rspec-collection_matchers (1.2.0)
+    rdoc (6.5.0)
+      psych (>= 4.0.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-collection_matchers (1.2.1)
       rspec-expectations (>= 2.99.0.beta1)
     rspec-context-private (0.0.1)
-    rspec-core (3.11.0)
-      rspec-support (~> 3.11.0)
-    rspec-expectations (3.11.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
+      rspec-support (~> 3.12.0)
     rspec-given (3.8.2)
       given_core (= 3.8.2)
       rspec (>= 2.14.0)
@@ -110,34 +110,21 @@ GEM
       rspec-expectations (>= 3.0.0)
     rspec-legacy_formatters (1.0.2)
       rspec (~> 3.0)
-    rspec-mocks (3.11.1)
+    rspec-mocks (3.12.6)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.11.0)
-    rspec-support (3.11.0)
-    rubocop (1.29.1)
-      parallel (~> 1.10)
-      parser (>= 3.1.0.0)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.17.0, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 3.0)
-    rubocop-ast (1.18.0)
-      parser (>= 3.1.1.0)
-    ruby-progressbar (1.11.0)
-    sdoc (2.3.1)
-      rdoc (>= 5.0, < 6.4.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    sdoc (2.6.1)
+      rdoc (>= 5.0)
     shellany (0.0.1)
     sorcerer (2.0.1)
+    stringio (3.0.8)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
-    thor (1.2.1)
+    thor (1.3.0)
     tty-color (0.6.0)
-    typhoeus (1.4.0)
-      ethon (>= 0.9.0)
-    unicode-display_width (2.1.0)
-    zeitwerk (2.5.4)
+    unicode-display_width (2.5.0)
+    zeitwerk (2.6.12)
 
 PLATFORMS
   x86_64-linux
@@ -146,11 +133,9 @@ DEPENDENCIES
   arcadedb!
   awesome_print
   bundler (~> 2)
-  dry-configurable
   guard
   guard-rspec
   pastel
-  pry
   rake (~> 13.0)
   rb-inotify
   rspec
@@ -159,7 +144,6 @@ DEPENDENCIES
   rspec-given
   rspec-its
   rspec-legacy_formatters
-  rubocop
   sdoc
   terminal-table
   zeitwerk

data/README.md

@@ -5,7 +5,7 @@ Ruby Interface to a [Arcade Database](https://arcadedb.com/).
 The program utilizes the HTTP-JSON API to direct database queries to an ArcadeDB server. 
 The server's response is then mapped to an ORM (Object-Relational Mapping) based on DRY::Struct. 
 Each database type is represented by a dedicated Model Class, where complex queries are encapsulated. 
-The program also includes a  Query-Preprocessor for constructing custom queries in ruby fashion.
+The program also includes a  Query-Preprocessor and Match-statment generator for constructing custom queries in ruby fashion.
 
 ***ArcadeDB internally uses `Arcade` as primary namespace**** 
 
@@ -13,11 +13,18 @@ The program also includes a  Query-Preprocessor for constructing custom queries
 
 A running AracdeDB-Instance. [Quick-Start-Guide](https://docs.arcadedb.com/#Quick-Start-Docker).
 
-[ArcadeDB V 22.10.1](https://github.com/ArcadeData/arcadedb/releases/tag/22.10.1)ff is supported
+## New Project
 
-## Config
-
-Edit the file `arcade.yml`  and  provide suitable databases for test, development and production environment.
+```
+mkdir project && cd project
+bundle init
+bundle add arcadedb
+bundle add pastel  # for console output
+mkdir model
+mkdir bin
+```
+copy `https://github.com/topofocus/arcadedb/blob/main/bin/console` to the `bin` directory  
+copy `https://github.com/topofocus/arcadedb/blob/main/arcade.yml` to the project root and modify to your needs
 
 ## Console
 
@@ -25,9 +32,19 @@ To start an interactive console, a script is provided in the bin-directory.
 ```
 $ cd bin && ./console.rb  t   ( or "d" or "p" for Test, Development and Production environment)
 
-**Database definitions  (model-files) of the test-suite are included!**
+**in Test environment Database definitions  (model-files) of the test-suite are included!**
 ```
 
+## Add to a project
+Just require it in your program:
+```ruby
+require "arcade"
+```
+## Config
+
+Add a file `arcade.yml` at the root of your program or in the `config`-dir  and  provide suitable databases for test, development and production environment.
+
+
 ## Examples  & Specs
 
 The `example` directory contains documented sample files for typical usecases
@@ -39,14 +56,13 @@ The `spec`-files in the rspec-test-suite-section are worth reading, too.
 The adapter uses a 3 layer concept. 
 
 Top-Layer : `Arcade::Base`-Model-Objects. 
-They operate similar to ActiveRecord Model Objects but are based on [Dry-Struct](https://dry-rb.org/gems/dry-struct/1.0/).
+Similar to ActiveRecord Model Objects but based on [Dry-Struct](https://dry-rb.org/gems/dry-struct/1.0/).
 
 ```ruby
 # Example model file  /model/demo/user.rb
 module Demo
-  class Person < Arcade::Vertex
+  class User < Arcade::Vertex
     attribute :name, Types::Nominal::String
-    timestamps true
     
     def grandparents
       db.query( "select in('is_family') from #{rid} ") &.allocate_model
@@ -58,14 +74,14 @@ __END__
   CREATE INDEX on demo_user( name ) UNIQUE
 ```
 
-Only the `name` attribute is declared. Timestamps (created & updated attributes) are included, too
+Only the `name` attribute is declared. 
 
-`Demo::User.create_type`  creates the type and executes the database-commands after __END__.   
+`Demo::User.create_type`  creates the type and executes provided database-commands after __END__.   
 
-Other properties are schemaless. 
+Other properties are schemaless, but have to be declared in the model-file. 
 
 ```ruby
-Person.create name: "Hubert", age: 35
+Person.insert name: "Hubert", age: 35
 Person.update set: { age: 36 }, where: { name: 'Hubert' }
 persons = Person.where "age > 40"
 persons.first.update age: 37
@@ -75,9 +91,66 @@ Person.all
 Person.delete all: true || where: age: 56 , ...
 ```
 
+### Nodes and Traverse
+
+`ArcadeDB` wraps common queries of bidirectional connected vertices.
+
+Suppose
+```ruby 
+m = Person.create name: 'Hubert', age: '25'
+f = Person.create name: 'Pauline', age: '28'
+m.assign via: IsMarriedTo, vertex: f , divorced: false
+
+```
+This creates the simple graph 
+>  Hubert --- is_married_to --> Pauline 
+>                  |
+>                  -- divorced (attribute on the edge)
+
+This can be queried through
+
+```ruby
+hubert =  Person.find name: 'Hubert'
+pauline = hubert.nodes( :out, via: IsMarriedTo ).first
+# or simply
+pauline = hubert.out.first
+
+```
+Conditions may be set, to. 
+```ruby
+hubert.nodes( :out, via: IsMarriedTo, where: "age < 30" )
+```
+gets all wives of hubert, who are younger then 30 years.  
+or
+```ruby
+Person.nodes( :outE, via: IsMarriedTo, where: { divorced: false } )
+
+```
+gets all wives where the divorced-condition, which is set on the edge, is false. 
+
+## Query
+
 A **Query Preprocessor** is implemented. Its adapted from ActiveOrient. The [documentation](https://github.com/topofocus/active-orient/wiki/OrientQuery)
 is still valid,  however the class has changed to `Arcade::Query`. 
 
+## Match
+
+A simple **Match Statement Generator** is provided for convenience. As the [declarative syntax](https://github.com/ArcadeData/arcadedb-docs/blob/main/src/main/asciidoc/sql/SQL-Match.adoc)  seems to be  very  intuitive, a preprocessor should not be 
+necessary. With the help of some ruby magic, the creation of match-statements is simply an no-brainer.
+
+```ruby
+a =  Arcade::Match.new( type: Person, as: :persons)
+                  .out( IsMarriedTo )
+                  .node( where: 'age < 30')
+a.to_s
+=>  Match { type: person, as: persons }.out('is_married_to'){ where: ( age < 30) } RETURN persons
+
+a.execute.select_results  #  sends the statement to the database and returns Arcade Objects. 
+```
+
+Arcade::Match-objects can be used as `from:` argument to Arcade::Query-Statements, thus hybrid queries are 
+easily constructed without extensive string-manipulations.
+
 The **second Layer** handles Database-Requests.  
 In its actual implementation, these requests are delegated to the HTTP/JSON-API.
 
@@ -90,20 +163,18 @@ DB =  Arcade::Init.db
 $ DB.get nn, mm                                 # returns a Aracde:Base object
                                                 # rid is either "#11:10:" or two numbers
 $ DB.query querystring                          # returns either an Array of results (as  Hash) 
-$ DB.execute { querystring }                    # 
+$ DB.execute { querystring }                    # execute a non idempotent query within a (nested) transaction
 $ DB.create <name>, attribute: value ....       # Creates a new <Document | Vertex> and returns the rid
                                                 # Operation is performed as Database-Transaction and is rolled back on error
-$ DB.insert <name>, attribute: value ....       # Inserts a new <Document | Vertex> and returns the rid
+$ DB.insert <name>, attribute: value ....       # Inserts a new <Document | Vertex> and returns the new object
 $ DB.create_edge <name>, from: <rid> or [rid, rid, ..] , to: <rid> or [rid, rid, ..]
 
-DB.query " Select from person where age > 40 "
-DB.execute { " Update person set name='Hubert' return after $current where age = 36 " }
 ```
 
 **Convert database input to Arcade::Base Models**
 
 Either  `DB.query` or  `DB.execute` return the raw JSON-input from the database. It can always converted to model-objects by chaining
-`allocatet_model`.
+`allocate_model` or `select_result`.
 
 ```ruby
 $ DB.query "select from my_names limit 1"
@@ -217,20 +288,24 @@ Select a range of nodes and perform a mathematical operation
   -=> select median(note_count) from  ( traverse out(connects) from #52:0 while $depth < 100 )  where $depth>=50  
    =>   {:"median(note_count)"=>75.5 }
 ```
-## Include in your own project
 
-Until a gem is released, first clone the project and set up your project environment
+### Transactions
+
+Database-Transactions are largely encapsulated
+
+```
+db =  Arcade::Init.db
+db.begin_transaction
+
+{ perform insert, update, query, etc tasks in the database }
+
+db.commit 
+
+# or
+
+db.rollback
+
 ```
-mkdir workspace && cd workspace
-git clone https://github.com/topofocus/arcadedb
-mkdir my-project && cd my-project
-bundle init
-cat "gem arcadedb, path='../arcadedb' " >> Gemfile
-bundle install && bundle upate
-cp ../arcadedb/config.yml .
-mkdir bin
-cp ../arcadedb/bin/console bin/
-````
 
 
 ## Contributing

data/arcade.yml

@@ -1,26 +1,22 @@
 ---
-## absolute path to the oetl-script
-:pg:
- :host: 10.247.8.109  # hierdevel
- :port: 5432
 :environment:
   :test:
     dbname: playground
     user:  root
-    pass:  topo1focus
+    pass: *** 
   :development:
     dbname: devel
     user: root
-    pass:  topo1focus
+    pass:  ***
   :production:
     dbname: production
     user: root
-    pass: topo1focus
+    pass: ***
 :admin:
   :host: 10.247.8.109
   :port: 2480
   :user: root
-  :pass: topo1focus
+  :pass: ***
 :logger: stdout           # 'file' or 'stdout'
 :namespace: Arcade        # Default Namespace
 :autoload: true           # load model if a link is detected in a record

data/arcadedb.gemspec

@@ -23,13 +23,10 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "bundler", "~> 2"
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 4.0"
-  #	'activesupport', '>= 6.0'
-#	spec.add_dependency 'activemodel'
-  spec.add_dependency "typhoeus" 
+  spec.add_dependency "httpx"
   spec.add_dependency 'dry-schema'
   spec.add_dependency 'dry-struct'
   spec.add_dependency 'dry-core'
-  ## Database-Access via Postgres is not implemented
-#	spec.add_dependency 'pg'
-#	spec.add_dependency 'mini_sql'
+  spec.add_dependency 'dry-configurable'
+#  spec.add_dependency 'dry-monads'  # future use
 end

data/bin/console

@@ -1,17 +1,17 @@
 #!/usr/bin/env ruby
-## loads the active-orient environment 
+## loads the arcadeDB environment
 ## and starts an interactive shell
 ##
-## Parameter:  
+## Parameter:
 ##	       production (p)
 ##	       development (d)  [default]
 ##	       test (t)
 require 'bundler/setup'
-require 'terminal-table'
+#require 'terminal-table'
 require 'zeitwerk'
 require 'pastel'
 require 'arcade'
-require 'pry'
+#require 'pry'
 #begin
 
 
@@ -66,10 +66,6 @@ def browse  db: Arcade::Api.databases.first , extended: false
 end
 
 
-
-
-
-
 include Arcade
 
 def help
@@ -106,21 +102,25 @@ end
 
 help
 e=  ARGV.empty? ? :development :  ARGV.last.downcase.to_sym
-## load test model files
-#require "#{__dir__}/../spec/model_helper"
-
 loader =  Zeitwerk::Loader.new
-loader.push_dir ("#{__dir__}/../spec/model")
+if e.to_s[0] == 't'
+  loader.push_dir ("#{__dir__}/../spec/model")
+else
+  loader.push_dir ("#{__dir__}/../lib/model")
+
+end
 loader.setup
 puts  "DB = Arcade::Database-instance"
 DB = Arcade::Init.connect e
 #require 'pry'
+#if e.to_s[0] == 't'
+#    DB.create_type :document, 'test_document'
+#    DB.create_type :vertex, :test_vertex
+#
+#end
 require 'irb'
 ARGV.clear
-#begin
-#IRB.start(__FILE__)
-#rescue ArgumentError => e
-#  puts e
-##  retry
-#end
-Pry.start(__FILE__)
+
+IRB.start(__FILE__)
+
+#Pry.start(__FILE__)