gcloud 0.0.7 → 0.1.0

data/test/gcloud/datastore/proto/test_cursor.rb

@@ -0,0 +1,36 @@
+# Copyright 2014 Google Inc. 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 "helper"
+require "gcloud/datastore/entity"
+require "gcloud/datastore/key"
+
+##
+# These tests are not part of the public API.
+# These tests are testing the implementation.
+# Similar to testing private methods.
+
+describe "Proto Cursor methods" do
+  let(:raw_cursor) {
+      "\x13\xE0\x01\x00\xEB".force_encoding Encoding::ASCII_8BIT }
+  let(:encoded_cursor) { "E+ABAOs=" }
+
+  it "encodes the bytestream" do
+    encoded_cursor.must_equal Gcloud::Datastore::Proto.encode_cursor(raw_cursor)
+  end
+
+  it "decodes the bytestream" do
+    raw_cursor.must_equal Gcloud::Datastore::Proto.decode_cursor(encoded_cursor)
+  end
+end

data/test/gcloud/datastore/proto/test_direction.rb

@@ -0,0 +1,60 @@
+# Copyright 2014 Google Inc. 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 "helper"
+require "gcloud/datastore/entity"
+require "gcloud/datastore/key"
+
+##
+# These tests are not part of the public API.
+# These tests are testing the implementation.
+# Similar to testing private methods.
+
+describe "Proto Direction methods" do
+  describe "PropertyOrder Direction" do
+    it "defaults to ascending" do
+      assert_ascending nil
+      assert_ascending ""
+      assert_ascending 123
+    end
+
+    it "is ascending when ascending" do
+      assert_ascending "asc"
+      assert_ascending "ascending"
+      assert_ascending :asc
+      assert_ascending :ascending
+      assert_ascending "ASC"
+      assert_ascending "ASCENDING"
+    end
+
+    it "is descending when given 'd' direction" do
+      assert_descending "desc"
+      assert_descending "descending"
+      assert_descending :desc
+      assert_descending :descending
+      assert_descending "DESC"
+      assert_descending "DESCENDING"
+    end
+
+    def assert_ascending direction
+      assert_equal Gcloud::Datastore::Proto::PropertyOrder::Direction::ASCENDING,
+                   Gcloud::Datastore::Proto.to_prop_order_direction(direction)
+    end
+
+    def assert_descending direction
+      assert_equal Gcloud::Datastore::Proto::PropertyOrder::Direction::DESCENDING,
+                   Gcloud::Datastore::Proto.to_prop_order_direction(direction)
+    end
+  end
+end

data/test/gcloud/datastore/proto/test_operator.rb

@@ -0,0 +1,76 @@
+# Copyright 2014 Google Inc. 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 "helper"
+require "gcloud/datastore/entity"
+require "gcloud/datastore/key"
+
+##
+# These tests are not part of the public API.
+# These tests are testing the implementation.
+# Similar to testing private methods.
+
+describe "Proto Operator methods" do
+  describe "Property Filter Operators" do
+    it "can convert strings" do
+      assert_prop_filter_op "<"   , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN
+      assert_prop_filter_op "lt"  , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN
+      assert_prop_filter_op "<="  , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN_OR_EQUAL
+      assert_prop_filter_op "lte" , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN_OR_EQUAL
+      assert_prop_filter_op ">"   , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN
+      assert_prop_filter_op "gt"  , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN
+      assert_prop_filter_op ">="  , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN_OR_EQUAL
+      assert_prop_filter_op "gte" , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN_OR_EQUAL
+      assert_prop_filter_op "="   , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op "eq"  , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op "eql" , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op "~"            , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op "~>"           , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op "ancestor"     , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op "has_ancestor" , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op "has ancestor" , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+    end
+
+    it "can convert symbols" do
+      assert_prop_filter_op :<   , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN
+      assert_prop_filter_op :lt  , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN
+      assert_prop_filter_op :<=  , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN_OR_EQUAL
+      assert_prop_filter_op :lte , Gcloud::Datastore::Proto::PropertyFilter::Operator::LESS_THAN_OR_EQUAL
+      assert_prop_filter_op :>   , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN
+      assert_prop_filter_op :gt  , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN
+      assert_prop_filter_op :>=  , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN_OR_EQUAL
+      assert_prop_filter_op :gte , Gcloud::Datastore::Proto::PropertyFilter::Operator::GREATER_THAN_OR_EQUAL
+      #               := is not a valid symbol
+      assert_prop_filter_op :"=" , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op :eq  , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op :eql , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op :~            , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      #               :~> is not a valid symbol
+      assert_prop_filter_op :"~>"         , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op :ancestor     , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+      assert_prop_filter_op :has_ancestor , Gcloud::Datastore::Proto::PropertyFilter::Operator::HAS_ANCESTOR
+    end
+
+    it "can handle unexpected values" do
+      assert_prop_filter_op nil   , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op ""    , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+      assert_prop_filter_op "foo" , Gcloud::Datastore::Proto::PropertyFilter::Operator::EQUAL
+    end
+
+    def assert_prop_filter_op string, proto
+      op = Gcloud::Datastore::Proto.to_prop_filter_op string
+      op.must_equal proto
+    end
+  end
+end

