parent_paths 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1a4a0e640330c967e7be13321bc60e72d75b7747
+  data.tar.gz: 89a646b1e73688a5e3498f8a0fb14dd43cbaa8e6
+SHA512:
+  metadata.gz: 95498e8bc02b836ee619c1234209eefac3fd999afbc75ec4a1248b59a92b9a4f57dd27de8e0676b37b3d22c315c2949e183f75ee4af52cfbf25c03e82bafee70
+  data.tar.gz: 4d9555c784b51b788978ed2f38fbd3031fe9fa66f1b958e47a8fbe1d50d40fc1612d4acc9d3595d98e9de6b6fbc0420369b98eca4b293fd6dcf177bee0100b86

data/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Jeff Lee
+
+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.

data/README.md

@@ -0,0 +1,37 @@
+# parent_paths
+
+Handy methods for scanning parent paths.
+
+## Installation
+
+Include `parent_paths` in your Gemfile, or call `gem install parent_paths`.
+
+## `ParentPaths` module
+
+### scan(start = nil, &criteria)
+
+From the given starting path, scan upward through the file hierachy until a particular criteria is met. The criteria is determined by a block that receives the path of the next directory in the hierarchy.
+
+If a starting path is not provided, it is assumed to be the path of the file that calls this method.
+
+```
+# Find the first ancestor directory of the current file to contain more than 5
+# files
+ParentPaths.scan do |path|
+  Dir.glob(path + '*').size > 5
+end
+```
+
+### scan_for_owner(filename, start = nil)
+
+From the given starting path, scan upward through the file hierachy until a particular filename is discovered.
+
+If a starting path is not provided, it is assumed to be the path of the file that calls this method.
+
+```
+# Find the first ancestor directory of the current file that contains a
+# particular filename.
+ParentPaths.scan_for_owner('Gemfile')
+```
+
+

data/lib/parent_paths/version.rb

@@ -0,0 +1,3 @@
+module ParentPaths
+  VERSION = '0.0.1'
+end

data/lib/parent_paths.rb

@@ -0,0 +1,46 @@
+require 'pathname'
+
+module ParentPaths
+
+  # From the given starting path, scan upward through the file hierachy until
+  # a particular criteria is met. The criteria is determined by a block that
+  # receives the path of the next directory in the hierarchy.
+  #
+  # If a starting path is not provided, it is assumed to be the path of the
+  # file that calls this method.
+  def self.scan(start = nil, &criteria)
+    start ||= caller_path
+    start = Pathname.new(start)
+    if criteria.call(start)
+      return start
+    else
+      parent = start.parent
+      if start == parent
+        nil
+      else
+        scan parent, &criteria
+      end
+    end
+  end
+
+  # From the given starting path, scan upward through the file hierachy until
+  # a particular filename is discovered.
+  #
+  # If a starting path is not provided, it is assumed to be the path of the
+  # file that calls this method.
+  def self.scan_for_owner(filename, start = nil)
+    start ||= caller_path
+    scan(start) { |pathname| File.exist?(pathname + filename) }
+  end
+
+  private
+
+  # Returns the path of the file that calls the method that calls caller_path.
+  # For example if, foo.rb#foo calls caller_path, calling foo.rb#foo will return
+  # the current file.
+  def self.caller_path
+    matches = caller(2).first.match(/(.*):\d+:in `/)
+    Pathname.new(File.expand_path(matches[1]))
+  end
+
+end

data/parent_paths.gemspec

@@ -0,0 +1,19 @@
+# encoding: utf-8
+$:.unshift File.expand_path("../lib", __FILE__)
+require 'parent_paths/version'
+
+Gem::Specification.new do |s|
+  s.name = 'parent_paths'
+  s.licenses = ['MIT']
+  s.summary = "Handy methods for scanning parent paths"
+  s.version = ParentPaths::VERSION
+  s.homepage = 'https://github.com/jeffomatic/parent_paths'
+
+  s.authors = ["Jeff Lee"]
+  s.email = 'jeffomatic@gmail.com'
+
+  s.files = %w( README.md LICENSE parent_paths.gemspec )
+  s.files += Dir.glob('lib/**/*')
+
+  s.add_development_dependency('rspec', '~>2.14.1')
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: parent_paths
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Jeff Lee
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  type: :development
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+description: 
+email: jeffomatic@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE
+- parent_paths.gemspec
+- lib/parent_paths/version.rb
+- lib/parent_paths.rb
+homepage: https://github.com/jeffomatic/parent_paths
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.11
+signing_key: 
+specification_version: 4
+summary: Handy methods for scanning parent paths
+test_files: []