arql 0.2.5 → 0.2.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 032762276fe5d2c764f71eae665d16e2e4786368c7f154e7bd19be5188a49027
-  data.tar.gz: 73b8ceedbcd0abdc5c87c186374c8cfe0db50e0c22d1e645d2c10396ec8c4aa3
+  metadata.gz: 2146ddb3d395a10ebd850db5f4d6a3d01b96dd4d62c1a90771ce286f54d3fb1c
+  data.tar.gz: 757595855e4889c2a6e0025954acf8887d728bbbc21d66cf0b09640b2ab848af
 SHA512:
-  metadata.gz: cc70e4f11ff7bcfc4f0654d8a3e59ac2ae666e55237dff7d62e408c3c6bba200b22f3e064ea17dc513a94bbd4eacefa8f369d4d79c24d9a9ada857efa00c58af
-  data.tar.gz: 34491bfc5588a4bae89f26f889c5863e700f79b926902bb769c3e122082342706252fc41bcf461244bfc82e8f5a5e7dbf1eb4bd3c43d726f1d9fb9f5164170b0
+  metadata.gz: 9a92b845a7fdafdda21c4e83eeff589d01319d432b58470e92fe28486cc83bb4cc998e8d8e7132b1674c7e61200c39f4f56d24a3ff19604c31e0b15612edbd4d
+  data.tar.gz: 19f2b4e03428e99182e5526ac2dbb0ae0f5205115f5f54d635894f4d8c4ce69dff8aadb26358c14ef480c7638203d751949c7f5b9734db68dc3ecf6f2254e521

data/Gemfile.lock

@@ -1,10 +1,11 @@
 PATH
   remote: .
   specs:
-    arql (0.2.5)
+    arql (0.2.10)
       activerecord (~> 6.0.3)
       activesupport (~> 6.0.3)
       caxlsx (~> 3.0.2)
+      composite_primary_keys (~> 12.0.3)
       mysql2 (~> 0.5.3)
       net-ssh-gateway (~> 2.0.0)
       pry (~> 0.13.1)
