azure-plus 0.6.5

data/test/integration/table/informative_errors_test.rb

@@ -0,0 +1,39 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "integration/test_helper"
+require "azure/table/table_service"
+require "azure/core/http/http_error"
+
+describe Azure::Table::TableService do
+  describe "#informative_errors_table" do
+    subject { Azure::Table::TableService.new }
+    let(:table_name){ TableNameHelper.name }
+    after { TableNameHelper.clean }
+
+    it "exception message should be valid" do
+      subject.create_table(table_name)
+      
+      # creating the same table again should throw
+      begin 
+        subject.create_table(table_name)
+        flunk "No exception"
+      rescue Azure::Core::Http::HTTPError => error
+        error.status_code.must_equal 409
+        error.type.must_equal "TableAlreadyExists"
+        error.description.start_with?("The table specified already exists.").must_equal true
+      end
+    end
+  end
+end

data/test/integration/table/insert_entity_batch_test.rb

@@ -0,0 +1,100 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "integration/test_helper"
+require "azure/table/batch"
+require "azure/table/table_service"
+require "azure/core/http/http_error"
+
+describe Azure::Table::TableService do
+  describe "#insert_entity_batch" do
+    subject { Azure::Table::TableService.new }
+    let(:table_name){ TableNameHelper.name }
+
+    let(:entity_properties) {
+      { 
+        "PartitionKey" => "testingpartition",
+        "RowKey" => "abcd123",
+        "CustomDoubleProperty" => 3.141592,
+        "CustomInt32Property" => 37,
+        "CustomInt64Property" => 2**32,
+        "CustomInt64NegProperty" => -(2**32),
+        "CustomGUIDProperty" => Azure::Table::GUID.new("81425519-6394-43e4-ac6e-28d91f5c3921"),
+        "CustomStringProperty" => "CustomPropertyValue",
+        "CustomBinaryProperty" => "\x01\x02\x03".force_encoding("BINARY"),
+        "CustomDateProperty" => Time.now,
+        "CustomDatePrecisionProperty" => Time.at(946684800, 123456.7),
+        "CustomIntegerProperty" => 37,
+        "CustomTrueProperty" => true,
+        "CustomFalseProperty" => false,
+        "CustomNilProperty" => nil
+      }
+    }
+
+    before { 
+      subject.create_table table_name
+    }
+    after { TableNameHelper.clean }
+
+    it "creates an entity" do 
+      batch = Azure::Table::Batch.new table_name, entity_properties["PartitionKey"]
+      batch.insert entity_properties["RowKey"], entity_properties
+      results = subject.execute_batch batch
+
+      results[0].must_be_kind_of Azure::Table::Entity
+      results[0].table.must_equal table_name
+      entity_properties.each { |k,v|
+        if entity_properties[k].class == Time
+          floor_to(results[0].properties[k].to_f, 6).must_equal floor_to(entity_properties[k].to_f, 6)
+        else
+          results[0].properties[k].must_equal entity_properties[k]
+        end
+      }
+    end
+
+    def floor_to(num, x)
+      (num * 10**x).floor.to_f / 10**x
+    end
+
+    it "errors on an invalid table name" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        batch = Azure::Table::Batch.new "this_table.cannot-exist!", entity_properties["PartitionKey"]
+        batch.insert entity_properties["RowKey"], entity_properties
+        results = subject.execute_batch batch
+      end
+    end
+
+    it "errors on an invalid partition key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["PartitionKey"] = "this/partition\\key#is?invalid"
+
+        batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+        batch.insert entity["RowKey"], entity
+        results = subject.execute_batch batch
+      end
+    end
+
+    it "errors on an invalid row key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "this/row\\key#is?invalid"
+
+        batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+        batch.insert entity["RowKey"], entity
+        results = subject.execute_batch batch
+      end
+    end
+  end
+end

data/test/integration/table/insert_entity_test.rb

