artrest 0.0.1

data/spec/artrest/repositories_spec.rb

@@ -0,0 +1,47 @@
+require File.expand_path("../../spec_helper", __FILE__)
+
+describe ArtRest::Repositories do
+
+    before(:each) do
+        @repos_url = "#{ARTIFACTORY_URL}/api/repositories"
+        @artrepos = ArtRest::Repositories.new(@repos_url, OPTIONS)
+        register_stub_request('./repositories/repositories_response.txt', "api/repositories")
+    end
+
+    describe "::get" do
+        it "should return an ArtRest::Repositories instance" do
+            repositories = ArtRest::Repositories.get(ARTIFACTORY_URL, OPTIONS)
+            repositories.should be_an_instance_of ArtRest::Repositories
+        end
+    end
+
+    describe "#each" do
+        it "should iterate over all repositories" do
+            expected_number_of_repos = 24
+            actual_number_of_repos = 0
+            @artrepos.each do |repo|
+                actual_number_of_repos += 1 
+            end
+            actual_number_of_repos.should equal expected_number_of_repos
+        end
+
+        it "should should return each repo as an ArtRest:Repository instance" do
+            @artrepos.each do |repo|
+                repo.should be_an_instance_of ArtRest::Repository 
+            end
+        end
+    end
+
+    describe "#repository" do
+
+        before(:each) do
+            @repo_name = 'libs-snapshot-local'
+            register_stub_request('./repositories/libs_snapshot_local_folder_response.txt', "api/storage/#{@repo_name}/")
+        end
+
+        it "should return requested repository as an ArtRest::Repository instance" do
+            repo = @artrepos.repository(@repo_name)
+            repo.should be_an_instance_of ArtRest::Repository
+        end
+    end
+end

data/spec/artrest/repository_spec.rb

@@ -0,0 +1,63 @@
+require File.expand_path("../../spec_helper", __FILE__)
+
+describe ArtRest::Repository do
+
+    before(:each) do
+        @repo_name  = 'libs-snapshot-local'
+        @repo_url   = "#{ARTIFACTORY_URL}/api/storage/#{@repo_name}"
+        @artrepo    = ArtRest::Repository.new(@repo_url, OPTIONS)
+        register_stub_request('./repository/libs_snapshot_local_response.txt', "api/storage/#{@repo_name}")
+    end
+
+    describe "#each" do
+        it "should iterate over all folders" do
+            expected_number_of_folders = 1
+            actual_number_of_folders = 0
+            @artrepo.each do |folder|
+                actual_number_of_folders += 1 
+            end
+            actual_number_of_folders.should equal expected_number_of_folders
+        end
+
+        it "should return each folder as an instance of ArtRest::Folder" do
+            @artrepo.each do |folder|
+                folder.should be_an_instance_of ArtRest::Folder
+            end
+        end
+    end
+
+    describe "[all resource attributes]" do
+
+        before(:each) do
+            @resource_attributes = [:path,
+                                    :lastUpdated,
+                                    :repo,
+                                    :uri,
+                                    :modifiedBy,
+                                    :created,
+                                    :createdBy,
+                                    :lastModified,
+                                    :metadataUri,
+                                    :children]
+        end
+
+        context "when no block given" do
+            it "should return a non-nil value" do
+                @resource_attributes.each do |attr|
+                    value = @artrepo.send(attr)
+                    value.should_not be_nil
+                end
+            end
+        end
+
+        context "when block given" do
+            it "should yield a non-nil value to that block" do
+                @resource_attributes.each do |attr|
+                    @artrepo.send(attr) do |value|
+                        value.should_not be_nil
+                    end
+                end
+            end
+        end
+    end
+end

data/spec/artrest/resource_spec.rb

