libpath-ruby 0.2.1 → 0.2.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6dd88bc30d1032ce6d4a4b279bb0692fbc0669205be981d9182abd7b6adbf7b9
-  data.tar.gz: 778b9b33864a813d2ab4ff67b8685f6ee193c0eeeb9b4632647a655ca4ff6ab5
+  metadata.gz: bb00e0cfae7c3f659f2b1db1a0d65491b8458be3d129861815427a00ca6b85a2
+  data.tar.gz: '09132f8eb4d1adb3fea11cca8eb2d8beaa824e25861387f2939a3e348eb6555b'
 SHA512:
-  metadata.gz: 02f1f20771f342c7df0945a887a3611fe1357e06e7a22c182382901711c837aef4fe6ec12e7c3ade63d9e86ee52697b30957eec7544271d998192ba3d633b9a3
-  data.tar.gz: 3a1bcce47edcfdee2f20a05fa7d42b4929d5a7abce60fec405e8d89e5141597825cf4cfd4dee0c74f057540f4e167bc44ce556891345aacb7a4ee690fbd8d33f
+  metadata.gz: e0642b21c266ce97a09b1cca3c4b5e79eefa197a95398ab57dc6022ec8c1262a40592b4a1a350255551402a49f8d2a7596de4a78131bb1e8600f443eadbb9439
+  data.tar.gz: a5ff1452f28d8e78bfe6c01333e1f94af191734ef795fbf6d63d753dfb5af2dcfdf0f3f135b3cf776686c831bdc93be57584a04c5bacd71532531da194a34f72

data/LICENSE

@@ -0,0 +1,33 @@
+libpath.Ruby - BSD 3-Clause License
+
+Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+Copyright (c) 2019, Matthew Wilson and Synesis Software
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.
+

data/README.md

