osgi 0.0.1

data/spec/osgi/execution_environment_spec.rb

@@ -0,0 +1,48 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+require File.join(File.dirname(__FILE__), '../spec_helpers')
+
+describe OSGi::ExecutionEnvironment do
+  
+  it 'should create a frozen object' do
+    ee = OSGi::ExecutionEnvironment.new("example", "hello", ["com", "org"])
+    ee.should be_frozen
+    ee.packages.should be_frozen
+  end
+end
+
+describe OSGi::ExecutionEnvironmentConfiguration do 
+  
+  before :all do
+    @conf = OSGi::ExecutionEnvironmentConfiguration.new
+  end
+    
+  
+  it "should add the default execution environments" do
+    @conf.send( :available_ee).values.should include OSGi::NONE, OSGi::CDC10FOUNDATION10, OSGi::CDC10FOUNDATION11, OSGi::J2SE12, OSGi::J2SE13, OSGi::J2SE14, OSGi::J2SE15, OSGi::JAVASE16, OSGi::JAVASE17, OSGi::OSGIMINIMUM10, OSGi::OSGIMINIMUM11, OSGi::OSGIMINIMUM12
+  end
+  
+  it "should set JavaSE1.6 as the default execution environment" do
+    @conf.current_execution_environment.should == OSGi::JAVASE16
+  end
+  
+  it "should let the user define extra packages to be part of the execution environment" do
+    @conf.extra_packages << "com.sum.nedia"
+    @conf.extra_packages.should include("com.sum.nedia")
+  end
+end
+     
+  

data/spec/osgi/registry_spec.rb

@@ -0,0 +1,84 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+require File.join(File.dirname(__FILE__), '../spec_helpers')
+
+
+Spec::Runner.configure do |config|
+  config.include SpecHelpers
+end
+
+describe OSGi::Registry do
+  
+  it 'should be possible to set the containers from the OSGi environment variables' do
+    ENV['OSGi'] = "foo;bar"
+    OSGi.registry.containers.should == ["foo","bar"]
+  end
+  
+  it 'should fall back on OSGI if the constant OSGi is not defined, issuing a warning' do
+    ENV['OSGi'] = nil
+    ENV['OSGI'] = "foo;bar"
+    lambda {OSGi.registry.resolved_containers}.should show_warning "The correct constant to define for the OSGi containers is named OSGi"
+    ENV['OSGi'].should == ENV['OSGI']
+  end
+  
+  it 'should not complain if OSGI is set and OSGi is also set' do
+    ENV['OSGI'] = nil
+    lambda {OSGi.registry.resolved_containers}.should_not show_warning "The correct constant to define for the OSGi containers is named OSGi"
+  end
+  
+  it 'should be possible to modify the containers in the registry before the resolved_containers method is called' do
+    lambda {OSGi.registry.containers << "hello"}.should_not raise_error
+    lambda {OSGi.registry.containers = ["hello"]}.should_not raise_error
+  end
+  
+  it 'should throw an exception when modifying the containers in the registry after the resolved_containers method is called' do
+    OSGi.registry.resolved_containers
+    lambda {OSGi.registry.containers << "hello"}.should raise_error(TypeError)
+    lambda {OSGi.registry.containers = ["hello"]}.should raise_error(RuntimeError, /Cannot set containers, containers have been resolved already/)
+  end
+end
+
+
+describe OSGi do
+  
+  it 'should give a handle over the OSGi containers registry' do
+    OSGi.registry.should be_instance_of(::OSGi::Registry)
+  end
+  
+  it 'should help determine whether a package is part of the framework given by the execution environment' do
+    OSGi.is_framework_package?("com.mypackage").should be_false
+    OSGi.is_framework_package?(OSGi::JAVASE16.packages.first).should be_true
+  end
+  
+end
+
+describe OSGi::GroupMatcher do
+  
+  it 'should use osgi as the default group for an artifact' do
+    OSGi::GroupMatcher.instance.group("hello").should == "osgi"
+  end
+
+  it 'should use org.eclipse  as the default group for Eclipse artifacts' do
+    OSGi::GroupMatcher.instance.group("org.eclipse.core.resources").should == "org.eclipse"
+  end  
+  
+  it 'should let users specify their own groups' do
+    OSGi::GroupMatcher.instance.group_matchers << Proc.new {|name| "bar" if name.match /foo$/}
+    OSGi::GroupMatcher.instance.group("org.eclipse.core.resources").should == "org.eclipse"
+    OSGi::GroupMatcher.instance.group("hello").should == "osgi"
+    OSGi::GroupMatcher.instance.group("org.eclipse.core.foo").should == "bar" 
+  end
+end

