sixarm_ruby_migration_helper_extensions 4.0.0 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fd950d267e81dcba654e1bb0a29b5fd5d3c7ee8352622442d0a3087bac4c4dc
-  data.tar.gz: 9ab29cc08595510a81668f3e69efba677c704e2e9658962b5004b9abdda49bff
+  metadata.gz: cfbd74ab297461d56b079b27be0fa2d037f2bea59ccecd664075729f1526b411
+  data.tar.gz: 8de8ed748526fe22b40966d6fb11a2531191d8d25b439fbf481f9d1d2db9699c
 SHA512:
-  metadata.gz: 818843bef0c81027327799a90e8517d080b7882912d95822c4e1adfe102598eaeeb430aa0d10cbe461fbdda4fb32fc9e2ba9847c5d3174cd548de6a4a924d87d
-  data.tar.gz: 58b6e276e9dc928d1cc72ecb3c3373673b29b8e286c12670e4b1e1de644808c7c1d9c2187ebf8493952b7c729605c71fb31e693eba5656c3e5a6843b52c6f5df
+  metadata.gz: 7d32cf5c457b5da445714e1a2f20c123ea45b525557ae1907f7e4f0d215226b97395ff36bcbdb4216629b723bf22c313da5744cd213f393b92bd3d17253602ae
+  data.tar.gz: fe55eefe68138ae9125413cff7c8fdbfb1cd35d0ca3931878a851e7a394961ea0d45b906fb8d86aa969f25f28b0edd863b7c793bfbbcb2c5a94dbc7730d5e6ae

data/lib/sixarm_ruby_migration_helper_extensions.rb

@@ -20,21 +20,12 @@ module Ddb
         #
         ##
 
-        ##
-        # Name
-        #
-        def name(column_name=:name)
-          column(column_name, :string)
-          index(column_name)
-        end
-
         ##
         # email: string limit is 320 because the email spec has pieces
         # that total to 320, though then trims the limit to 254.
         #
         def email(column_name=:email)
           column(column_name, :string, limit: 320)
-          index(column_name)
         end
 
         ##
@@ -43,7 +34,6 @@ module Ddb
         #
         def phone(column_name=:phone)
           column(column_name, :string)
-          index(column_name)
         end
 
         ##
@@ -51,7 +41,13 @@ module Ddb
         #
         def uri(column_name=:uri)
           column(column_name, :string)
-          index(column_name)
+        end
+
+        ##
+        # hostname: POSIX standard is not to exceed 255 bytes.
+        #
+        def hostname(column_name=:hostname)
+          column(column_name, :string, limit: 255)
         end
 
         ##
@@ -72,24 +68,37 @@ module Ddb
         #
         ##
 
-        def latitude(column_name=:latitude)     column(column_name, :decimal, precision: 13, scale: 10); index(column_name); end
-        def longitude(column_name=:longitude)   column(column_name, :decimal, precision: 13, scale: 10); index(column_name); end
-        def altitude(column_name=:altitude)     column(column_name, :decimal, precision: 13, scale: 10); index(column_name); end
+        def latitude(column_name=:latitude)     column(column_name, :decimal, precision: 13, scale: 10); end
+        def longitude(column_name=:longitude)   column(column_name, :decimal, precision: 13, scale: 10); end
+        def altitude(column_name=:altitude)     column(column_name, :decimal, precision: 13, scale: 10); end
+        def elevation(column_name=:elevation)   column(column_name, :decimal, precision: 13, scale: 10); end
 
         def geolocation
           latitude
           longitude
           altitude
+          elevation
         end
 
         ##
         #
-        # Vendors
+        # Places
         #
         ##
 
-        def freebase(column_name=:freebase)
-          column(column_name, :string)
+        # ISO 3166-1 alpha-2 - two-letter country codes which are also used to create the ISO 3166-2 country subdivision codes and the Internet country code top-level domains.
+        def iso_3166_1_alpha_2(column_name=:iso_3166_1_alpha_2)
+          column(column_name, :string, limit: 2)
+        end
+
+        # ISO 3166-1 alpha-3 – three-letter country codes which may allow a better visual association between the codes and the country names than the 3166-1 alpha-2 codes.
+        def iso_3166_1_alpha_3(column_name=:iso_3166_1_alpha_3)
+          column(column_name, :string, limit: 3)
+        end
+
+        # ISO 3166-1 numeric – three-digit country codes which are identical to those developed and maintained by the United Nations Statistics Division, with the advantage of script (writing system) independence, and hence useful for people or systems using non-Latin scripts.
+        def iso_3166_1_numeric(column_name=:iso_3166_1_numeric)
+          column(column_name, :string, limit: 3)
         end
 
         ##
@@ -99,12 +108,27 @@ module Ddb
         ##
 
         ##
-        # uuid_string: we sometimes like to use UUID strings; 
+        # timestamp_string: timestamp strings are good for e.g. log reports;
+        # our format has a max length of  "YYYY-DD-MMTHH:MM:SS.NNNNNNNNN+HH:MM".
+        #
+        def timestamp_string(column_name=:timestamp_string)
+          column(column_name, :string, limit: 35)
+        end
+
+        ##
+        # uuid_string: we sometimes like to use UUID strings;
         # for efficiency, we suggest using a database-native format.
         #
         def uuid_string(column_name=:uuid_string)
           column(column_name, :string, limit: 36)
