pompompom 1.0.0

data/lib/pompompom/url_builder.rb

@@ -0,0 +1,37 @@
+module PomPomPom
+  module UrlBuilder
+    def jar_url(repository_url)
+      file_url(repository_url, 'jar')
+    end
+    
+    def pom_url(repository_url)
+      file_url(repository_url, 'pom')
+    end
+    
+    def file_url(repository_url, type)
+      file_name = "#{artifact_id}-#{version}.#{type}"
+      "#{append_slash(repository_url)}#{group_path}/#{artifact_id}/#{version}/#{file_name}"
+    end
+    
+    def jar_file_name
+      "#{artifact_id}-#{version}.jar"
+    end
+    
+    def metadata_url(repository_url)
+      "#{append_slash(repository_url)}#{group_path}/#{artifact_id}/maven-metadata.xml"
+    end
+    
+    def append_slash(repository_url)
+      if repository_url[-1,1] == '/'
+        repository_url
+      else
+        repository_url + '/' 
+      end
+    end
+    
+    def group_path
+      group_id.split('.').join('/')
+    end
+  end
+end
+    

data/lib/pompompom.rb

@@ -0,0 +1,10 @@
+require 'pompompom/url_builder'
+require 'pompompom/metadata'
+require 'pompompom/dependency'
+require 'pompompom/pom'
+require 'pompompom/downloader'
+require 'pompompom/resolver'
+
+module PomPomPom
+  VERSION = '1.0.0'
+end

data/pompompom.gemspec