@@ -19,12 +20,12 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.0.3.3)
-      activesupport (= 6.0.3.3)
-    activerecord (6.0.3.3)
-      activemodel (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
-    activesupport (6.0.3.3)
+    activemodel (6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activerecord (6.0.3.4)
+      activemodel (= 6.0.3.4)
+      activesupport (= 6.0.3.4)
+    activesupport (6.0.3.4)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (>= 0.7, < 2)
       minitest (~> 5.1)
@@ -37,6 +38,8 @@ GEM
       nokogiri (~> 1.10, >= 1.10.4)
       rubyzip (>= 1.3.0, < 3)
     coderay (1.1.3)
+    composite_primary_keys (12.0.3)
+      activerecord (~> 6.0.0)
     concurrent-ruby (1.1.7)
     htmlentities (4.3.4)
     i18n (1.8.5)
@@ -71,11 +74,11 @@ GEM
     terminal-table (1.8.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
     thread_safe (0.3.6)
-    tzinfo (1.2.7)
+    tzinfo (1.2.8)
       thread_safe (~> 0.1)
     unicode-display_width (1.7.0)
     yard (0.9.25)
-    zeitwerk (2.4.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby

data/arql.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |spec|
   # spec.add_dependency 'activerecord-sqlserver-adapter'
   # spec.add_dependency 'activerecord-oracle_enhanced-adapter'
   spec.add_dependency 'activerecord', '~> 6.0.3'
+  spec.add_dependency 'composite_primary_keys', '~> 12.0.3'
   spec.add_dependency 'activesupport', '~> 6.0.3'
   spec.add_dependency 'net-ssh-gateway', '~> 2.0.0'
   spec.add_dependency 'pry', '~> 0.13.1'

data/lib/arql/app.rb

@@ -22,6 +22,7 @@ module Arql
     def initialize(options)
       require 'active_support/all'
       require 'active_record'
+      require 'composite_primary_keys'
       require "arql/connection"
       require "arql/definition"
       @options = options

data/lib/arql/commands/models.rb

@@ -5,25 +5,29 @@ module Arql::Commands
     class << self
       def models
         t = []
-        t << ['Table Name', 'Model Class', 'Abbr']
+        t << ['Table Name', 'Model Class', 'Abbr', 'Comment']
         t << nil
         Arql::Definition.models.each do |definition|
-          t << [definition[:table], definition[:model].name, definition[:abbr] || '']
+          t << [definition[:table], definition[:model].name, definition[:abbr] || '', definition[:comment] || '']
         end
         t
       end
 
-      def models_table
+      def models_table(regexp)
         Terminal::Table.new do |t|
-          models.each { |row| t << (row || :separator) }
+          models.each_with_index { |row, idx| t << (row || :separator) if row.nil? ||
+            regexp.nil? ||
+            idx.zero? ||
+            row.any? { |e| e =~ regexp }
+          }
         end
       end
     end
   end
 
-  Pry.commands.block_command 'm' do
+  Pry.commands.block_command 'm' do |regexp|
     puts
-    puts Models::models_table
+    puts Models::models_table(regexp.try { |e| e.start_with?('/') ? eval(e) : Regexp.new(e) })
   end
 
   Pry.commands.alias_command 'l', 'm'

data/lib/arql/commands/table.rb

@@ -25,7 +25,7 @@ module Arql::Commands
         t << nil
         connection = ::ActiveRecord::Base.connection
         connection.columns(table_name).each do |column|
-          pk = if column.name == connection.primary_key(table_name)
+          pk = if [connection.primary_key(table_name)].flatten.include?(column.name)
                  'Y'
                else
                  ''

data/lib/arql/definition.rb

@@ -83,13 +83,18 @@ module Arql
         @@models = []
         ActiveRecord::Base.connection.tap do |conn|
           conn.tables.each do |table_name|
+            table_comment = conn.table_comment(table_name)
             conn.primary_key(table_name).tap do |pkey|
               table_name.camelize.tap do |const_name|
                 const_name = 'Modul' if const_name == 'Module'
                 const_name = 'Clazz' if const_name == 'Class'
                 Class.new(::ArqlModel) do
                   include Arql::Extension
-                  self.primary_key = pkey
+                  if pkey.is_a?(Array)
+                    self.primary_keys = pkey
+                  else
+                    self.primary_key = pkey
+                  end
                   self.table_name = table_name
                   self.inheritance_column = nil
                   self.default_timezone = :local
@@ -106,16 +111,22 @@ module Arql
                   end
                 end.tap do |clazz|
                   Object.const_set(const_name, clazz).tap do |const|
-                    const_name.gsub(/[a-z]*/, '').tap do |abbr|
-                      unless Object.const_defined?(abbr)
-                        Object.const_set abbr, const
-                        abbr_const = abbr
+                    const_name.gsub(/[a-z]*/, '').tap do |bare_abbr|
+                      abbr_const = nil
+                      9.times do |idx|
+                        abbr = idx.zero? ? bare_abbr : "#{bare_abbr}#{idx+1}"
+                        unless Object.const_defined?(abbr)
+                          Object.const_set abbr, const
+                          abbr_const = abbr
+                          break
+                        end
                       end
 
                       @@models << {
                         model: const,
                         abbr: abbr_const,
-                        table: table_name
+                        table: table_name,
+                        comment: table_comment
                       }
                     end
                   end
@@ -133,15 +144,258 @@ module Arql
       @@options = options
       @@models = []
       ActiveRecord::Base.connection.tap do |conn|
-        Object.const_set('ArqlModel', Class.new(ActiveRecord::Base) { self.abstract_class = true })
+        Object.const_set('ArqlModel', Class.new(ActiveRecord::Base) do
+                           self.abstract_class = true
+
+                           define_singleton_method(:indexes) do
+                             conn.indexes(table_name).map do |idx|
+                               {
+                                 Table: idx.table,
+                                 Name: idx.name,
+                                 Columns: idx.columns.join(', '),
+                                 Unique: idx.unique,
+                                 Comment: idx.comment
+                               }
+                             end.t
+                           end
+                           # Add a new +type+ column named +column_name+ to +table_name+.
+                           #
+                           # The +type+ parameter is normally one of the migrations native types,
+                           # which is one of the following:
+                           # <tt>:primary_key</tt>, <tt>:string</tt>, <tt>:text</tt>,
+                           # <tt>:integer</tt>, <tt>:bigint</tt>, <tt>:float</tt>, <tt>:decimal</tt>, <tt>:numeric</tt>,
+                           # <tt>:datetime</tt>, <tt>:time</tt>, <tt>:date</tt>,
+                           # <tt>:binary</tt>, <tt>:boolean</tt>.
+                           #
+                           # You may use a type not in this list as long as it is supported by your
+                           # database (for example, "polygon" in MySQL), but this will not be database
+                           # agnostic and should usually be avoided.
+                           #
+                           # Available options are (none of these exists by default):
+                           # * <tt>:limit</tt> -
+                           #   Requests a maximum column length. This is the number of characters for a <tt>:string</tt> column
+                           #   and number of bytes for <tt>:text</tt>, <tt>:binary</tt>, and <tt>:integer</tt> columns.
+                           #   This option is ignored by some backends.
+                           # * <tt>:default</tt> -
+                           #   The column's default value. Use +nil+ for +NULL+.
+                           # * <tt>:null</tt> -
+                           #   Allows or disallows +NULL+ values in the column.
+                           # * <tt>:precision</tt> -
+                           #   Specifies the precision for the <tt>:decimal</tt>, <tt>:numeric</tt>,
+                           #   <tt>:datetime</tt>, and <tt>:time</tt> columns.
+                           # * <tt>:scale</tt> -
+                           #   Specifies the scale for the <tt>:decimal</tt> and <tt>:numeric</tt> columns.
+                           # * <tt>:collation</tt> -
+                           #   Specifies the collation for a <tt>:string</tt> or <tt>:text</tt> column. If not specified, the
+                           #   column will have the same collation as the table.
+                           # * <tt>:comment</tt> -
+                           #   Specifies the comment for the column. This option is ignored by some backends.
+                           #
+                           # Note: The precision is the total number of significant digits,
+                           # and the scale is the number of digits that can be stored following
+                           # the decimal point. For example, the number 123.45 has a precision of 5
+                           # and a scale of 2. A decimal with a precision of 5 and a scale of 2 can
+                           # range from -999.99 to 999.99.
+                           #
+                           # Please be aware of different RDBMS implementations behavior with
+                           # <tt>:decimal</tt> columns:
+                           # * The SQL standard says the default scale should be 0, <tt>:scale</tt> <=
+                           #   <tt>:precision</tt>, and makes no comments about the requirements of
+                           #   <tt>:precision</tt>.
+                           # * MySQL: <tt>:precision</tt> [1..63], <tt>:scale</tt> [0..30].
+                           #   Default is (10,0).
+                           # * PostgreSQL: <tt>:precision</tt> [1..infinity],
+                           #   <tt>:scale</tt> [0..infinity]. No default.
+                           # * SQLite3: No restrictions on <tt>:precision</tt> and <tt>:scale</tt>,
+                           #   but the maximum supported <tt>:precision</tt> is 16. No default.
+                           # * Oracle: <tt>:precision</tt> [1..38], <tt>:scale</tt> [-84..127].
+                           #   Default is (38,0).
+                           # * DB2: <tt>:precision</tt> [1..63], <tt>:scale</tt> [0..62].
+                           #   Default unknown.
+                           # * SqlServer: <tt>:precision</tt> [1..38], <tt>:scale</tt> [0..38].
+                           #   Default (38,0).
+                           #
+                           # == Examples
+                           #
+                           #  User.add_column(:picture, :binary, limit: 2.megabytes)
+                           #  # ALTER TABLE "users" ADD "picture" blob(2097152)
+                           #
+                           #  Article.add_column(:status, :string, limit: 20, default: 'draft', null: false)
+                           #  # ALTER TABLE "articles" ADD "status" varchar(20) DEFAULT 'draft' NOT NULL
+                           #
+                           #  Answer.add_column(:bill_gates_money, :decimal, precision: 15, scale: 2)
+                           #  # ALTER TABLE "answers" ADD "bill_gates_money" decimal(15,2)
+                           #
+                           #  Measurement.add_column(:sensor_reading, :decimal, precision: 30, scale: 20)
+                           #  # ALTER TABLE "measurements" ADD "sensor_reading" decimal(30,20)
+                           #
+                           #  # While :scale defaults to zero on most databases, it
+                           #  # probably wouldn't hurt to include it.
+                           #  Measurement.add_column(:huge_integer, :decimal, precision: 30)
+                           #  # ALTER TABLE "measurements" ADD "huge_integer" decimal(30)
+                           #
+                           #  # Defines a column that stores an array of a type.
+                           #  User.add_column(:skills, :text, array: true)
+                           #  # ALTER TABLE "users" ADD "skills" text[]
+                           #
+                           #  # Defines a column with a database-specific type.
+                           #  Shape.add_column(:triangle, 'polygon')
+                           #  # ALTER TABLE "shapes" ADD "triangle" polygon
+                           define_singleton_method(:add_column) do |column_name, type, **options|
+                             conn.add_column(table_name, column_name, type, **options)
+                           end
+
+                           # Changes the column's definition according to the new options.
+                           # See TableDefinition#column for details of the options you can use.
+                           #
+                           #   Supplier.change_column(:name, :string, limit: 80)
+                           #   Post.change_column(:description, :text)
+                           #
+                           define_singleton_method(:change_column) do |column_name, type, options = {}|
+                             conn.change_column(table_name, column_name, type, options)
+                           end
+
+                           # Removes the column from the table definition.
+                           #
+                           #   Supplier.remove_column(:qualification)
+                           #
+                           # The +type+ and +options+ parameters will be ignored if present. It can be helpful
+                           # to provide these in a migration's +change+ method so it can be reverted.
+                           # In that case, +type+ and +options+ will be used by #add_column.
+                           # Indexes on the column are automatically removed.
+                           define_singleton_method(:remove_column) do |column_name, type = nil, **options|
+                             conn.remove_column(table_name, column_name, type, **options)
+                           end
+
+                           # Adds a new index to the table. +column_name+ can be a single Symbol, or
+                           # an Array of Symbols.
+                           #
+                           # The index will be named after the table and the column name(s), unless
+                           # you pass <tt>:name</tt> as an option.
+                           #
+                           # ====== Creating a simple index
+                           #
+                           #   Supplier.add_index(:name)
+                           #
+                           # generates:
+                           #
+                           #   CREATE INDEX suppliers_name_index ON suppliers(name)
+                           #
+                           # ====== Creating a unique index
+                           #
+                           #   Account.add_index([:branch_id, :party_id], unique: true)
+                           #
+                           # generates:
+                           #
+                           #   CREATE UNIQUE INDEX accounts_branch_id_party_id_index ON accounts(branch_id, party_id)
+                           #
+                           # ====== Creating a named index
+                           #
+                           #   Account.add_index([:branch_id, :party_id], unique: true, name: 'by_branch_party')
+                           #
+                           # generates:
+                           #
+                           #  CREATE UNIQUE INDEX by_branch_party ON accounts(branch_id, party_id)
+                           #
+                           # ====== Creating an index with specific key length
+                           #
+                           #   Account.add_index(:name, name: 'by_name', length: 10)
+                           #
+                           # generates:
+                           #
+                           #   CREATE INDEX by_name ON accounts(name(10))
+                           #
+                           # ====== Creating an index with specific key lengths for multiple keys
+                           #
+                           #   Account.add_index([:name, :surname], name: 'by_name_surname', length: {name: 10, surname: 15})
+                           #
+                           # generates:
+                           #
+                           #   CREATE INDEX by_name_surname ON accounts(name(10), surname(15))
+                           #
+                           # Note: SQLite doesn't support index length.
+                           #
+                           # ====== Creating an index with a sort order (desc or asc, asc is the default)
+                           #
+                           #   Account.add_index([:branch_id, :party_id, :surname], order: {branch_id: :desc, party_id: :asc})
+                           #
+                           # generates:
+                           #
+                           #   CREATE INDEX by_branch_desc_party ON accounts(branch_id DESC, party_id ASC, surname)
+                           #
+                           # Note: MySQL only supports index order from 8.0.1 onwards (earlier versions accepted the syntax but ignored it).
+                           #
+                           # ====== Creating a partial index
+                           #
+                           #   Account.add_index([:branch_id, :party_id], unique: true, where: "active")
+                           #
+                           # generates:
+                           #
+                           #   CREATE UNIQUE INDEX index_accounts_on_branch_id_and_party_id ON accounts(branch_id, party_id) WHERE active
+                           #
+                           # Note: Partial indexes are only supported for PostgreSQL and SQLite 3.8.0+.
+                           #
+                           # ====== Creating an index with a specific method
+                           #
+                           #   Developer.add_index(:name, using: 'btree')
+                           #
+                           # generates:
+                           #
+                           #   CREATE INDEX index_developers_on_name ON developers USING btree (name) -- PostgreSQL
+                           #   CREATE INDEX index_developers_on_name USING btree ON developers (name) -- MySQL
+                           #
+                           # Note: only supported by PostgreSQL and MySQL
+                           #
+                           # ====== Creating an index with a specific operator class
+                           #
+                           #   Developer.add_index(:name, using: 'gist', opclass: :gist_trgm_ops)
+                           #   # CREATE INDEX developers_on_name ON developers USING gist (name gist_trgm_ops) -- PostgreSQL
+                           #
+                           #   Developer.add_index([:name, :city], using: 'gist', opclass: { city: :gist_trgm_ops })
+                           #   # CREATE INDEX developers_on_name_and_city ON developers USING gist (name, city gist_trgm_ops) -- PostgreSQL
+                           #
+                           #   Developer.add_index([:name, :city], using: 'gist', opclass: :gist_trgm_ops)
+                           #   # CREATE INDEX developers_on_name_and_city ON developers USING gist (name gist_trgm_ops, city gist_trgm_ops) -- PostgreSQL
+                           #
+                           # Note: only supported by PostgreSQL
+                           #
+                           # ====== Creating an index with a specific type
+                           #
+                           #   Developer.add_index(:name, type: :fulltext)
+                           #
+                           # generates:
+                           #
+                           #   CREATE FULLTEXT INDEX index_developers_on_name ON developers (name) -- MySQL
+                           #
+                           # Note: only supported by MySQL.
+                           #
+                           # ====== Creating an index with a specific algorithm
+                           #
+                           #  Developer.add_index(:name, algorithm: :concurrently)
+                           #  # CREATE INDEX CONCURRENTLY developers_on_name on developers (name)
+                           #
+                           # Note: only supported by PostgreSQL.
+                           #
+                           # Concurrently adding an index is not supported in a transaction.
+                           #
+                           # For more information see the {"Transactional Migrations" section}[rdoc-ref:Migration].
+                           define_singleton_method(:add_index) do |column_name, options = {}|
+                             conn.add_index(table_name, column_name, options)
+                           end
+                         end)
         conn.tables.each do |table_name|
+          table_comment = conn.table_comment(table_name)
           conn.primary_key(table_name).tap do |pkey|
             table_name.camelize.tap do |const_name|
               const_name = 'Modul' if const_name == 'Module'
               const_name = 'Clazz' if const_name == 'Class'
               Class.new(::ArqlModel) do
                 include Arql::Extension
-                self.primary_key = pkey
+                if pkey.is_a?(Array)
+                  self.primary_keys = pkey
+                else
+                  self.primary_key = pkey
+                end
                 self.table_name = table_name
                 self.inheritance_column = nil
                 self.default_timezone = :local
@@ -158,16 +412,22 @@ module Arql
                 end
               end.tap do |clazz|
                 Object.const_set(const_name, clazz).tap do |const|
-                  const_name.gsub(/[a-z]*/, '').tap do |abbr|
-                    unless Object.const_defined?(abbr)
-                      Object.const_set abbr, const
-                      abbr_const = abbr
+                  const_name.gsub(/[a-z]*/, '').tap do |bare_abbr|
+                    abbr_const = nil
+                    9.times do |idx|
+                      abbr = idx.zero? ? bare_abbr : "#{bare_abbr}#{idx+1}"
+                      unless Object.const_defined?(abbr)
+                        Object.const_set abbr, const
+                        abbr_const = abbr
+                        break
+                      end
                     end
 
                     @@models << {
                       model: const,
                       abbr: abbr_const,
-                      table: table_name
+                      table: table_name,
+                      comment: table_comment
                     }
                   end
                 end

data/lib/arql/ext/kernel.rb

@@ -25,7 +25,7 @@ module Kernel
           Terminal::Table.new { |t|
           t.headings = ['PK', 'Name', 'SQL Type', 'Limit', 'Precision', 'Scale', 'Default', 'Nullable', 'Comment']
           t.rows = table[:columns].map { |column|
-            pk = if column.name == ::ActiveRecord::Base.connection.primary_key(table_name)
+            pk = if [::ActiveRecord::Base.connection.primary_key(table_name)].flatten.include?(column_name)
                    'Y'
                  else
                    ''
@@ -44,7 +44,7 @@ module Kernel
           Terminal::Table.new { |t|
           t.headings = ['PK', 'Name', 'SQL Type', 'Limit', 'Precision', 'Scale', 'Default', 'Nullable', 'Comment']
           t.rows = table[:columns].map { |column|
-            pk = if column.name == ::ActiveRecord::Base.connection.primary_key(table_name)
+            pk = if [::ActiveRecord::Base.connection.primary_key(table_name)].flatten.include?(column_name)
                    'Y'
                  else
                    ''
@@ -105,4 +105,160 @@ module Kernel
       end
     end
   end
+
+  # Example:
+  #
+  #   create_table :post, id: false, primary_key: :id do |t|
+  #     t.column :id, :bigint, precison: 19, comment: 'ID'
+  #     t.column :name, :string, comment: '名称'
+  #     t.column :gmt_created, :datetime, comment: '创建时间'
+  #     t.column :gmt_modified, :datetime, comment: '最后修改时间'
+  #   end
+  #
+  # Creates a new table with the name +table_name+. +table_name+ may either
+  # be a String or a Symbol.
+  #
+  # There are two ways to work with #create_table. You can use the block
+  # form or the regular form, like this:
+  #
+  # === Block form
+  #
+  #   # create_table() passes a TableDefinition object to the block.
+  #   # This form will not only create the table, but also columns for the
+  #   # table.
+  #
+  #   create_table(:suppliers) do |t|
+  #     t.column :name, :string, limit: 60
+  #     # Other fields here
+  #   end
+  #
+  # === Block form, with shorthand
+  #
+  #   # You can also use the column types as method calls, rather than calling the column method.
+  #   create_table(:suppliers) do |t|
+  #     t.string :name, limit: 60
+  #     # Other fields here
+  #   end
+  #
+  # === Regular form
+  #
+  #   # Creates a table called 'suppliers' with no columns.
+  #   create_table(:suppliers)
+  #   # Add a column to 'suppliers'.
+  #   add_column(:suppliers, :name, :string, {limit: 60})
+  #
+  # The +options+ hash can include the following keys:
+  # [<tt>:id</tt>]
+  #   Whether to automatically add a primary key column. Defaults to true.
+  #   Join tables for {ActiveRecord::Base.has_and_belongs_to_many}[rdoc-ref:Associations::ClassMethods#has_and_belongs_to_many] should set it to false.
+  #
+  #   A Symbol can be used to specify the type of the generated primary key column.
+  # [<tt>:primary_key</tt>]
+  #   The name of the primary key, if one is to be added automatically.
+  #   Defaults to +id+. If <tt>:id</tt> is false, then this option is ignored.
+  #
+  #   If an array is passed, a composite primary key will be created.
+  #
+  #   Note that Active Record models will automatically detect their
+  #   primary key. This can be avoided by using
+  #   {self.primary_key=}[rdoc-ref:AttributeMethods::PrimaryKey::ClassMethods#primary_key=] on the model
+  #   to define the key explicitly.
+  #
+  # [<tt>:options</tt>]
+  #   Any extra options you want appended to the table definition.
+  # [<tt>:temporary</tt>]
+  #   Make a temporary table.
+  # [<tt>:force</tt>]
+  #   Set to true to drop the table before creating it.
+  #   Set to +:cascade+ to drop dependent objects as well.
+  #   Defaults to false.
+  # [<tt>:if_not_exists</tt>]
+  #   Set to true to avoid raising an error when the table already exists.
+  #   Defaults to false.
+  # [<tt>:as</tt>]
+  #   SQL to use to generate the table. When this option is used, the block is
+  #   ignored, as are the <tt>:id</tt> and <tt>:primary_key</tt> options.
+  #
+  # ====== Add a backend specific option to the generated SQL (MySQL)
+  #
+  #   create_table(:suppliers, options: 'ENGINE=InnoDB DEFAULT CHARSET=utf8mb4')
+  #
+  # generates:
+  #
+  #   CREATE TABLE suppliers (
+  #     id bigint auto_increment PRIMARY KEY
+  #   ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
+  #
+  # ====== Rename the primary key column
+  #
+  #   create_table(:objects, primary_key: 'guid') do |t|
+  #     t.column :name, :string, limit: 80
+  #   end
+  #
+  # generates:
+  #
+  #   CREATE TABLE objects (
+  #     guid bigint auto_increment PRIMARY KEY,
+  #     name varchar(80)
+  #   )
+  #
+  # ====== Change the primary key column type
+  #
+  #   create_table(:tags, id: :string) do |t|
+  #     t.column :label, :string
+  #   end
+  #
+  # generates:
+  #
+  #   CREATE TABLE tags (
+  #     id varchar PRIMARY KEY,
+  #     label varchar
+  #   )
+  #
+  # ====== Create a composite primary key
+  #
+  #   create_table(:orders, primary_key: [:product_id, :client_id]) do |t|
+  #     t.belongs_to :product
+  #     t.belongs_to :client
+  #   end
+  #
+  # generates:
+  #
+  #   CREATE TABLE order (
+  #       product_id bigint NOT NULL,
+  #       client_id bigint NOT NULL
+  #   );
+  #
+  #   ALTER TABLE ONLY "orders"
+  #     ADD CONSTRAINT orders_pkey PRIMARY KEY (product_id, client_id);
+  #
+  # ====== Do not add a primary key column
+  #
+  #   create_table(:categories_suppliers, id: false) do |t|
+  #     t.column :category_id, :bigint
+  #     t.column :supplier_id, :bigint
+  #   end
+  #
+  # generates:
+  #
+  #   CREATE TABLE categories_suppliers (
+  #     category_id bigint,
+  #     supplier_id bigint
+  #   )
+  #
+  # ====== Create a temporary table based on a query
+  #
+  #   create_table(:long_query, temporary: true,
+  #     as: "SELECT * FROM orders INNER JOIN line_items ON order_id=orders.id")
+  #
+  # generates:
+  #
+  #   CREATE TEMPORARY TABLE long_query AS
+  #     SELECT * FROM orders INNER JOIN line_items ON order_id=orders.id
+  #
+  # See also TableDefinition#column for details on how to create columns.
+
+  def create_table(table_name, **options, &blk)
+    ActiveRecord::Base.connection.create_table(table_name, **options, &blk)
+  end
 end

data/lib/arql/version.rb

@@ -1,3 +1,3 @@
 module Arql
-  VERSION = "0.2.5"
+  VERSION = "0.2.10"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: arql
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.10
 platform: ruby
 authors:
 - Liu Xiang
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-12-01 00:00:00.000000000 Z
+date: 2020-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mysql2
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 6.0.3
+- !ruby/object:Gem::Dependency
+  name: composite_primary_keys
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 12.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 12.0.3
 - !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement