skyward-orm 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (191) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +182 -75
  3. data/lib/skyward/orm/adapters/postgresql/connection.rb +52 -0
  4. data/lib/skyward/orm/adapters/postgresql.rb +283 -0
  5. data/lib/skyward/orm/adapters/sqlite/constraints.rb +172 -0
  6. data/lib/skyward/orm/adapters/sqlite.rb +317 -0
  7. data/lib/skyward/orm/adapters.rb +38 -0
  8. data/lib/skyward/orm/catalog/column.rb +12 -0
  9. data/lib/skyward/orm/catalog/constraint.rb +13 -0
  10. data/lib/skyward/orm/catalog/index.rb +11 -0
  11. data/lib/skyward/orm/catalog/table.rb +10 -0
  12. data/lib/skyward/orm/catalog.rb +6 -0
  13. data/lib/skyward/orm/cli/boot_file.rb +43 -0
  14. data/lib/skyward/orm/cli/migrate.rb +30 -0
  15. data/lib/skyward/orm/cli/migration.rb +111 -0
  16. data/lib/skyward/orm/cli/rollback.rb +18 -0
  17. data/lib/skyward/orm/cli/status.rb +36 -0
  18. data/lib/skyward/orm/cli.rb +4 -0
  19. data/lib/skyward/orm/commands.rb +64 -0
  20. data/lib/skyward/orm/connection/database/schema_check.rb +67 -0
  21. data/lib/skyward/orm/connection/database.rb +357 -0
  22. data/lib/skyward/orm/connection/pool.rb +102 -0
  23. data/lib/skyward/orm/connection/session.rb +38 -0
  24. data/lib/skyward/orm/connection.rb +7 -0
  25. data/lib/skyward/orm/members.rb +16 -0
  26. data/lib/skyward/orm/migration_error.rb +4 -0
  27. data/lib/skyward/orm/migrations/add_column.rb +7 -0
  28. data/lib/skyward/orm/migrations/add_constraint.rb +7 -0
  29. data/lib/skyward/orm/migrations/add_index.rb +7 -0
  30. data/lib/skyward/orm/migrations/alter_table.rb +12 -0
  31. data/lib/skyward/orm/migrations/change_default.rb +9 -0
  32. data/lib/skyward/orm/migrations/change_nullable.rb +8 -0
  33. data/lib/skyward/orm/migrations/change_type.rb +9 -0
  34. data/lib/skyward/orm/migrations/create_table.rb +8 -0
  35. data/lib/skyward/orm/migrations/definitions.rb +176 -0
  36. data/lib/skyward/orm/migrations/diff.rb +213 -0
  37. data/lib/skyward/orm/migrations/directory.rb +48 -0
  38. data/lib/skyward/orm/migrations/discovery.rb +14 -0
  39. data/lib/skyward/orm/migrations/drop_column.rb +7 -0
  40. data/lib/skyward/orm/migrations/drop_constraint.rb +7 -0
  41. data/lib/skyward/orm/migrations/drop_index.rb +7 -0
  42. data/lib/skyward/orm/migrations/rename_column.rb +8 -0
  43. data/lib/skyward/orm/migrations/runner/edited.rb +7 -0
  44. data/lib/skyward/orm/migrations/runner/failed.rb +8 -0
  45. data/lib/skyward/orm/migrations/runner/irreversible.rb +7 -0
  46. data/lib/skyward/orm/migrations/runner/locked.rb +8 -0
  47. data/lib/skyward/orm/migrations/runner/migration.rb +11 -0
  48. data/lib/skyward/orm/migrations/runner/missing.rb +7 -0
  49. data/lib/skyward/orm/migrations/runner/raced.rb +7 -0
  50. data/lib/skyward/orm/migrations/runner.rb +227 -0
  51. data/lib/skyward/orm/migrations/script.rb +350 -0
  52. data/lib/skyward/orm/migrations/status.rb +93 -0
  53. data/lib/skyward/orm/migrations/summary.rb +110 -0
  54. data/lib/skyward/orm/migrations/versions.rb +19 -0
  55. data/lib/skyward/orm/migrations.rb +8 -0
  56. data/lib/skyward/orm/placeholders.rb +37 -0
  57. data/lib/skyward/orm/pool_timeout.rb +4 -0
  58. data/lib/skyward/orm/projection.rb +67 -0
  59. data/lib/skyward/orm/queries/clauses.rb +588 -0
  60. data/lib/skyward/orm/queries.rb +4 -0
  61. data/lib/skyward/orm/query.rb +26 -0
  62. data/lib/skyward/orm/record.rb +96 -0
  63. data/lib/skyward/orm/schema_mismatch.rb +4 -0
  64. data/lib/skyward/orm/statements.rb +97 -0
  65. data/lib/skyward/orm/tables/check.rb +8 -0
  66. data/lib/skyward/orm/tables/column.rb +10 -0
  67. data/lib/skyward/orm/tables/column_types.rb +74 -0
  68. data/lib/skyward/orm/tables/declarations.rb +172 -0
  69. data/lib/skyward/orm/tables/length.rb +8 -0
  70. data/lib/skyward/orm/tables/loaded.rb +21 -0
  71. data/lib/skyward/orm/tables/reference.rb +9 -0
  72. data/lib/skyward/orm/tables/rows.rb +52 -0
  73. data/lib/skyward/orm/tables/schema.rb +14 -0
  74. data/lib/skyward/orm/tables/sql.rb +7 -0
  75. data/lib/skyward/orm/tables/validation.rb +29 -0
  76. data/lib/skyward/orm/tables/values.rb +102 -0
  77. data/lib/skyward/orm/tables.rb +7 -0
  78. data/lib/skyward/orm/transactional.rb +18 -0
  79. data/lib/skyward/orm/version.rb +1 -1
  80. data/lib/skyward/orm/violation.rb +13 -0
  81. data/lib/skyward/orm/violation_error.rb +13 -0
  82. data/lib/skyward/orm.rb +72 -1
  83. data/sig/generated/skyward/orm/adapters/postgresql/connection.rbs +41 -0
  84. data/sig/generated/skyward/orm/adapters/postgresql.rbs +138 -0
  85. data/sig/generated/skyward/orm/adapters/sqlite/constraints.rbs +87 -0
  86. data/sig/generated/skyward/orm/adapters/sqlite.rbs +166 -0
  87. data/sig/generated/skyward/orm/adapters.rbs +15 -0
  88. data/sig/generated/skyward/orm/catalog/column.rbs +20 -0
  89. data/sig/generated/skyward/orm/catalog/constraint.rbs +22 -0
  90. data/sig/generated/skyward/orm/catalog/index.rbs +20 -0
  91. data/sig/generated/skyward/orm/catalog/table.rbs +20 -0
  92. data/sig/generated/skyward/orm/catalog.rbs +5 -0
  93. data/sig/generated/skyward/orm/cli/boot_file.rbs +21 -0
  94. data/sig/generated/skyward/orm/cli/migrate.rbs +15 -0
  95. data/sig/generated/skyward/orm/cli/migration.rbs +45 -0
  96. data/sig/generated/skyward/orm/cli/rollback.rbs +7 -0
  97. data/sig/generated/skyward/orm/cli/status.rbs +17 -0
  98. data/sig/generated/skyward/orm/cli.rbs +4 -0
  99. data/sig/generated/skyward/orm/commands.rbs +2 -0
  100. data/sig/generated/skyward/orm/connection/database/schema_check.rbs +31 -0
  101. data/sig/generated/skyward/orm/connection/database.rbs +226 -0
  102. data/sig/generated/skyward/orm/connection/pool.rbs +54 -0
  103. data/sig/generated/skyward/orm/connection/session.rbs +25 -0
  104. data/sig/generated/skyward/orm/connection.rbs +7 -0
  105. data/sig/generated/skyward/orm/members.rbs +9 -0
  106. data/sig/generated/skyward/orm/migration_error.rbs +4 -0
  107. data/sig/generated/skyward/orm/migrations/add_column.rbs +14 -0
  108. data/sig/generated/skyward/orm/migrations/add_constraint.rbs +14 -0
  109. data/sig/generated/skyward/orm/migrations/add_index.rbs +14 -0
  110. data/sig/generated/skyward/orm/migrations/alter_table.rbs +22 -0
  111. data/sig/generated/skyward/orm/migrations/change_default.rbs +18 -0
  112. data/sig/generated/skyward/orm/migrations/change_nullable.rbs +16 -0
  113. data/sig/generated/skyward/orm/migrations/change_type.rbs +18 -0
  114. data/sig/generated/skyward/orm/migrations/create_table.rbs +16 -0
  115. data/sig/generated/skyward/orm/migrations/definitions.rbs +81 -0
  116. data/sig/generated/skyward/orm/migrations/diff.rbs +99 -0
  117. data/sig/generated/skyward/orm/migrations/directory.rbs +37 -0
  118. data/sig/generated/skyward/orm/migrations/discovery.rbs +9 -0
  119. data/sig/generated/skyward/orm/migrations/drop_column.rbs +14 -0
  120. data/sig/generated/skyward/orm/migrations/drop_constraint.rbs +14 -0
  121. data/sig/generated/skyward/orm/migrations/drop_index.rbs +14 -0
  122. data/sig/generated/skyward/orm/migrations/rename_column.rbs +16 -0
  123. data/sig/generated/skyward/orm/migrations/runner/edited.rbs +14 -0
  124. data/sig/generated/skyward/orm/migrations/runner/failed.rbs +16 -0
  125. data/sig/generated/skyward/orm/migrations/runner/irreversible.rbs +14 -0
  126. data/sig/generated/skyward/orm/migrations/runner/locked.rbs +16 -0
  127. data/sig/generated/skyward/orm/migrations/runner/migration.rbs +22 -0
  128. data/sig/generated/skyward/orm/migrations/runner/missing.rbs +14 -0
  129. data/sig/generated/skyward/orm/migrations/runner/raced.rbs +14 -0
  130. data/sig/generated/skyward/orm/migrations/runner.rbs +73 -0
  131. data/sig/generated/skyward/orm/migrations/script.rbs +161 -0
  132. data/sig/generated/skyward/orm/migrations/status.rbs +49 -0
  133. data/sig/generated/skyward/orm/migrations/summary.rbs +50 -0
  134. data/sig/generated/skyward/orm/migrations/versions.rbs +11 -0
  135. data/sig/generated/skyward/orm/migrations.rbs +7 -0
  136. data/sig/generated/skyward/orm/placeholders.rbs +21 -0
  137. data/sig/generated/skyward/orm/pool_timeout.rbs +4 -0
  138. data/sig/generated/skyward/orm/projection.rbs +42 -0
  139. data/sig/generated/skyward/orm/queries/clauses.rbs +367 -0
  140. data/sig/generated/skyward/orm/queries.rbs +4 -0
  141. data/sig/generated/skyward/orm/query.rbs +20 -0
  142. data/sig/generated/skyward/orm/record.rbs +80 -0
  143. data/sig/generated/skyward/orm/schema_mismatch.rbs +4 -0
  144. data/sig/generated/skyward/orm/statements.rbs +53 -0
  145. data/sig/generated/skyward/orm/tables/check.rbs +16 -0
  146. data/sig/generated/skyward/orm/tables/column.rbs +20 -0
  147. data/sig/generated/skyward/orm/tables/column_types.rbs +39 -0
  148. data/sig/generated/skyward/orm/tables/declarations.rbs +87 -0
  149. data/sig/generated/skyward/orm/tables/length.rbs +16 -0
  150. data/sig/generated/skyward/orm/tables/loaded.rbs +14 -0
  151. data/sig/generated/skyward/orm/tables/reference.rbs +18 -0
  152. data/sig/generated/skyward/orm/tables/rows.rbs +24 -0
  153. data/sig/generated/skyward/orm/tables/schema.rbs +28 -0
  154. data/sig/generated/skyward/orm/tables/sql.rbs +14 -0
  155. data/sig/generated/skyward/orm/tables/validation.rbs +9 -0
  156. data/sig/generated/skyward/orm/tables/values.rbs +49 -0
  157. data/sig/generated/skyward/orm/tables.rbs +7 -0
  158. data/sig/generated/skyward/orm/transactional.rbs +11 -0
  159. data/sig/generated/skyward/orm/violation.rbs +22 -0
  160. data/sig/generated/skyward/orm/violation_error.rbs +10 -0
  161. data/sig/generated/skyward/orm.rbs +29 -0
  162. data/sig/manual/pg.rbs +31 -0
  163. data/sig/manual/skyward/orm/adapters/postgresql.rbs +3 -0
  164. data/sig/manual/skyward/orm/adapters/sqlite/constraints.rbs +3 -0
  165. data/sig/manual/skyward/orm/adapters/sqlite.rbs +3 -0
  166. data/sig/manual/skyward/orm/adapters.rbs +3 -0
  167. data/sig/manual/skyward/orm/cli/boot_file.rbs +3 -0
  168. data/sig/manual/skyward/orm/cli/migrate.rbs +3 -0
  169. data/sig/manual/skyward/orm/cli/migration.rbs +3 -0
  170. data/sig/manual/skyward/orm/cli/rollback.rbs +3 -0
  171. data/sig/manual/skyward/orm/cli/status.rbs +3 -0
  172. data/sig/manual/skyward/orm/connection/database/schema_check.rbs +3 -0
  173. data/sig/manual/skyward/orm/members.rbs +3 -0
  174. data/sig/manual/skyward/orm/migrations/definitions.rbs +3 -0
  175. data/sig/manual/skyward/orm/migrations/diff.rbs +3 -0
  176. data/sig/manual/skyward/orm/migrations/directory.rbs +3 -0
  177. data/sig/manual/skyward/orm/migrations/discovery.rbs +3 -0
  178. data/sig/manual/skyward/orm/migrations/runner.rbs +3 -0
  179. data/sig/manual/skyward/orm/migrations/script.rbs +3 -0
  180. data/sig/manual/skyward/orm/migrations/status.rbs +3 -0
  181. data/sig/manual/skyward/orm/migrations/summary.rbs +3 -0
  182. data/sig/manual/skyward/orm/migrations/versions.rbs +3 -0
  183. data/sig/manual/skyward/orm/placeholders.rbs +3 -0
  184. data/sig/manual/skyward/orm/statements.rbs +3 -0
  185. data/sig/manual/skyward/orm/tables/loaded.rbs +3 -0
  186. data/sig/manual/skyward/orm/tables/rows.rbs +3 -0
  187. data/sig/manual/skyward/orm/tables/validation.rbs +3 -0
  188. data/sig/manual/skyward/orm/tables/values.rbs +3 -0
  189. data/sig/manual/skyward/orm.rbs +45 -0
  190. data/sig/manual/sqlite3.rbs +23 -0
  191. metadata +188 -3
