gcloud 0.12.1 → 0.12.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NGYyNjAzODc0Yzg1YjlhYWY0ZjI1YjU3ZjViYzhjOTYxZDVjNmFiNQ==
+    OThmNGI2N2Q2MjdmYTUwZWJkMWFjZWFlZjliMDA0NGRmNmFlZmYwNQ==
   data.tar.gz: !binary |-
-    NWY2NTM5NTg3YmIzYmZjYzRlY2VlMzk1OGRlN2MzYjAwZGQzMWI3ZA==
+    MDVjY2QyZjVlZjQ0MjlhOWVmMjY3MDQxNDUxOGRkZTdkNDgxMDQ3Mw==
 SHA512:
   metadata.gz: !binary |-
-    MmVkZWEwYzAwNWFjYmIyOWVlZjVjMDZiYmUwMTA1NDJiZjZhOWQxMWYwMjIy
-    YTUwMmYyYTBiZGQ2MzEwZWI5YTA0NWY1YzczN2FmYzg5ZjJmZDY3MTc3OTgx
-    YTM2MmU5ZGQ3MmIzM2U1NTIxOGJlZDE5OGU2YmQ1Yzk1NDU5M2Y=
+    MTU5YjQ2ZWMxZjk5MDE2ZWYzMGE1NTNiNTg0NzkyNWM0ODJjZWFlYjc0NDA4
+    Y2M3NzNhM2NjOTc1MmIwNzhjNDg5NzRkNGJlYTU2YWU4YmFhOGQwMmU4Y2Nk
+    NjEwNTlmMjQzYjg1MzM2ODJlMzc2MzE4N2RiZmYwNjQ5MzQ3OTg=
   data.tar.gz: !binary |-
-    ZTA4M2MyZTYxYWNlODA4MTk0MTllNTRjZmQxYTU1ZTgzZjBlYmM5MzM3OGU4
-    MmMwNGNiNWM3NDdjNzQ0ZjBmYjU0NjlmNDU5NmE5MTIwOTkwN2JmZGQ1MWFk
-    MDVhZTI2ZjkzODU2YWJjNmQ5ZjU3MGVkOWMwOGI5MDQ0YTgwNDM=
+    ZTQzYjkxZmZjMmFiMTM2MTU3MjkzZWQwNTFiOTE0ODI2YWM4YjMwZmY2ZjJl
+    ZmVmNmExYzZlZDMzMWMxOGVhMzcwOTFkYjE4ZjM3NTdlMzU3MGQyMjY3MWI5
+    MTBhYjBmMGFhODcyMzg1OTVmMGI1YjljY2M5M2I5NGM3MjY1YzM=

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Release History
 
+### 0.12.2 / 2016-08-09
+
+#### Changes
+
+* BigQuery
+  * Allow `Dataset#create_table` syntax used prior to v0.12.0.
+
 ### 0.12.1 / 2016-08-01
 
 #### Changes

data/lib/gcloud/bigquery/schema.rb

@@ -197,8 +197,8 @@ module Gcloud
       #   `:nullable`, `:required`, and `:repeated`. The default value is
       #   `:nullable`.
       # @yield [nested_schema] a block for setting the nested schema
-      # @yieldparam [Table::Schema] nested_schema the object accepting the
-      #   nested schema
+      # @yieldparam [Schema] nested_schema the object accepting the nested
+      #   schema
       #
       # @example
       #   require "gcloud"

data/lib/gcloud/bigquery/table.rb

@@ -325,7 +325,7 @@ module Gcloud
       #   already contains data, schema changes must be additive. Thus, the
       #   default value is `false`.
       # @yield [schema] a block for setting the schema
-      # @yieldparam [Table::Schema] schema the object accepting the schema
+      # @yieldparam [Schema] schema the object accepting the schema
       #
       # @return [Gcloud::Bigquery::Schema]
       #
@@ -871,6 +871,41 @@ module Gcloud
           @schema = nil
         end
 
