build-files 1.4.3 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5298ff2018cafcc8c18f9319af1027d92c5f5a1b2c11cb683f916d65e0ba5ba
-  data.tar.gz: ab00474b4117ae16729255445285d9b835fe1d92a6de7b5c7a10207bb684c4e1
+  metadata.gz: 777a262af38e7bd84dc924b8e140d8d4e00077fab74b35d6f6ee555063809981
+  data.tar.gz: 981cbf1c9ff4234e9ef7e220de1362ecbcad2d61ae50d77ec072d19586471028
 SHA512:
-  metadata.gz: fd0603af29ac1189dd43b9b8beee290e091709cb218389a47dce5489bfed64aa716d9534c6848d2a735341cf7ed34149fb815d46605020f2c1806743ed7e7a44
-  data.tar.gz: b47e003284e29761c501d27e82032011e9350e816627d16223f24657c5f8ffdb155e69753c179ffc08b7c7bd95e633bc6aa851b55c1feab64be834cbce6e5529
+  metadata.gz: 85211d1effb626dd6d7664a3eaa15ab1f96b456ea49588dcd231c231fb47bbe545e4ea1aacfd7971c523b1674d418f47f4b1c86aa0b472dbb7c4f98c7e6e2587
+  data.tar.gz: a3f499ce331105afe331dbc912a41a532d9478dae92be32da1362dc082133533f6e4b42305e22a7b5a32959093a74a753d30b47b6b3cf361cc8fb3438cef81fd

data/lib/build/files.rb

@@ -24,7 +24,4 @@ require_relative 'files/paths'
 require_relative 'files/glob'
 require_relative 'files/directory'
 
-require_relative 'files/state'
-require_relative 'files/monitor'
-
 require_relative 'files/system'

data/lib/build/files/glob.rb

@@ -44,12 +44,15 @@ module Build
 			def full_pattern
 				Path.join(@root, @pattern)
 			end
-		
+			
 			# Enumerate all paths matching the pattern.
 			def each(&block)
-				return to_enum(:each) unless block_given?
+				return to_enum unless block_given?
 				
-				Dir.glob(full_pattern) do |path|
+				::Dir.glob(full_pattern, ::File::FNM_DOTMATCH) do |path|
+					# Ignore `.` and `..` entries.
+					next if path =~ /\/..?$/
+					
 					yield Path.new(path, @root)
 				end
 			end
@@ -57,15 +60,15 @@ module Build
 			def eql?(other)
 				self.class.eql?(other.class) and @root.eql?(other.root) and @pattern.eql?(other.pattern)
 			end
-		
+			
 			def hash
 				[@root, @pattern].hash
 			end
-		
+			
 			def include?(path)
 				File.fnmatch(full_pattern, path)
 			end
-		
+			
 			def rebase(root)
 				self.class.new(root, @pattern)
 			end

data/lib/build/files/list.rb

@@ -55,13 +55,13 @@ module Build
 				other.any?{|path| include?(path)}
 			end
 			
-			def with(**args)
-				return to_enum(:with, **args) unless block_given?
+			def with(**options)
+				return to_enum(:with, **options) unless block_given?
 				
 				paths = []
 				
-				each do |path|
-					updated_path = path.with(args)
+				self.each do |path|
+					updated_path = path.with(**options)
 					
 					yield path, updated_path
 					

data/lib/build/files/path.rb

@@ -22,6 +22,10 @@ module Build
 	module Files
 		# Represents a file path with an absolute root and a relative offset:
 		class Path
+			def self.current
+				self.new(::Dir.pwd)
+			end
+			
 			def self.split(path)
 				# Effectively dirname and basename:
 				dirname, separator, filename = path.rpartition(File::SEPARATOR)
@@ -44,6 +48,14 @@ module Build
 				end
 			end
 			
+			def self.root(path)
+				if Path === path
+					path.root
+				else
+					File.dirname(path)
+				end
+			end
+			
 			# Return the shortest relative path to get to path from root. Root should be a directory with which you are computing the relative path.
 			def self.shortest_path(path, root)
 				path_components = Path.components(path)
@@ -89,9 +101,6 @@ module Build
 					# Effectively dirname and basename:
 					@root, _, @relative_path = full_path.rpartition(File::SEPARATOR)
 				end
-				
-				# This improves the cost of hash/eql? slightly but the root cannot be deconstructed if it was an instance of Path.
-				# @root = @root.to_s
 			end
 			
 			attr :root
@@ -101,6 +110,8 @@ module Build
 				@full_path.length
 			end
 			
+			alias size length
+			
 			def components
 				@components ||= @full_path.split(File::SEPARATOR).freeze
 			end
@@ -109,6 +120,21 @@ module Build
 				self.parts.last
 			end
 			
+			def parent
+				root = @root
+				full_path = File.dirname(@full_path)
+				
+				while root.size > full_path.size
+					root = Path.root(root)
+				end
+				
+				if root.size == full_path.size
+					root = Path.root(root)
+				end
+				
+				self.class.new(full_path, root)
+			end
+			
 			def start_with?(*args)
 				@full_path.start_with?(*args)
 			end
@@ -116,7 +142,7 @@ module Build
 			alias parts components
 			
 			def relative_path
-				@relative_path ||= Path.relative_path(@root.to_s, @full_path).freeze
+				@relative_path ||= Path.relative_path(@root.to_s, @full_path.to_s).freeze
 			end
 			
 			def relative_parts
@@ -176,12 +202,12 @@ module Build
 				self.new(File.join(root, relative_path), root)
 			end
 			
-			# Expand a subpath within a given root, similar to `File.expand_path`
-			def self.expand(subpath, root = Dir.getwd)
-				if subpath.start_with? File::SEPARATOR
-					self.new(subpath)
+			# Expand a path within a given root.
+			def self.expand(path, root = Dir.getwd)
+				if path.start_with?(File::SEPARATOR)
+					self.new(path)
 				else