@@ -0,0 +1,88 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "integration/test_helper"
+require "azure/table/table_service"
+require "azure/core/http/http_error"
+
+describe Azure::Table::TableService do
+  describe "#insert_entity" do
+    subject { Azure::Table::TableService.new }
+    let(:table_name){ TableNameHelper.name }
+
+    let(:entity_properties) {
+      { 
+        "PartitionKey" => "testingpartition",
+        "RowKey" => "abcd123",
+        "CustomDoubleProperty" => 3.141592,
+        "CustomInt32Property" => 37,
+        "CustomInt64Property" => 2**32,
+        "CustomInt64NegProperty" => -(2**32),
+        "CustomGUIDProperty" => Azure::Table::GUID.new("81425519-6394-43e4-ac6e-28d91f5c3921"),
+        "CustomStringProperty" => "CustomPropertyValue",
+        "CustomBinaryProperty" => "\x01\x02\x03".force_encoding("BINARY"),
+        "CustomDateProperty" => Time.now,
+        "CustomDatePrecisionProperty" => Time.at(946684800, 123456.7),
+        "CustomIntegerProperty" => 37,
+        "CustomTrueProperty" => true,
+        "CustomFalseProperty" => false,
+        "CustomNilProperty" => nil
+      }
+    }
+
+    before { 
+      subject.create_table table_name
+    }
+    after { TableNameHelper.clean }
+
+    it "creates an entity" do 
+      result = subject.insert_entity table_name, entity_properties
+      result.must_be_kind_of Azure::Table::Entity
+      result.table.must_equal table_name
+      entity_properties.each { |k,v|
+        if entity_properties[k].class == Time
+          floor_to(result.properties[k].to_f, 6).must_equal floor_to(entity_properties[k].to_f, 6)
+        else
+          result.properties[k].must_equal entity_properties[k]
+        end
+      }
+    end
+
+    def floor_to(num, x)
+      (num * 10**x).floor.to_f / 10**x
+    end
+
+    it "errors on an invalid table name" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        subject.insert_entity "this_table.cannot-exist!", entity_properties
+      end
+    end
+
+    it "errors on an invalid partition key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["PartitionKey"] = "this/partition\\key#is?invalid"
+        subject.insert_entity table_name, entity
+      end
+    end
+
+    it "errors on an invalid row key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "this/row\\key#is?invalid"
+        subject.insert_entity table_name, entity
+      end
+    end
+  end
+end

data/test/integration/table/insert_or_merge_entity_batch_test.rb

@@ -0,0 +1,159 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "integration/test_helper"
+require "azure/table/batch"
+require "azure/table/table_service"
+require "azure/core/http/http_error"
+
+describe Azure::Table::TableService do
+  describe "#insert_or_merge_entity_batch" do
+    subject { Azure::Table::TableService.new }
+    let(:table_name){ TableNameHelper.name }
+
+    let(:entity_properties){ 
+      { 
+        "PartitionKey" => "testingpartition",
+        "CustomStringProperty" => "CustomPropertyValue",
+        "CustomIntegerProperty" => 37,
+        "CustomBooleanProperty" => true,
+        "CustomDateProperty" => Time.now
+      }
+    }
+
+    before { 
+      subject.create_table table_name
+    }
+
+    after { TableNameHelper.clean }
+
+    it "creates an entity if it does not already exist" do 
+      entity = entity_properties.dup
+      entity["RowKey"] = "abcd1234"
+
+      does_not_exist = true
+      begin
+        subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+        does_not_exist = false
+      rescue
+      end
+
+      assert does_not_exist
+
+      batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+      batch.insert entity["RowKey"], entity
+      result = subject.execute_batch batch
+
+      result = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+
+      result.must_be_kind_of Azure::Table::Entity
+      result.table.must_equal table_name
+      result.etag.wont_be_nil
+      
+      entity.each { |k,v|
+        unless entity[k].class == Time
+          result.properties[k].must_equal entity[k]
+        else
+          result.properties[k].to_i.must_equal entity[k].to_i
+        end
+      }
+    end
+
+    it "updates an existing entity, merging the properties" do 
+      entity = entity_properties.dup
+      entity["RowKey"] = "abcd1234_existing"
+
+      batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+      batch.insert entity["RowKey"], entity
+      subject.execute_batch batch
+
+      existing_etag = ""
+
+      exists = false
+      begin
+        existing = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+        existing_etag = existing.etag
+        exists = true
+      rescue
+      end
+
+      assert exists, "cannot verify existing record"
+
+      batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+      batch.insert_or_merge entity["RowKey"], {
+        "PartitionKey" => entity["PartitionKey"],
+        "RowKey" => entity["RowKey"],
+        "NewCustomProperty" => "NewCustomValue",
+        "NewNilProperty" => nil
+      }
+
+      subject.execute_batch batch
+
+      result = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+
+      result.etag.must_be_kind_of String
+      result.etag.wont_equal existing_etag
+
+      result.must_be_kind_of Azure::Table::Entity
+      result.table.must_equal table_name
+      
+      # retained all existing props
+      entity.each { |k,v|
+        if entity[k].class == Time
+          result.properties[k].to_i.must_equal entity[k].to_i
+        else
+          result.properties[k].must_equal entity[k]
+        end
+      }
+
+      # and has the new one
+      result.properties["NewCustomProperty"].must_equal "NewCustomValue"
+      result.properties["NewNilProperty"].must_equal nil
+    end
+
+    it "errors on an invalid table name" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "row_key"
+
+        batch = Azure::Table::Batch.new "this_table.cannot-exist!", entity["PartitionKey"]
+        batch.insert entity["RowKey"], entity
+        result = subject.execute_batch batch
+      end
+    end
+
+    it "errors on an invalid partition key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["PartitionKey"] = "this/partition_key#is?invalid"
+        entity["RowKey"] = "row_key"
+
+        batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+        batch.insert entity["RowKey"], entity
+        result = subject.execute_batch batch
+      end
+    end
+
+    it "errors on an invalid row key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "this/partition_key#is?invalid"
+
+        batch = Azure::Table::Batch.new table_name, entity["PartitionKey"]
+        batch.insert entity["RowKey"], entity
+        result = subject.execute_batch batch
+      end
+    end
+  end
+end

