path 2.0.0 → 2.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: dc79568913620a232363ac1c8337e5b163a1a910
-  data.tar.gz: 3b1e928062bba5999f0ffd1afd6ac8895b7838a0
+SHA256:
+  metadata.gz: efcdf8c91dddaf7c18d7d833a664da77428c72f354bc73fbc89d9fb1d2fe4eb8
+  data.tar.gz: 9e1dea71086a4eb45b6aac1ad91c417432820985a2cdd222e77f1dc458fee1d7
 SHA512:
-  metadata.gz: 81762a43a917e1b34e483753bdb72bfe5256a4eb777c07f32a5ae108b166ef67da09bef20af735b4c3e3154bdb606fffd7cc5134c99e9e474d4bb1d5ed99927e
-  data.tar.gz: 8456c2c9eda72afbe858e5a22cf6648297acd75a3101d5b5abc7a4d4a117dcae2e86b807f0ec585367295a2b2354f4ce3272917ef6e0a7c16d3f9ce7d7530b0f
+  metadata.gz: 40610513248438fbc3038167c1aaff927d725107d2cfcdaf87d6d38036c9cc2fe432ce4e658fcefdd367cb42e3f467ded88cc81be273f73e53fe8dd2e13336e5
+  data.tar.gz: e09e515fbdf68768d9a39ac4e68d6665095f7216784d5ebbfa5e5b2261b904fd09d6d7eb010a54b398d825d0ccd224066c63aca6bf29919bedc2c2652e840417

data/README.md

@@ -1,8 +1,7 @@
 # Path - a Path manipulation library
 