+        ##
+        # Returns the table's schema. This method can also be used to set,
+        # replace, or add to the schema by passing a block. See {Schema} for
+        # available methods.
+        #
+        # @param [Boolean] replace Whether to replace the existing schema with
+        #   the new schema. If `true`, the fields will replace the existing
+        #   schema. If `false`, the fields will be added to the existing
+        #   schema. When a table already contains data, schema changes must be
+        #   additive. Thus, the default value is `false`.
+        # @yield [schema] a block for setting the schema
+        # @yieldparam [Schema] schema the object accepting the schema
+        #
+        # @return [Gcloud::Bigquery::Schema]
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.name = "My Table",
+        #     t.description = "A description of my table."
+        #     t.schema do |s|
+        #       s.string "first_name", mode: :required
+        #       s.record "cities_lived", mode: :repeated do |r|
+        #         r.string "place", mode: :required
+        #         r.integer "number_of_years", mode: :required
+        #       end
+        #     end
+        #   end
+        #
+        # @!group Schema
+        #
         def schema replace: false
           # Same as Table#schema, but not frozen
           # TODO: make sure to call ensure_full_data! on Dataset#update
@@ -887,6 +922,190 @@ module Gcloud
           @schema
         end
 
+        ##
+        # Adds a string field to the schema.
+        #
+        # See {Schema#string}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.string "first_name", mode: :required
+        #   end
+        #
+        # @!group Schema
+        def string name, description: nil, mode: :nullable
+          schema.string name, description: description, mode: mode
+        end
+
+        ##
+        # Adds an integer field to the schema.
+        #
+        # See {Schema#integer}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.integer "age", mode: :required
+        #   end
+        #
+        # @!group Schema
+        def integer name, description: nil, mode: :nullable
+          schema.integer name, description: description, mode: mode
+        end
+
+        ##
+        # Adds a floating-point number field to the schema.
+        #
+        # See {Schema#float}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.float "price", mode: :required
+        #   end
+        #
+        # @!group Schema
+        def float name, description: nil, mode: :nullable
+          schema.float name, description: description, mode: mode
+        end
+
+        ##
+        # Adds a boolean field to the schema.
+        #
+        # See {Schema#boolean}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.boolean "active", mode: :required
+        #   end
+        #
+        # @!group Schema
+        def boolean name, description: nil, mode: :nullable
+          schema.boolean name, description: description, mode: mode
+        end
+
+        ##
+        # Adds a timestamp field to the schema.
+        #
+        # See {Schema#timestamp}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.timestamp "creation_date", mode: :required
+        #   end
+        #
+        # @!group Schema
+        def timestamp name, description: nil, mode: :nullable
+          schema.timestamp name, description: description, mode: mode
+        end
+
+        ##
+        # Adds a record field to the schema. A block must be passed describing
+        # the nested fields of the record. For more information about nested
+        # and repeated records, see [Preparing Data for BigQuery
+        # ](https://cloud.google.com/bigquery/preparing-data-for-bigquery).
+        #
+        # See {Schema#record}.
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        # @yield [nested_schema] a block for setting the nested schema
+        # @yieldparam [Schema] nested_schema the object accepting the
+        #   nested schema
+        #
+        # @example
+        #   require "gcloud"
+        #
+        #   gcloud = Gcloud.new
+        #   bigquery = gcloud.bigquery
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.create_table "my_table" do |schema|
+        #     schema.record "cities_lived", mode: :repeated do |cities_lived|
+        #       cities_lived.string "place", mode: :required
+        #       cities_lived.integer "number_of_years", mode: :required
+        #     end
+        #   end
+        #
+        # @!group Schema
+        #
+        def record name, description: nil, mode: nil, &block
+          schema.record name, description: description, mode: mode, &block
+        end
+
         ##
         # Make sure any access changes are saved
         def check_for_mutated_schema!

data/lib/gcloud/version.rb

@@ -14,5 +14,5 @@
 
 
 module Gcloud
-  VERSION = "0.12.1"
+  VERSION = "0.12.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gcloud
 version: !ruby/object:Gem::Version
-  version: 0.12.1
+  version: 0.12.2
 platform: ruby
 authors:
 - Silvano Luciani
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-01 00:00:00.000000000 Z
+date: 2016-08-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: grpc