data/spec/osgi/resolving_strategies_spec.rb

@@ -0,0 +1,116 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+require File.join(File.dirname(__FILE__), '../spec_helpers')
+
+describe OSGi::BundleResolvingStrategies do
+  
+  before(:all) do
+    @bundles = [OSGi::Bundle.new("art", "1.0"), OSGi::Bundle.new("art", "2.0"), 
+      OSGi::Bundle.new("art", "2.0.1"), OSGi::Bundle.new("art", "3.0")]
+    
+  end
+  
+  it 'should use latest by default to resolve bundle dependencies' do
+    OSGi.options.bundle_resolving_strategy.should eql(:latest)
+  end
+  
+  describe 'latest' do
+    
+    it 'should return the bundle with the latest version' do
+      OSGi::BundleResolvingStrategies.latest(@bundles).should == @bundles.last
+    end
+    
+  end
+  
+  describe 'oldest' do
+    
+    it 'should return the bundle with the oldest version' do
+      OSGi::BundleResolvingStrategies.oldest(@bundles).should == @bundles.first
+    end
+    
+  end
+  
+  describe 'prompt' do
+    
+    it 'should prompt the user to choose a bundle' do
+      input = $stdin
+      $stdin = StringIO.new
+      $stdin.should_receive(:gets).and_return("i\n")
+      $stdin.should_receive(:gets).and_return("256\n")
+      $stdin.should_receive(:gets).and_return("2\n")
+      lambda { 
+        OSGi::BundleResolvingStrategies.prompt(@bundles).should == @bundles[1]
+      }.should show("Invalid index")
+      $stdin = input
+    end
+    
+  end
+  
+end
+
+describe OSGi::PackageResolvingStrategies do
+  
+  before(:all) do
+    @bundles = [OSGi::Bundle.new("art", "1.0"), OSGi::Bundle.new("art", "2.0"), 
+      OSGi::Bundle.new("art", "2.0.1"), OSGi::Bundle.new("art", "3.0")]
+    
+  end
+  
+  it 'should use all by default to resolve package dependencies' do
+    OSGi.options.package_resolving_strategy.should eql(:all)
+  end
+  
+  describe 'all' do
+    
+    it 'should take all the bundles' do
+      OSGi::PackageResolvingStrategies.all(::OSGi::BundlePackage.new("com.package", "1.0"), @bundles).should == @bundles
+    end
+    
+  end
+  
+  describe 'prompt' do
+    
+    it 'should prompt the user to choose a bundle' do
+      input = $stdin
+      $stdin = StringIO.new
+      $stdin.should_receive(:gets).and_return("2\n")
+      OSGi::PackageResolvingStrategies.prompt(::OSGi::BundlePackage.new("com.package", "1.0"), @bundles).should == [@bundles[1]]
+      $stdin = input
+    end
+    
+    it 'should complain if the user enters an invalid index' do
+      input = $stdin
+      $stdin = StringIO.new
+      $stdin.should_receive(:gets).and_return("i\n")
+      $stdin.should_receive(:gets).and_return("256\n")
+      $stdin.should_receive(:gets).and_return("2\n")
+      lambda { 
+        OSGi::PackageResolvingStrategies.prompt(::OSGi::BundlePackage.new("com.package", "1.0"), @bundles).should == [@bundles[1]]
+      }.should show("Invalid index")
+      $stdin = input
+    end
+    
+    it 'should let the user select all bundles' do
+      input = $stdin
+      $stdin = StringIO.new
+      $stdin.should_receive(:gets).and_return("A\n")
+      OSGi::PackageResolvingStrategies.prompt(::OSGi::BundlePackage.new("com.package", "1.0"), @bundles).should == @bundles
+      $stdin = input
+    end
+    
+  end
+  
+end

data/spec/osgi/version_spec.rb

@@ -0,0 +1,133 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+require File.join(File.dirname(__FILE__), '../spec_helpers')
+
+describe OSGi::Version do
+  it 'should initialize itself from a string' do
+    version = OSGi::Version.new("1.0.0.qualifier")
+    version.major.should eql("1")
+    version.minor.should eql("0")
+    version.tiny.should eql("0")
+    version.qualifier.should eql("qualifier")
+  end  
+  
+  it 'should accept versions without a qualifier' do
+    version = OSGi::Version.new("1.0.0")
+    version.major.should eql("1")
+    version.minor.should eql("0")
+    version.tiny.should eql("0")
+    version.qualifier.should be_nil
+  end
+  
+  it 'should accept versions without a qualifier and a tiny digit' do
+    version = OSGi::Version.new("1.0")
+    version.major.should eql("1")
+    version.minor.should eql("0")
+    version.tiny.should be_nil
+    version.qualifier.should be_nil
+  end
+  
+  it 'should accept versions without a qualifier, a minor and a tiny digit' do
+    version = OSGi::Version.new("1")
+    version.major.should eql("1")
+    version.minor.should be_nil
+    version.tiny.should be_nil
+    version.qualifier.should be_nil
+  end
+  
+  it 'should raise an exception if no major digit is given' do
+    lambda { OSGi::Version.new(".0.0.qualifier") }.should raise_error(RuntimeError, /Invalid version:/)
+  end
+  
+  it 'should raise an exception if no minor digit is given' do
+    lambda { OSGi::Version.new("1..0.qualifier") }.should raise_error(RuntimeError, /Invalid version:/)
+  end
+  
+  it 'should raise an exception if no tiny digit is given' do
+    lambda { OSGi::Version.new("1.0..qualifier") }.should raise_error(RuntimeError, /Invalid version:/)
+  end
+  
+  it 'should have a string representation' do
+    version = OSGi::Version.new("1.0.0.qualifier")
+    version.to_s.should eql("1.0.0.qualifier")
+    version.major = 2
+    version.to_s.should eql("2.0.0.qualifier")
+  end
+  
+  it 'should compare with other versions' do
+    (OSGi::Version.new('1.0.0') < "2.0.0").should be_true
+    (OSGi::Version.new('1.9.9') > "2.0.0").should be_false
+    (OSGi::Version.new('1.54.112') < "2.2.0").should be_true
+    (OSGi::Version.new('1.0.3') > "1.0.2").should be_true
+    (OSGi::Version.new('2.3.4') == "2.3.4").should be_true
+    (OSGi::Version.new('2.3.4') <=> "2.3.4").should eql(0)
+  end
+  
+  it 'should compare with nil' do
+    (OSGi::Version.new('1.0.0') <=> nil).should eql(1)
+  end
+  
+  it 'should find if two versions are equal' do
+    (OSGi::Version.new('1.0.0.001-March') <=> "1.0.0.001-March").should == 0
+  end
+  
+  it "should consider a version with no qualifier equals the same version with a qualifier" do
+    (OSGi::Version.new('2.5.0') == "2.5.0.v200806031605").should be_true
+    (OSGi::Version.new('2.5.0.v200806031605') == "2.5.0").should be_true
+  end
+end
+
+describe OSGi::VersionRange do
+  
+  it 'should be able to parse version ranges' do
+    OSGi::VersionRange.parse("[1.0.0,2.0.0)").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("[1.0.0,2.0.0]").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("(1.0.0,2.0.0)").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("(1.0.0,2.0.0]").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("[1.0.02.0.0)").should be_false
+    OSGi::VersionRange.parse("[1.0.0,2.0.0").should be_false
+    OSGi::VersionRange.parse("1.0.0,2.0.0)").should be_false
+    OSGi::VersionRange.parse("[1.0,0,2.0.0)").should be_false
+  end
+  
+  it 'should be able to tell if a version is in a range' do
+    range = OSGi::VersionRange.parse("[1.0.0,2.0.0)")
+    range.in_range("1.5.0.20080607").should be_true
+    range.in_range("2.0.0.20080607").should be_false
+    range.in_range("1.0.0.20080607").should be_true
+    range.in_range("0.9.0.20080607").should be_false
+    range = OSGi::VersionRange.parse("(1.0.0,2.0.0]")
+    range.in_range("2.0.0.20080607").should be_true
+    range.in_range("1.0.0.20080607").should be_false
+  end
+  
+  it 'should have a String representation' do
+    range = OSGi::VersionRange.parse("[1.0.0,2.0.0)")
+    range.to_s.should eql("[1.0.0,2.0.0)")
+    r2 = OSGi::VersionRange.new
+    r2.min = OSGi::Version.new("1.0.0")
+    r2.max = OSGi::Version.new("2.0.0")
+    r2.min_inclusive = true
+    r2.to_s.should eql("[1.0.0,2.0.0)")
+  end
+  
+  it 'should be able to consume a range with a space before or after the two limits' do
+    OSGi::VersionRange.parse("[1.0.0, 2.0.0)").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("[1.0.0 , 2.0.0)").should be_instance_of(OSGi::VersionRange)
+    OSGi::VersionRange.parse("[1.0.0 ,2.0.0)").should be_instance_of(OSGi::VersionRange)
+  end
+  
+end

