dk-bdb 0.2.4

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Dan Janowski <danj@3skel.com>, Matt Bauer <bauer@pedalbrain.com>
+Copyright (c) 2009 Justin Balthrop <code@justinbalthrop.com>
+
+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,102 @@
+Description
+===
+
+Ruby bindings for Berkeley DB versions 4.2-4.7.
+
+Download
+========
+
+Currently this library is available via git at:
+
+	git://github.com/DenisKnauf/bdb.git
+
+
+Installation
+============
+
+From Git
+--------
+
+You can check out the latest source from git:
+
+	git clone git://github.com/DenisKnauf/bdb.git
+
+As a Gem
+========
+
+At the moment this library is not available on Rubyforge.  To install it as a
+gem, do the following (for custom compiled version 4.8):
+
+	wget http://github.com/downloads/DenisKnauf/bdb/bdb-VERSION.gem
+	sudo env ARCHFLAGS="-arch i386" gem install bdb-VERSION.gem -- --with-db-dir=/usr/local/BerkeleyDB.4.8
+
+For Berkeley DB v4.7 installed from MacPorts do the following:
+
+	sudo env ARCHFLAGS="-arch i386" gem install bdb-VERSION.gem -- --with-db-include=/opt/local/include/db47 --with-db-lib=/opt/local/lib/db47
+
+This assumes you're on OS X and BerkeleyDB wasn't compiled as a universal binary.
+
+Sample Usage
+============
+
+
+	env = Bdb::Env.new(0)
+	env_flags =  Bdb::DB_CREATE |    # Create the environment if it does not already exist.
+	             Bdb::DB_INIT_TXN  | # Initialize transactions
+	             Bdb::DB_INIT_LOCK | # Initialize locking.
+	             Bdb::DB_INIT_LOG  | # Initialize logging
+	             Bdb::DB_INIT_MPOOL  # Initialize the in-memory cache.
+	env.open(File.join(File.dirname(__FILE__), 'tmp'), env_flags, 0);
+	
+	db = env.db
+	db.open(nil, 'db1.db', nil, Bdb::Db::BTREE, Bdb::DB_CREATE | Bdb::DB_AUTO_COMMIT, 0)    
+
+	txn = env.txn_begin(nil, 0)
+	db.put(txn, 'key', 'value', 0)
+	txn.commit(0)
+
+	value = db.get(nil, 'key', nil, 0)
+
+	db.close(0)
+	env.close
+
+API
+===
+
+This interface is most closely based on the DB4 C api and tries to maintain close 
+interface proximity.
+[That API is published by Oracle](http://www.oracle.com/technology/documentation/berkeley-db/db/api_reference/C/frame_main.html).
+
+All function arguments systematically omit the leading DB handles and TXN handles.
+A few calls omit the flags parameter when the documentation indicates that no
+flag values are used - cursor.close is one.
+
+Alternative API
+---------------
+
+You can use [SBDB](http://github.com/DenisKnauf/sbdb), too.  It is easier to use, but base on this library.
+
+Notes
+=====
+
+The defines generator is imperfect and includes some defines that are not
+flags. While it could be improved, it is easier to delete the incorrect ones.
+Thus, if you decide to rebuild the defines, you will need to edit the resulting
+file. This may be necessary if using a different release of DB4 than the ones
+the authors developed against.  In nearly every case the defines generator works
+flawlessly.
+
+The authors have put all possible caution into ensuring that DB and Ruby cooperate.
+The memory access was one aspect carefully considered. Since Ruby copies
+when doing String#new, all key/data retrieval from DB is done with a 0 flag,
+meaning that DB will be responsible. See [*this* news group posting](http://groups.google.com/group/comp.databases.berkeley-db/browse_frm/thread/4f70a9999b64ce6a/c06b94692e3cbc41?tvc=1&q=dbt+malloc#c06b94692e3cbc41)
+about the effect of that.
+
+The only other design consideration of consequence was associate. The prior
+version used a Ruby thread local variable and kept track of the current
+database in use. The authors decided to take a simpler approach since Ruby is green
+threads. A global array stores the VALUE of the Proc for a given association
+by the file descriptor number of the underlying database. This is looked
+up when the first layer callback is made. It would have been better considered
+if DB allowed the passing of a (void *) user data into the alloc that would
+be supplied during callback. So far this design has not produced any problems.

data/VERSION

@@ -0,0 +1 @@
+0.2.4

data/examples/replication.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'bdb/database'
+require 'fileutils'
+
+role = ARGV.shift || 'client'
+
+MASTER = 'localhost:8888'
+CLIENT = 'localhost:9999'
+
+DIR = "/tmp/#{role}"
+FileUtils.rmtree DIR
+FileUtils.mkdir  DIR
+
+puts "Starting #{role}..."
+
+Bdb::Environment.replicate DIR, :from => MASTER, :to => CLIENT, :host => role == 'master' ? MASTER : CLIENT
+db = Bdb::Database.new('foo', :path => DIR)
+
+loop do
+  100.times do |i|
+    if role == 'master'
+      db.set(i, db[i].to_i + 1)
+      puts "#{i}: #{db[i]}"
+    else
+      puts "#{i}: #{db[i]}"
+    end
+    sleep 0.1
+  end
+end