data/test/integration/table/insert_or_merge_entity_test.rb

@@ -0,0 +1,143 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "integration/test_helper"
+require "azure/table/table_service"
+require "azure/core/http/http_error"
+
+describe Azure::Table::TableService do
+  describe "#insert_or_merge_entity" do
+    subject { Azure::Table::TableService.new }
+    let(:table_name){ TableNameHelper.name }
+
+    let(:entity_properties){ 
+      { 
+        "PartitionKey" => "testingpartition",
+        "CustomStringProperty" => "CustomPropertyValue",
+        "CustomIntegerProperty" => 37,
+        "CustomBooleanProperty" => true,
+        "CustomDateProperty" => Time.now
+      }
+    }
+
+    before { 
+      subject.create_table table_name
+    }
+
+    after { TableNameHelper.clean }
+
+    it "creates an entity if it does not already exist" do 
+      entity = entity_properties.dup
+      entity["RowKey"] = "abcd1234"
+
+      does_not_exist = true
+      begin
+        subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+        does_not_exist = false
+      rescue
+      end
+
+      assert does_not_exist
+
+      etag = subject.insert_or_merge_entity table_name, entity
+      etag.must_be_kind_of String
+
+      result = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+
+      result.must_be_kind_of Azure::Table::Entity
+      result.table.must_equal table_name
+      result.etag.must_equal etag
+      
+      entity.each { |k,v|
+        unless entity[k].class == Time
+          result.properties[k].must_equal entity[k]
+        else
+          result.properties[k].to_i.must_equal entity[k].to_i
+        end
+      }
+    end
+
+    it "updates an existing entity, merging the properties" do 
+      entity = entity_properties.dup
+      entity["RowKey"] = "abcd1234_existing"
+
+      result = subject.insert_entity table_name, entity
+
+      existing_etag = ""
+
+      exists = false
+      begin
+        existing = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+        existing_etag = existing.etag
+        exists = true
+      rescue
+      end
+
+      assert exists, "cannot verify existing record"
+
+      etag = subject.insert_or_merge_entity table_name, {
+        "PartitionKey" => entity["PartitionKey"],
+        "RowKey" => entity["RowKey"],
+        "NewCustomProperty" => "NewCustomValue",
+        "NewNilProperty" => nil
+      }
+
+      etag.must_be_kind_of String
+      etag.wont_equal existing_etag
+
+      result = subject.get_entity table_name, entity["PartitionKey"], entity["RowKey"]
+      
+      result.must_be_kind_of Azure::Table::Entity
+      result.table.must_equal table_name
+      
+      # retained all existing props
+      entity.each { |k,v|
+        if entity[k].class == Time
+          result.properties[k].to_i.must_equal entity[k].to_i
+        else
+          result.properties[k].must_equal entity[k]
+        end
+      }
+
+      # and has the new one
+      result.properties["NewCustomProperty"].must_equal "NewCustomValue"
+      result.properties["NewNilProperty"].must_equal nil
+    end
+
+    it "errors on an invalid table name" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "row_key"
+        subject.insert_or_merge_entity "this_table.cannot-exist!", entity
+      end
+    end
+
+    it "errors on an invalid partition key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["PartitionKey"] = "this/partition_key#is?invalid"
+        entity["RowKey"] = "row_key"
+        subject.insert_or_merge_entity table_name, entity
+      end
+    end
+
+    it "errors on an invalid row key" do
+      assert_raises(Azure::Core::Http::HTTPError) do
+        entity = entity_properties.dup
+        entity["RowKey"] = "this/partition_key#is?invalid"
+        subject.insert_or_merge_entity table_name, entity
+      end
+    end
+  end
+end