-[![Gem Version](https://badge.fury.io/rb/path.png)](https://rubygems.org/gems/path)
-[![Build Status](https://travis-ci.org/eregon/path.svg?branch=master)](https://travis-ci.org/eregon/path)
-[![Build Status](https://ci.appveyor.com/api/projects/status/jg6fx1692mw8mu58/branch/master?svg=true)](https://ci.appveyor.com/project/eregon/path/branch/master)
+[![Gem Version](https://badge.fury.io/rb/path.svg)](https://rubygems.org/gems/path)
+[![CI](https://github.com/eregon/path/actions/workflows/ci.yml/badge.svg)](https://github.com/eregon/path/actions/workflows/ci.yml)
 
 [Path](http://rubydoc.info/github/eregon/path/master/Path) is a library to manage paths.  
 It is similar to Pathname, but has some extra goodness.  
@@ -167,6 +166,17 @@ which will show where `+` is used as String concatenation.
 Coming from a path library using `+` as #join, one should just use the default (`Path.configure(:+ => :warning)`),
 which will show where `+` is used.
 
+## Migration from path 1.x
+
+A couple methods changed since 1.x, all mentioned in the [ChangeLog](Changelog.md).
+
+One of the easiest way is to grep for the changed methods.
+Here is a list of each with a direct replacement.
+
+* Path.here => Path.file
+* Path#base => Path#stem
+* Path#ext => Path#pure_ext (it now returns a leading dot)
+
 ## Status
 
 This is still in the early development stage, you should expect many additions and some changes.

data/lib/path/dir.rb

@@ -96,7 +96,8 @@ class Path
   end
 
   # Returns the children of the directory (files and subdirectories, not
-  # recursive) as an array of Path objects. By default, the returned
+  # recursive) as an array of Path objects. The children paths are always
+  # sorted to ensure a deterministic order. By default, the returned
   # paths will have enough information to access the files. If you set
   # +with_directory+ to +false+, then the returned paths will contain the
   # filename only.
@@ -123,10 +124,12 @@ class Path
         result << Path.new(e)
       end
     }
+    result.sort!
     result
   end
 
   # Iterates over the children of the directory (files and subdirectories, not recursive).
+  # The children paths are always sorted to ensure a deterministic order.
   # By default, the yielded paths will have enough information to access the files.
   # If you set +with_directory+ to +false+, then the returned paths will contain the filename only.
   #
@@ -158,6 +161,7 @@ class Path
   # Equivalent of +parent.children - [self]+.
   # Returns the siblings, the files in the same directory as the current +path+.
   # Returns only the root if +path+ is the root.
+  # The sibling paths are always sorted to ensure a deterministic order.
   def siblings(with_directory = true)
     if root?
       [self]

data/lib/path/fileutils.rb

@@ -80,8 +80,8 @@ class Path
   # Install +file+ into +path+ (the "prefix", which should be a directory).
   # If +file+ is not same as +path/file+, replaces it.
   # See +FileUtils.install+ (arguments are swapped).
-  def install(file, options = {})
-    FileUtils.install(file, @path, options)
+  def install(file, **options)
+    FileUtils.install(file, @path, **options)
   end
 
   # Recusively changes permissions. See +FileUtils.chmod_R+ and +File.chmod+.

data/lib/path/identity.rb

@@ -80,9 +80,11 @@ class Path
   # Returns the +path+ as a String.
   # {#path} is implemented for better readability (+file.path+ instead of +file.to_s+) and as an accessor.
   # {#to_path} is implemented so Path objects are usable with +open+, etc.
+  # {#to_str} is implemented so Path objects are usable with +open+, etc with Ruby 1.8 (it is not defined in Ruby 1.9).
   attr_reader :path
   alias :to_s :path
   alias :to_path :path
+  alias :to_str :path if RUBY_VERSION < '1.9'
 
   # Compare this path with +other+. The comparison is string-based.
   # Be aware that two different paths (+foo.txt+ and +./foo.txt+)

data/lib/path/implementation.rb

@@ -133,7 +133,6 @@ class Path
   def init
     @path = validate(@path)
 
-    taint if @path.tainted?
     @path.freeze
     freeze
   end

data/lib/path/io.rb

@@ -64,11 +64,11 @@ class Path
     end
   end
 
-  if IO.respond_to? :write and !RUBY_DESCRIPTION.start_with?('jruby')
+  if IO.respond_to? :write and RUBY_ENGINE != 'jruby'
     # Appends +contents+ to +self+. See +IO.write+ or +IO#write+.
-    def append(contents, open_args = {})
+    def append(contents, **open_args)
       open_args[:mode] = 'a'
-      IO.write(@path, contents, open_args)
+      IO.write(@path, contents, **open_args)
     end
   else
     def append(contents, *open_args)

data/lib/path/predicates.rb

@@ -30,4 +30,9 @@ class Path
       false
     end
   end
+
+  # Whether this is a hidden path, i.e. starting with a dot.
+  def hidden?
+    basename.to_s.start_with?('.')
+  end
 end

data/lib/path/version.rb

@@ -1,5 +1,5 @@
 class Path
   # The version of the gem.
   # Set here to avoid duplication and allow introspection.
-  VERSION = '2.0.0'
+  VERSION = '2.1.0'
 end

data/path.gemspec

@@ -10,4 +10,5 @@ Gem::Specification.new do |s|
   s.files = Dir['lib/**/*.rb'] + %w[README.md LICENSE path.gemspec]
   s.licenses = ['MIT']
   s.version = Path::VERSION
+  s.required_ruby_version = '>= 2.6.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: path
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.0
 platform: ruby
 authors:
 - eregon
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2016-11-13 00:00:00.000000000 Z
+date: 2023-04-15 00:00:00.000000000 Z
 dependencies: []
 description: Path is a library to easily manage paths and with a lot of extra goodness.
 email: eregontp@gmail.com
@@ -38,7 +38,7 @@ homepage: https://github.com/eregon/path
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -46,17 +46,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
-signing_key: 
+rubygems_version: 3.3.26
+signing_key:
 specification_version: 4
 summary: The Path manipulation library
 test_files: []
-has_rdoc: