finder 0.3.0 → 0.4.0

data/{.ruby → .index}

@@ -1,56 +1,57 @@
 ---
-source:
-- ruby.yml
+type: ruby
+revision: 2013
+sources:
+- Index.yml
 authors:
 - name: Trans
   email: transfire@gmail.com
-copyrights:
-- holder: Rubyworks
-  year: '2009'
-  license: BSD-2-Clause
+organizations:
+- name: rubyworks
 requirements:
-- name: detroit
-  groups:
+- groups:
   - build
   development: true
-- name: qed
-  groups:
+  name: detroit
+- groups:
   - test
   development: true
-- name: ae
-  groups:
+  name: qed
+- groups:
   - test
   development: true
-dependencies: []
-alternatives: []
+  name: ae
 conflicts: []
-repositories:
-- uri: git://github.com/rubyworks/plugin.git
-  scm: git
-  name: upstream
+alternatives: []
 resources:
-- uri: http://rubyworks.github.com/finder
-  label: Website
-  type: home
-- uri: http://github.com/rubyworks/finder
+- type: home
+  uri: http://rubyworks.github.com/finder
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/finder
   label: Source Code
-  type: code
-- uri: http://groups.google.com/rubyworks-mailinglist
+- type: mail
+  uri: http://groups.google.com/rubyworks-mailinglist
   label: Mailing List
-  type: mail
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/finder.git
 categories: []
-extra: {}
-load_path:
-- lib
-revision: 0
+paths:
+  load:
+  - lib
+copyrights:
+- holder: Rubyworks
+  year: '2009'
+  license: BSD-2-Clause
 name: finder
 title: Finder
-version: 0.3.0
+version: 0.4.0
 summary: Robust library file locator
 created: '2009-11-24'
 description: Finder is a general purpose file finder for Ruby. Finder can search RubyGems,
   Roll libraries and Ruby's standard $LOAD_PATH and system data directory for the
   active or the most current library files. It is especially useful for implementing
   library-based plugin systems.
-organization: rubyworks
-date: '2012-05-22'
+date: '2012-12-24'

data/HISTORY.md

@@ -1,5 +1,17 @@
 # RELEASE HISTORY
 
+## 0.4.0 / 2012-12-25
+
+New release adds Kernel#import and #import_relative core extensions.
+The methods load code directly into the calling scope, unlike 
+the #require and #load methods which do so at the toplevel.
+
+Changes:
+
+* Add Kernel#import and #import_relative.
+* Add dynamic project metadata lookup.
+
+
 ## 0.3.0 / 2012-05-22
 
 This is a significant release in that the behavior of `Find.load_path` has

data/LICENSE.txt

@@ -1,8 +1,4 @@
-Finder
-
-Copyright (c) 2012 Rubyworks. All rights reserved.
-
-License (spdx) BSD-2-Clause
+BSD-2-Clause License
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:
@@ -25,7 +21,3 @@ 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.
 
------
-* http://rubyworks.github.com/finder
-* http://spdx.com/licenses/BSD-2_clause
-

data/README.md