-          index(column_name, unique: true)
+        end
+
+        ##
+        # zid_string: we sometimes like to use ZID strings, similar to UUID stings;
+        # for efficiency, we suggest using a database-native format.
+        #
+        def zid_string(column_name=:zid_string)
+          column(column_name, :string, limit: 36)
         end
 
         ##
@@ -113,25 +137,22 @@ module Ddb
         #
         def parent_id(column_name=:parent_id)
           column(column_name, :integer)
-          index(column_name)
         end
 
         ##
-        # position: we sometimes like to use ordered lists, 
+        # position: we sometimes like to use ordered lists,
         # where the `position` is the list position.
         #
         def position(column_name=:position)
           column(column_name, :integer)
-          index(column_name)
         end
 
         ##
-        # state: we sometimes like to use state machines, 
+        # state: we sometimes like to use state machines,
         # where the `state` is an integer enumeration.
         #
         def state(column_name=:state)
           column(column_name, :integer)
-          index(column_name)
         end
 
         ##
@@ -140,27 +161,25 @@ module Ddb
         #
         def lock_version(column_name=:lock_version)
           column(column_name, :integer)
-          index(column_name)
         end
 
         ##
-        # type: Rails single table inheritance (STI) 
+        # type: Rails single table inheritance (STI)
         # uses a magic field name `type`.
         #
         def type(column_name=:type)
           column(column_name, :string)
-          index(column_name)
-        end  
+        end
 
         ##
         # auditstamps: we like to track what's happening to a row,
         # by using typical Rails timestamps and then some more.
         #
         def auditstamps
-          column(:created_at, :datetime); index(:created_at); column(:created_by, :integer); index(:created_by)
-          column(:updated_at, :datetime); index(:updated_at); column(:updated_by, :integer); index(:updated_by)
-          column(:proofed_at, :datetime); index(:proofed_at); column(:proofed_by, :integer); index(:proofed_by)
-          column(:retired_at, :datetime); index(:retired_at); column(:retired_by, :integer); index(:retired_by)
+          column(:created_at, :datetime); column(:created_by, :integer);
+          column(:updated_at, :datetime); column(:updated_by, :integer);
+          column(:proofed_at, :datetime); column(:proofed_by, :integer);
+          column(:retired_at, :datetime); column(:retired_by, :integer);
         end
 
         ##
@@ -185,6 +204,16 @@ module Ddb
           type
         end
 
+        ##
+        #
+        # Vendor
+        #
+        ##
+
+        def freebase(column_name=:freebase)
+          column(column_name, :string)
+        end
+
       end
     end
   end

data/test/sixarm_ruby_migration_helper_extensions_test.rb

@@ -10,24 +10,36 @@ require "sixarm_ruby_active_record_migration_mock"
 require "sixarm_ruby_migration_helper_extensions"
 
 class Testing < Minitest::Test
- 
+
  def test_columns
   CreateFoos.up
   for col in [
+    ## Contact
     :email,
-    :freebase,
+    :phone,
+    :uri,
+    :hostname,
+    ## Size
     :height,
     :length,
     :width,
     :depth,
     :mass,
+    ## Geolocation
     :latitude,
     :longitude,
     :altitude,
-    :length,
-    :longitude,
-    :phone,
-    :uri,
+    :elevation,
+    ## Place
+    :iso_3166_1_alpha_2,
+    :iso_3166_1_alpha_3,
+    :iso_3166_1_numeric,
+    ## Admin
+    :timestamp_string,
+    :uuid_string,
+    :zid_string,
+    ## Vendor
+    :freebase,
   ] do
     assert(ActiveRecordMigrationMock.tables['foos'].has_column?(col),"has_column?(:#{col})")
   end
@@ -45,17 +57,32 @@ class CreateFoos < ActiveRecordMigrationMock
 
   def self.up
     create_table 'foos', :force => true do |t|
+      ## Contact
+      t.name
       t.email
+      t.phone
+      t.uri
+      t.hostname
+      ## Size
       t.height
       t.length
       t.width
       t.depth
       t.mass
+      ## Geolocation
       t.latitude
       t.longitude
       t.altitude
-      t.phone
-      t.uri
+      t.elevation
+      ## Place
+      t.iso_3166_1_alpha_2
+      t.iso_3166_1_alpha_3
+      t.iso_3166_1_numeric
+      ## Admin
+      t.timestamp_string
+      t.uuid_string
+      t.zid_string
+      ## Vendor
       t.freebase
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sixarm_ruby_migration_helper_extensions
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 5.0.0
 platform: ruby
 authors:
 - SixArm
@@ -39,7 +39,7 @@ cert_chain:
   tzpk/VnZXj7Ek/earx+N/Z+Wtnl2xENm5IF8SFPeI1HFa9NH47pqtxF1YKpNIEVc
   2xa2BNHSePe7tys/2hbmZuyMu8X5ERmovsabSXB3a+YwtJh5c2jhA21wF7986s0q
   -----END CERTIFICATE-----
-date: 2018-06-24 00:00:00.000000000 Z
+date: 2019-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -294,8 +294,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: SixArm.com → Ruby → Migration helper extensions