sldb 0.1.0

data/sample/a.rb

@@ -0,0 +1,22 @@
+require 'sldb'
+
+#
+# use the factory method to specify your database class
+#
+DB =
+  SLDB::class {
+    schema 'create table t ( a, b, c )'
+    path 'sldb'
+  }
+
+#
+# create and instance and use it - it will be created and initialized with the
+# schema on the first use
+#
+db = DB::new
+
+db.transaction do
+  db.execute 'insert into t values (0,1,2)'
+  db.execute('select * from t'){|tuple| p tuple}
+end
+

data/sample/b.rb

@@ -0,0 +1,29 @@
+require 'csv'
+require 'sldb'
+
+DB = SLDB::class :schema => 'create table t ( a, b, c )'
+db = DB::new 'sldb'
+
+#
+# sldb uses arrayfields so many operations are natural since tuples are arrays,
+# yet can be indexed by field
+#
+db.transaction do
+  db.execute "insert into t values ( 'A', 'B', 'C' )"
+  db.execute('select * from t') do |tuple| 
+    puts "tuple => #{ tuple.inspect }"
+    tuple.fields.each{|f| puts "  tuple[#{ f }] => #{ tuple[f] }"}
+  end
+end
+
+puts
+
+#
+# csv generation is an example of something which is much more natural with
+# arrays
+#
+CSV::generate('csv') do |csv|
+  db.ro_transaction{db.execute('select * from t'){|t| csv << t}}
+end
+puts(IO::read('csv'))
+

data/sample/c.rb

@@ -0,0 +1,35 @@
+require 'yaml'
+require 'sldb'
+
+DB = SLDB::new { 
+  schema <<-sql
+    create table t0 ( a, b, c);
+    create table t1 ( x, y, z);
+  sql
+
+  path 'sldb'
+}
+
+db = DB::new
+
+#
+# many utility methods exist to make working with the databases easier
+#
+db.transaction do
+  db.tablenames.each do |tablename|
+    tuple = db.tuple_for tablename
+    tuple.fields.each{|f| tuple[f] = db.timestamp 'local' => true}
+    values = db.quote tuple
+    sql = "insert into #{ tablename } values (#{ values.join ',' })"
+    db.execute sql
+  end
+end
+
+db.read_only_transaction do
+  db.tablenames.each do |tablename|
+    db.execute("select * from #{ tablename }") do |t|
+      t.map!{|f| db.stamptime f, 'local' => true}
+      y t.to_hash
+    end
+  end
+end

data/sample/d.rb

@@ -0,0 +1,37 @@
+require 'yaml'
+require 'sldb'
+
+DB = SLDB::new { schema 'create table t ( tid, time )'; path 'sldb' }
+db = DB::new
+
+#
+# multi-processed/multi-threaded applications may simoultaneously access the db 
+#
+
+4.times do
+  unless fork
+    pid = $$
+    threads = []
+    2.times do |i|
+      threads << 
+        Thread::new(i, db) do |tid, db|
+          sleep rand
+          tuple = db.tuple_for 't'
+          tuple['tid'] = "#{ pid }:#{ tid }" 
+          tuple['time'] = Time::now.to_f
+          values = db.quote tuple
+          db.transaction{db.execute "insert into t values(#{ values.join ',' })"}
+        end
+    end
+    threads.each{|t| t.join}
+    exit
+  end
+end
+
+4.times{ Process::wait }
+
+report = Hash::new{|h,k| h[k] = []} 
+
+db.transaction{db.execute("select * from t"){|t| report['t'] << t.to_hash}}
+
+y report

data/sample/e.rb

@@ -0,0 +1,19 @@
+require 'sldb'
+
+#
+# the SLDB factory method handles - as a special case - a pathname being passed
+# in as meaning : create the class AND give me and instance of it which allows
+# connecting to dbs even when the schema is unknown
+#
+
+dbklass = SLDB::new 'schema' => 'create table t ( answer )', 
+                    'path'  => 'sldb'
+db = dbklass::new
+db.transaction{ db.execute 'insert into t values ( 42 )' }
+
+fork do
+  db = SLDB::new 'sldb'  # here we don't know schema
+  db.transaction{ db.execute('select * from t'){|t| puts t['answer']}}
+end
+
+Process::wait

data/white_box/test.rb

@@ -0,0 +1,49 @@
+$VERBOSE=nil
+$:.unshift 'lib'
+
+require 'yaml'
+require 'sldb'
+
+DB = SLDB::new { schema 'create table t ( tid, time )'; path 'sldb' }
+db = DB::new
+
+loop do
+
+#
+# multi-processed/multi-threaded applications may simoultaneously access the db 
+#
+
+4.times do
+  unless fork
+    pid = $$
+    threads = []
+    2.times do |i|
+      threads << 
+        Thread::new(i, db) do |tid, db|
+          sleep rand
+          tuple = db.tuple_for 't'
+          tuple['tid'] = "#{ pid }:#{ tid }" 
+          tuple['time'] = Time::now.to_f
+          values = db.quote tuple
+          db.transaction{db.execute "insert into t values(#{ values.join ',' })"}
+        end
+    end
+    threads.each{|t| t.join}
+    exit
+  end
+end
+
+4.times{ Process::wait }
+
+tuples = nil
+
+db.transaction{
+  tuples = db.execute("select * from t")
+  if tuples.size > 1024
+    db.execute("delete from t"){}
+  end
+}
+
+tuples.each_with_index{|tuple, idx| p [idx, tuple]}
+
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: sldb
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2006-10-23 00:00:00.000000 -06:00
+summary: sldb
+require_paths: 
+  - lib
+email: ara.t.howard@noaa.gov
+homepage: http://codeforpeople.com/lib/ruby/sldb/
+rubyforge_project: 
+description: 
+autorequire: sldb
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+  - Ara T. Howard
+files: 
+  - lib
+  - install.rb
+  - README.tmpl
+  - white_box
+  - README
+  - gen_readme.rb
+  - VERSION
+  - gemspec.rb
+  - sample
+  - lib/sldb.rb
+  - lib/sldb-0.1.0.rb
+  - white_box/test.rb
+  - sample/a.rb
+  - sample/b.rb
+  - sample/c.rb
+  - sample/d.rb
+  - sample/e.rb
+test_files: []
+rdoc_options: []
+extra_rdoc_files: []
+executables: []
+extensions: []
+requirements: []
+dependencies: []