nexus_cli 0.4.0 → 0.5.0

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.5.0

data/features/nexus_oss.feature

@@ -22,9 +22,9 @@ Feature: Use the Nexus CLI
   Scenario: Pull an artifact
     When I call the nexus "pull com.test:mytest:1.0.0:tgz" command
     Then the output should contain:
-    """
-    Artifact has been retrived and can be found at path:
-    """
+      """
+      Artifact has been retrived and can be found at path:
+      """
     And the exit status should be 0
 
   Scenario: Pull the LATEST of an artifact
@@ -40,18 +40,18 @@ Feature: Use the Nexus CLI
   Scenario: Get an artifact's info
     When I call the nexus "info com.test:mytest:1.0.0:tgz" command
     Then the output should contain:
-    """
-    <groupId>com.test</groupId>
-    """
+      """
+      <groupId>com.test</groupId>
+      """
     And the exit status should be 0
 
   Scenario: Search for artifacts
     When I call the nexus "search_for_artifacts com.test:mytest" command
     Then the output should contain:
-    """
-    Found Versions:
-    1.0.0:    `nexus-cli pull com.test:mytest:1.0.0:tgz`
-    """
+      """
+      Found Versions:
+      1.0.0:    `nexus-cli pull com.test:mytest:1.0.0:tgz`
+      """
     And the exit status should be 0
 
   @delete
@@ -59,18 +59,18 @@ Feature: Use the Nexus CLI
     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
     Then the output should contain:
-    """
-    The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
-    """
+      """
+      The artifact you requested information for could not be found. Please ensure it exists inside the Nexus.
+      """
     And the exit status should be 101
 
   Scenario: Get the current global settings of Nexus
     When I call the nexus "get_global_settings" command
     Then the output should contain:
-    """
-    Your current Nexus global settings have been written to the file: global_settings.json
-    """
-    And a file named "global_settings.json" should exist
+      """
+      Your current Nexus global settings have been written to the file: ~/.nexus/global_settings.json
+      """
+    And a file named "global_settings.json" should exist in my nexus folder
     And the exit status should be 0
 
   Scenario: Update the global settings of Nexus
@@ -78,25 +78,52 @@ Feature: Use the Nexus CLI
     And I edit the "global_settings.json" files "forceBaseUrl" field to true
     And I call the nexus "upload_global_settings" command
     Then the output should contain:
-    """
-    Your global_settings.json file has been uploaded to Nexus
-    """
+      """
+      Your global_settings.json file has been uploaded to Nexus
+      """
     When I call the nexus "get_global_settings" command
-    Then the file "global_settings.json" should contain:
+    Then the file "global_settings.json" in my nexus folder should contain:
+      """
+      "forceBaseUrl": true
+      """
+    And the exit status should be 0
+  
+  Scenario: Update the global settings of Nexus with a string
+    When I update global settings uiTimeout to 61 and upload the json string
+    And I call the nexus "get_global_settings" command
+    Then the file "global_settings.json" in my nexus folder should contain:
     """
-    "forceBaseUrl": true
+    "uiTimeout": 61
     """
     And the exit status should be 0
 
   Scenario: Reset the global settings of Nexus
     When I call the nexus "reset_global_settings" command
     Then the output should contain:
-    """
-    Your Nexus global settings have been reset to their default values
-    """
+      """
+      Your Nexus global settings have been reset to their default values
+      """
     When I call the nexus "get_global_settings" command
-    Then the file "global_settings.json" should contain:
-    """
-    "forceBaseUrl": false
-    """
-    And the exit status should be 0
+    Then the file "global_settings.json" in my nexus folder should contain:
+      """
+      "forceBaseUrl": false
+      """
+    And the exit status should be 0
+
+  Scenario: Create a new repository in Nexus
+    When I call the nexus "create_repository Artifacts" command
+    Then the output should contain:
+      """
+      A new Repository named Artifacts has been created.
+      """
+    And the exit status should be 0
+
+  Scenario: Delete a repository in Nexus
+    When I call the nexus "delete_repository Artifacts" command
+    And I call the nexus "get_repository_info Artifacts" command
+    Then the output should contain:
+      """
+      The repository you requested information could not be found. Please ensure the repository exists.
+      """
+    And the exit status should be 114
+    

data/features/step_definitions/cli_steps.rb

@@ -1,5 +1,6 @@
 require 'aruba/api'
 require 'json'
+require 'jsonpath'
 World(Aruba::Api)
 
 When /^I call the nexus "(.*?)" command$/ do |command|
@@ -7,8 +8,8 @@ When /^I call the nexus "(.*?)" command$/ do |command|
 end
 
 When /^I push an artifact with the GAV of "(.*)"$/ do |gav|
-  groupId, artifactId, version, extension = gav.split(":")
-  file = File.new(File.join(temp_dir, "#{artifactId}-#{version}.#{extension}"), 'w')
+  groupId, artifact_id, version, extension = gav.split(":")
+  file = File.new(File.join(temp_dir, "#{artifact_id}-#{version}.#{extension}"), 'w')
   file.puts "some data"
   file.close
   step "I run `nexus-cli push #{gav} #{file.path} --overrides=#{get_overrides_string}`"
@@ -28,14 +29,30 @@ end
 
 When /^I edit the "(.*?)" files "(.*?)" field to true$/ do |file, field|
   Dir.chdir('tmp/aruba') do
