nexus_cli 3.0.0 → 4.0.0.beta1

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# 4.0.0.beta1
+
+* Added support for Maven classifiers
+* In general, references to an 'artifact' have been renamed to 'coordinates'

data/README.md

@@ -9,7 +9,7 @@ A CLI wrapper around Sonatype Nexus REST calls.
 
 # Installation
 
-1. Install the Gem
+1. Install the Gem - `gem install nexus_cli`
 2. Create a file in your user's home directory named `.nexus_cli`
 3. Give the file the following information:
 
@@ -22,18 +22,18 @@ password: 		"password"
 
 # Usage
 
-There are two calls that can be made. push\_artifact and pull\_artifact. Both calls will push or pull artifacts from Nexus using the Maven-flavored syntax: `groupId:artifactId:version:extension`
+There are two calls that can be made. push\_artifact and pull\_artifact. Both calls will push or pull artifacts from Nexus using the Maven Co-ordinates syntax: `groupId:artifactId:version` or `groupId:artifactId:extension:version` or `groupId:artifactId:extension:classifier:version`
 
 ## Pull Artifact Example
 
 ```
-nexus-cli pull_artifact com.mycompany.artifacts:myartifact:1.0.0:tgz
+nexus-cli pull_artifact com.mycompany.artifacts:myartifact:tgz:1.0.0
 ```
 
 ## Push Artifact Example
 
 ```
-nexus-cli push_artifact com.mycompany.artifacts:myartifact:1.0.0:tgz ~/path/to/file/to/push/myartifact.tgz
+nexus-cli push_artifact com.mycompany.artifacts:myartifact:tgz:1.0.0 ~/path/to/file/to/push/myartifact.tgz
 ```
 
 # License and Author

data/VERSION

@@ -1 +1 @@
-3.0.0
+4.0.0.beta1

data/data/pom.xml.erb

@@ -2,9 +2,12 @@
 <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <modelVersion>4.0.0</modelVersion>
-  <groupId><%= group_id %></groupId>
-  <artifactId><%= artifact_id %></artifactId>
-  <version><%= version %></version>
-  <packaging><%= extension %></packaging>
+  <groupId><%= artifact.group_id %></groupId>
+  <artifactId><%= artifact.artifact_id %></artifactId>
+  <version><%= artifact.version %></version>
+  <% unless artifact.classifier.nil? %>
+    <classifier><%= artifact.classifier %></classifier>
+  <% end %>
+  <packaging><%= artifact.extension %></packaging>
   <description>POM was created by Sonatype Nexus</description>
-</project>
+</project>

data/features/nexus_oss.feature

@@ -12,34 +12,34 @@ Feature: Use the Nexus CLI
 
   @push
   Scenario: Push an Artifact
-    When I push an artifact with the GAV of "com.test:mytest:1.0.0:tgz"
+    When I push an artifact with the GAV of "com.test:mytest:tgz:1.0.0"
     Then the output should contain:
       """
-      Artifact com.test:mytest:1.0.0:tgz has been successfully pushed to Nexus.
+      Artifact com.test:mytest:tgz:1.0.0 has been successfully pushed to Nexus.
       """
     And the exit status should be 0
   
   @pull
   Scenario: Pull an artifact
-    When I call the nexus "pull com.test:mytest:1.0.0:tgz" command
+    When I call the nexus "pull com.test:mytest:tgz:1.0.0" command
     Then the output should contain:
       """
-      Artifact has been retrived and can be found at path:
+      Artifact has been retrieved and can be found at path:
       """
     And the exit status should be 0
 
   Scenario: Pull the LATEST of an artifact
-    When I pull an artifact with the GAV of "com.test:mytest:latest:tgz" to a temp directory
+    When I pull an artifact with the GAV of "com.test:mytest:tgz:latest" to a temp directory
     Then I should have a copy of the "mytest-1.0.0.tgz" artifact in a temp directory
     And the exit status should be 0
   
   Scenario: Pull an artifact to a specific place
-    When I pull an artifact with the GAV of "com.test:mytest:1.0.0:tgz" to a temp directory
+    When I pull an artifact with the GAV of "com.test:mytest:tgz:1.0.0" to a temp directory
     Then I should have a copy of the "mytest-1.0.0.tgz" artifact in a temp directory
     And the exit status should be 0
 
   Scenario: Get an artifact's info