@@ -0,0 +1,385 @@
+require File.expand_path("../../spec_helper", __FILE__)
+
+describe ArtRest::Resource do
+
+    describe "::create" do
+        before(:each) do
+            @system_url = "#{ARTIFACTORY_URL}/api/system"
+            register_stub_request('./resource/system_response.txt', "api/system")
+
+            @system_config_url = "#{ARTIFACTORY_URL}/api/system/configuration"
+            register_stub_request('./resource/system_general_configuration_response.txt', "api/system/configuration")
+
+            @builds_url = "#{ARTIFACTORY_URL}/api/build"
+            register_stub_request('./resource/builds_response.txt', "api/build")
+
+            @build_url = "#{ARTIFACTORY_URL}/api/build/vnet.sms.common.shell"
+            register_stub_request('./resource/build_response.txt', "api/build/vnet.sms.common.shell")
+
+            @buildnumber_url = "#{ARTIFACTORY_URL}/api/build/vnet.sms.common.shell/25"
+            register_stub_request('./resource/buildnumber_response.txt', "api/build/vnet.sms.common.shell/25")
+
+            @repositories_url = "#{ARTIFACTORY_URL}/api/repositories"
+            register_stub_request('./resource/repositories_response.txt', "api/repositories")
+
+            @repository_url = "#{ARTIFACTORY_URL}/api/storage/libs-snapshot-local"
+            register_stub_request('./resource/repository_response.txt', "api/storage/libs-snapshot-local")
+
+            @folder_url = "#{ARTIFACTORY_URL}/api/storage/ext-snapshot-local/vnet/sms/infrastructure/rpm-elasticsearch/1.0.0-SNAPSHOT"
+            register_stub_request('./resource/folder_response.txt', 
+                                  'api/storage/ext-snapshot-local/vnet/sms/infrastructure/rpm-elasticsearch/1.0.0-SNAPSHOT')
+
+            @artifact_url = "#{ARTIFACTORY_URL}/api/storage/ext-snapshot-local/vnet/sms/infrastructure/rpm-elasticsearch/1.0.0-SNAPSHOT//rpm-elasticsearch-1.0.0-20120411.155423-1.pom"
+            register_stub_request('./resource/artifact_response.txt', 
+                                  'api/storage/ext-snapshot-local/vnet/sms/infrastructure/rpm-elasticsearch/1.0.0-SNAPSHOT//rpm-elasticsearch-1.0.0-20120411.155423-1.pom')
+        end
+
+        context "given a system resource URL" do
+            it "should create an ArtRest::System instance" do
+                instance = ArtRest::Resource.create("#{@system_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::System
+            end
+        end
+
+        context "given a system general configuration resource URL" do
+            it "should create an ArtRest::System::GeneralConfiguration instance" do
+                instance = ArtRest::Resource.create("#{@system_config_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::System::GeneralConfiguration
+            end
+        end
+
+        context "given a builds resource URL" do
+            it "should create an ArtRest::Builds instance" do
+                instance = ArtRest::Resource.create("#{@builds_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Builds
+            end
+        end
+
+        context "given a build resource URL" do
+            it "should create an ArtRest::Build instance" do
+                instance = ArtRest::Resource.create("#{@build_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Build
+            end
+        end
+
+        context "given a buildnumber resource URL" do
+            it "should create an ArtRest::Buildnumber instance" do
+                instance = ArtRest::Resource.create("#{@buildnumber_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Buildnumber
+            end
+        end
+
+        context "given a repositories resource URL" do
+            it "should create an ArtRest::Repositories instance" do
+                instance = ArtRest::Resource.create("#{@repositories_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Repositories
+            end
+        end
+
+        context "given a repository resource URL" do
+            it "should create an ArtRest::Repository instance" do
+                instance = ArtRest::Resource.create("#{@repository_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Repository
+            end
+        end
+
+        context "given a folder resource URL" do
+            it "should create an ArtRest::Folder instance" do
+                instance = ArtRest::Resource.create("#{@folder_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Folder
+            end
+        end
+
+        context "given an artifact resource URL" do
+            it "should create an ArtRest::Artifact instance" do
+                instance = ArtRest::Resource.create("#{@artifact_url}?foo=bar", OPTIONS)
+                instance.should be_an_instance_of ArtRest::Artifact
+            end
+        end
+    end
+
+    describe "#base_url" do
+        it "should correctly expose the 'base_url' property" do
+            resource = ArtRest::Resource.new("#{ARTIFACTORY_URL}/api/resource", OPTIONS)
+            base_url = resource.base_url
+            base_url.should_not be_nil
+            base_url.should eq ARTIFACTORY_URL
+        end
+    end
+
+    describe "#content" do
+        before(:each) do
+            @string_url = "#{ARTIFACTORY_URL}/api/string"
+            @string_res  = StringResourceSample.new(@string_url, OPTIONS)
+            register_stub_request('./resource/string_response.txt', "api/string")
+
+            @json_url = "#{ARTIFACTORY_URL}/api/json"
+            @json_res  = JsonResourceSample.new(@json_url, OPTIONS)
+            register_stub_request('./resource/json_response.txt', "api/json")
+        end
+
+        context "when dealing with plain text content" do
+            it "should return content as string" do
+                content = @string_res.content
+                content.should be_an_instance_of String
+            end
+        end
+
+        context "when dealing with json content" do
+            it "should return content as ruby hash" do
+                content = @json_res.content
+                content.should be_an_instance_of Hash
+            end
+        end
+
+        context "when passing in a block" do
+            it "should pass content on to a given block" do
+                @string_res.content do |content|
+                    content.should be_an_instance_of String
+                end
+            end
+
+            it "should return self" do
+                return_value = @string_res.content do |content|
+                    # Intentionally left blank
+                end
+                return_value.should be @string_res
+            end
+        end
+
+        context "given a non-existing resource URL" do
+            before(:each) do
+                @non_existing_res_url = "#{ARTIFACTORY_URL}/api/does-not-exist"
+                @non_existing_res     = JsonResourceSample.new(@non_existing_res_url, OPTIONS)
+                register_stub_request('./resource/repository_not_found_response.txt', "api/does-not-exist")
+            end
+
+            it "should raise RestClient::ResourceNotFound" do
+                expect { @non_existing_res.content }.to raise_error RestClient::ResourceNotFound
+            end
+        end
+
+        context "given invalid credentials" do
+            before(:each) do
+                @unauthorized_res_url = "#{ARTIFACTORY_URL}/api/unauthorized"
+                @invalid_options      = OPTIONS.merge({ :password => 'wrong' })
+                @unauthorized_res     = JsonResourceSample.new(@unauthorized_res_url, @invalid_options)
+                register_stub_request('./resource/repository_unauthorized_response.txt', "api/unauthorized", "wrong")
+            end
+
+            it "should raise RestClient::Unauthorized" do
+                expect { @unauthorized_res.content }.to raise_error RestClient::Unauthorized
+            end
+        end
+    end
+
+    describe "#content=" do
+        before(:each) do
+            @string_url = "#{ARTIFACTORY_URL}/api/string"
+            @string_res  = StringResourceSample.new(@string_url, OPTIONS)
+            register_stub_request('./resource/string_response.txt', "api/string")
+
+            @json_url = "#{ARTIFACTORY_URL}/api/json"
+            @json_res  = JsonResourceSample.new(@json_url, OPTIONS)
+            register_stub_request('./resource/json_response.txt', "api/json")
+        end
+
+        context "when dealing with a string resource" do
+            it "should accept a string as is" do
+                new_content = "NEW"
+                @string_res.content = new_content
+                @string_res.content.should == new_content
+            end
+
+            it "should convert a hash into a string" do
+                new_content = { :content => "NEW" }
+                @string_res.content = new_content
+                @string_res.content.should == new_content.to_s
+            end
+        end
+
+        context "when dealing with a json resource" do
+            it "should accept a hash as is" do
+                new_content = { :content => "NEW" }
+                @json_res.content = new_content
+                @json_res.content.should == new_content
+            end
+
+            it "should parse a json hash into a ruby hash" do
+                new_content = "{ \"json\": 1 }"
+                @json_res.content = new_content
+                @json_res.content.should == JSON.parse(new_content)
+            end
+
+            it "should reject content that is neither a ruby hash nor a json hash with an ArgumentError" do
+                new_content = MIME::Types['text/plain']
+                expect { @json_res.content = new_content }.to raise_error ArgumentError
+            end
+        end
+    end
+
+    describe "#content!" do
+        before(:each) do
+            @string_url = "#{ARTIFACTORY_URL}/api/string"
+            @string_res  = StringResourceSample.new(@string_url, OPTIONS)
+            register_stub_request('./resource/string_response.txt', "api/string")
+        end
+
+        context "when passing in a block" do
+            it "should pass content on to a given block" do
+                @string_res.content! do |content|
+                    content.should be_an_instance_of String
+                end
+            end
+
+            it "should return self" do
+                return_value = @string_res.content! do |content|
+                    # Intentionally left blank
+                end
+                return_value.should be @string_res
+            end
+        end
+
+        context "when passing in a block returning a value" do
+            it "should accept that value as our resource's new content" do
+                new_value = "NEW"
+                @string_res.content! do |content|
+                    new_value
+                end
+                @string_res.content.should == new_value
+            end
+        end
+
+        context "given a non-existing resource URL" do
+            before(:each) do
+                @non_existing_res_url = "#{ARTIFACTORY_URL}/api/does-not-exist"
+                @non_existing_res     = JsonResourceSample.new(@non_existing_res_url, OPTIONS)
+                register_stub_request('./resource/repository_not_found_response.txt', "api/does-not-exist")
+            end
+
+            it "should raise RestClient::ResourceNotFound" do
+                expect { @non_existing_res.content! { |content| } }.to raise_error RestClient::ResourceNotFound
+            end
+        end
+
+        context "given invalid credentials" do
+            before(:each) do
+                @unauthorized_res_url = "#{ARTIFACTORY_URL}/api/unauthorized"
+                @invalid_options      = OPTIONS.merge({ :password => 'wrong' })
+                @unauthorized_res     = JsonResourceSample.new(@unauthorized_res_url, @invalid_options)
+                register_stub_request('./resource/repository_unauthorized_response.txt', "api/unauthorized", "wrong")
+            end
+
+            it "should raise RestClient::Unauthorized" do
+                expect { @unauthorized_res.content! { |content| } }.to raise_error RestClient::Unauthorized
+            end
+        end
+    end
+
+    describe "#unparsed_content" do
+        before(:each) do
+            class ArtRest::Resource
+                public :unparsed_content
+            end
+            @string_url = "#{ARTIFACTORY_URL}/api/string"
+            @string_res  = StringResourceSample.new(@string_url, OPTIONS)
+            register_stub_request('./resource/string_response.txt', "api/string")
+
+            @json_url = "#{ARTIFACTORY_URL}/api/json"
+            @json_res  = JsonResourceSample.new(@json_url, OPTIONS)
+            register_stub_request('./resource/json_response.txt', "api/json")
+        end
+
+        after(:each) do
+            class ArtRest::Resource
+                protected :unparsed_content
+            end
+        end
+
+        context "when dealing with plain text content" do
+            it "should return content as string" do
+                unparsed_content = @string_res.unparsed_content
+                unparsed_content.should be_an_instance_of String
+            end
+        end
+
+        context "when dealing with json content" do
+            it "should return content as string " do
+                unparsed_content = @json_res.unparsed_content
+                unparsed_content.should be_an_instance_of String
+            end
+        end
+
+        context "given a non-existing resource URL" do
+            before(:each) do
+                @non_existing_res_url = "#{ARTIFACTORY_URL}/api/does-not-exist"
+                @non_existing_res     = JsonResourceSample.new(@non_existing_res_url, OPTIONS)
+                register_stub_request('./resource/repository_not_found_response.txt', "api/does-not-exist")
+            end
+
+            it "should raise RestClient::ResourceNotFound" do
+                expect { @non_existing_res.unparsed_content }.to raise_error RestClient::ResourceNotFound
+            end
+        end
+
+        context "given invalid credentials" do
+            before(:each) do
+                @unauthorized_res_url = "#{ARTIFACTORY_URL}/api/unauthorized"
+                @invalid_options      = OPTIONS.merge({ :password => 'wrong' })
+                @unauthorized_res     = JsonResourceSample.new(@unauthorized_res_url, @invalid_options)
+                register_stub_request('./resource/repository_unauthorized_response.txt', "api/unauthorized", "wrong")
+            end
+
+            it "should raise RestClient::Unauthorized" do
+                expect { @unauthorized_res.unparsed_content }.to raise_error RestClient::Unauthorized
+            end
+        end
+    end
+
+    describe "#[]" do
+        before(:each) do
+            @json_url = "#{ARTIFACTORY_URL}/api/json"
+            @json_res  = JsonResourceSample.new(@json_url, OPTIONS)
+            register_stub_request('./resource/sub_response.txt', "api/json/sub")
+        end
+
+        it "should return sub resource of appropriate type" do
+            sub_resource = @json_res['/sub']
+            sub_resource.should_not be_nil
+            sub_resource.should be_an_instance_of SubResourceSample
+        end
+    end
+end
+
+class StringResourceSample < ArtRest::Resource
+
+    self.mime_type = MIME::Types['text/plain']
+
+    class << self
+        def matches_path(path, options)
+            path =~ /^\/api\/string$/
+        end
+    end
+end
+
+class JsonResourceSample < ArtRest::Resource
+
+    self.mime_type = MIME::Types['application/json']
+
+    class << self
+        def matches_path(path, options)
+            path =~ /^\/api\/json$/
+        end
+    end
+end
+
+class SubResourceSample < ArtRest::Resource
+
+    self.mime_type = MIME::Types['text/plain']
+
+    class << self
+        def matches_path(path, options)
+            path =~ /^\/api\/json\/sub.*/
+        end
+    end
+end