-    json = JSON.parse(File.read(File.join(File.expand_path("."), file)))
-    File.open(File.join(File.expand_path("."), file), "w+") do |opened|
+    json = JSON.parse(File.read(File.join(File.expand_path("~/.nexus"), file)))
+    File.open(File.join(File.expand_path("~/.nexus"), file), "w+") do |opened|
       json["data"]["globalRestApiSettings"][field] = true
       opened.write(JSON.pretty_generate(json))
     end
   end
 end
 
+When /^I update global settings uiTimeout to (\d+) and upload the json string$/ do |value|  
+  json = JSON.parse(nexus_remote.get_global_settings_json)
+  edited_json = JsonPath.for(json).gsub("$..uiTimeout") {|v| value.to_i}.to_hash
+  nexus_remote.upload_global_settings(JSON.dump(edited_json))
+end
+
+Then /^a file named "(.*?)" should exist in my nexus folder$/ do |file|
+  path = File.join(File.expand_path("~/.nexus"), file)
+  step "a file named \"#{path}\" should exist"
+end
+
+Then /^the file "(.*?)" in my nexus folder should contain:$/ do |file, partial_content|
+  path = File.join(File.expand_path("~/.nexus"), file)
+  check_file_content(path, partial_content, true)
+end
+
 Then /^the file "([^"]*)" should contain:$/ do |file, partial_content|
   check_file_content(file, partial_content, true)
 end

data/features/support/env.rb

@@ -17,14 +17,15 @@ end
 World(ArubaOverrides)
 
 Before do
-  @aruba_timeout_seconds = 5
+  @aruba_timeout_seconds = 10
 end
+
 def get_overrides_string
   @overrides_string ||= "url:http://localhost:8081/nexus repository:releases username:admin password:admin123"
 end
 
 def get_overrides
-  @overrides ||= {'url' => 'http://localhost:8081/nexus', 'repository' => 'releases', 'username' => 'deployment', 'password' => 'deployment123'}
+  @overrides ||= {'url' => 'http://localhost:8081/nexus', 'repository' => 'releases', 'username' => 'admin', 'password' => 'admin123'}
 end
 
 def temp_dir
@@ -37,4 +38,4 @@ end
 
 at_exit do
   FileUtils.rm_rf(temp_dir)
-end
+end

data/lib/nexus_cli.rb

@@ -6,6 +6,7 @@ require 'nexus_cli/nexus_remote_factory'
 require 'nexus_cli/nexus_oss_remote'
 require 'nexus_cli/nexus_pro_remote'
 require 'nexus_cli/configuration'
+require 'nexus_cli/n3_metadata'
 
 module NexusCli
   class << self

data/lib/nexus_cli/configuration.rb

@@ -15,7 +15,7 @@ module NexusCli
       end
 
       def validate_config(configuration)
-        ["url", "repository", "username","password"].each do |key|
+        ["url", "repository", "username", "password"].each do |key|
           raise InvalidSettingsException.new(key) if configuration[key].blank?
         end
       end

data/lib/nexus_cli/errors.rb

@@ -81,7 +81,7 @@ This could mean several things:
 
   class SearchParameterMalformedException < NexusCliError
     def message
-      "Submit your search request specifying the search key, type, and value. The available search types are `equal`, `matches`, `bounded`, and `notequal`."
+      "Submit your search request specifying one or more 3 colon-separated values: `key:type:value`. The available search types are `equal`, `matches`, `bounded`, and `notequal`."
     end
     status_code(109)
   end
@@ -105,4 +105,48 @@ The output from the server was:
     end
     status_code(111)
   end