-    When I call the nexus "info com.test:mytest:1.0.0:tgz" command
+    When I call the nexus "info com.test:mytest:tgz:1.0.0" command
     Then the output should contain:
       """
       <groupId>com.test</groupId>
@@ -51,23 +51,23 @@ Feature: Use the Nexus CLI
     Then the output should contain:
       """
       Found Versions:
-      1.0.0:    `nexus-cli pull com.test:mytest:1.0.0:tgz`
+      1.0.0:    `nexus-cli pull com.test:mytest:tgz:1.0.0`
       """
     And the exit status should be 0
 
   @transfer
   Scenario: Transfer an artifact between repositories
-    When I call the nexus "transfer com.test:mytest:1.0.0:tgz releases thirdparty" command
+    When I call the nexus "transfer com.test:mytest:tgz:1.0.0 releases thirdparty" command
     Then the output should contain:
       """
-      The artifact com.test:mytest:1.0.0:tgz has been transferred from releases to thirdparty.
+      The artifact com.test:mytest:tgz:1.0.0 has been transferred from releases to thirdparty.
       """
     And the exit status should be 0
 
   @delete
   Scenario: Attempt to delete an artifact
-    When I delete an artifact with the GAV of "com.test:mytest:1.0.0:tgz"
-    And I call the nexus "info com.test:mytest:1.0.0:tgz" command
+    When I delete an artifact with the GAV of "com.test:mytest:tgz:1.0.0"
+    And I call the nexus "info com.test:mytest:tgz:1.0.0" command
     Then the output should contain:
       """
       The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
@@ -76,8 +76,8 @@ Feature: Use the Nexus CLI
 
   @delete
   Scenario: Attempt to delete another artifact
-    When I delete an artifact with the GAV of "com.test:mytest:1.0.0:tgz" from the "thirdparty" repository
-    And I call the nexus "info com.test:mytest:1.0.0:tgz" command overriding "repository:thirdparty"
+    When I delete an artifact with the GAV of "com.test:mytest:tgz:1.0.0" from the "thirdparty" repository
+    And I call the nexus "info com.test:mytest:tgz:1.0.0" command overriding "repository:thirdparty"
     Then the output should contain:
       """
       The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
@@ -249,4 +249,4 @@ Feature: Use the Nexus CLI
       """
       \"id\":\"cucumber_group\"
       """
-    And the exit status should be 114
+    And the exit status should be 114

data/features/pro/nexus_custom_metadata.feature

@@ -3,39 +3,39 @@ Feature: Use the Nexus Pro CLI
 	I need commands to get, update, search, and delete Nexus artifact custom metadata
 
   Scenario: Push an artifact
-    When I push an artifact with the GAV of "com.test:myprotest:1.0.0:tgz"
+    When I push an artifact with the GAV of "com.test:myprotest:tgz:1.0.0"
     Then the output should contain:
 	    """
-	    Artifact com.test:myprotest:1.0.0:tgz has been successfully pushed to Nexus.
+	    Artifact com.test:myprotest:tgz:1.0.0 has been successfully pushed to Nexus.
 	    """
     And the exit status should be 0
 
   Scenario: Update an artifact's custom metadata
-		When I call the nexus "update_artifact_custom_info com.test:myprotest:1.0.0:tgz somekey:somevalue" command
+		When I call the nexus "update_artifact_custom_info com.test:myprotest:tgz:1.0.0 somekey:somevalue" command
 		Then the output should contain:
 			"""
-			Custom metadata for artifact com.test:myprotest:1.0.0:tgz has been successfully pushed to Nexus.
+			Custom metadata for artifact com.test:myprotest:tgz:1.0.0 has been successfully pushed to Nexus.
 			"""
 		And the exit status should be 0
 
 	Scenario: Update an artifact's custom metadata with multiple parameters
-		When I call the nexus "update_artifact_custom_info com.test:myprotest:1.0.0:tgz somekey:somevalue_1! \"someotherkey:some other value\" tempkey:tempvalue" command
+		When I call the nexus "update_artifact_custom_info com.test:myprotest:tgz:1.0.0 somekey:somevalue_1! \"someotherkey:some other value\" tempkey:tempvalue" command
 		Then the output should contain:
 			"""
-			Custom metadata for artifact com.test:myprotest:1.0.0:tgz has been successfully pushed to Nexus.
+			Custom metadata for artifact com.test:myprotest:tgz:1.0.0 has been successfully pushed to Nexus.
 			"""
 		And the exit status should be 0
 		
 	Scenario: Update an artifact's custom metadata and remove a key
-		When I call the nexus "update_artifact_custom_info com.test:myprotest:1.0.0:tgz tempkey:" command
+		When I call the nexus "update_artifact_custom_info com.test:myprotest:tgz:1.0.0 tempkey:" command
 		Then the output should contain:
 			"""