data/test/gcloud/datastore/proto/test_value.rb

@@ -0,0 +1,231 @@
+# Copyright 2014 Google Inc. 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 "helper"
+require "gcloud/datastore/entity"
+require "gcloud/datastore/key"
+
+describe "Proto Value methods" do
+  let(:time_obj) { Time.new(2014, 1, 1, 0, 0, 0, 0) }
+  let(:time_num) { 1388534400000000 }
+
+  ##
+  # This is testing a helper.
+  # These tests are for sanity only.
+  # This is not part of the public API.
+  # Testing implementation, not behavior.
+
+  it "encodes a string" do
+    raw = "hello, i am a string"
+    value = Gcloud::Datastore::Proto.to_proto_value raw
+    value.string_value.must_equal raw
+    value.timestamp_microseconds_value.must_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes a string" do
+    str = "ohai, i am also a string"
+    value = Gcloud::Datastore::Proto::Value.new
+    value.string_value = str
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal str
+  end
+
+  it "encodes true" do
+    value = Gcloud::Datastore::Proto.to_proto_value true
+    value.boolean_value.must_equal true
+    value.timestamp_microseconds_value.must_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes true" do
+    value = Gcloud::Datastore::Proto::Value.new
+    value.boolean_value = true
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal true
+  end
+
+  it "encodes false" do
+    value = Gcloud::Datastore::Proto.to_proto_value false
+    value.boolean_value.must_equal false
+    value.timestamp_microseconds_value.must_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes false" do
+    value = Gcloud::Datastore::Proto::Value.new
+    value.boolean_value = false
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal false
+  end
+
+  it "encodes Time" do
+    value = Gcloud::Datastore::Proto.to_proto_value time_obj
+    value.timestamp_microseconds_value.must_equal time_num
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes timestamp" do
+    value = Gcloud::Datastore::Proto::Value.new
+    value.timestamp_microseconds_value = time_num
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal time_obj
+  end
+
+  it "encodes integer" do
+    raw = 1234
+    value = Gcloud::Datastore::Proto.to_proto_value raw
+    value.integer_value.must_equal raw
+    value.timestamp_microseconds_value.must_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes integer" do
+    num = 1234
+    value = Gcloud::Datastore::Proto::Value.new
+    value.integer_value = num
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal num
+  end
+
+  it "encodes float" do
+    raw = 12.34
+    value = Gcloud::Datastore::Proto.to_proto_value raw
+    value.double_value.must_equal raw
+    value.timestamp_microseconds_value.must_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes float" do
+    num = 12.34
+    value = Gcloud::Datastore::Proto::Value.new
+    value.double_value = num
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    raw.must_equal num
+  end
+
+  it "encodes Key" do
+    key = Gcloud::Datastore::Key.new "Thing", 123
+    value = Gcloud::Datastore::Proto.to_proto_value key
+    value.key_value.must_equal key.to_proto
+    value.timestamp_microseconds_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes Key" do
+    key = Gcloud::Datastore::Key.new "Thing", 123
+    value = Gcloud::Datastore::Proto::Value.new
+    value.key_value = key.to_proto
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    assert_kind_of Gcloud::Datastore::Key, raw
+    refute_kind_of Gcloud::Datastore::Proto::Key, raw
+    raw.to_proto.must_equal key.to_proto
+  end
+
+  it "encodes Entity" do
+    entity = Gcloud::Datastore::Entity.new
+    entity.key = Gcloud::Datastore::Key.new "Thing", 123
+    entity["name"] = "Thing 1"
+    value = Gcloud::Datastore::Proto.to_proto_value entity
+    value.key_value.must_be :nil?
+    value.entity_value.must_equal entity.to_proto
+    value.timestamp_microseconds_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+    value.list_value.must_be :nil?
+  end
+
+  it "decodes Entity" do
+    entity = Gcloud::Datastore::Entity.new
+    entity.key = Gcloud::Datastore::Key.new "Thing", 123
+    entity["name"] = "Thing 1"
+    value = Gcloud::Datastore::Proto::Value.new
+    value.entity_value = entity.to_proto
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    assert_kind_of Gcloud::Datastore::Entity, raw
+    refute_kind_of Gcloud::Datastore::Proto::Entity, raw
+    # Fix up the indexed values so they can match
+    raw_proto = raw.to_proto
+    raw_proto.property.first.value.indexed = true
+    entity_proto = entity.to_proto
+    entity_proto.property.first.value.indexed = true
+    raw_proto.must_equal entity_proto
+  end
+
+  it "encodes Array" do
+    array = ["string", 123, true]
+    value = Gcloud::Datastore::Proto.to_proto_value array
+    value.list_value.wont_be :nil?
+    value.key_value.must_be :nil?
+    value.entity_value.must_be :nil?
+    value.timestamp_microseconds_value.must_be :nil?
+    value.boolean_value.must_be :nil?
+    value.double_value.must_be :nil?
+    value.integer_value.must_be :nil?
+    value.string_value.must_be :nil?
+  end
+
+  it "decodes List" do
+    value = Gcloud::Datastore::Proto::Value.new
+    value.list_value = [
+      Gcloud::Datastore::Proto::Value.new.tap { |v| v.string_value = "string" },
+      Gcloud::Datastore::Proto::Value.new.tap { |v| v.integer_value = 123 },
+      Gcloud::Datastore::Proto::Value.new.tap { |v| v.boolean_value = true },
+    ]
+    raw = Gcloud::Datastore::Proto.from_proto_value value
+    assert_kind_of Array, raw
+    raw.count.must_equal 3
+    raw[0].must_equal "string"
+    raw[1].must_equal 123
+    raw[2].must_equal true
+  end
+end