-end
+
+  class CreateRepsitoryException < NexusCliError
+    def initialize(body)
+      @server_response = JSON.pretty_generate(JSON.parse(body))
+    end
+
+    def message
+      %{Your create repository command failed due to the following:
+        #{@server_response}}
+    end
+    status_code(112)
+  end
+
+  class RepositoryDoesNotExistException < NexusCliError
+    def message
+      "The repository you are trying to delete does not exist."
+    end
+    status_code(113)
+  end
+
+  class RepositoryNotFoundException < NexusCliError
+    def message
+      "The repository you requested information could not be found. Please ensure the repository exists."
+    end
+    status_code(114)
+  end
+
+  class UnexpectedStatusCodeException < NexusCliError
+    def initialize(code)
+      @code = code
+    end
+
+    def  message
+      "The server responded with a #{@code} status code which is unexpected. Please submit a bug."
+    end
+    status_code(115)
+  end
+
+  class N3ParameterMalformedException < NexusCliError
+    def message
+      "Submit your tag request specifying one or more 2 colon-separated values: `key:value`. The key can only consist of alphanumeric characters."
+    end
+    status_code(116)
+  end
+end

data/lib/nexus_cli/n3_metadata.rb

@@ -0,0 +1,88 @@
+require 'nokogiri'
+
+module NexusCli
+  module N3Metadata
+    class << self
+      def generate_n3_path(group_id, artifact_id, version, extension, repository)
+        return "content/repositories/#{repository}/.meta/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}/#{artifact_id}-#{version}.#{extension}.n3"
+      end
+
+      def valid_n3_key?(element)
+        return !element.match(/^[a-zA-Z0-9]+$/).nil? ? true : false
+      end
+
+      def valid_n3_value?(element)
+        return !element.match(/^[^"'\\]*$/).nil? ? true : false
+      end
+
+      def valid_n3_search_type?(element)
+        return ["equal", "notequal", "matches", "bounded"].include?(element)
+      end
+
+      # Generates the Nexus .n3 header for the tempfile that will be used to update an artifact's custom metadata.
+      def generate_n3_header(group_id, artifact_id, version, extension)
+        return "<urn:maven/artifact##{group_id}:#{artifact_id}:#{version}::#{extension}> a <urn:maven#artifact>"
+      end
+
+      # Generates a hash containing the Nexus .n3 contents for the tempfile that will be used to update an artifact's custom metadata.
+      # If a hash of n3 user urns is provided, the contents will override existing key/value pairs.
+      def generate_n3_urns_from_n3(contents, n3_user_urns={})
+        contents.each_line do |line|
+          if !line.match(/urn:nexus\/user#/).nil?
+            tag, value = parse_n3_item(line)
+            # Delete the nexus key if the local key has no value.
+            if n3_user_urns.has_key?(tag) && value.empty?
+              n3_user_urns.delete(tag)
+            else
+              n3_user_urns[tag] = generate_n3_item(tag, value) unless tag.empty? || value.empty?
+            end
+          end
+        end
+        return n3_user_urns
+      end
+
+      def generate_n3_urns_from_hash(contents, n3_user_urns={})
+        contents.each do |tag, value|
+          # Delete the nexus key if the local key has no value.
+          if n3_user_urns.has_key?(tag) && value.empty?
+            n3_user_urns.delete(tag)
+          else
+            n3_user_urns[tag] = generate_n3_item(tag, value) unless tag.empty? || value.empty?
+          end
+        end
+        return n3_user_urns
+      end
+
+      # Parses a hash of n3 user urns and returns it as an n3-formatted string.
+      def parse_n3_hash(contents)
+        return contents.values.count == 1 ? contents.values[0] + " ." : contents.values.join(" ;\n") + " ."
+      end
+
+      # Returns n3 as XML.
+      def n3_to_xml(n3)
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.send("artifact-resolution") {
+            xml.data {
+              n3.each_line do |line|
+                tag, value = parse_n3_item(line)
+                xml.send(tag, value) unless tag.empty? || value.empty?
+              end
+            }
+          }
+        end
+        return builder.doc.root.to_s
+      end
+
+      private
+      def parse_n3_item(line)
+        tag = line.match(/#(\w*)>/) ? "#{$1}" : ""
+        value = line.match(/"([^"]*)"/)  ? "#{$1}" : ""
+        return tag, value
+      end
+
+      def generate_n3_item(tag, value)
+        return "\t<urn:nexus/user##{tag}> \"#{value}\""
+      end
+    end
+  end
+end

data/lib/nexus_cli/nexus_oss_remote.rb

@@ -31,27 +31,34 @@ module NexusCli
     end
 
     def pull_artifact(artifact, destination)
+      # Using net/http because restclient dies on large files.
       group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      begin
-        fileData = nexus['service/local/artifact/maven/redirect'].get({:params => {:r => configuration['repository'], :g => group_id, :a => artifact_id, :v => version, :e => extension}})
-      rescue RestClient::ResourceNotFound
-        raise ArtifactNotFoundException
-      end
-      if version.casecmp("latest")
-        doc = Nokogiri::XML(get_artifact_info(artifact))
-        version = doc.xpath("//version").first.content()
-      end
+      uri = URI(File.join(configuration["url"], "service/local/artifact/maven/redirect"))
+      params = {:g => group_id, :a => artifact_id, :v => version, :e => extension, :r => configuration["repository"]}.collect {|k,v| "#{k}=#{URI::escape(v.to_s)}"}.join("&")
+      version = Nokogiri::XML(get_artifact_info(artifact)).xpath("//version").first.content() if version.casecmp("latest")
       destination = File.join(File.expand_path(destination || "."), "#{artifact_id}-#{version}.#{extension}")
-      artifact_file = File.open(destination, 'wb')
-      artifact_file.write(fileData)
-      artifact_file.close()
-      File.expand_path(artifact_file.path)
+      Net::HTTP.start(uri.host, uri.port) do |http|
+        request = Net::HTTP::Get.new(URI(http.request_get(uri.request_uri + "?" + params)["location"]).request_uri)
+        request.basic_auth(configuration["username"], configuration["password"])
+        http.request(request) do |response|
+          case response.code.to_i
+          when 404
+            raise ArtifactNotFoundException
+          end
+          artifact_file = File.open(destination, "wb") do |io|
+            response.read_body do |chunk|
+              io.write(chunk)
+            end
+          end
+        end
+      end
+      File.expand_path(destination)
     end
 
     def push_artifact(artifact, file)
       group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      nexus['service/local/artifact/maven/content'].post({:hasPom => false, :g => group_id, :a => artifact_id, :v => version, :e => extension, :p => extension, :r => configuration['repository'],
-      :file => File.new(file)}) do |response|
+      nexus['service/local/artifact/maven/content'].post(:hasPom => false, :g => group_id, :a => artifact_id, :v => version, :e => extension, :p => extension, :r => configuration['repository'],
+      :file => File.new(file)) do |response|
         case response.code
         when 400
           raise BadUploadRequestException
@@ -74,7 +81,7 @@ module NexusCli
     def get_artifact_info(artifact)
       group_id, artifact_id, version, extension = parse_artifact_string(artifact)
       begin
-        nexus['service/local/artifact/maven/resolve'].get({:params => {:r => configuration['repository'], :g => group_id, :a => artifact_id, :v => version, :e => extension}})
+        nexus['service/local/artifact/maven/resolve'].get(:params => {:r => configuration['repository'], :g => group_id, :a => artifact_id, :v => version, :e => extension})
       rescue Errno::ECONNREFUSED => e
         raise CouldNotConnectToNexusException
       rescue RestClient::ResourceNotFound => e
@@ -84,25 +91,30 @@ module NexusCli
 
     def search_for_artifacts(artifact)
       group_id, artifact_id = artifact.split(":")
-      nexus['service/local/data_index'].get({:params => {:g => group_id, :a => artifact_id}}) do |response|
+      nexus['service/local/data_index'].get(:params => {:g => group_id, :a => artifact_id}) do |response|
         doc = Nokogiri::XML(response.body)
         return format_search_results(doc, group_id, artifact_id)
       end
     end
 
     def get_global_settings
-      nexus['service/local/global_settings/current'].get({:accept => "application/json"}) do |response|
-        pretty_json = JSON.pretty_generate(JSON.parse(response.body))
-        destination = File.join(File.expand_path("."), "global_settings.json")
-        artifact_file = File.open(destination, 'wb') do |file|
-          file.write(pretty_json)
-        end
+      json = get_global_settings_json
+      pretty_json = JSON.pretty_generate(JSON.parse(json))
+      Dir.mkdir(File.expand_path("~/.nexus")) unless Dir.exists?(File.expand_path("~/.nexus"))
+      destination = File.join(File.expand_path("~/.nexus"), "global_settings.json")
+      artifact_file = File.open(destination, 'wb') do |file|
+        file.write(pretty_json)
       end
     end
 
-    def upload_global_settings
-      global_settings_file = File.join(File.expand_path("."), "global_settings.json")
-      nexus['service/local/global_settings/current'].put(File.read(global_settings_file), {:content_type => "application/json"}) do |response|
+    def upload_global_settings(json=nil)
+      global_settings = nil
+      if json == nil
+        global_settings = File.read(File.join(File.expand_path("~/.nexus"), "global_settings.json"))
+      else
+        global_settings = json
+      end
+      nexus['service/local/global_settings/current'].put(global_settings, {:content_type => "application/json"}) do |response|
         case response.code
         when 400
           raise BadSettingsException.new(response.body)
@@ -110,9 +122,49 @@ module NexusCli
       end
     end
 
+    def get_global_settings_json
+      nexus['service/local/global_settings/current'].get(:accept => "application/json")
+    end
+
     def reset_global_settings
-      default_json = nexus['service/local/global_settings/default'].get({:accept => "application/json"})
-      nexus['service/local/global_settings/current'].put(default_json, {:content_type => "application/json"})
+      default_json = nexus['service/local/global_settings/default'].get(:accept => "application/json")
+      nexus['service/local/global_settings/current'].put(default_json, :content_type => "application/json")
+    end
+
+    def create_repository(name)
+      nexus['service/local/repositories'].post(create_repository_json(name), :content_type => "application/json") do |response|
+        case response.code
+        when 400
+          raise CreateRepsitoryException.new(response.body)
+        when 201
+          return true
+        else
+          raise UnexpectedStatusCodeException.new(response.code)
+        end
+      end
+    end
+
+    def delete_repository(name)
+      nexus["service/local/repositories/#{name.downcase}"].delete do |response|
+        case response.code
+        when 404
+          raise RepositoryDoesNotExistException
+        when 204
+          return true
+        else
+          raise UnexpectedStatusCodeException.new(response.code)
+        end
+      end
+    end
+
+    def get_repository_info(name)
+      begin
+        nexus["service/local/repositories/#{name.downcase}"].get
+      rescue Errno::ECONNREFUSED => e
+        raise CouldNotConnectToNexusException
+      rescue RestClient::ResourceNotFound => e
+        raise RepositoryNotFoundException
+      end
     end
 
     private
@@ -135,5 +187,22 @@ module NexusCli
       version.upcase! if version.casecmp("latest")
       return group_id, artifact_id, version, extension
     end
+
+    def create_repository_json(name)
+      %{
+        {
+          "data" : {
+            "provider" : "maven2",
+            "providerRole" : "org.sonatype.nexus.proxy.repository.Repository",
+            "exposed" : true,
+            "repoType" : "hosted",
+            "repoPolicy" : "RELEASE",
+            "name" : #{name},
+            "id" : #{name.downcase},
+            "format" : "maven2"
+          }
+        }
+      }
+    end
   end
 end

data/lib/nexus_cli/nexus_pro_remote.rb

@@ -7,31 +7,50 @@ module NexusCli
   class ProRemote < OSSRemote
 
     def get_artifact_custom_info(artifact)
-      parse_n3(get_artifact_custom_info_n3(artifact))
+      return N3Metadata::n3_to_xml(get_artifact_custom_info_n3(artifact))
     end
 
     def get_artifact_custom_info_n3(artifact)
       group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      file_name = "#{artifact_id}-#{version}.#{extension}.n3"
-      get_string = "content/repositories/#{configuration['repository']}/.meta/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}/#{file_name}"
+      get_string = N3Metadata::generate_n3_path(group_id, artifact_id, version, extension, configuration['repository'])
       begin
-        nexus[get_string].get
+        n3 = nexus[get_string].get
+        if !n3.match(/<urn:maven#deleted>/).nil?
+          raise ArtifactNotFoundException
+        else
+          return n3
+        end
       rescue RestClient::ResourceNotFound => e
         raise ArtifactNotFoundException
       end
     end
 
-    def update_artifact_custom_info(artifact, file)
+    def update_artifact_custom_info(artifact, *params)
+      group_id, artifact_id, version, extension = parse_artifact_string(artifact)
+      n3_user_urns = { "n3_header" => N3Metadata::generate_n3_header(group_id, artifact_id, version, extension) }.merge(N3Metadata::generate_n3_urns_from_hash(parse_update_params(*params)))
+
+      n3_temp = Tempfile.new("nexus_n3")
+      begin
+        n3_temp.write(N3Metadata::parse_n3_hash(n3_user_urns))
+        n3_temp.close
+        update_artifact_custom_info_n3(artifact, n3_temp.path)
+      ensure
+        n3_temp.close
+        n3_temp.unlink
+      end
+    end
+
+    def update_artifact_custom_info_n3(artifact, file)
       # Check if artifact exists before posting custom metadata.
       get_artifact_info(artifact)
       # Update the custom metadata using the n3 file.
       group_id, artifact_id, version, extension = parse_artifact_string(artifact)
-      file_name = "#{artifact_id}-#{version}.#{extension}.n3"
-      post_string = "content/repositories/#{configuration['repository']}/.meta/#{group_id.gsub(".", "/")}/#{artifact_id.gsub(".", "/")}/#{version}/#{file_name}"
+      post_string = N3Metadata::generate_n3_path(group_id, artifact_id, version, extension, configuration['repository'])
 
+      # Get all the urn:nexus/user# keys and consolidate.
       # Read in nexus n3 file. If this is a newly-added artifact, there will be no n3 file so escape the exception.
       begin
-        nexus_n3 = get_artifact_custom_info_n3(artifact, overrides)
+        nexus_n3 = get_artifact_custom_info_n3(artifact)
       rescue ArtifactNotFoundException
         nexus_n3 = ""
       end
@@ -39,74 +58,112 @@ module NexusCli
       # Read in local n3 file.
       local_n3 = File.open(file).read
 
-      n3_user_urns = { "head" => "<urn:maven/artifact##{group_id}:#{artifact_id}:#{version}::#{extension}> a <urn:maven#artifact>" }
-      # Get all the urn:nexus/user# keys and consolidate.
-      # First, get the nexus keys.
-      nexus_n3.each_line { |line|
-        if line.match(/urn:nexus\/user#/)
-          tag, value = parse_n3_line(line)
-          n3_user_urns[tag] = "\t<urn:nexus/user##{tag}> \"#{value}\"" unless tag.empty? || value.empty?
-        end
-      }
-      # Next, get the local keys and update the nexus keys.
-      local_n3.each_line { |line|
-        if line.match(/urn:nexus\/user#/)
-          tag, value = parse_n3_line(line)
-          # Delete the nexus key if the local key has no value.
-          if n3_user_urns.has_key?(tag) && value.empty?
-            n3_user_urns.delete(tag)
-          else
-            n3_user_urns[tag] = "\t<urn:nexus/user##{tag}> \"#{value}\"" unless tag.empty? || value.empty?
-          end
-        end
-      }
+      n3_user_urns = { "n3_header" => N3Metadata::generate_n3_header(group_id, artifact_id, version, extension) }
+      # Get the nexus keys.
+      n3_user_urns = N3Metadata::generate_n3_urns_from_n3(nexus_n3, n3_user_urns)
+      # Get the local keys and update the nexus keys.
+      n3_user_urns = N3Metadata::generate_n3_urns_from_n3(local_n3, n3_user_urns)
+      n3_temp = Tempfile.new("nexus_n3")
+      begin
+        n3_temp.write(N3Metadata::parse_n3_hash(n3_user_urns))
+        n3_temp.close
+        nexus[post_string].put({:file => File.new(n3_temp.path)})
+      ensure
+        n3_temp.close
+        n3_temp.unlink
+      end
+    end
 
-      n3_data = n3_user_urns.values.join(" ;\n") + " ."
+    def clear_artifact_custom_info(artifact)
+      get_artifact_info(artifact)
+      group_id, artifact_id, version, extension = parse_artifact_string(artifact)
+      post_string = N3Metadata::generate_n3_path(group_id, artifact_id, version, extension, configuration['repository'])
+      n3_user_urns = { "n3_header" => N3Metadata::generate_n3_header(group_id, artifact_id, version, extension) }
       n3_temp = Tempfile.new("nexus_n3")
       begin
-        n3_temp.write(n3_data)
-        n3_temp.rewind
-        Kernel.quietly {`curl -T #{n3_temp.path} #{File.join(configuration['url'], post_string)} -u #{configuration['username']}:#{configuration['password']}`}
+        n3_temp.write(N3Metadata::parse_n3_hash(n3_user_urns))
+        n3_temp.close
+        nexus[post_string].put({:file => File.new(n3_temp.path)})
       ensure
         n3_temp.close
         n3_temp.unlink
       end
     end
 
-    def search_artifacts(key, type, value)
-      if key.empty? || type.empty? || value.empty?
-        raise SearchParameterMalformedException
+    def search_artifacts(*params)
+      docs = Array.new
+      parse_search_params(*params).each do |param|
+        begin
+          nexus['service/local/search/m2/freeform'].get ({params: {p: param[0], t: param[1], v: param[2]}}) do |response|
+            raise BadSearchRequestException if response.code == 400
+            docs.push(Nokogiri::XML(response.body).xpath("/search-results/data"))
+          end
+        rescue RestClient::ResourceNotFound => e
+          raise ArtifactNotFoundException
+        end
       end
+      result = docs.inject(docs.first) {|memo,doc| get_common_artifact_set(memo, doc)}
+      return result.nil? ? "" : result.to_xml(:indent => 4)
+    end
+
+    private
+    def parse_update_params(*params)
       begin
-        nexus['service/local/search/m2/freeform'].get ({params: {p: key, t: type, v: value}}) do |response, request, result, &block|
-          raise BadSearchRequestException if response.code == 400
-          doc = Nokogiri::XML(response.body).xpath("/search-results")
-          return doc.xpath("count")[0].text.to_i > 0 ? doc.to_s : "No search results."
+        parsed_params = Hash.new
+        params.each do |param|
+          # The first colon separates key and value.
+          c1 = param.index(":")
+          key = param[0..(c1 - 1)]
+          value = param[(c1 + 1)..-1]
+          !c1.nil? && N3Metadata::valid_n3_key?(key) && N3Metadata::valid_n3_value?(value) ? parsed_params[key] = value : raise
         end
-      rescue RestClient::ResourceNotFound => e
-        raise ArtifactNotFoundException
+        return parsed_params
+      rescue
+        raise N3ParameterMalformedException
       end
     end
 
-    private
-    def parse_n3(data)
-      builder = Nokogiri::XML::Builder.new do |xml|
-        xml.send("artifact-resolution") {
-          xml.data {
-            data.each_line { |line|
-              tag, value = parse_n3_line(line)
-              xml.send(tag, value) unless tag.empty? || value.empty?
-            }
-          }
-        }
+    def parse_search_params(*params)
+      begin
+        parsed_params = Array.new
+        params.each do |param|
+          # The first two colons separate key, type, and value.
+          c1 = param.index(":")
+          c2 = param.index(":", (c1 + 1))
+          key = param[0..(c1 - 1)]
+          type = param[(c1 + 1)..(c2 - 1)]
+          value = param[(c2 + 1)..-1]
+          !c1.nil? && !c2.nil? && N3Metadata::valid_n3_key?(key) && N3Metadata::valid_n3_value?(value) && N3Metadata::valid_n3_search_type?(type) ? parsed_params.push([key, type, value]) : raise
+        end
+        return parsed_params
+      rescue
+        raise SearchParameterMalformedException
       end
-      return builder.doc.root.to_s
     end
 
-    def parse_n3_line(line)
-      tag = line.match(/#(\w*)>/) ? "#{$1}" : ""
-      value = line.match(/"([^"]*)"/)  ? "#{$1}" : ""
-      return tag, value
+    # Expects the XML set with `data` as root.
+    def get_common_artifact_set(set1, set2)
+      intersection = get_artifact_array(set1) & get_artifact_array(set2)
+      return intersection.count > 0 ? Nokogiri::XML("<data>#{intersection.join}</data>").root : Nokogiri::XML("").root
+    end
+
+    # Collect <artifact>...</artifact> elements into an array.
+    # This will allow use of array intersection to find common artifacts in searches.
+    def get_artifact_array(set)
+      artifacts = Array.new
+      artifact = nil
+      set.to_s.split("\n").collect {|x| x.to_s.strip}.each do |piece|
+        if piece == "<artifact>"
+          artifact = piece
+        elsif piece == "</artifact>"
+          artifact += piece
+          artifacts.push(artifact)
+          artifact = nil
+        elsif !artifact.nil?
+          artifact += piece
+        end
+      end
+      return artifacts
     end
   end
 end

data/lib/nexus_cli/nexus_remote_factory.rb

@@ -32,9 +32,9 @@ module NexusCli
       end
 
       private
-        def running_nexus_pro?
-          return status['edition_long'] == "Professional" ? true : false
-        end
+      def running_nexus_pro?
+        return status['edition_long'] == "Professional" ? true : false
+      end
     end
   end
-end
+end

data/lib/nexus_cli/tasks.rb

@@ -6,13 +6,15 @@ module NexusCli
       base.send :include, ::Thor::Actions
       base.class_eval do
 
-        map 'pull'   => :pull_artifact
-        map 'push'   => :push_artifact
-        map 'info'   => :get_artifact_info
-        map 'custom' => :get_artifact_custom_info
-        map 'config' => :get_nexus_configuration
-        map 'status' => :get_nexus_status
-        map 'search' => :search_for_artifacts
+        map 'pull'          => :pull_artifact
+        map 'push'          => :push_artifact
+        map 'info'          => :get_artifact_info
+        map 'custom'        => :get_artifact_custom_info
+        map 'custom_raw'    => :get_artifact_custom_info_n3
+        map 'config'        => :get_nexus_configuration
+        map 'status'        => :get_nexus_status
+        map 'search'        => :search_for_artifacts
+        map 'search_custom' => :search_artifacts
 
         class_option :overrides,
           :type => :hash,
@@ -29,7 +31,7 @@ module NexusCli
           end
         end
 
-        method_option :destination, 
+        method_option :destination,
           :type => :string,
           :default => nil,
           :desc => "A different folder other than the current working directory."
@@ -61,22 +63,36 @@ module NexusCli
         end
 
         desc "get_artifact_custom_info_n3 artifact", "Gets and returns the custom metadata in Nexus n3 format about a particular artifact."
-        def get_artifact_custom_info_n3(artifact)          
+        def get_artifact_custom_info_n3(artifact)
           raise NotNexusProException unless @nexus_remote.kind_of? ProRemote
           say @nexus_remote.get_artifact_custom_info_n3(artifact), :green
         end
 
-        desc "update_artifact_custom_info artifact file", "Updates the artifact custom metadata by pushing the Nexus custom artifact file (n3) from your machine onto the Nexus."
-        def update_artifact_custom_info(artifact, file)
+        desc "update_artifact_custom_info artifact param1 param2 ...", "Updates the artifact custom metadata with the given key-value pairs."
+        def update_artifact_custom_info(artifact, *params)
           raise NotNexusProException unless @nexus_remote.kind_of? ProRemote
-          @nexus_remote.update_artifact_custom_info(artifact, file)
+          @nexus_remote.update_artifact_custom_info(artifact, *params)
           say "Custom metadata for artifact #{artifact} has been successfully pushed to Nexus.", :green
         end
 
-        desc "search_artifacts key type value", "Searches for artifacts using artifact metadata and returns the result as a list with items in XML format."
-        def search_artifacts(key, type, value)
+        desc "update_artifact_custom_info_n3 artifact file", "Updates the artifact custom metadata by pushing the Nexus custom artifact file (n3) from your machine onto the Nexus."
+        def update_artifact_custom_info_n3(artifact, file)
           raise NotNexusProException unless @nexus_remote.kind_of? ProRemote
-          say @nexus_remote.search_artifacts(key, type, value), :green
+          @nexus_remote.update_artifact_custom_info_n3(artifact, file)
+          say "Custom metadata for artifact #{artifact} has been successfully pushed to Nexus.", :green
+        end
+
+        desc "clear_artifact_custom_info artifact", "Clears the artifact custom metadata."
+        def clear_artifact_custom_info(artifact)
+          raise NotNexusProException unless @nexus_remote.kind_of? ProRemote
+          @nexus_remote.clear_artifact_custom_info(artifact)
+          say "Custom metadata for artifact #{artifact} has been successfully cleared.", :green
+        end
+
+        desc "search_artifacts param1 param2 ... ", "Searches for artifacts using artifact metadata and returns the result as a list with items in XML format."
+        def search_artifacts(*params)
+          raise NotNexusProException unless @nexus_remote.kind_of? ProRemote
+          say (s = @nexus_remote.search_artifacts(*params)) == "" ? "No search results." : s, :green
         end
 
         desc "get_nexus_configuration", "Prints out configuration from the .nexus_cli file that helps inform where artifacts will be uploaded."
@@ -102,12 +118,16 @@ module NexusCli
         desc "get_global_settings", "Prints out your Nexus' current setttings and saves them to a file."
         def get_global_settings
           @nexus_remote.get_global_settings
-          say "Your current Nexus global settings have been written to the file: global_settings.json", :blue
+          say "Your current Nexus global settings have been written to the file: ~/.nexus/global_settings.json", :blue
         end
 
+        method_option :json, 
+          :type => :string,
+          :default => nil,
+          :desc => "A String of the JSON you wish to upload."
         desc "upload_global_settings", "Uploads a global_settings.json file to your Nexus to update its settings."
         def upload_global_settings
-          @nexus_remote.upload_global_settings
+          @nexus_remote.upload_global_settings(options[:json])
           say "Your global_settings.json file has been uploaded to Nexus", :blue
         end
 
@@ -116,7 +136,26 @@ module NexusCli
           @nexus_remote.reset_global_settings
           say "Your Nexus global settings have been reset to their default values", :blue
         end
+
+        desc "create_repository name", "Creates a new Repository with the provided name."
+        def create_repository(name)
+          if @nexus_remote.create_repository(name)
+            say "A new Repository named #{name} has been created.", :blue
+          end
+        end
+
+        desc "delete_repository name", "Deletes a Repository with the provided name."
+        def delete_repository(name)
+          if @nexus_remote.delete_repository(name)
+            say "The Repository named #{name} has been deleted.", :blue
+          end
+        end
+
+        desc "get_repository_info name", "Finds and returns information about the provided Repository."
+        def get_repository_info(name)
+          say @nexus_remote.get_repository_info(name), :green
+        end
       end
     end
   end
-end
+end

data/nexus_cli.gemspec

@@ -26,4 +26,5 @@ Gem::Specification.new do |s|
   s.add_development_dependency 'aruba'
   s.add_development_dependency 'cucumber'
   s.add_development_dependency 'rake'
+  s.add_development_dependency 'jsonpath'
 end

data/pro/nexus_pro.feature

@@ -0,0 +1,110 @@
+Feature: Use the Nexus Pro CLI
+	As a Pro CLI user
+	I need commands to get, update, search, and delete Nexus artifact custom metadata
+
+	Scenario: Get Nexus Pro Status
+		When I call the nexus "status" command
+		Then the output should contain:
+			"""
+			Application Name: Sonatype Nexus Professional
+			"""
+		And the exit status should be 0
+
+  @push
+  Scenario: Push an artifact
+    When I push an artifact with the GAV of "com.test:myprotest:1.0.0:tgz"
+    Then the output should contain:
+	    """
+	    Artifact com.test:myprotest:1.0.0:tgz 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 teemoHat:equipped" command
+		Then the output should contain:
+			"""
+			Custom metadata for artifact com.test:myprotest:1.0.0:tgz 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 teemoHat:equipped_ \"teemoSkins:many skins!!1\"" command
+		Then the output should contain:
+			"""
+			Custom metadata for artifact com.test:myprotest:1.0.0:tgz 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
+		Then the output should contain:
+			"""
+			<teemoHat>equipped_</teemoHat>
+			"""
+		And the output should contain:
+			"""
+			<teemoSkins>many skins!!1</teemoSkins>
+			"""
+		And the exit status should be 0
+
+	Scenario: Get an artifact's raw custom metadata
+		When I call the nexus "custom_raw com.test:myprotest:1.0.0:tgz" command
+		Then the output should contain:
+			"""
+			<urn:nexus/user#teemoHat> "equipped_"
+			"""
+		And the output should contain:
+			"""
+			<urn:nexus/user#teemoSkins> "many skins!!1"
+			"""
+		And the exit status should be 0
+
+	Scenario: Search for artifacts by custom metadata using matches
+		When I call the nexus "search_custom teemoHat:matches:equip*" command
+		Then the output should contain:
+			"""
+			<artifactId>myprotest</artifactId>
+			"""
+		And the exit status should be 0
+
+	Scenario: Search for artifacts by custom metadata using equal
+		When I call the nexus "search_custom teemoHat:equal:equipped_" command
+		Then the output should contain:
+			"""
+			<artifactId>myprotest</artifactId>
+			"""
+		And the exit status should be 0
+
+	Scenario: Search for artifacts by custom metadata using multiple parameters
+		When I call the nexus "search_custom teemoHat:matches:equip* teemoHat:equal:equipped_" command
+		Then the output should contain:
+			"""
+			<artifactId>myprotest</artifactId>
+			"""
+		And the exit status should be 0
+
+	Scenario: Search for artifacts by custom metadata that return an empty result set
+		When I call the nexus "search_custom bestTeemo:equal:malady" command
+		Then the output should contain:
+			"""
+			No search results.
+			"""
+		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
+		Then the output should contain:
+			"""
+			Custom metadata for artifact com.test:myprotest:1.0.0:tgz 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
+    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

data/spec/pro_remote_spec.rb

@@ -0,0 +1,43 @@
+require 'nexus_cli'
+
+remote = NexusCli::ProRemote.new(nil)
+
+describe NexusCli do
+  it "gives you errors when you attempt to get an artifact's custom info and don't give a valid artifact name" do
+    expect {remote.get_artifact_custom_info("com.something:something:1.0.0")}.to raise_error(NexusCli::ArtifactMalformedException)
+  end
+
+  it "gives you errors when you attempt to get an artifact's custom info and it cannot be found" do
+    RestClient::Resource.any_instance.stub(:get).and_raise(RestClient::ResourceNotFound)
+    expect {remote.get_artifact_custom_info("com.something:something:1.0.0:tgz")}.to raise_error(NexusCli::ArtifactNotFoundException)
+  end
+
+  it "gives you errors when you attempt to update an artifact's custom info and don't give valid parameters" do
+    expect {remote.update_artifact_custom_info("com.something:something:1.0.0:tgz", "_somebadkey:_somebadvalue")}.to raise_error(NexusCli::N3ParameterMalformedException)
+  end
+
+  it "gives you errors when you attempt to update an artifact's custom info and don't give valid parameters" do
+    expect {remote.update_artifact_custom_info("com.something:something:1.0.0:tgz", "_somebadkey")}.to raise_error(NexusCli::N3ParameterMalformedException)
+  end
+
+  it "gives you errors when you attempt to clear an artifact's custom info and it cannot be found" do
+    RestClient::Resource.any_instance.stub(:get).and_raise(RestClient::ResourceNotFound)
+    expect {remote.clear_artifact_custom_info("com.something:something:1.0.0:tgz")}.to raise_error(NexusCli::ArtifactNotFoundException)
+  end
+
+  it "gives you errors when you attempt to search for artifacts using custom info and don't give valid key" do
+    expect {remote.search_artifacts("somekey_:equal:somevalue")}.to raise_error(NexusCli::SearchParameterMalformedException)
+  end
+
+  it "gives you errors when you attempt to search for artifacts using custom info and don't give valid value" do
+    expect {remote.search_artifacts("somekey:equal:somevalue \"\'\\/")}.to raise_error(NexusCli::SearchParameterMalformedException)
+  end
+
+  it "gives you errors when you attempt to search for artifacts using custom info and don't give valid search type" do
+    expect {remote.search_artifacts("somekey:equals:somevalue")}.to raise_error(NexusCli::SearchParameterMalformedException)
+  end
+
+  it "gives you errors when you attempt to search for artifacts using custom info and don't give valid parameters" do
+    expect {remote.search_artifacts("somekey")}.to raise_error(NexusCli::SearchParameterMalformedException)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nexus_cli
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-10 00:00:00.000000000 Z
+date: 2012-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -155,6 +155,22 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: jsonpath
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A command-line wrapper for making REST calls to Sonatype Nexus.
 email:
 - kallan@riotgames.com
@@ -178,14 +194,17 @@ files:
 - lib/nexus_cli/configuration.rb
 - lib/nexus_cli/errors.rb
 - lib/nexus_cli/kernel.rb
+- lib/nexus_cli/n3_metadata.rb
 - lib/nexus_cli/nexus_oss_remote.rb
 - lib/nexus_cli/nexus_pro_remote.rb
 - lib/nexus_cli/nexus_remote_factory.rb
 - lib/nexus_cli/tasks.rb
 - lib/nexus_cli/version.rb
 - nexus_cli.gemspec
+- pro/nexus_pro.feature
 - spec/configuration_spec.rb
 - spec/oss_remote_spec.rb
+- spec/pro_remote_spec.rb
 homepage: https://github.com/RiotGames/nexus_cli
 licenses: []
 post_install_message: 
@@ -200,7 +219,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -589331205850929008
+      hash: 2849503457088068545
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -209,7 +228,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -589331205850929008
+      hash: 2849503457088068545
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.21
@@ -222,3 +241,4 @@ test_files:
 - features/support/env.rb
 - spec/configuration_spec.rb
 - spec/oss_remote_spec.rb
+- spec/pro_remote_spec.rb