-			Custom metadata for artifact com.test:myprotest:1.0.0:tgz has been successfully pushed to Nexus.
+			Custom metadata for artifact com.test:myprotest:tgz:1.0.0 has been successfully pushed to Nexus.
 			"""
 		And the exit status should be 0
 
 	Scenario: Get an artifact's custom metadata
-		When I call the nexus "custom com.test:myprotest:1.0.0:tgz" command
+		When I call the nexus "custom com.test:myprotest:tgz:1.0.0" command
 		Then the output should contain:
 			"""
 			<somekey>somevalue_1!</somekey>
@@ -79,8 +79,8 @@ Feature: Use the Nexus Pro CLI
 		And the exit status should be 0
 
   Scenario: Transfer an artifact and ensure its metadata is also copied
-    When I call the nexus "transfer com.test:myprotest:1.0.0:tgz releases thirdparty" command
-    And I call the nexus "custom com.test:myprotest:1.0.0:tgz" command overriding "repository:thirdparty"
+    When I call the nexus "transfer com.test:myprotest:tgz:1.0.0 releases thirdparty" command
+    And I call the nexus "custom com.test:myprotest:tgz:1.0.0" command overriding "repository:thirdparty"
     Then the output should contain:
       """
       <somekey>somevalue_1!</somekey>
@@ -88,17 +88,17 @@ Feature: Use the Nexus Pro CLI
     And the exit status should be 0
 
 	Scenario: Clear an artifact's custom metadata
-		When I call the nexus "clear_artifact_custom_info com.test:myprotest:1.0.0:tgz" command
+		When I call the nexus "clear_artifact_custom_info com.test:myprotest:tgz:1.0.0" command
 		Then the output should contain:
 			"""
-			Custom metadata for artifact com.test:myprotest:1.0.0:tgz has been successfully cleared.
+			Custom metadata for artifact com.test:myprotest:tgz:1.0.0 has been successfully cleared.
 			"""
 		And the exit status should be 0
 
   @delete
   Scenario: Attempt to delete an artifact
-    When I delete an artifact with the GAV of "com.test:myprotest:1.0.0:tgz"
-    And I call the nexus "info com.test:myprotest:1.0.0:tgz" command
+    When I delete an artifact with the GAV of "com.test:myprotest:tgz:1.0.0"
+    And I call the nexus "info com.test:myprotest:tgz:1.0.0" command
     Then the output should contain:
 	    """
 	    The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
@@ -107,10 +107,10 @@ Feature: Use the Nexus Pro CLI
 
   @delete
   Scenario: Attempt to delete another artifact
-    When I delete an artifact with the GAV of "com.test:myprotest:1.0.0:tgz" from the "thirdparty" repository
-    And I call the nexus "info com.test:myprotest:1.0.0:tgz" command overriding "repository:thirdparty"
+    When I delete an artifact with the GAV of "com.test:myprotest:tgz:1.0.0" from the "thirdparty" repository
+    And I call the nexus "info com.test:myprotest:tgz:1.0.0" command overriding "repository:thirdparty"
     Then the output should contain:
 	    """
 	    The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
 	    """
-    And the exit status should be 101
+    And the exit status should be 101

data/lib/nexus_cli/artifact.rb

@@ -0,0 +1,46 @@
+module NexusCli
+  class Artifact
+    attr_reader :group_id
+    attr_reader :artifact_id
+    attr_reader :extension
+    attr_reader :classifier
+    attr_reader :version
+    attr_reader :file_name
+
+    # Constructs an artifact object from Maven co-ordinates
+    # See http://maven.apache.org/pom.html#Maven_coordinatess
+    # for more information on maven coordinatess
+    # 
+    # @param  coordinates [String] the Maven identifier
+    # 
+    # @return [Array<String>] an Array with four elements
+    def initialize(coordinates)
+      @group_id, @artifact_id, @extension, @classifier, @version = parse_coordinates(coordinates)
+
+      if @classifier.nil?
+        @file_name = "#{@artifact_id}-#{@version}.#{@extension}"
+      else
+        @file_name = "#{@artifact_id}-#{@version}-#{@classifier}.#{@extension}"
+      end
+    end
+
+    private
+
+    def parse_coordinates(coordinates)
+      split_coordinates = coordinates.split(":")
+      if(split_coordinates.size < 3 or split_coordinates.size > 5)
+        raise ArtifactMalformedException
+      end
+
+      group_id = split_coordinates[0]
+      artifact_id = split_coordinates[1]
+      extension = split_coordinates.size > 3 ? split_coordinates[2] : "jar"
+      classifier = split_coordinates.size > 4 ? split_coordinates[3] : nil
+      version = split_coordinates[-1]
+
+      version.upcase! if version == "latest"
+
+      return group_id, artifact_id, extension, classifier, version
+    end
+  end
+end