data/spec/spec_helpers.rb

@@ -0,0 +1,131 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
+# License for the specific language governing permissions and limitations under
+# the License.
+
+unless defined?(SpecHelpers)
+  
+  # For testing we use the gem requirements specified on the buildr4osgi.gemspec
+  spec = Gem::Specification.load(File.expand_path('../osgi.gemspec', File.dirname(__FILE__)))
+  spec.dependencies.each { |dep| gem dep.name, dep.version_requirements.to_s }
+  # Make sure to load from these paths first, we don't want to load any
+  # code from Gem library.
+  $LOAD_PATH.unshift File.expand_path('../lib', File.dirname(__FILE__))
+  require 'osgi'
+  
+  [:info, :warn, :error, :puts].each do |severity|
+    ::Object.class_eval do
+      define_method severity do |*args|
+        $messages ||= {}
+        $messages[severity] ||= []
+        $messages[severity].push(*args)
+      end
+    end
+  end
+  
+  class MessageWithSeverityMatcher
+    def initialize(severity, message)
+      @severity = severity
+      @expect = message
+    end
+
+    def matches?(target)
+      $messages = {@severity => []}
+      target.call
+      return Regexp === @expect ? $messages[@severity].join('\n') =~ @expect : $messages[@severity].include?(@expect.to_s)
+    end
+
+    def failure_message
+      "Expected #{@severity} #{@expect.inspect}, " +
+        ($messages[@severity].empty? ? "no #{@severity} issued" : "found #{$messages[@severity].inspect}")
+    end
+
+    def negative_failure_message
+      "Found unexpected #{$messages[@severity].inspect}"
+    end
+  end
+
+  # Test if an info message was shown.  You can use a string or regular expression.
+  #
+  # For example:
+  #   lambda { info 'ze test' }.should show_info(/ze test/)
+  def show_info(message)
+    MessageWithSeverityMatcher.new :info, message
+  end
+
+  # Test if a warning was shown. You can use a string or regular expression.
+  #
+  # For example:
+  #   lambda { warn 'ze test' }.should show_warning(/ze test/)
+  def show_warning(message)
+    MessageWithSeverityMatcher.new :warn, message
+  end
+
+  # Test if an error message was shown.  You can use a string or regular expression.
+  #
+  # For example:
+  #   lambda { error 'ze test' }.should show_error(/ze test/)
+  def show_error(message)
+    MessageWithSeverityMatcher.new :error, message
+  end
+
+  # Test if any message was shown (puts).  You can use a string or regular expression.
+  #
+  # For example:
+  #   lambda { puts 'ze test' }.should show(/ze test/)
+  def show(message)
+    MessageWithSeverityMatcher.new :puts, message
+  end
+  
+  # Writes contents in file
+  def write(file, contents)
+    FileUtils.mkpath File.dirname(file)
+    File.open(file.to_s, 'wb') { |file| file.write contents.to_s }
+  end
+  
+  OSGi_REPOS = File.expand_path File.join(File.dirname(__FILE__), "..", "tmp", "osgi")
+
+  module MockInstanceWriter
+    def registry=(i)
+      @registry=i
+    end
+  end
+  
+  module SpecHelpers
+    
+    class << self
+  
+      def included(config)
+        config.before(:all) {
+          OSGi.extend MockInstanceWriter
+        }
+      
+        config.before(:each) {
+          OSGi.registry = OSGi::Registry.new
+        }
+        config.after(:all) {
+          FileUtils.rm_rf OSGi_REPOS        
+        }
+    end
+    
+  end
+  
+  end
+    
+  def createRepository(name)
+    repo = File.join(OSGi_REPOS, name)
+    FileUtils.mkpath repo
+    return repo
+  end
+
+end