relaxo 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a027f37d320054b6e6a138ea76b9582ce2e106bb79a84d1f4c2ab7341d3b246c
-  data.tar.gz: bf137e98b7a3591715e29aa2aa7cc70f08f150676cc707b9c426c31f1fe9bc12
+  metadata.gz: b43e712b63b0f63807a9a0c99bfeb9aa25c7e775f1594ff08081c9fb3db52cc0
+  data.tar.gz: 1c48257495fbf410453e08a23d9d05cc2c1be3acb64d750253be9b6f33bab8f8
 SHA512:
-  metadata.gz: fc8c1565cfd9bfa00e7518179f8142589135ab705c562bcb0b948804b817bc9d929d2ecff8c857ad59d36572b053a0f1340a33b0e8034aabd39ea5168c0b0eb5
-  data.tar.gz: 30e95d123d262733674834c64a12d4cc60e4594598c76ccaf45789a44b82760c126e492117253552e7eae0279df0c02aee36654bd52debb16d060d8c5bc855d7
+  metadata.gz: 498bed1e58dd6577e988d1303c8b835fea6c95785563dbe812ce570870e94a4a01d42b5a775ab54ae4e2063fdf4d5151dc4343791864e6ef3f86bbba7e781e59
+  data.tar.gz: 47412c47d2828083cb40bca0785cce94bf3c0b14e023f1447b689272f0b63c2ac6e876a02af66ed338b4dc717cc14090d28ebc0aed3c157de5f0fcdb88a38f2c

data/lib/relaxo/changeset.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2012-2019, by Samuel Williams.
+# Copyright, 2012-2025, by Samuel Williams.
 
-require_relative 'dataset'
+require_relative "dataset"
 
 module Relaxo
 	class Changeset < Dataset
@@ -38,7 +38,7 @@ module Relaxo
 		end
 		
 		def write(path, object, mode = 0100644)
-			root, _, name = path.rpartition('/')
+			root, _, name = path.rpartition("/")
 			
 			entry = @changes[path] = {
 				action: :upsert,
@@ -58,7 +58,7 @@ module Relaxo
 		alias []= write
 		
 		def delete(path)
-			root, _, name = path.rpartition('/')
+			root, _, name = path.rpartition("/")
 			
 			entry = @changes[path] = {
 				action: :remove,

data/lib/relaxo/database.rb

@@ -1,17 +1,17 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2012-2024, by Samuel Williams.
+# Copyright, 2012-2025, by Samuel Williams.
 # Copyright, 2017, by Huba Nagy.
 
-require 'rugged'
+require "rugged"
 
-require_relative 'logger'
-require_relative 'dataset'
-require_relative 'changeset'
+require_relative "logger"
+require_relative "dataset"
+require_relative "changeset"
 
 module Relaxo
-	HEAD = 'HEAD'.freeze
+	HEAD = "HEAD".freeze
 	
 	class Database
 		def initialize(path, branch, metadata = {})
@@ -32,6 +32,9 @@ module Relaxo
 		attr :metadata
 		attr :repository
 		
+		# @attribute branch [String] The branch that this database is currently working with.
+		attr :branch
+		
 		# Completely clear out the database.
 		def clear!
 			if head = @repository.branches[@branch]

data/lib/relaxo/dataset.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2012-2019, by Samuel Williams.
+# Copyright, 2012-2025, by Samuel Williams.
 
-require 'rugged'
+require "rugged"
 
-require_relative 'directory'
+require_relative "directory"
 
 module Relaxo
 	class Dataset
@@ -40,7 +40,7 @@ module Relaxo
 			return false
 		end
 		
-		def each(path = '', &block)
+		def each(path = "", &block)
 			return to_enum(:each, path) unless block_given?
 			
 			directory = fetch_directory(path)

data/lib/relaxo/directory.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2017, by Samuel Williams.
+# Copyright, 2017-2025, by Samuel Williams.
 
-require 'rugged'
+require "rugged"
 
 module Relaxo
 	class Directory
@@ -50,7 +50,7 @@ module Relaxo
 		end
 		
 		def insert(entry)
-			_, _, name = entry[:name].rpartition('/')
+			_, _, name = entry[:name].rpartition("/")
 			
 			@changes[name] = entry
 			
@@ -59,7 +59,7 @@ module Relaxo
 		end
 		
 		def delete(entry)
-			_, _, name = entry[:name].rpartition('/')
+			_, _, name = entry[:name].rpartition("/")
 			
 			@changes[name] = nil
 			

data/lib/relaxo/logger.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
-require 'console'
+require "console"
 
 module Relaxo
 	extend Console

data/lib/relaxo/version.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2012-2020, by Samuel Williams.
+# Copyright, 2012-2025, by Samuel Williams.
 
 module Relaxo
-	VERSION = "1.7.0"
+	VERSION = "1.8.0"
 end

data/lib/relaxo.rb

@@ -1,41 +1,61 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2012-2024, by Samuel Williams.
+# Copyright, 2012-2025, by Samuel Williams.
 
-require 'relaxo/database'
+require "relaxo/database"
 
-require 'etc'
-require 'socket'
+require "etc"
+require "socket"
 
 module Relaxo
-	MASTER = 'master'.freeze
+	DEFAULT_BRANCH = "main".freeze
 	
 	def self.connect(path, branch: nil, sync: nil, create: true, **metadata)
 		if !File.exist?(path) || create
 			repository = Rugged::Repository.init_at(path, true)
 			
-			if sync || ENV['RELAXO_SYNC']
-				repository.config['core.fsyncObjectFiles'] = true
+			if branch
+				repository.head = "refs/heads/#{branch}"
 			end
+			
+			if sync || ENV["RELAXO_SYNC"]
+				repository.config["core.fsyncObjectFiles"] = true
+			end
+		else
+			repository = Rugged::Repository.new(path)
 		end
 		
-		branch ||= MASTER
+		# Automatically detect the current branch if `branch` is not provided:
+		branch ||= self.default_branch(repository)
 		
 		database = Database.new(path, branch, metadata)
 		
 		if config = database.config
-			unless config['user.name']
+			unless config["user.name"]
 				login = Etc.getpwuid
 				hostname = Socket.gethostname
 				
 				if login
-					config['user.name'] = login.name
-					config['user.email'] = "#{login.name}@#{hostname}"
+					config["user.name"] = login.name
+					config["user.email"] = "#{login.name}@#{hostname}"
 				end
 			end
 		end
 		
 		return database
 	end
+	
+	private
+	
+	# Detect the default branch of the repository, taking into account unborn branches.
+	def self.default_branch(repository)
+		if head = repository.references["HEAD"]
+			if target_id = head.target_id
+				return target_id.sub(/^refs\/heads\//, "")
+			end
+		end
+		
+		return DEFAULT_BRANCH
+	end
 end

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2012-2024, by Samuel Williams.  
+Copyright, 2012-2025, by Samuel Williams.  
 Copyright, 2017-2018, by Huba Nagy.  
 Copyright, 2020, by Olle Jonsson.  
 

data/readme.md

@@ -146,8 +146,8 @@ We welcome contributions to this project.
 
 ### Developer Certificate of Origin
 
-This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: relaxo
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -39,7 +39,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-05-08 00:00:00.000000000 Z
+date: 2025-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -105,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Relaxo is versioned document database built on top of git.