@@ -0,0 +1,116 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{pompompom}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Theo Hultberg"]
+  s.date = %q{2010-07-08}
+  s.default_executable = %q{pompompom}
+  s.description = %q{Ruby dependency manager for Maven repository artifacts}
+  s.email = %q{theo@iconara.net}
+  s.executables = ["pompompom"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.mdown",
+     "TODO"
+  ]
+  s.files = [
+    ".gitignore",
+     "Gemfile",
+     "LICENSE",
+     "README.mdown",
+     "Rakefile",
+     "bin/pompompom",
+     "lib/pom_pom_pom.rb",
+     "lib/pompompom.rb",
+     "lib/pompompom/cli.rb",
+     "lib/pompompom/dependency.rb",
+     "lib/pompompom/downloader.rb",
+     "lib/pompompom/metadata.rb",
+     "lib/pompompom/pom.rb",
+     "lib/pompompom/resolver.rb",
+     "lib/pompompom/url_builder.rb",
+     "pompompom.gemspec",
+     "spec/pompompom/cli_spec.rb",
+     "spec/pompompom/dependency_spec.rb",
+     "spec/pompompom/metadata_spec.rb",
+     "spec/pompompom/pom_spec.rb",
+     "spec/pompompom/resolver_spec.rb",
+     "spec/pompompom/url_builders_shared.rb",
+     "spec/resources/repository/aopalliance/aopalliance/1.0/aopalliance-1.0.jar",
+     "spec/resources/repository/aopalliance/aopalliance/1.0/aopalliance-1.0.pom",
+     "spec/resources/repository/aopalliance/aopalliance/maven-metadata.xml",
+     "spec/resources/repository/com/example/test-abc/1.0/test-abc-1.0.jar",
+     "spec/resources/repository/com/example/test-abc/1.0/test-abc-1.0.pom",
+     "spec/resources/repository/com/example/test-abc/maven-metadata.xml",
+     "spec/resources/repository/com/example/test-child/1.0/test-child-1.0.pom",
+     "spec/resources/repository/com/example/test-def/1.0/test-def-1.0.jar",
+     "spec/resources/repository/com/example/test-def/1.0/test-def-1.0.pom",
+     "spec/resources/repository/com/example/test-exclusions/1.0/test-exclusions-1.0.jar",
+     "spec/resources/repository/com/example/test-exclusions/1.0/test-exclusions-1.0.pom",
+     "spec/resources/repository/com/example/test-optional/1.0/test-optional-1.0.jar",
+     "spec/resources/repository/com/example/test-optional/1.0/test-optional-1.0.pom",
+     "spec/resources/repository/com/example/test-parent/1.0/test-parent-1.0.pom",
+     "spec/resources/repository/com/example/test/8.8/test-8.8.jar",
+     "spec/resources/repository/com/example/test/8.8/test-8.8.pom",
+     "spec/resources/repository/com/example/test/9.9/test-9.9.jar",
+     "spec/resources/repository/com/example/test/9.9/test-9.9.pom",
+     "spec/resources/repository/com/example/test/maven-metadata.xml",
+     "spec/resources/repository/com/google/google/1/google-1.pom",
+     "spec/resources/repository/com/google/inject/guice-parent/2.0/guice-parent-2.0.pom",
+     "spec/resources/repository/com/google/inject/guice/2.0/guice-2.0.jar",
+     "spec/resources/repository/com/google/inject/guice/2.0/guice-2.0.pom",
+     "spec/resources/repository/com/rabbitmq/amqp-client/1.8.0/amqp-client-1.8.0.jar",
+     "spec/resources/repository/com/rabbitmq/amqp-client/1.8.0/amqp-client-1.8.0.pom",
+     "spec/resources/repository/commons-cli/commons-cli/1.1/commons-cli-1.1.jar",
+     "spec/resources/repository/commons-cli/commons-cli/1.1/commons-cli-1.1.pom",
+     "spec/resources/repository/commons-io/commons-io/1.2/commons-io-1.2.jar",
+     "spec/resources/repository/commons-io/commons-io/1.2/commons-io-1.2.pom",
+     "spec/resources/repository/javax/servlet/servlet-api/2.5/servlet-api-2.5.jar",
+     "spec/resources/repository/javax/servlet/servlet-api/2.5/servlet-api-2.5.pom",
+     "spec/resources/repository/net/iconara/pompompom/1.0/pompompom-1.0.jar",
+     "spec/resources/repository/net/iconara/pompompom/1.0/pompompom-1.0.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-continuation/7.1.4.v20100610/jetty-continuation-7.1.4.v20100610.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-http/7.1.4.v20100610/jetty-http-7.1.4.v20100610.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-io/7.1.4.v20100610/jetty-io-7.1.4.v20100610.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-parent/15/jetty-parent-15.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-project/7.1.4.v20100610/jetty-project-7.1.4.v20100610.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-server/7.1.4.v20100610/jetty-server-7.1.4.v20100610.jar",
+     "spec/resources/repository/org/eclipse/jetty/jetty-server/7.1.4.v20100610/jetty-server-7.1.4.v20100610.pom",
+     "spec/resources/repository/org/eclipse/jetty/jetty-util/7.1.4.v20100610/jetty-util-7.1.4.v20100610.pom",
+     "spec/spec_helper.rb",
+     "tasks/gem.rake",
+     "tasks/rdoc.rake",
+     "tasks/spec.rake"
+  ]
+  s.homepage = %q{http://github.com/iconara/pompompom}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Ruby dependency manager for Maven repository artifacts}
+  s.test_files = [
+    "spec/pompompom/cli_spec.rb",
+     "spec/pompompom/dependency_spec.rb",
+     "spec/pompompom/metadata_spec.rb",
+     "spec/pompompom/pom_spec.rb",
+     "spec/pompompom/resolver_spec.rb",
+     "spec/pompompom/url_builders_shared.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/spec/pompompom/cli_spec.rb

@@ -0,0 +1,93 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require 'tmpdir'
+require 'fileutils'
+
+
+module PomPomPom
+  describe Cli do
+    before do
+      @repository_path = File.expand_path('../../resources/repository', __FILE__)
+      @stdin  = StringIO.new
+      @stdout = StringIO.new
+      @stderr = StringIO.new
+      @downloader = FilesystemDownloader.new
+      @resolver = Resolver.new([@repository_path])
+      @cli = Cli.new(@stdin, @stdout, @stderr)
+      @cli.stub!(:create_resolver).and_return(@resolver)
+      @cli.stub!(:create_lib_directory!)
+      @tmp_dir = File.join(Dir.tmpdir, 'pompompom')
+      FileUtils.rm_rf(@tmp_dir)
+      Dir.mkdir(@tmp_dir)
+      Dir.chdir(@tmp_dir)
+    end
+    
+    after do
+      FileUtils.rm_rf(@tmp_dir)
+    end
+    
+    it 'prints usage if no arguments given' do
+      @cli.run!
+      @stderr.string.should include('Usage: pompompom <group_id:artifact_id:version> [<group_id:artifact_id:version>]')
+    end
+    
+    it 'returns 1 if no arguments given' do
+      @cli.run!.should == 1
+    end
+    
+    it 'installs any artifacts mentioned on the command line' do
+      @cli.run!('net.iconara:pompompom:1.0', 'com.example:test:9.9')
+      @stderr.string.should include('Determining transitive dependencies...')
+      @stderr.string.should include('Downloading "net.iconara:pompompom:1.0"')
+      @stderr.string.should include('Downloading "com.example:test:9.9"')
+    end
+    
+    it 'returns 0 if all goes well' do
+      @cli.run!('net.iconara:pompompom:1.0', 'com.example:test:9.9').should == 0
+    end
+    
+    context 'when artifacts have already been downloaded' do
+      before do
+        FileUtils.mkdir('lib')
+        FileUtils.touch(File.join('lib', 'pompompom-1.0.jar'))
+      end
+      
+      it 'does not download them again' do
+        @cli.run!('net.iconara:pompompom:1.0', 'com.example:test:9.9')
+        @stderr.string.should_not include('Downloading "net.iconara:pompompom:1.0"')
+      end
+      
+      it 'warns if none will be downloaded' do
+        FileUtils.touch(File.join('lib', 'test-9.9.jar'))
+        @cli.run!('net.iconara:pompompom:1.0', 'com.example:test:9.9')
+        @stderr.string.should include('All dependencies are met')
+      end
+      
+      it 'returns 0' do
+        FileUtils.touch(File.join('lib', 'test-9.9.jar'))
+        @cli.run!('net.iconara:pompompom:1.0', 'com.example:test:9.9').should == 0
+      end
+    end
+    
+    it 'complains about malformed artifact coordinates' do
+      @cli.run!('net.iconara:pompompom:1.0', 'foobar')
+      @stderr.string.should include('Warning: "foobar" is not a valid artifact coordinate')
+    end
+    
+    context 'when "lib" exists but is not a directory' do
+      before do
+        @cli = Cli.new(@stdin, @stdout, @stderr)
+        @cli.stub!(:create_resolver).and_return(@resolver)
+        FileUtils.touch(File.join(@tmp_dir, 'lib'))
+      end
+      
+      it 'complains' do
+        @cli.run!('com.example:test:9.9')
+        @stderr.string.should include('Warning: Cannot create destination, "lib" is a file!')
+      end
+      
+      it 'returns 1' do
+        @cli.run!('com.example:test:9.9').should == 1
+      end
+    end
+  end
+end

data/spec/pompompom/dependency_spec.rb

@@ -0,0 +1,144 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require File.expand_path('../url_builders_shared', __FILE__)
+
+
+module PomPomPom
+  describe Dependency do
+    before do
+      @url_builder = Dependency.new('net.iconara', 'pompompom', '1.0')
+    end
+    
+    it_should_behave_like 'an URL builder'
+    
+    describe '#initialize' do
+      it 'can be created with named arguments' do
+        d = Dependency.new(:group_id => 'net.iconara', :artifact_id => 'pompompom', :version => '1.0')
+        d.group_id.should == 'net.iconara'
+        d.artifact_id.should == 'pompompom'
+        d.version.should == '1.0'
+      end
+      
+      it 'can be created with a regular argument list' do
+        d = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d.group_id.should == 'net.iconara'
+        d.artifact_id.should == 'pompompom'
+        d.version.should == '1.0'
+      end
+    end
+    
+    describe '#to_s' do
+      it 'returns the Maven artifact descriptor' do
+        s = Dependency.new('net.iconara', 'pompompom', '1.0').to_s
+        s.should == 'net.iconara:pompompom:1.0'
+      end
+    end
+
+    describe '#eql?' do
+      it 'is equal to another dependency with the same group ID, artifact ID and version' do
+        d1 = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d2 = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d1.should == d2
+      end
+
+      it 'is not equal to another dependency with another version' do
+        d1 = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d2 = Dependency.new('net.iconara', 'pompompom', '1.1')
+        d1.should_not == d2
+      end
+
+      it 'is not equal to another dependency with another group ID' do
+        d1 = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d2 = Dependency.new('com.example', 'pompompom', '1.0')
+        d1.should_not == d2
+      end
+
+      it 'is not equal to another dependency with another artifact ID' do
+        d1 = Dependency.new('net.iconara', 'pompompom', '1.0')
+        d2 = Dependency.new('net.iconara', 'mopmopmop', '1.0')
+        d1.should_not == d2
+      end
+    end
+
+    describe '.parse' do
+      it 'parses a Maven coordinate' do
+        d = Dependency.parse('net.iconara:pompompom:1.0')
+        d.group_id.should == 'net.iconara'
+        d.artifact_id.should == 'pompompom'
+        d.version.should == '1.0'
+      end
+      
+      it 'parses a Maven coordinate with packaging label' do
+        d = Dependency.parse('net.iconara:pompompom:jar:1.0')
+        d.group_id.should == 'net.iconara'
+        d.artifact_id.should == 'pompompom'
+        d.version.should == '1.0'
+        d.packaging.should == 'jar'
+      end
+      
+      it 'parses a Maven coordinate with packaging label and classifier' do
+        d = Dependency.parse('net.iconara:pompompom:ear:xyz:1.0')
+        d.group_id.should == 'net.iconara'
+        d.artifact_id.should == 'pompompom'
+        d.version.should == '1.0'
+        d.packaging.should == 'ear'
+        d.classifier.should == 'xyz'
+      end
+      
+      it 'raises an exception if the coordinate is malformed' do
+        expect { Dependency.parse('net.iconara:pompompom') }.to raise_error
+      end
+
+      it 'raises an exception if the coordinate is empty' do
+        expect { Dependency.parse('') }.to raise_error
+      end
+
+      it 'raises an exception if the coordinate is nil' do
+        expect { Dependency.parse('') }.to raise_error
+      end
+    end
+
+    describe '#has_version?' do
+      it 'is true if version is unspecified' do
+        d = Dependency.new(:group_id => 'com.example', :artifact_id => 'test')
+        d.should_not have_version
+      end
+      
+      it 'is false if version is set' do
+        d = Dependency.new(:group_id => 'com.example', :artifact_id => 'test', :version => '0.0.1')
+        d.should have_version
+      end
+    end
+    
+    describe '#same_artifact?' do
+      it 'returns true if the group and artifact IDs are the same' do
+        d1 = Dependency.new(:group_id => 'com.example', :artifact_id => 'hello', :version => '3')
+        d2 = Dependency.new(:group_id => 'com.example', :artifact_id => 'hello', :version => '4')
+        d1.same_artifact?(d2).should be_true
+      end
+
+      it 'returns false if the group and artifact IDs are the same' do
+        d1 = Dependency.new(:group_id => 'com.elpmaxe', :artifact_id => 'hello', :version => '3')
+        d2 = Dependency.new(:group_id => 'com.example', :artifact_id => 'hello', :version => '3')
+        d1.same_artifact?(d2).should_not be_true
+      end
+    end
+    
+    describe '#clone' do
+      it 'creates an identical copy' do
+        d1 = Dependency.new(:group_id => 'com.example', :artifact_id => 'test', :version => '0.0.1')
+        d2 = d1.clone
+        d1.should == d2
+      end
+      
+      it 'creates an identical copy, save for overridden properties' do
+        d1 = Dependency.new(:group_id => 'com.example', :artifact_id => 'test', :version => '0.0.1', :classifier => 'foo')
+        d2 = d1.clone(:version => '1.0.0')
+        d1.should_not == d2
+        d2.group_id.should == 'com.example'
+        d2.artifact_id.should == 'test'
+        d2.classifier.should == 'foo'
+        d2.version.should == '1.0.0'
+      end
+    end
+  end
+end

data/spec/pompompom/metadata_spec.rb

@@ -0,0 +1,38 @@
+require File.expand_path('../../spec_helper', __FILE__)
+
+
+module PomPomPom
+  describe Metadata do
+    before do
+      @metadata1 = File.open(File.expand_path('../../resources/repository/aopalliance/aopalliance/maven-metadata.xml', __FILE__), 'r') do |f|
+        md = Metadata.new(f)
+        md.parse!
+        md
+      end
+      @metadata2 = File.open(File.expand_path('../../resources/repository/com/example/test/maven-metadata.xml', __FILE__), 'r') do |f|
+        md = Metadata.new(f)
+        md.parse!
+        md
+      end
+      @metadata3 = File.open(File.expand_path('../../resources/repository/com/example/test-abc/maven-metadata.xml', __FILE__), 'r') do |f|
+        md = Metadata.new(f)
+        md.parse!
+        md
+      end
+    end
+    
+    describe '#latest_version' do
+      it 'returns the latest version when there is only one' do
+        @metadata1.latest_version.should == '1.0'
+      end
+      
+      it 'returns the last version' do
+        @metadata2.latest_version.should == '9.9'
+      end
+      
+      it 'returns the release version when one is specified' do
+        @metadata3.latest_version.should == '1.0'
+      end
+    end
+  end
+end

data/spec/pompompom/pom_spec.rb

@@ -0,0 +1,221 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require File.expand_path('../url_builders_shared', __FILE__)
+
+
+module PomPomPom
+  describe Pom do
+    it_should_behave_like 'an URL builder'
+    
+    before do
+      @url_builder = Pom.new(StringIO.new('<project><groupId>net.iconara</groupId><artifactId>pompompom</artifactId><version>1.0</version><packaging>jar</packaging></project>'))
+      @url_builder.parse!
+    end
+      
+    describe '#parse!' do
+      context 'when parsing a file' do
+        before do
+          @example_pom_path = File.expand_path('../../resources/repository/com/rabbitmq/amqp-client/1.8.0/amqp-client-1.8.0.pom', __FILE__)
+          @pom = File.open(@example_pom_path, 'r') do |f|
+            pom = Pom.new(f)
+            pom.parse!
+            pom
+          end
+        end
+    
+        it('finds the right group ID') { @pom.group_id.should == 'com.rabbitmq' }
+        it('finds the right artifact ID') { @pom.artifact_id.should == 'amqp-client' }
+        it('finds the right version') { @pom.version.should == '1.8.0' }
+        it('finds the right packaging type') { @pom.packaging.should == 'jar' }
+        it('finds the right name') { @pom.name.should == 'RabbitMQ Java Client' }
+        it('finds the right description') { @pom.description.should == 'RabbitMQ AMQP Java Client' }
+        it('finds the right URL') { @pom.url.should == 'http://www.rabbitmq.com' }
+
+        it 'finds two dependencies in the default scope' do
+          @pom.dependencies.should have(2).items
+        end
+      
+        it 'finds one dependency in the test scope' do
+          @pom.dependencies(:test).should have(1).items
+        end
+      
+        it 'finds a dependency on JUnit' do
+          dep = @pom.dependencies(:test).first
+          dep.group_id.should == 'junit'
+        end
+      
+        it 'finds a dependency on commons-cli v1.1' do
+          dep = @pom.dependencies.select { |d| d.group_id == 'commons-cli' && d.artifact_id == 'commons-cli' && d.version == '1.1' }
+          dep.should_not be_empty
+        end
+      end
+
+      context 'with exclusions' do
+        before do
+          @example_pom_path = File.expand_path('../../resources/repository/com/example/test-exclusions/1.0/test-exclusions-1.0.pom', __FILE__)
+          @pom = File.open(@example_pom_path, 'r') do |f|
+            pom = Pom.new(f)
+            pom.parse!
+            pom
+          end
+        end
+        
+        it 'finds exclusions' do
+          d = @pom.dependencies.first
+          d.exclusions.first.artifact_id.should == 'commons-cli'
+        end
+      end
+
+      context 'with optional' do
+        before do
+          @example_pom_path = File.expand_path('../../resources/repository/com/example/test-optional/1.0/test-optional-1.0.pom', __FILE__)
+          @pom = File.open(@example_pom_path, 'r') do |f|
+            pom = Pom.new(f)
+            pom.parse!
+            pom
+          end
+        end
+        
+        it 'finds exclusions' do
+          d = @pom.dependencies.first
+          d.should be_optional
+        end
+      end
+    
+      context 'when properties are inherited from parent' do
+        before do
+          p = <<-XML
+            <project>
+              <parent>
+                <groupId>com.example</groupId>
+                <artifactId>test-parent</artifactId>
+                <version>2.0</version>
+              </parent>
+              <artifactId>pompompom</artifactId>
+              <packaging>jar</packaging>
+            </project>
+          XML
+          @pom = Pom.new(StringIO.new(p))
+          @pom.parse!
+        end
+        
+        it 'finds the group ID from the parent specification' do
+          @pom.group_id.should == 'com.example'
+        end
+
+        it 'finds the version from the parent specification' do
+          @pom.version.should == '2.0'
+        end
+        
+        it 'knows it has a parent' do
+          @pom.should have_parent
+        end
+        
+        it 'knows the artifact ID of its parent' do
+          @pom.parent.group_id.should == 'com.example'
+        end
+        
+        it 'knows the group ID of its parent' do
+          @pom.parent.artifact_id.should == 'test-parent'
+        end
+      end
+
+      context 'property expansion' do
+        before do
+          @base_pom = <<-XML
+            <project>
+              <groupId>net.iconara</groupId>
+              <artifactId>pompompom</artifactId>
+              <version>1.0</version>
+              <name>Name</name>
+              <description>Description</description>
+              <packaging>jar</packaging>
+              <properties>
+                <foo.bar>baz</foo.bar>
+              </properties>
+              <dependencies>
+                <dependency>
+                  <groupId>net.iconara</groupId>
+                  <artifactId>pimpimpim</artifactId>
+                  <version>9.9</version>
+                </dependency>
+              </dependencies>
+            </project>
+          XML
+        end
+        
+        it 'knowns how to expand ${version}' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<version>9.9</version>', '<version>${version}</version>')))
+          pom.parse!
+          pom.dependencies.first.version.should == '1.0'
+        end
+        
+        it 'knowns how to expand ${project.version}' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<version>9.9</version>', '<version>${project.version}</version>')))
+          pom.parse!
+          pom.dependencies.first.version.should == '1.0'
+        end
+
+        it 'knowns how to expand ${project.artifactId}' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<name>Name</name>', '<name>This is ${project.artifactId}</name>')))
+          pom.parse!
+          pom.name.should == 'This is pompompom'
+        end
+
+        it 'knowns how to expand ${project.groupId}' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<description>Description</description>', '<description>The group ID is ${project.groupId}</description>')))
+          pom.parse!
+          pom.description.should == 'The group ID is net.iconara'
+        end
+
+        it 'knowns how to expand and environment variable' do
+          ENV['JAVA_HOME'] = '/opt/java'
+          pom = Pom.new(StringIO.new(@base_pom.sub('<description>Description</description>', '<description>Java is at ${env.JAVA_HOME}</description>')))
+          pom.parse!
+          pom.description.should == 'Java is at /opt/java'
+        end
+
+        it 'looks up project-specific properties' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<description>Description</description>', '<description>${foo.bar}</description>')))
+          pom.parse!
+          pom.description.should == 'baz'
+        end
+
+        it 'leaves unexpandable properties in place' do
+          pom = Pom.new(StringIO.new(@base_pom.sub('<description>Description</description>', '<description>${plonk}</description>')))
+          pom.parse!
+          pom.description.should == '${plonk}'
+        end
+      end
+    end
+    
+    describe '#merge' do
+      before do
+        @child_pom_path  = File.expand_path('../../resources/repository/com/example/test-child/1.0/test-child-1.0.pom', __FILE__)
+        @parent_pom_path = File.expand_path('../../resources/repository/com/example/test-parent/1.0/test-parent-1.0.pom', __FILE__)
+        @child_pom_io    = File.open(@child_pom_path, 'r')
+        @parent_pom_io   = File.open(@parent_pom_path, 'r')
+        @child_pom       = Pom.new(@child_pom_io)
+        @parent_pom      = Pom.new(@parent_pom_io)
+        @child_pom.parse!
+        @parent_pom.parse!
+      end
+      
+      after do
+        @child_pom_io.close
+        @parent_pom_io.close
+      end
+      
+      it 'creates a copy' do
+        pom = @child_pom.merge(@parent_pom)
+        pom.group_id.should == @child_pom.group_id
+        pom.artifact_id.should == @child_pom.artifact_id
+        pom.version.should == @child_pom.version
+      end
+      
+      it 'resolves dependency versions using the parent' do
+        pom = @child_pom.merge(@parent_pom)
+        pom.dependencies.first.version.should == '8.8'
+      end
+    end
+  end
+end