@@ -1,15 +1,10 @@
-# Finder
-
 [Homepage](http://rubyworks.github.com/finder) /
 [Report Issue](http://github.com/rubyworks/finder/issues) /
-[Development](http://github.com/rubyworks/finder) /
-[Mailing List](http://groups.google.com/groups/rubyworks-mailinglist) /
-[IRC Channel](irc://chat.us.freenode.net/rubyworks)
-
-[![Build Status](https://secure.travis-ci.org/rubyworks/finder.png)](http://travis-ci.org/rubyworks/finder)
+[Source Code](http://github.com/rubyworks/finder)
+( [![Build Status](https://secure.travis-ci.org/rubyworks/finder.png)](http://travis-ci.org/rubyworks/finder) )
 
 
-## DESCRIPTION
+# Finder
 
 Finder is a straight-forward file finder for searching Ruby library paths.
 It can handle RubyGems, Rolls and Ruby's standard site locals. It is both
@@ -17,7 +12,7 @@ more flexible and more robust the using Gem.find_files or searching the
 $LOAD_PATH manually.
 
 
-## INSTRUCTION
+## Instructions
 
 To find paths, simply provide a glob to the appropriate Finder function,
 and it will return all matches found within current or most recent
@@ -41,12 +36,33 @@ This is basically equivalent to:
 Alternately you might load files only as needed. For instance, if a
 command-line option calls for it.
 
+In addition Finder has two optional Kernel extensions: `#import`
+and `#import_relative`. These methods can be used like `#require`
+and `#require_relative`, but load code directory into the 
+current scope instead of the toplevel.
 
-## COPYRIGHTS
+    require 'finder/import'
 
-Copyright (c) 2009 Rubyworks
+    module My
+      import('abbrev.rb')
+    emd
 
-Finder is release under the terms of the **BSD-2-Clause** license.
+    My::Abbrev::abbrev(['ruby'])
+    => {"rub"=>"ruby", "ru"=>"ruby", "r"=>"ruby", "ruby"=>"ruby"}
+
+It is important to be careful when using `#import` to make sure loaded
+scripts behave as intended. For example, if `abbrev.rb`  were to define
+itself using `::` toplevel namespace indicators, i.e. `::Abbrev`, then
+the above import would not work as demonstrated.
 
-See LICENSE.txt file for details.
 
+## Copyrights
+
+Finder is copyrighted opensource software.
+
+    Copyright (c) 2009 Rubyworks
+
+It can be modified and redistributed in accordance with the terms of
+the **BSD-2-Clause** license.
+
+See LICENSE.txt file for details.

data/lib/finder.rb

@@ -1,9 +1,35 @@
+# Finder (http://rubyworks.github.com/finder)
+#
+# (c) 2012 Rubyworks
+#
+# 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.
+#
+# THIS SOFTWARE IS PROVIDED ``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 HOLDERS 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.
+
+require 'finder/index'
 require 'finder/find'
 
-module Finder
+# TODO: Import is optional for the time bing.
+#require 'finder/import'
 
-  # Current version.
-  VERSION = '0.2.0'
+module Finder
 
   # Clean module that can be included elsewhere, to proved #path, #load_path
   # and #data_path methods without including the Gem, Roll, and Site constants.

data/lib/finder.yml

@@ -0,0 +1,57 @@
+---
+type: ruby
+revision: 2013
+sources:
+- Index.yml
+authors:
+- name: Trans
+  email: transfire@gmail.com
+organizations:
+- name: rubyworks
+requirements:
+- groups:
+  - build
+  development: true
+  name: detroit
+- groups:
+  - test
+  development: true
+  name: qed
+- groups:
+  - test
+  development: true
+  name: ae
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/finder
+  label: Homepage
+- type: code
+  uri: http://github.com/rubyworks/finder
+  label: Source Code
+- type: mail
+  uri: http://groups.google.com/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/finder.git
+categories: []
+paths:
+  load:
+  - lib
+copyrights:
+- holder: Rubyworks
+  year: '2009'
+  license: BSD-2-Clause
+name: finder
+title: Finder
+version: 0.4.0
+summary: Robust library file locator
+created: '2009-11-24'
+description: Finder is a general purpose file finder for Ruby. Finder can search RubyGems,
+  Roll libraries and Ruby's standard $LOAD_PATH and system data directory for the
+  active or the most current library files. It is especially useful for implementing
+  library-based plugin systems.
+date: '2012-12-24'

data/lib/finder/import.rb

@@ -0,0 +1,35 @@
+module Kernel
+
+  private
+
+  #
+  # Evaluate script directly into current scope.
+  #
+  def import(feature)
+    file = Find.feature(feature, :absolute=>true).first
+    raise LoadError, "no such file -- #{feature}" unless file
+    instance_eval(::File.read(file), file) if file
+  end
+
+  #
+  # Evaluate script directly into current scope relative to
+  # the current script.
+  #
+  # Note this is implemented via #caller.first.
+  #
+  def import_relative(fname)
+    call = caller.first
+    fail "Can't parse #{call}" unless call.rindex(/:\d+(:in `.*')?$/)
+    path = $` # File.dirname(call)
+    if /\A\((.*)\)/ =~ path # eval, etc.
+      raise LoadError, "import_relative is called in #{$1}"
+    end
+    file = File.expand_path(fname, File.dirname(path))
+
+    raise LoadError, "no such file -- #{file}" unless File.file?(file)
+
+    instance_eval(::File.read(file), file) #if file
+  end
+
+end
+

data/lib/finder/index.rb

@@ -0,0 +1,24 @@
+module Finder
+
+  #
+  # Cached access to project metadata.
+  #
+  def index
+    @index ||=(
+      require 'yaml'
+      file = File.expand_path('../finder.yml', File.dirname(__FILE__))
+      YAML.load_file(file)
+    )
+  end
+
+  #
+  # Access to project metadata via constants.
+  #
+  # @example
+  #   Finder::VERSION  #=> '0.2.0'
+  #
+  def const_missing(name)
+    index[name.to_s.downcase] || super(name)
+  end
+
+end

data/lib/finder/roll.rb

@@ -36,7 +36,7 @@ module Finder
             end
             lib = lib.sort.first
           else
-            next unless criteria.all?{ |c| l.version.satisfy?(c) }
+            next unless criteria.all?{ |c| lib.version.satisfy?(c) }
           end
           find = File.join(lib.location, match)
           list = Dir.glob(find)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: finder
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-05-23 00:00:00.000000000 Z
+date: 2012-12-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: detroit
-  requirement: &28070020 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *28070020
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: qed
-  requirement: &28069460 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +37,15 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *28069460
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: ae
-  requirement: &28068940 !ruby/object:Gem::Requirement
+  requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,7 +53,12 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *28068940
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Finder is a general purpose file finder for Ruby. Finder can search RubyGems,
   Roll libraries and Ruby's standard $LOAD_PATH and system data directory for the
   active or the most current library files. It is especially useful for implementing
@@ -57,7 +72,7 @@ extra_rdoc_files:
 - HISTORY.md
 - README.md
 files:
-- .ruby
+- .index
 - .yardopts
 - demo/00_intro.md
 - demo/01_load_path.md
@@ -68,12 +83,15 @@ files:
 - lib/finder/base.rb
 - lib/finder/find.rb
 - lib/finder/gem.rb
+- lib/finder/import.rb
+- lib/finder/index.rb
 - lib/finder/roll.rb
 - lib/finder/site.rb
 - lib/finder.rb
-- LICENSE.txt
+- lib/finder.yml
 - HISTORY.md
 - README.md
+- LICENSE.txt
 homepage: http://rubyworks.github.com/finder
 licenses:
 - BSD-2-Clause
@@ -95,7 +113,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.11
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Robust library file locator