-					self.join(root, subpath)
+					self.join(root, path)
 				end
 			end
 			
@@ -190,7 +216,7 @@ module Build
 			end
 			
 			def to_str
-				@full_path
+				@full_path.to_str
 			end
 			
 			def to_path
@@ -198,7 +224,8 @@ module Build
 			end
 			
 			def to_s
-				@full_path
+				# It's not guaranteed to be string.
+				@full_path.to_s
 			end
 			
 			def inspect

data/lib/build/files/paths.rb

@@ -69,5 +69,11 @@ module Build
 				self.new(paths, [root])
 			end
 		end
+		
+		class Path
+			def list(*relative_paths)
+				Paths.directory(self, relative_paths)
+			end
+		end
 	end
 end

data/lib/build/files/version.rb

@@ -20,6 +20,6 @@
 
 module Build
 	module Files
-		VERSION = "1.4.3"
+		VERSION = "1.7.1"
 	end
 end

metadata

@@ -1,45 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: build-files
 version: !ruby/object:Gem::Version
-  version: 1.4.3
+  version: 1.7.1
 platform: ruby
 authors:
 - Samuel Williams
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-02-14 00:00:00.000000000 Z
+date: 2021-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rb-inotify
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: rb-fsevent
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: covered
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -53,7 +25,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: covered
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -80,64 +52,29 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.4'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-description: 
+description:
 email:
-- samuel.williams@oriontransfer.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
-- ".travis.yml"
-- Gemfile
-- README.md
-- Rakefile
-- build-files.gemspec
+- lib/.DS_Store
 - lib/build/files.rb
+- lib/build/files/.DS_Store
 - lib/build/files/composite.rb
 - lib/build/files/difference.rb
 - lib/build/files/directory.rb
 - lib/build/files/glob.rb
-- lib/build/files/handle.rb
 - lib/build/files/list.rb
-- lib/build/files/monitor.rb
-- lib/build/files/monitor/fsevent.rb
-- lib/build/files/monitor/inotify.rb
-- lib/build/files/monitor/polling.rb
 - lib/build/files/path.rb
 - lib/build/files/paths.rb
-- lib/build/files/state.rb
 - lib/build/files/system.rb
 - lib/build/files/version.rb
-- spec/build/files/directory_spec.rb
-- spec/build/files/directory_spec/.dot_file.yaml
-- spec/build/files/directory_spec/normal_file.txt
-- spec/build/files/glob_spec.rb
-- spec/build/files/list_spec.rb
-- spec/build/files/monitor_spec.rb
-- spec/build/files/path_spec.rb
-- spec/build/files/state_spec.rb
-- spec/build/files/system_spec.rb
-- spec/spec_helper.rb
-homepage: ''
+homepage:
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -152,19 +89,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
-signing_key: 
+rubygems_version: 3.2.3
+signing_key:
 specification_version: 4
-summary: Build::Files is a set of idiomatic classes for dealing with paths and monitoring
-  directories.
-test_files:
-- spec/build/files/directory_spec.rb
-- spec/build/files/directory_spec/.dot_file.yaml
-- spec/build/files/directory_spec/normal_file.txt
-- spec/build/files/glob_spec.rb
-- spec/build/files/list_spec.rb
-- spec/build/files/monitor_spec.rb
-- spec/build/files/path_spec.rb
-- spec/build/files/state_spec.rb
-- spec/build/files/system_spec.rb
-- spec/spec_helper.rb
+summary: Abstractions for handling and mapping paths.
+test_files: []

data/.rspec

@@ -1,4 +0,0 @@
---format documentation
---backtrace
---warnings
---require spec_helper

data/.travis.yml

@@ -1,14 +0,0 @@
-language: ruby
-dist: xenial
-cache: bundler
-
-matrix:
-  include:
-    - rvm: 2.3
-    - rvm: 2.4
-    - rvm: 2.5
-    - rvm: 2.6
-      env: COVERAGE=BriefSummary,Coveralls
-    - rvm: 2.6
-      os: osx
-      env: COVERAGE=BriefSummary,Coveralls

data/Gemfile

@@ -1,9 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in build-files.gemspec
-gemspec
-
-group :test do
-	gem 'rb-fsevent'
-	gem 'rb-inotify'
-end

data/README.md

@@ -1,69 +0,0 @@
-# Build::Files
-
-Build::Files is a set of idiomatic classes for dealing with paths and monitoring directories. File paths are represented with both root and relative parts which makes copying directory structures intuitive.
-
-[![Build Status](https://secure.travis-ci.org/ioquatix/build-files.svg)](http://travis-ci.org/ioquatix/build-files)
-[![Code Climate](https://codeclimate.com/github/ioquatix/build-files.svg)](https://codeclimate.com/github/ioquatix/build-files)
-[![Coverage Status](https://coveralls.io/repos/ioquatix/build-files/badge.svg)](https://coveralls.io/r/ioquatix/build-files)
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'build-files'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install build-files
-
-## Usage
-
-The basic structure is the `Path`. Paths are stored with a root and relative part. By default, if no root is specified, it is the `dirname` part.
-
-	require 'build/files'
-	
-	path = Build::Files::Path("/foo/bar/baz")
-	=> "/foo/bar"/"baz"
-
-	> path.root
-	=> "/foo/bar"
-	> path.relative_path
-	=> "baz"
-
-Paths can be coerced to strings and thus are suitable arguments to `exec`/`system` functions.
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-## License
-
-Released under the MIT license.
-
-Copyright, 2014, by [Samuel G. D. Williams](http://www.codeotaku.com/samuel-williams).
-
-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.