@@ -0,0 +1,18 @@
1
+ # Generated from lib/skyward/orm/migrations/change_default.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class ChangeDefault < Data
5
+ attr_reader column(): Symbol
6
+
7
+ attr_reader from(): String?
8
+
9
+ attr_reader to(): String?
10
+
11
+ def self.new: (Symbol column, String? from, String? to) -> instance
12
+ | (column: Symbol, from: String?, to: String?) -> instance
13
+
14
+ def self.members: () -> [ :column, :from, :to ]
15
+
16
+ def members: () -> [ :column, :from, :to ]
17
+ end
18
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/migrations/change_nullable.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class ChangeNullable < Data
5
+ attr_reader column(): Symbol
6
+
7
+ attr_reader nullable(): bool
8
+
9
+ def self.new: (Symbol column, bool nullable) -> instance
10
+ | (column: Symbol, nullable: bool) -> instance
11
+
12
+ def self.members: () -> [ :column, :nullable ]
13
+
14
+ def members: () -> [ :column, :nullable ]
15
+ end
16
+ end
@@ -0,0 +1,18 @@
1
+ # Generated from lib/skyward/orm/migrations/change_type.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class ChangeType < Data
5
+ attr_reader column(): Symbol
6
+
7
+ attr_reader from(): String
8
+
9
+ attr_reader to(): String
10
+
11
+ def self.new: (Symbol column, String from, String to) -> instance
12
+ | (column: Symbol, from: String, to: String) -> instance
13
+
14
+ def self.members: () -> [ :column, :from, :to ]
15
+
16
+ def members: () -> [ :column, :from, :to ]
17
+ end
18
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/migrations/create_table.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class CreateTable < Data
5
+ attr_reader klass(): singleton(Skyward::ORM::Record)
6
+
7
+ attr_reader columns(): Array[Skyward::ORM::Tables::Column]
8
+
9
+ def self.new: (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns) -> instance
10
+ | (klass: singleton(Skyward::ORM::Record), columns: Array[Skyward::ORM::Tables::Column]) -> instance
11
+
12
+ def self.members: () -> [ :klass, :columns ]
13
+
14
+ def members: () -> [ :klass, :columns ]
15
+ end
16
+ end
@@ -0,0 +1,81 @@
1
+ # Generated from lib/skyward/orm/migrations/definitions.rb with RBS::Inline
2
+
3
+ # What a class's declarations make of its table, written as the catalog reads
4
+ # a table back, so a migration can write it and compare it with the database.
5
+ #
6
+ # Every constraint and index is named, so a violation names the same
7
+ # constraint on every database: SQLite reports an unnamed check by its
8
+ # expression, where PostgreSQL would make up these names.
9
+ module Skyward::ORM::Migrations::Definitions
10
+ ON_DELETE: Hash[Skyward::ORM::Tables::on_delete, String]
11
+
12
+ # Each column's constraints, in the order a column lists them, then each
13
+ # unique on more than one column.
14
+ # @rbs klass: singleton(Skyward::ORM::Record)
15
+ # @rbs columns: Array[Skyward::ORM::Tables::Column]
16
+ # @rbs return: Array[Skyward::ORM::Catalog::Constraint]
17
+ def constraints: (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns) -> Array[Skyward::ORM::Catalog::Constraint]
18
+
19
+ # @rbs klass: singleton(Skyward::ORM::Record)
20
+ # @rbs return: Array[Skyward::ORM::Catalog::Index]
21
+ def indexes: (singleton(Skyward::ORM::Record) klass) -> Array[Skyward::ORM::Catalog::Index]
22
+
23
+ # The SQL that follows the column's DEFAULT, or nil when it has none.
24
+ # @rbs klass: singleton(Skyward::ORM::Record)
25
+ # @rbs column: Symbol
26
+ # @rbs adapter: Skyward::ORM::_Adapter
27
+ # @rbs return: String?
28
+ def default: (singleton(Skyward::ORM::Record) klass, Symbol column, Skyward::ORM::_Adapter adapter) -> String?
29
+
30
+ # The constraint as a column's own, in a column's definition.
31
+ # @rbs constraint: Skyward::ORM::Catalog::Constraint
32
+ # @rbs return: String
33
+ def inline: (Skyward::ORM::Catalog::Constraint constraint) -> String
34
+
35
+ # @rbs value: untyped
36
+ # @rbs return: String
37
+ def literal: (untyped value) -> String
38
+
39
+ private
40
+
41
+ # @rbs name: String
42
+ # @rbs kind: Skyward::ORM::Catalog::constraint_kind
43
+ # @rbs columns: Array[Symbol]
44
+ # @rbs definition: String
45
+ # @rbs references: Symbol?
46
+ # @rbs return: Skyward::ORM::Catalog::Constraint
47
+ def constraint: (String name, Skyward::ORM::Catalog::constraint_kind kind, Array[Symbol] columns, String definition, ?Symbol? references) -> Skyward::ORM::Catalog::Constraint
48
+
49
+ # @rbs table: Symbol
50
+ # @rbs columns: Array[Symbol]
51
+ # @rbs return: Skyward::ORM::Catalog::Constraint
52
+ def unique: (Symbol table, Array[Symbol] columns) -> Skyward::ORM::Catalog::Constraint
53
+
54
+ # A symbol union's check comes first, as part of the column's type.
55
+ # @rbs table: Symbol
56
+ # @rbs column: Skyward::ORM::Tables::Column
57
+ # @rbs checks: Array[Skyward::ORM::Tables::Check]
58
+ # @rbs return: Array[Skyward::ORM::Catalog::Constraint]
59
+ def checks: (Symbol table, Skyward::ORM::Tables::Column column, Array[Skyward::ORM::Tables::Check] checks) -> Array[Skyward::ORM::Catalog::Constraint]
60
+
61
+ # @rbs column: Symbol
62
+ # @rbs rule: Skyward::ORM::Tables::SQL | Skyward::ORM::Tables::Length
63
+ # @rbs return: String
64
+ def rule: (Symbol column, Skyward::ORM::Tables::SQL | Skyward::ORM::Tables::Length rule) -> String
65
+
66
+ # @rbs column: Symbol
67
+ # @rbs length: Skyward::ORM::Tables::Length
68
+ # @rbs return: String
69
+ def length: (Symbol column, Skyward::ORM::Tables::Length length) -> String
70
+
71
+ # @rbs table: Symbol
72
+ # @rbs reference: Skyward::ORM::Tables::Reference
73
+ # @rbs return: Skyward::ORM::Catalog::Constraint
74
+ def reference: (Symbol table, Skyward::ORM::Tables::Reference reference) -> Skyward::ORM::Catalog::Constraint
75
+
76
+ # @rbs table: Symbol
77
+ # @rbs columns: Array[Symbol]
78
+ # @rbs suffix: String
79
+ # @rbs return: String
80
+ def name: (Symbol table, Array[Symbol] columns, String suffix) -> String
81
+ end
@@ -0,0 +1,99 @@
1
+ # Generated from lib/skyward/orm/migrations/diff.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Diff
4
+ ON_DELETE: Regexp
5
+
6
+ NULL: String
7
+
8
+ # New tables come first, each after the tables it references, so a changed
9
+ # table can reference a new table too. A table with no class is left alone:
10
+ # a class that isn't loaded looks the same.
11
+ # @rbs (Array[singleton(Skyward::ORM::Record)] classes, Skyward::ORM::Tables::ColumnTypes column_types,
12
+ # Array[Skyward::ORM::Catalog::Table] tables, Skyward::ORM::_Adapter adapter,
13
+ # ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Array[Skyward::ORM::Migrations::change]
14
+ def changes: (Array[singleton(Skyward::ORM::Record)] classes, Skyward::ORM::Tables::ColumnTypes column_types, Array[Skyward::ORM::Catalog::Table] tables, Skyward::ORM::_Adapter adapter, ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Array[Skyward::ORM::Migrations::change]
15
+
16
+ private
17
+
18
+ # @rbs classes: Array[singleton(Skyward::ORM::Record)]
19
+ # @rbs return: void
20
+ def refuse_shared: (Array[singleton(Skyward::ORM::Record)] classes) -> void
21
+
22
+ # Indexes and constraints go before the columns they're on, and come back
23
+ # after the columns they need.
24
+ # @rbs (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns,
25
+ # Skyward::ORM::Catalog::Table table, Skyward::ORM::_Adapter adapter,
26
+ # ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Skyward::ORM::Migrations::AlterTable?
27
+ def altered: (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns, Skyward::ORM::Catalog::Table table, Skyward::ORM::_Adapter adapter, ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Skyward::ORM::Migrations::AlterTable?
28
+
29
+ # The indexes to drop and to add. One is compared by the columns it will
30
+ # have after any rename, and dropped as the database has it.
31
+ # @rbs klass: singleton(Skyward::ORM::Record)
32
+ # @rbs table: Skyward::ORM::Catalog::Table
33
+ # @rbs renamed: Hash[Symbol, Symbol]
34
+ # @rbs return: [Array[Skyward::ORM::Migrations::edit], Array[Skyward::ORM::Migrations::edit]]
35
+ def indexes: (singleton(Skyward::ORM::Record) klass, Skyward::ORM::Catalog::Table table, Hash[Symbol, Symbol] renamed) -> [ Array[Skyward::ORM::Migrations::edit], Array[Skyward::ORM::Migrations::edit] ]
36
+
37
+ # The constraints to drop and to add, compared as indexes are. A new
38
+ # column's own constraints are part of its definition.
39
+ # @rbs (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns,
40
+ # Skyward::ORM::Catalog::Table table, Hash[Symbol, Symbol] renamed, Array[Skyward::ORM::Tables::Column] new_columns)
41
+ # -> [Array[Skyward::ORM::Migrations::edit], Array[Skyward::ORM::Migrations::edit]]
42
+ def constraints: (singleton(Skyward::ORM::Record) klass, Array[Skyward::ORM::Tables::Column] columns, Skyward::ORM::Catalog::Table table, Hash[Symbol, Symbol] renamed, Array[Skyward::ORM::Tables::Column] new_columns) -> [ Array[Skyward::ORM::Migrations::edit], Array[Skyward::ORM::Migrations::edit] ]
43
+
44
+ # Each column that went is asked about each new one of a compatible type, in
45
+ # order, until one is a rename. A column it renames to isn't asked about again.
46
+ # @rbs (Symbol table, Array[Skyward::ORM::Catalog::Column] removed, Array[Skyward::ORM::Tables::Column] added,
47
+ # Skyward::ORM::_Adapter adapter, ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Hash[Symbol, Symbol]
48
+ def renames: (Symbol table, Array[Skyward::ORM::Catalog::Column] removed, Array[Skyward::ORM::Tables::Column] added, Skyward::ORM::_Adapter adapter, ^(Symbol table, Symbol from, Symbol to) -> bool rename) -> Hash[Symbol, Symbol]
49
+
50
+ # An untyped column has no type or nullability to compare.
51
+ # @rbs klass: singleton(Skyward::ORM::Record)
52
+ # @rbs column: Skyward::ORM::Tables::Column
53
+ # @rbs had: Skyward::ORM::Catalog::Column
54
+ # @rbs adapter: Skyward::ORM::_Adapter
55
+ # @rbs return: Array[Skyward::ORM::Migrations::edit]
56
+ def changed: (singleton(Skyward::ORM::Record) klass, Skyward::ORM::Tables::Column column, Skyward::ORM::Catalog::Column had, Skyward::ORM::_Adapter adapter) -> Array[Skyward::ORM::Migrations::edit]
57
+
58
+ # Constraints are matched by name. SQLite can hold one with no name, which
59
+ # matches the one its class declares on the same columns. PostgreSQL rewrites
60
+ # a check's expression, and puts it on every column it mentions, so a check
61
+ # is matched by its name alone. A reference is also matched by what it does
62
+ # ON DELETE.
63
+ # @rbs had: Skyward::ORM::Catalog::Constraint
64
+ # @rbs wanted: Skyward::ORM::Catalog::Constraint
65
+ # @rbs return: bool
66
+ def same?: (Skyward::ORM::Catalog::Constraint had, Skyward::ORM::Catalog::Constraint wanted) -> bool
67
+
68
+ # @rbs constraint: Skyward::ORM::Catalog::Constraint
69
+ # @rbs return: String
70
+ def on_delete: (Skyward::ORM::Catalog::Constraint constraint) -> String
71
+
72
+ # An index is matched by its columns, so one a database already has under
73
+ # another name is kept.
74
+ # @rbs had: Skyward::ORM::Catalog::Index
75
+ # @rbs wanted: Skyward::ORM::Catalog::Index
76
+ # @rbs return: bool
77
+ def same_index?: (Skyward::ORM::Catalog::Index had, Skyward::ORM::Catalog::Index wanted) -> bool
78
+
79
+ # @rbs constraint: Skyward::ORM::Catalog::Constraint
80
+ # @rbs added: Array[Skyward::ORM::Tables::Column]
81
+ # @rbs return: bool
82
+ def inline?: (Skyward::ORM::Catalog::Constraint constraint, Array[Skyward::ORM::Tables::Column] added) -> bool
83
+
84
+ # @rbs columns: Array[Symbol]
85
+ # @rbs renamed: Hash[Symbol, Symbol]
86
+ # @rbs return: Array[Symbol]
87
+ def moved: (Array[Symbol] columns, Hash[Symbol, Symbol] renamed) -> Array[Symbol]
88
+
89
+ # Tables that reference each other can't all come after their parents, so
90
+ # the first left goes next.
91
+ # @rbs pending: Array[Skyward::ORM::Migrations::CreateTable]
92
+ # @rbs placed: Array[Skyward::ORM::Migrations::CreateTable]
93
+ # @rbs return: Array[Skyward::ORM::Migrations::CreateTable]
94
+ def parents_first: (Array[Skyward::ORM::Migrations::CreateTable] pending, ?Array[Skyward::ORM::Migrations::CreateTable] placed) -> Array[Skyward::ORM::Migrations::CreateTable]
95
+
96
+ # @rbs klass: singleton(Skyward::ORM::Record)
97
+ # @rbs return: Array[Symbol]
98
+ def parents: (singleton(Skyward::ORM::Record) klass) -> Array[Symbol]
99
+ end
@@ -0,0 +1,37 @@
1
+ # Generated from lib/skyward/orm/migrations/directory.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Directory
4
+ PATH: String
5
+
6
+ # @rbs directory: String
7
+ # @rbs name: String
8
+ # @rbs return: String?
9
+ def named: (String directory, String name) -> String?
10
+
11
+ # A migration's version is the timestamp its file name starts with.
12
+ # @rbs directory: String
13
+ # @rbs ran: Array[String]
14
+ # @rbs return: Array[String]
15
+ def pending: (String directory, Array[String] ran) -> Array[String]
16
+
17
+ # @rbs directory: String
18
+ # @rbs time: Time
19
+ # @rbs name: String
20
+ # @rbs sql: String
21
+ # @rbs return: String
22
+ def write: (String directory, Time time, String name, String sql) -> String
23
+
24
+ # @rbs path: String
25
+ # @rbs return: Array[String]
26
+ def sql_files: (String path) -> Array[String]
27
+
28
+ # @rbs file: String
29
+ # @rbs return: String
30
+ def version: (String file) -> String
31
+
32
+ private
33
+
34
+ # @rbs directory: String
35
+ # @rbs return: Array[String]
36
+ def files: (String directory) -> Array[String]
37
+ end
@@ -0,0 +1,9 @@
1
+ # Generated from lib/skyward/orm/migrations/discovery.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Discovery
4
+ # Subclasses lists only loaded classes, so an app that autoloads would
5
+ # otherwise hide every table class nothing has used yet.
6
+ # @rbs loader: singleton(Zeitwerk::Loader)
7
+ # @rbs return: Array[singleton(Skyward::ORM::Record)]
8
+ def table_classes: (singleton(Zeitwerk::Loader) loader) -> Array[singleton(Skyward::ORM::Record)]
9
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/drop_column.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class DropColumn < Data
5
+ attr_reader column(): Skyward::ORM::Catalog::Column
6
+
7
+ def self.new: (Skyward::ORM::Catalog::Column column) -> instance
8
+ | (column: Skyward::ORM::Catalog::Column) -> instance
9
+
10
+ def self.members: () -> [ :column ]
11
+
12
+ def members: () -> [ :column ]
13
+ end
14
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/drop_constraint.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class DropConstraint < Data
5
+ attr_reader constraint(): Skyward::ORM::Catalog::Constraint
6
+
7
+ def self.new: (Skyward::ORM::Catalog::Constraint constraint) -> instance
8
+ | (constraint: Skyward::ORM::Catalog::Constraint) -> instance
9
+
10
+ def self.members: () -> [ :constraint ]
11
+
12
+ def members: () -> [ :constraint ]
13
+ end
14
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/drop_index.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class DropIndex < Data
5
+ attr_reader index(): Skyward::ORM::Catalog::Index
6
+
7
+ def self.new: (Skyward::ORM::Catalog::Index index) -> instance
8
+ | (index: Skyward::ORM::Catalog::Index) -> instance
9
+
10
+ def self.members: () -> [ :index ]
11
+
12
+ def members: () -> [ :index ]
13
+ end
14
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/migrations/rename_column.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations
4
+ class RenameColumn < Data
5
+ attr_reader from(): Symbol
6
+
7
+ attr_reader to(): Symbol
8
+
9
+ def self.new: (Symbol from, Symbol to) -> instance
10
+ | (from: Symbol, to: Symbol) -> instance
11
+
12
+ def self.members: () -> [ :from, :to ]
13
+
14
+ def members: () -> [ :from, :to ]
15
+ end
16
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/edited.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Edited < Data
5
+ attr_reader files(): Array[String]
6
+
7
+ def self.new: (Array[String] files) -> instance
8
+ | (files: Array[String]) -> instance
9
+
10
+ def self.members: () -> [ :files ]
11
+
12
+ def members: () -> [ :files ]
13
+ end
14
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/failed.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Failed < Data
5
+ attr_reader file(): String
6
+
7
+ attr_reader message(): String
8
+
9
+ def self.new: (String file, String message) -> instance
10
+ | (file: String, message: String) -> instance
11
+
12
+ def self.members: () -> [ :file, :message ]
13
+
14
+ def members: () -> [ :file, :message ]
15
+ end
16
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/irreversible.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Irreversible < Data
5
+ attr_reader file(): String
6
+
7
+ def self.new: (String file) -> instance
8
+ | (file: String) -> instance
9
+
10
+ def self.members: () -> [ :file ]
11
+
12
+ def members: () -> [ :file ]
13
+ end
14
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/locked.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Locked < Data
5
+ attr_reader file(): String
6
+
7
+ attr_reader message(): String
8
+
9
+ def self.new: (String file, String message) -> instance
10
+ | (file: String, message: String) -> instance
11
+
12
+ def self.members: () -> [ :file, :message ]
13
+
14
+ def members: () -> [ :file, :message ]
15
+ end
16
+ end
@@ -0,0 +1,22 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/migration.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Migration < Data
5
+ attr_reader file(): String
6
+
7
+ attr_reader version(): String
8
+
9
+ attr_reader up(): String
10
+
11
+ attr_reader down(): String
12
+
13
+ attr_reader checksum(): String
14
+
15
+ def self.new: (String file, String version, String up, String down, String checksum) -> instance
16
+ | (file: String, version: String, up: String, down: String, checksum: String) -> instance
17
+
18
+ def self.members: () -> [ :file, :version, :up, :down, :checksum ]
19
+
20
+ def members: () -> [ :file, :version, :up, :down, :checksum ]
21
+ end
22
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/missing.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Missing < Data
5
+ attr_reader version(): String
6
+
7
+ def self.new: (String version) -> instance
8
+ | (version: String) -> instance
9
+
10
+ def self.members: () -> [ :version ]
11
+
12
+ def members: () -> [ :version ]
13
+ end
14
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/migrations/runner/raced.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ class Raced < Data
5
+ attr_reader file(): String
6
+
7
+ def self.new: (String file) -> instance
8
+ | (file: String) -> instance
9
+
10
+ def self.members: () -> [ :file ]
11
+
12
+ def members: () -> [ :file ]
13
+ end
14
+ end
@@ -0,0 +1,73 @@
1
+ # Generated from lib/skyward/orm/migrations/runner.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Migrations::Runner
4
+ type outcome = Array[String] | Edited | Locked | Failed
5
+
6
+ type unrolled = :nothing | Missing | Irreversible | Raced | Locked | Failed
7
+
8
+ type rolled_back = String | unrolled
9
+
10
+ TABLE: Symbol
11
+
12
+ DOWN: Regexp
13
+
14
+ # @rbs path: String
15
+ # @rbs return: Array[Migration]
16
+ def read: (String path) -> Array[Migration]
17
+
18
+ # Line endings are normalised first, so a checkout that converts them
19
+ # doesn't read as an edit.
20
+ # @rbs file: String
21
+ # @rbs source: String
22
+ # @rbs return: Migration
23
+ def parse: (String file, String source) -> Migration
24
+
25
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Array[Migration] migrations) -> outcome
26
+ def run: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Array[Migration] migrations) -> outcome
27
+
28
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Array[Migration] migrations)
29
+ # -> rolled_back
30
+ def rollback: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Array[Migration] migrations) -> rolled_back
31
+
32
+ # @rbs failure: Edited | Locked | Failed
33
+ # @rbs return: String
34
+ def message: (Edited | Locked | Failed failure) -> String
35
+
36
+ # @rbs failure: unrolled
37
+ # @rbs return: String
38
+ def rollback_message: (unrolled failure) -> String
39
+
40
+ private
41
+
42
+ # Made under the migration lock, since two migrators making it at once on
43
+ # PostgreSQL can collide in its catalog, and IF NOT EXISTS doesn't stop that.
44
+ # Returns the database's message when the lock can't be taken.
45
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection) -> String?
46
+ def create_table: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection) -> String?
47
+
48
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration)
49
+ # { () -> (bool | Failed) } -> (bool | Locked | Failed)
50
+ def apply: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration) { () -> (bool | Failed) } -> (bool | Locked | Failed)
51
+
52
+ # Rolled back in ensure rather than rescue, so a migration left by throw or a
53
+ # killed thread rolls back too, before foreign keys go back on.
54
+ # @rbs (Skyward::ORM::_Connection connection, Migration migration) { () -> (bool | Failed) } -> (bool | Failed)
55
+ def run_locked: (Skyward::ORM::_Connection connection, Migration migration) { () -> (bool | Failed) } -> (bool | Failed)
56
+
57
+ # SQLite ends the transaction itself on some failures, such as ON CONFLICT
58
+ # ROLLBACK, and then ROLLBACK raises, though the outcome is already decided.
59
+ # @rbs (Skyward::ORM::_Connection connection) -> void
60
+ def cancel: (Skyward::ORM::_Connection connection) -> void
61
+
62
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration) -> bool
63
+ def pending?: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration) -> bool
64
+
65
+ # Versions sort in filename order, which is the order they ran in, so the
66
+ # greatest is the latest.
67
+ # @rbs (Skyward::ORM::_Connection connection) -> String?
68
+ def latest: (Skyward::ORM::_Connection connection) -> String?
69
+
70
+ # @rbs (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration, String section)
71
+ # { () -> void } -> (true | Failed)
72
+ def change: (Skyward::ORM::_Adapter adapter, Skyward::ORM::_Connection connection, Migration migration, String section) { () -> void } -> (true | Failed)
73
+ end