data/lib/nexus_cli/base_remote.rb

@@ -9,24 +9,8 @@ module NexusCli
     # @param [Hash] overrides
     # @param [Boolean] ssl_verify
     def initialize(overrides, ssl_verify=true)
-      @configuration = Configuration::parse(overrides)
+      @configuration = overrides ? Configuration.from_overrides(overrides) : Configuration.from_file
       @connection = Connection.new(configuration, ssl_verify)
     end
-
-    # Parses a given artifact string into its
-    # four, distinct, Maven pieces.
-    # 
-    # @param  artifact [String] the Maven identifier
-    # 
-    # @return [Array<String>] an Array with four elements
-    def parse_artifact_string(artifact)
-      split_artifact = artifact.split(":")
-      if(split_artifact.size < 4)
-        raise ArtifactMalformedException
-      end
-      group_id, artifact_id, version, extension = split_artifact
-      version.upcase! if version.casecmp("latest")
-      return group_id, artifact_id, version, extension
-    end
   end
-end
+end

data/lib/nexus_cli/configuration.rb

@@ -1,44 +1,78 @@
 require 'extlib'
+require 'chozo'
 
 module NexusCli
-  module Configuration
+  class Configuration
     DEFAULT_FILE = "~/.nexus_cli".freeze
 
     class << self
-      attr_writer :path
-
       # The filepath to the nexus cli configuration file
       #
       # @return [String]
-      def path
-        @path || File.expand_path(ENV['NEXUS_CONFIG'] || DEFAULT_FILE)
+      def file_path
+        File.expand_path(ENV['NEXUS_CONFIG'] || File.expand_path(DEFAULT_FILE))
       end
 
+      # Creates a new instance of the Configuration object based on some overrides
+      # 
       # @param [Hash] overrides
       #
-      # @return [Hash]
-      def parse(overrides = {})
-        config = File.exists?(self.path) ? YAML::load_file(self.path) : Hash.new
-
-        if config.nil? && (overrides.nil? || overrides.empty?)
-          raise MissingSettingsFileException
-        end
-
-        unless overrides.nil? || overrides.empty?
-          overrides.each { |key, value| config[key] = value }
-        end
+      # @return [NexusCli::Configuration]
+      def from_overrides(overrides)
+        raise MissingSettingsFileException unless overrides
+        overrides = overrides.with_indifferent_access
+        new(overrides)
+      end
 
-        validate_config(config)
+      # Creates a new instance of the Configuration object from the config file
+      #
+      #
+      # @return [NexusCli::Configuration]
+      def from_file
+        config = YAML.load_file(file_path)
+        raise MissingSettingsFileException unless config
 
-        config["repository"] = config["repository"].gsub(" ", "_").downcase
-        config
+        config = config.with_indifferent_access
+        new(config)
       end
 
-      def validate_config(configuration)
-        ["url", "repository", "username", "password"].each do |key|
-          raise InvalidSettingsException.new(key) if configuration[key].blank?
+      # Validates an instance of the Configuration object and raises when there
+      # is an error with it
+      #
+      # @param  config [NexusCli::Configuration]
+      # 
+      # @raise [NexusCli::InvalidSettingsException]
+      def validate!(config)
+        unless config.valid?
+          raise InvalidSettingsException.new(config.errors)
         end
       end
     end
+
+    include Chozo::VariaModel
+
+    attribute :url,
+      type: String,
+      required: true
+
+    attribute :repository,
+      type: String,
+      required: true,
+      coerce: lambda { |m|
+        m = m.is_a?(String) ? m.gsub(' ', '_').downcase : m
+      }
+
+    attribute :username,
+      type: String,
+      required: true
+
+    attribute :password,
+      type: String,
+      required: true
+
+    def initialize(options)
+      mass_assign(options)
+      self.repository = options[:repository]
+    end
   end
 end

data/lib/nexus_cli/errors.rb

