jenkins-plugin-runtime 0.1.5 → 0.1.6

data/lib/jenkins/plugin/runtime/version.rb

@@ -1,7 +1,7 @@
 module Jenkins
   class Plugin
     module Runtime
-      VERSION = "0.1.5"
+      VERSION = "0.1.6"
     end
   end
 end

data/lib/jenkins/plugin/specification.rb

@@ -39,11 +39,37 @@ module Jenkins
         end
       end
 
+      # Evaluates `path` as ruby code, expecting it to contain an instance
+      # of `Jenkins::Plugin::Specification`.
+      #
+      # @return [Jenkins::Plugin::Specification] the loaded specification
       def self.load(path)
         eval(File.read(path), binding, path, 1)
       end
+
+      # Looks inside `dir` for a file ending in .pluginspec, and if found,
+      # loads it.
+      #
+      # @return [Jenkins::Plugin::Specification] the loaded specification object, nil otherwise
+      def self.find(dir = Dir.pwd)
+        dir = Pathname(dir)
+        if spec_path = Pathname(dir).entries.find {|e| e.to_s =~ /\.pluginspec$/}
+          load(dir.join(spec_path))
+        end
+      rescue Errno::ENOENT => e
+        fail SpecificationNotFound, "#{dir} does not appear to be a directory"
+      end
+
+      # Attempts to `#find` a plugin spec in `dir` and raises an exception if unsuccessful
+      #
+      # @param [String] path in which to look
+      # @return [Jenkins::Plugin::Specification] the found specifiaction object
+      def self.find!(dir = Dir.pwd)
+        find(dir) or fail SpecificationNotFound, "no plugin specification found in #{dir}"
+      end
     end
 
     SpecificationError = Class.new(StandardError)
+    SpecificationNotFound = Class.new(SpecificationError)
   end
 end

data/spec/jenkins/plugin/specification_spec.rb

@@ -1,6 +1,7 @@
 require 'spec_helper'
 
 describe Jenkins::Plugin::Specification do
+  Specification = Jenkins::Plugin::Specification
   it "is invalid by default" do
     expect {subject.validate!}.should raise_error Jenkins::Plugin::SpecificationError
   end
@@ -19,10 +20,19 @@ describe Jenkins::Plugin::Specification do
   end
 
   describe "a spec loaded from a file" do
-    subject {Jenkins::Plugin::Specification.load(Pathname(__FILE__).dirname.join('example.pluginspec'))}
+    subject {Specification.load(Pathname(__FILE__).dirname.join('example.pluginspec'))}
     its(:name) {should eql "the-name"}
     its(:version) {should eql "1.0.0"}
     its(:description) {should eql "one great plugin"}
     its(:dependencies) {should be_empty}
   end
+
+  describe "find!" do
+    it "looks for a .pluginspec in the current directory and loads it" do
+      Specification.find!(Pathname(__FILE__).dirname.to_s).name.should eql "the-name"
+    end
+    it "raises an exception if one cannot be found" do
+      expect {Specification.find!('..')}.should raise_error Jenkins::Plugin::SpecificationNotFound
+    end
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: jenkins-plugin-runtime
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.5
+  version: 0.1.6
 platform: ruby
 authors: 
   - Charles Lowell
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-09-16 00:00:00 -05:00
+date: 2011-09-19 00:00:00 -05:00
 default_executable: 
 dependencies: 
   - !ruby/object:Gem::Dependency