data/test/gcloud/datastore/test_connection.rb

@@ -0,0 +1,93 @@
+# Copyright 2014 Google Inc. 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 "helper"
+require "gcloud/datastore"
+
+describe Gcloud::Datastore::Connection do
+  let(:project)     { "my-todo-project" }
+  let(:credentials) { OpenStruct.new }
+  let(:connection)  { Gcloud::Datastore::Connection.new project, credentials }
+  let(:http_mock)   { Minitest::Mock.new }
+  let(:mocks)       { [] }
+
+  before do
+    connection.http = http_mock
+    mocks << http_mock
+  end
+
+  it "makes an http POST for allocate_ids" do
+    http_mock.expect :post, new_response_mock, [rpc_path("allocateIds")]
+    key = Gcloud::Datastore::Key.new "User"
+    response = connection.allocate_ids key.to_proto, key.to_proto, key.to_proto
+    response.must_be_kind_of Gcloud::Datastore::Proto::AllocateIdsResponse
+  end
+
+  it "makes an http POST for lookup" do
+    http_mock.expect :post, new_response_mock, [rpc_path("lookup")]
+    key1 = Gcloud::Datastore::Key.new "User", "silvolu"
+    key2 = Gcloud::Datastore::Key.new "User", "blowmage"
+    response = connection.lookup key1.to_proto, key2.to_proto
+    response.must_be_kind_of Gcloud::Datastore::Proto::LookupResponse
+  end
+
+  it "makes an http POST for run_query" do
+    http_mock.expect :post, new_response_mock, [rpc_path("runQuery")]
+    query = Gcloud::Datastore::Query.new.kind("User")
+    response = connection.run_query query.to_proto
+    response.must_be_kind_of Gcloud::Datastore::Proto::RunQueryResponse
+  end
+
+  it "makes an http POST for begin_transaction" do
+    http_mock.expect :post, new_response_mock, [rpc_path("beginTransaction")]
+    response = connection.begin_transaction
+    response.must_be_kind_of Gcloud::Datastore::Proto::BeginTransactionResponse
+  end
+
+  it "makes an http POST for commit" do
+    http_mock.expect :post, new_response_mock, [rpc_path("commit")]
+    mutation_proto = Gcloud::Datastore::Proto::Mutation.new
+    response = connection.commit mutation_proto
+    response.must_be_kind_of Gcloud::Datastore::Proto::CommitResponse
+  end
+
+  it "makes an http POST for commit with transaction" do
+    http_mock.expect :post, new_response_mock, [rpc_path("commit")]
+    mutation_proto = Gcloud::Datastore::Proto::Mutation.new
+    response = connection.commit mutation_proto, "transaction123456"
+    response.must_be_kind_of Gcloud::Datastore::Proto::CommitResponse
+  end
+
+  it "makes an http POST for rollback" do
+    http_mock.expect :post, new_response_mock, [rpc_path("rollback")]
+    response = connection.rollback "transaction123456"
+    response.must_be_kind_of Gcloud::Datastore::Proto::RollbackResponse
+  end
+
+  after do
+    mocks.each { |mock| mock.verify }
+  end
+
+  def rpc_path method
+    connection.send :rpc_path, method
+  end
+
+  def new_response_mock
+    response_mock = Minitest::Mock.new
+    response_mock.expect :success?, true
+    response_mock.expect :body, ""
+    mocks << response_mock
+    response_mock
+  end
+end