@@ -1,26 +1,34 @@
-# libpath.Ruby
+# libpath.Ruby <!-- omit in toc -->
+
 **libpath**, for Ruby
 
 [![Gem Version](https://badge.fury.io/rb/libpath-ruby.svg)](https://badge.fury.io/rb/libpath-ruby)
 
-## Table of Contents
 
-1. [Introduction](#introduction)
-2. [Installation](#installation)
-3. [Components](#components)
-4. [Examples](#examples)
-5. [Project Information](#project-information)
+## Table of Contents <!-- omit in toc -->
+
+- [Introduction](#introduction)
+- [Installation](#installation)
+- [Components](#components)
+- [Examples](#examples)
+- [Project Information](#project-information)
+  - [Where to get help](#where-to-get-help)
+  - [Contribution guidelines](#contribution-guidelines)
+  - [Related projects](#related-projects)
+  - [License](#license)
+
 
 ## Introduction
 
 **libpath** is a path-parsing and utility library. It is concerned entirely with paths, as opposed to file-system entities.
 
+
 ## Installation
 
 Install via **gem** as in:
 
 ```
-	gem install libpath-ruby
+  gem install libpath-ruby
 ```
 
 or add it to your `Gemfile`.
@@ -35,27 +43,36 @@ require 'libpath'
 
 T.B.C.
 
+
 ## Examples
 
 Examples are provided in the ```examples``` directory, along with a markdown description for each. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).
 
+
 ## Project Information
 
+
 ### Where to get help
 
 [GitHub Page](https://github.com/synesissoftware/libpath.Ruby "GitHub Page")
 
+
 ### Contribution guidelines
 
 Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/libpath.Ruby.
 
+
 ### Related projects
 
 **libpath.Ruby** is based on the [C/C++ libpath library](https://github.com/synesissoftware/libpath), which itself was prompted by a request on the [STLSoft](https://github.com/synesissoftware/STLSoft-1.10) project by my friend and esteemed programmer [Adi Shavit](https://github.com/adishavit).
 
 **libpath.Ruby** will be used in **version 3+** of the **[recls.Ruby](https://github.com/synesissoftware/recls.Ruby)** library, which currently has its own path-parsing logic.
 
+
 ### License
 
 **libpath.Ruby** is released under the 3-clause BSD license. See LICENSE for details.
 
+
+<!-- ########################### end of file ########################### -->
+

data/examples/path_from_arg0.md

@@ -16,23 +16,23 @@ require 'libpath/path'
 
 PATH_ATTRIBUTES = %i{
 
-	given_path
-	absolute_path
-	compare_path
-	directory
-	directory_path
-	dirname
-	directory_parts
-	file_full_name
-	basename
-	file_name_only
-	stem
-	file_extension
-	extension
-	search_directory
-	search_relative_path
-	search_relative_directory_path
-	search_relative_directory_parts
+  given_path
+  absolute_path
+  compare_path
+  directory
+  directory_path
+  dirname
+  directory_parts
+  file_full_name
+  basename
+  file_name_only
+  stem
+  file_extension
+  extension
+  search_directory
+  search_relative_path
+  search_relative_directory_path
+  search_relative_directory_parts
 }
 
 
@@ -49,16 +49,16 @@ puts
 
 puts "\tall attributes:"
 
-max_name_len	=	PATH_ATTRIBUTES.map { |sym| sym.to_s.size }.max_by { |s| s }
-max_type_len	=	PATH_ATTRIBUTES.map { |sym| path.send(sym).class.to_s.size }.max_by { |s| s }
+max_name_len = PATH_ATTRIBUTES.map { |sym| sym.to_s.size }.max_by { |s| s }
+max_type_len = PATH_ATTRIBUTES.map { |sym| path.send(sym).class.to_s.size }.max_by { |s| s }
 
 PATH_ATTRIBUTES.each do |attr|
 
-	name	=	attr.to_s
-	value	=	path.send(attr)
-	type	=	value.class
+  name  = attr.to_s
+  value = path.send(attr)
+  type  = value.class
 
-	puts "\t\t#{name.to_s.rjust(max_name_len)} (#{type.to_s.rjust(max_type_len)}) : #{value}"
+  puts "\t\t#{name.to_s.rjust(max_name_len)} (#{type.to_s.rjust(max_type_len)}) : #{value}"
 end
 ```
 
@@ -75,25 +75,25 @@ The output is:
 ```
 path obtained from '.gitignore' (with search directory '../../../CLASP/CLASP.Ruby/trunk'):
 
-	path: /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
-
-	all attributes:
-		                     given_path (  String) : .gitignore
-		                  absolute_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
-		                   compare_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
-		                      directory (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
-		                 directory_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
-		                        dirname (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
-		                directory_parts (   Array) : ["/", "Users/", "matthewwilson/", "dev/", "freelibs/", "libpath/", "libpath.Ruby/", "trunk/"]
-		                 file_full_name (  String) : .gitignore
-		                       basename (  String) : .gitignore
-		                 file_name_only (NilClass) : 
-		                           stem (NilClass) : 
-		                 file_extension (  String) : .gitignore
-		                      extension (  String) : .gitignore
-		               search_directory (  String) : /Users/matthewwilson/dev/freelibs/CLASP/CLASP.Ruby/trunk/
-		           search_relative_path (  String) : ../../../libpath/libpath.Ruby/trunk/.gitignore
-		 search_relative_directory_path (  String) : ../../../libpath/libpath.Ruby/trunk/
-		search_relative_directory_parts (   Array) : ["../", "../", "../", "libpath/", "libpath.Ruby/", "trunk/"]
+  path: /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
+
+  all attributes:
+                        given_path (  String) : .gitignore
+                      absolute_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
+                      compare_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/.gitignore
+                          directory (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
+                    directory_path (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
+                            dirname (  String) : /Users/matthewwilson/dev/freelibs/libpath/libpath.Ruby/trunk/
+                    directory_parts (   Array) : ["/", "Users/", "matthewwilson/", "dev/", "freelibs/", "libpath/", "libpath.Ruby/", "trunk/"]
+                    file_full_name (  String) : .gitignore
+                          basename (  String) : .gitignore
+                    file_name_only (NilClass) :
+                              stem (NilClass) :
+                    file_extension (  String) : .gitignore
+                          extension (  String) : .gitignore
+                  search_directory (  String) : /Users/matthewwilson/dev/freelibs/CLASP/CLASP.Ruby/trunk/
+              search_relative_path (  String) : ../../../libpath/libpath.Ruby/trunk/.gitignore
+    search_relative_directory_path (  String) : ../../../libpath/libpath.Ruby/trunk/
+    search_relative_directory_parts (   Array) : ["../", "../", "../", "libpath/", "libpath.Ruby/", "trunk/"]
 ```
 

data/examples/path_from_arg0.rb

@@ -7,23 +7,23 @@ require 'libpath/path'
 
 PATH_ATTRIBUTES = %i{
 
-	given_path
-	absolute_path
-	compare_path
-	directory
-	directory_path
-	dirname
-	directory_parts
-	file_full_name
-	basename
-	file_name_only
-	stem
-	file_extension
-	extension
-	search_directory
-	search_relative_path
-	search_relative_directory_path
-	search_relative_directory_parts
+  given_path
+  absolute_path
+  compare_path
+  directory
+  directory_path
+  dirname
+  directory_parts
+  file_full_name
+  basename
+  file_name_only
+  stem
+  file_extension
+  extension
+  search_directory
+  search_relative_path
+  search_relative_directory_path
+  search_relative_directory_parts
 }
 
 
@@ -40,16 +40,18 @@ puts
 
 puts "\tall attributes:"
 
-max_name_len	=	PATH_ATTRIBUTES.map { |sym| sym.to_s.size }.max_by { |s| s }
-max_type_len	=	PATH_ATTRIBUTES.map { |sym| path.send(sym).class.to_s.size }.max_by { |s| s }
+max_name_len = PATH_ATTRIBUTES.map { |sym| sym.to_s.size }.max_by { |s| s }
+max_type_len = PATH_ATTRIBUTES.map { |sym| path.send(sym).class.to_s.size }.max_by { |s| s }
 
 PATH_ATTRIBUTES.each do |attr|
 
-	name	=	attr.to_s
-	value	=	path.send(attr)
-	type	=	value.class
+  name  = attr.to_s
+  value = path.send(attr)
+  type  = value.class
 
-	puts "\t\t#{name.to_s.rjust(max_name_len)} (#{type.to_s.rjust(max_type_len)}) : #{value}"
+  puts "\t\t#{name.to_s.rjust(max_name_len)} (#{type.to_s.rjust(max_type_len)}) : #{value}"
 end
 
 
+# ############################## end of file ############################# #
+

data/lib/libpath/constants/unix.rb

@@ -1,15 +1,16 @@
 # ######################################################################## #
-# File:         libpath/constants/unix.rb
+# File:     libpath/constants/unix.rb
 #
-# Purpose:      LibPath::Constants::Unix module
+# Purpose:  LibPath::Constants::Unix module
 #
-# Created:      29th January 2019
-# Updated:      16th April 2019
+# Created:  29th January 2019
+# Updated:  6th April 2024
 #
-# Home:         http://github.com/synesissoftware/libpath.Ruby
+# Home:     http://github.com/synesissoftware/libpath.Ruby
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
+# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -43,7 +44,6 @@
 # ######################################################################## #
 
 
-
 =begin
 =end
 
@@ -55,83 +55,83 @@ module Unix # :nodoc:
 # any class or module including/extending module LibPath::Constants::Unix
 module LibPath_Constants_Unix_Methods
 
-	# Defines invalid characters
-	module InvalidCharacters
-
-		# Innately invalid characters
-		module Innate
-
-			# The list of characters
-			LIST	=	[
-
-				"\0",
-			]
-			# The regular expression
-			RE		=	/[#{LIST.map { |m| Regexp.escape m }.join}]/
-		end # module Innate
-
-		# Valid path name separator characters
-		module PathNameSeparators
-
-			# The list of characters
-			LIST	=	[
-
-				'/',
-			]
-			# The regular expression
-			RE		=	/[#{LIST.map { |m| Regexp.escape m }.join}]/
-		end # module PathNameSeparators
-
-		# Valid path separator characters
-		module PathSeparators
-
-			# The list of characters
-			LIST	=	[
-
-				':',
-			]
-			# The regular expression
-			RE		=	/[#{LIST.map { |m| Regexp.escape m }.join}]/
-		end # module PathSeparators
-
-		# Invalid shell characters
-		module Shell
-
-			# The list of characters
-			LIST	=	[
-
-				'*',
-				'<',
-				'>',
-				'?',
-				'|',
-			]
-			# The regular expression
-			RE		=	/[#{LIST.map { |m| Regexp.escape m }.join}]/
-		end # module Shell
-	end # module InvalidCharacters
+  # Defines invalid characters
+  module InvalidCharacters
+
+    # Innately invalid characters
+    module Innate
+
+      # The list of characters
+      LIST = [
+
+        "\0",
+      ]
+      # The regular expression
+      RE = /[#{LIST.map { |m| Regexp.escape m }.join}]/
+    end # module Innate
+
+    # Valid path name separator characters
+    module PathNameSeparators
+
+      # The list of characters
+      LIST = [
+
+        '/',
+      ]
+      # The regular expression
+      RE = /[#{LIST.map { |m| Regexp.escape m }.join}]/
+    end # module PathNameSeparators
+
+    # Valid path separator characters
+    module PathSeparators
+
+      # The list of characters
+      LIST = [
+
+        ':',
+      ]
+      # The regular expression
+      RE = /[#{LIST.map { |m| Regexp.escape m }.join}]/
+    end # module PathSeparators
+
+    # Invalid shell characters
+    module Shell
+
+      # The list of characters
+      LIST = [
+
+        '*',
+        '<',
+        '>',
+        '?',
+        '|',
+      ]
+      # The regular expression
+      RE = /[#{LIST.map { |m| Regexp.escape m }.join}]/
+    end # module Shell
+  end # module InvalidCharacters
 end # module LibPath_Constants_Unix_Methods
 
 # @!visibility private
 def self.extended receiver # :nodoc:
 
-	receiver.class_eval do
+  receiver.class_eval do
 
-		extend LibPath_Constants_Unix_Methods
-	end
+    extend LibPath_Constants_Unix_Methods
+  end
 
-	$stderr.puts "#{receiver} extended by #{LibPath_Constants_Unix_Methods}" if $DEBUG
+  $stderr.puts "#{receiver} extended by #{LibPath_Constants_Unix_Methods}" if $DEBUG
 end
 
 # @!visibility private
 def self.included receiver # :nodoc:
 
-	receiver.class_eval do
+  receiver.class_eval do
 
-		include LibPath_Constants_Unix_Methods
-	end
+    include LibPath_Constants_Unix_Methods
+  end
 
-	$stderr.puts "#{receiver} included #{LibPath_Constants_Unix_Methods}" if $DEBUG
+  $stderr.puts "#{receiver} included #{LibPath_Constants_Unix_Methods}" if $DEBUG
 end
 
 extend LibPath_Constants_Unix_Methods
@@ -141,6 +141,6 @@ end # module Unix
 end # module Constants
 end # module LibPath
 
-# ############################## end of file ############################# #
 
+# ############################## end of file ############################# #