relaxo 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 814525baa6f655dc170eec88ee0878abf080f10c
-  data.tar.gz: 8c530c78c0b059db275418b4db7bfc521b562663
+  metadata.gz: 801d2413ec4ce9a0befc4ad46726900c09453cb8
+  data.tar.gz: e9b179cd2f9a6da4083848c3197f69b328dc455e
 SHA512:
-  metadata.gz: e5f3dbc6500971bf4ece1cea1369f8f4b0d1e3ffa5055163a89da3a4c9f2ff796eea4b7031c82231bda3694f65f77a7620312966490124ff5d0ec4d9611aa5d8
-  data.tar.gz: 1322de675206c9ce30f8f088d85ba0646155e9ae54f0e974274fdeae23bd80b9287526a91f8c6554c81536a3c67c8c244fba00487c7b216bc004ba50fb98106d
+  metadata.gz: 6f5c211fdb870371d30dd6555b556771a78a12408004db4bc1be125bcced2daa64bf05c989a8a8045b0456a64cc277d9fc1d132af9f26ed6a76c7ede4c3714af
+  data.tar.gz: 9f6a3c721c120a000666fb192fc2d779ff62a3d0ab714cc24f75284bfa6ca1bfe72cd5e32be469c241af28a43b6a3309f683dda823a76ecd74dd638eba176c68

data/README.md

@@ -106,6 +106,17 @@ Reading data is lighting fast as it's loaded directly from disk and cached.
 
 As Relaxo is unapologetically based on git, you can use git directly with a non-bare working directory to add any files you like. You can even point Relaxo at an existing git repository.
 
+### Durability
+
+Relaxo is based on `libgit2` and asserts that it is a transactional database. We base this assertion on:
+
+- All writes into the object store using `libgit2` are atomic and synchronized to disk.
+- All updates to refs are atomic and synchronized to disk.
+
+Provided these two invariants are maintained, the operation of Relaxo will be safe, even if there are unexpected interruptions to the program.
+
+The durability guarantees of Relaxo depend on [`libgit2` calling `fsync`](https://github.com/libgit2/libgit2/pull/4030), and [this being respected by the underlying hardware](http://www.evanjones.ca/intel-ssd-durability.html). Otherwise, durability cannot be guaranteed.
+
 ## Contributing
 
 1. Fork it

data/lib/relaxo/changeset.rb

@@ -49,7 +49,7 @@ module Relaxo
 		def append(data, type = :blob)
 			oid = @repository.write(data, type)
 			
-			return Rugged::Object.new(@repository, oid)
+			return @repository.read(oid)
 		end
 		
 		def write(path, object, mode = 0100644)

data/lib/relaxo/database.rb

@@ -75,6 +75,34 @@ module Relaxo
 			return dataset
 		end
 		
+		# revision history of given object
+		def history(path)
+			head, _ = latest_commit
+			
+			walker = Rugged::Walker.new(@repository) # Sounds like 'Walker, Texas Ranger'...
+			walker.sorting(Rugged::SORT_TOPO | Rugged::SORT_REVERSE)
+			walker.push(head.oid)
+			
+			commits = []
+			
+			old_oid = nil
+			
+			walker.each do |commit|
+				dataset = Dataset.new(@repository, commit.tree)
+				oid = dataset.read(path).oid
+				
+				if oid != old_oid # modified
+					yield commit if block_given?
+					commits << commit
+					old_oid = oid
+				end
+				
+				break if oid.nil? && !old_oid.nil? # deleted or moved
+			end
+			
+			return commits
+		end
+		
 		private
 		
 		def track_time(message)

data/lib/relaxo/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Relaxo
-	VERSION = "1.0.0"
+	VERSION = "1.0.1"
 end

data/spec/relaxo/database_spec.rb

@@ -84,4 +84,20 @@ RSpec.describe Relaxo::Database do
 			expect(dataset.each('test').count).to be == 10
 		end
 	end
+	
+	it "can enumerate commit history of a document" do
+		10.times do |id|
+			database.commit(message: "revising the document #{id}") do |changeset|
+				oid = changeset.append("revision \##{id} of this document")
+				changeset.write('test/doot.txt', oid)
+			end
+		end
+		
+		database.commit(message: "unrelated commit") do |changeset|
+			oid = changeset.append("unrelated document")
+			changeset.write('test/unrelated.txt', oid)
+		end
+		
+		expect(database.history('test/doot.txt').count).to be == 10
+	end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaxo
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-02-12 00:00:00.000000000 Z
+date: 2017-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rugged