arcadedb 0.4 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1855060886e9837ef486e44f07155ae99cd242f76aceccb8a7bf4c2ab515eca0
-  data.tar.gz: d99f2a402eba561fcf851a3838b3bec7eee58f1a788ab9fc7e2ce1208c33611a
+  metadata.gz: 7d7f1f29472b0fb31734654c9456ec5bdfb31cd42fd46b658139ac840691c6f6
+  data.tar.gz: 4c1c95707c8e2c528654f2a7509b1b6943ef9615fe203c81cd421d52636dcac7
 SHA512:
-  metadata.gz: 78936dfe0069d531c1bcfd6191f0269ed84a44cd8e0321a37ef9d569048ff8a20d38d0a221d0b0b93f3e64f39d61a758d2978545beec86d27baf5836c3cdbf4a
-  data.tar.gz: 6ff4e9242c74887935074ed60810b144a08ad2dad7a6d3374bc0216f74873abb6a1b6f66428a2ed6e7fa9f49dec3ee07ebbe5cc64488744829f76eb037db286c
+  metadata.gz: f54746f04760ebfbc8c1588e66fb0bb52e820eef83df564e3563e37219835ff86c93e5b3d2e2a7617452218938c30a5aabff099361d0fd829890e2ac83411fc8
+  data.tar.gz: 0f8bf3623302c5204ca56552fb41694bfd506c493dc72463b8000e66c82aacddb7f42188f41508c84e9fc5bf93fa78e42e4235ed904982b97d38a4a5c8d4ff40

data/CHANGELOG.md

@@ -15,5 +15,19 @@ All notable changes to this project will be documented in this file.
 ## 0.4.0 - 2023.10.28
 - completely remove pg-stuff
 - substitute typhoreous with  HTTPX
-- include dry::monards to process raw-data
 
+## 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.lock

@@ -1,10 +1,9 @@
 PATH
   remote: .
   specs:
-    arcadedb (0.4)
+    arcadedb (0.4.1)
       dry-configurable
       dry-core
-      dry-monads
       dry-schema
       dry-struct
       httpx
@@ -12,9 +11,7 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
     awesome_print (1.9.2)
-    base64 (0.1.1)
     coderay (1.1.3)
     concurrent-ruby (1.2.2)
     diff-lcs (1.5.0)
@@ -30,10 +27,6 @@ GEM
       concurrent-ruby (~> 1.0)
       dry-core (~> 1.0, < 2)
       zeitwerk (~> 2.6)
-    dry-monads (1.6.0)
-      concurrent-ruby (~> 1.0)
-      dry-core (~> 1.0, < 2)
-      zeitwerk (~> 2.6)
     dry-schema (1.13.3)
       concurrent-ruby (~> 1.0)
       dry-configurable (~> 1.0, >= 1.0.1)
@@ -72,11 +65,9 @@ GEM
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
     http-2-next (1.0.1)
-    httpx (1.0.2)
+    httpx (1.1.0)
       http-2-next (>= 1.0.1)
     ice_nine (0.11.2)
-    json (2.6.3)
-    language_server-protocol (3.17.0.3)
     listen (3.8.0)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
@@ -86,10 +77,6 @@ GEM
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
-    parallel (1.23.0)
-    parser (3.2.2.4)
-      ast (~> 2.4.1)
-      racc
     pastel (0.8.0)
       tty-color (~> 0.5)
     pry (0.14.2)
@@ -97,16 +84,12 @@ GEM
       method_source (~> 1.0)
     psych (5.1.1.1)
       stringio
-    racc (1.7.1)
-    rainbow (3.1.1)
     rake (13.0.6)
     rb-fsevent (0.11.2)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
     rdoc (6.5.0)
       psych (>= 4.0.0)
-    regexp_parser (2.8.2)
-    rexml (3.2.6)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
       rspec-expectations (~> 3.12.0)
@@ -131,21 +114,6 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.1)
-    rubocop (1.57.1)
-      base64 (~> 0.1.1)
-      json (~> 2.3)
-      language_server-protocol (>= 3.17.0)
-      parallel (~> 1.10)
-      parser (>= 3.2.2.4)
-      rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
-      ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
-      parser (>= 3.2.1.0)
-    ruby-progressbar (1.13.0)
     sdoc (2.6.1)
       rdoc (>= 5.0)
     shellany (0.0.1)
@@ -168,7 +136,6 @@ DEPENDENCIES
   guard
   guard-rspec
   pastel
-  pry
   rake (~> 13.0)
   rb-inotify
   rspec
@@ -177,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

@@ -3,20 +3,20 @@
   :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/bin/console

@@ -1,13 +1,13 @@
 #!/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'
@@ -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__)