@@ -24,12 +24,12 @@ module NexusCli
   end
 
   class InvalidSettingsException < NexusCliError
-    def initialize(key)
-      @missing_setting = key
+    def initialize(errors)
+      @errors = errors
     end
 
     def message
-      "The .nexus_cli file or your overrides are missing the value: #{@missing_setting}"
+      "Your configuration has an error: #{@errors}"
     end
     status_code(102)
   end

data/lib/nexus_cli/mixins/artifact_actions.rb

@@ -5,20 +5,22 @@ module NexusCli
   # @author Kyle Allan <kallan@riotgames.com>
   module ArtifactActions
     
-    # Retrieves a file from the Nexus server using the given [String] artifact
-    # identifier. Optionally provide a destination [String].
+    # Retrieves a file from the Nexus server using the given [String] 
+    # coordinates. Optionally provide a destination [String].
     #
-    # @param [String] artifact
+    # @param [String] coordinates
     # @param [String] destination
     #
     # @return [Hash] Some information about the artifact that was pulled.
-    def pull_artifact(artifact, destination=nil)
-      group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      version = REXML::Document.new(get_artifact_info(artifact)).elements["//version"].text if version.casecmp("latest")
+    def pull_artifact(coordinates, destination=nil)
+      artifact = Artifact.new(coordinates)
+      version = REXML::Document.new(get_artifact_info(coordinates)).elements["//version"].text if artifact.version.casecmp("latest")
 
-      file_name = "#{artifact_id}-#{version}.#{extension}"
+      file_name = artifact.file_name
       destination = File.join(File.expand_path(destination || "."), file_name)
-      response = nexus.get(nexus_url("service/local/artifact/maven/redirect"), :query => {:g => group_id, :a => artifact_id, :v => version, :e => extension, :r => configuration['repository']})
+      query = {:g => artifact.group_id, :a => artifact.artifact_id, :e => artifact.extension, :v => artifact.version, :r => configuration['repository']}
+      query.merge!({:c => artifact.classifier}) unless artifact.classifier.nil?
+      response = nexus.get(nexus_url("service/local/artifact/maven/redirect"), :query => query)
       case response.status
       when 301, 307
         # Follow redirect and stream in chunks.
@@ -43,23 +45,22 @@ module NexusCli
     # Pushes the given [file] to the Nexus server
     # under the given [artifact] identifier.
     # 
-    # @param  artifact [String] the Maven identifier
+    # @param  coordinates [String] the Maven identifier
     # @param  file [type] the path to the file
     # 
     # @return [Boolean] returns true when successful
-    def push_artifact(artifact, file)
-      group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      file_name = "#{artifact_id}-#{version}.#{extension}"
-      put_string = "content/repositories/#{configuration['repository']}/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}/#{file_name}"
+    def push_artifact(coordinates, file)
+      artifact = Artifact.new(coordinates)
+      put_string = "content/repositories/#{configuration['repository']}/#{artifact.group_id.gsub(".", "/")}/#{artifact.artifact_id.gsub(".", "/")}/#{artifact.version}/#{artifact.file_name}"
       response = nexus.put(nexus_url(put_string), File.open(file))
 
       case response.status
       when 201
-        pom_name = "#{artifact_id}-#{version}.pom"
-        put_string = "content/repositories/#{configuration['repository']}/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}/#{pom_name}"
-        pom_file = generate_fake_pom(pom_name, group_id, artifact_id, version, extension)
+        pom_name = "#{artifact.artifact_id}-#{artifact.version}.pom"
+        put_string = "content/repositories/#{configuration['repository']}/#{artifact.group_id.gsub(".", "/")}/#{artifact.artifact_id.gsub(".", "/")}/#{artifact.version}/#{pom_name}"
+        pom_file = generate_fake_pom(pom_name, artifact)
         nexus.put(nexus_url(put_string), File.open(pom_file))
-        delete_string = "/service/local/metadata/repositories/#{configuration['repository']}/content/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}"
+        delete_string = "/service/local/metadata/repositories/#{configuration['repository']}/content/#{artifact.group_id.gsub(".", "/")}/#{artifact.artifact_id.gsub(".", "/")}"
         nexus.delete(nexus_url(delete_string))
         return true
       when 400
@@ -75,9 +76,9 @@ module NexusCli
       end
     end
 
-    def delete_artifact(artifact)
-      group_id, artifact_id, version = parse_artifact_string(artifact)
-      response = nexus.delete(nexus_url("content/repositories/#{configuration['repository']}/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}"))
+    def delete_artifact(coordinates)
+      artifact = Artifact.new(coordinates)
+      response = nexus.delete(nexus_url("content/repositories/#{configuration['repository']}/#{artifact.group_id.gsub(".", "/")}/#{artifact.artifact_id.gsub(".", "/")}/#{artifact.version}"))
       case response.status
       when 204
         return true
@@ -90,12 +91,14 @@ module NexusCli
     # Retrieves information about the given [artifact] and returns
     # it in as a [String] of XML.
     # 
-    # @param  artifact [String] the Maven identifier
+    # @param  coordinates [String] the Maven identifier
     # 
     # @return [String] A string of XML data about the desired artifact
-    def get_artifact_info(artifact)
-      group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      response = nexus.get(nexus_url("service/local/artifact/maven/resolve"), :query => {:g => group_id, :a => artifact_id, :v => version, :e => extension, :r => configuration['repository']})
+    def get_artifact_info(coordinates)
+      artifact = Artifact.new(coordinates)
+      query = {:g => artifact.group_id, :a => artifact.artifact_id, :e => artifact.extension, :v => artifact.version, :r => configuration['repository']}
+      query.merge!({:c => artifact.classifier}) unless artifact.classifier.nil?
+      response = nexus.get(nexus_url("service/local/artifact/maven/resolve"), query)
       case response.status
       when 200
         return response.content
@@ -111,16 +114,16 @@ module NexusCli
 
     # Searches for an artifact using the given identifier.
     #
-    # @param  artifact [String] the Maven identifier
+    # @param  coordinates [String] the Maven identifier
     # @example com.artifact:my-artifact
     # 
     # @return [Array<String>] a formatted Array of results
     # @example 
-    #   1.0.0     `nexus-cli pull com.artifact:my-artifact:1.0.0:tgz`
-    #   2.0.0     `nexus-cli pull com.artifact:my-artifact:2.0.0:tgz`
-    #   3.0.0     `nexus-cli pull com.artifact:my-artifact:3.0.0:tgz`
-    def search_for_artifacts(artifact)
-      group_id, artifact_id = artifact.split(":")
+    #   1.0.0     `nexus-cli pull com.artifact:my-artifact:tgz:1.0.0`
+    #   2.0.0     `nexus-cli pull com.artifact:my-artifact:tgz:2.0.0`
+    #   3.0.0     `nexus-cli pull com.artifact:my-artifact:tgz:3.0.0`
+    def search_for_artifacts(coordinates)
+      group_id, artifact_id = coordinates.split(":")
       response = nexus.get(nexus_url("service/local/data_index"), :query => {:g => group_id, :a => artifact_id})
       case response.status
       when 200
@@ -131,8 +134,8 @@ module NexusCli
       end
     end
 
-    def transfer_artifact(artifact, from_repository, to_repository)
-      do_transfer_artifact(artifact, from_repository, to_repository)
+    def transfer_artifact(coordinates, from_repository, to_repository)
+      do_transfer_artifact(coordinates, from_repository, to_repository)
     end
 
     private
@@ -164,21 +167,21 @@ module NexusCli
     # Transfers an artifact from one repository
     # to another. Sometimes called a `promotion`
     # 
-    # @param  artifact [String] a Maven identifier
+    # @param  coordinates [String] a Maven identifier
     # @param  from_repository [String] the name of the from repository
     # @param  to_repository [String] the name of the to repository
     # 
     # @return [Boolean] returns true when successful
-    def do_transfer_artifact(artifact, from_repository, to_repository)
+    def do_transfer_artifact(coordinates, from_repository, to_repository)
       Dir.mktmpdir do |temp_dir|
         configuration["repository"] = sanitize_for_id(from_repository)
-        artifact_file = pull_artifact(artifact, temp_dir)
+        artifact_file = pull_artifact(coordinates, temp_dir)
         configuration["repository"] = sanitize_for_id(to_repository)
-        push_artifact(artifact, artifact_file[:file_path])
+        push_artifact(coordinates, artifact_file[:file_path])
       end
     end
 
-    def generate_fake_pom(pom_name, group_id, artifact_id, version, extension)
+    def generate_fake_pom(pom_name, artifact)
       Tempfile.open(pom_name) do |file|
         template_path = File.join(NexusCli.root, "data", "pom.xml.erb")
         file.puts ERB.new(File.read(template_path)).result(binding)
@@ -186,4 +189,4 @@ module NexusCli
       end
     end
   end
-end
+end