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,87 @@
1
+ # Generated from lib/skyward/orm/tables/declarations.rb with RBS::Inline
2
+
3
+ # @rbs module-self Class
4
+ module Skyward::ORM::Tables::Declarations : Class
5
+ EMPTY: Skyward::ORM::Tables::Schema
6
+
7
+ ON_DELETE: Array[Skyward::ORM::Tables::on_delete]
8
+
9
+ @schema: Skyward::ORM::Tables::Schema?
10
+
11
+ # @rbs return: Skyward::ORM::Tables::Schema
12
+ def schema: () -> Skyward::ORM::Tables::Schema
13
+
14
+ # @rbs return: Symbol
15
+ def table_name: () -> Symbol
16
+
17
+ # Every attr_reader is a column, so each one compiles the row's methods again.
18
+ # @rbs *names: interned
19
+ # @rbs return: Array[Symbol]
20
+ def attr_reader: (*interned names) -> Array[Symbol]
21
+
22
+ # @rbs name: Symbol
23
+ # @rbs return: void
24
+ def table: (Symbol name) -> void
25
+
26
+ # @rbs column: Symbol
27
+ # @rbs return: void
28
+ def primary_key: (Symbol column) -> void
29
+
30
+ # @rbs column: Symbol
31
+ # @rbs table: singleton(Skyward::ORM::Record)
32
+ # @rbs on_delete: Skyward::ORM::Tables::on_delete?
33
+ # @rbs return: void
34
+ def references: (Symbol column, singleton(Skyward::ORM::Record) table, ?on_delete: Skyward::ORM::Tables::on_delete?) -> void
35
+
36
+ # @rbs **values: untyped
37
+ # @rbs return: void
38
+ def default: (**untyped values) -> void
39
+
40
+ # @rbs *columns: Symbol
41
+ # @rbs return: void
42
+ def unique: (*Symbol columns) -> void
43
+
44
+ # @rbs column: Symbol
45
+ # @rbs sql: Skyward::ORM::Tables::SQL?
46
+ # @rbs length: Range[Integer?]?
47
+ # @rbs return: void
48
+ def check: (Symbol column, ?Skyward::ORM::Tables::SQL? sql, ?length: Range[Integer?]?) -> void
49
+
50
+ # @rbs *columns: Symbol
51
+ # @rbs return: void
52
+ def index: (*Symbol columns) -> void
53
+
54
+ private
55
+
56
+ # @rbs **changes: untyped
57
+ # @rbs return: void
58
+ def declare: (**untyped changes) -> void
59
+
60
+ # @rbs declaration: Symbol
61
+ # @rbs arguments: Array[untyped]
62
+ # @rbs problem: String
63
+ # @rbs return: bot
64
+ def refuse: (Symbol declaration, Array[untyped] arguments, String problem) -> bot
65
+
66
+ # @rbs value: untyped
67
+ # @rbs return: bool
68
+ def symbol?: (untyped value) -> bool
69
+
70
+ # @rbs columns: Array[untyped]
71
+ # @rbs return: String?
72
+ def unnamed: (Array[untyped] columns) -> String?
73
+
74
+ # @rbs table: untyped
75
+ # @rbs on_delete: untyped
76
+ # @rbs return: String?
77
+ def unreferenceable: (untyped table, untyped on_delete) -> String?
78
+
79
+ # @rbs sql: untyped
80
+ # @rbs length: untyped
81
+ # @rbs return: Skyward::ORM::Tables::SQL | Skyward::ORM::Tables::Length | String
82
+ def check_rule: (untyped sql, untyped length) -> (Skyward::ORM::Tables::SQL | Skyward::ORM::Tables::Length | String)
83
+
84
+ # @rbs range: untyped
85
+ # @rbs return: Skyward::ORM::Tables::Length | String
86
+ def length_rule: (untyped range) -> (Skyward::ORM::Tables::Length | String)
87
+ end
@@ -0,0 +1,16 @@
1
+ # Generated from lib/skyward/orm/tables/length.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables
4
+ class Length < Data
5
+ attr_reader min(): Integer?
6
+
7
+ attr_reader max(): Integer?
8
+
9
+ def self.new: (Integer? min, Integer? max) -> instance
10
+ | (min: Integer?, max: Integer?) -> instance
11
+
12
+ def self.members: () -> [ :min, :max ]
13
+
14
+ def members: () -> [ :min, :max ]
15
+ end
16
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/tables/loaded.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables::Loaded
4
+ # A subclass with no table is a shared base class or a row class, not a table.
5
+ # @rbs root: singleton(Skyward::ORM::Record)
6
+ # @rbs return: Array[singleton(Skyward::ORM::Record)]
7
+ def table_classes: (singleton(Skyward::ORM::Record) root) -> Array[singleton(Skyward::ORM::Record)]
8
+
9
+ private
10
+
11
+ # @rbs klass: singleton(Skyward::ORM::Record)
12
+ # @rbs return: Array[singleton(Skyward::ORM::Record)]
13
+ def descendants: (singleton(Skyward::ORM::Record) klass) -> Array[singleton(Skyward::ORM::Record)]
14
+ end
@@ -0,0 +1,18 @@
1
+ # Generated from lib/skyward/orm/tables/reference.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables
4
+ class Reference < Data
5
+ attr_reader column(): Symbol
6
+
7
+ attr_reader table(): singleton(Skyward::ORM::Record)
8
+
9
+ attr_reader on_delete(): on_delete?
10
+
11
+ def self.new: (Symbol column, singleton(Skyward::ORM::Record) table, on_delete? on_delete) -> instance
12
+ | (column: Symbol, table: singleton(Skyward::ORM::Record), on_delete: on_delete?) -> instance
13
+
14
+ def self.members: () -> [ :column, :table, :on_delete ]
15
+
16
+ def members: () -> [ :column, :table, :on_delete ]
17
+ end
18
+ end
@@ -0,0 +1,24 @@
1
+ # Generated from lib/skyward/orm/tables/rows.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables::Rows
4
+ METHODS: Array[Symbol]
5
+
6
+ # Each row sets, compares and hashes its columns' instance variables
7
+ # directly, rather than reflecting on them for every row.
8
+ # @rbs columns: Array[Symbol]
9
+ # @rbs return: String
10
+ def source: (Array[Symbol] columns) -> String
11
+
12
+ # @rbs klass: Class
13
+ # @rbs columns: Array[Symbol]
14
+ # @rbs given: Array[Symbol]
15
+ # @rbs return: String
16
+ def mismatch: (Class klass, Array[Symbol] columns, Array[Symbol] given) -> String
17
+
18
+ private
19
+
20
+ # @rbs columns: Array[Symbol]
21
+ # @rbs method: String
22
+ # @rbs return: String
23
+ def compare: (Array[Symbol] columns, String method) -> String
24
+ end
@@ -0,0 +1,28 @@
1
+ # Generated from lib/skyward/orm/tables/schema.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables
4
+ class Schema < Data
5
+ attr_reader table(): Symbol?
6
+
7
+ attr_reader primary_key(): Symbol
8
+
9
+ attr_reader columns(): Array[Symbol]
10
+
11
+ attr_reader references(): Array[Reference]
12
+
13
+ attr_reader defaults(): Hash[Symbol, untyped]
14
+
15
+ attr_reader checks(): Array[Check]
16
+
17
+ attr_reader uniques(): Array[Array[Symbol]]
18
+
19
+ attr_reader indexes(): Array[Array[Symbol]]
20
+
21
+ def self.new: (Symbol? table, Symbol primary_key, Array[Symbol] columns, Array[Reference] references, Hash[Symbol, untyped] defaults, Array[Check] checks, Array[Array[Symbol]] uniques, Array[Array[Symbol]] indexes) -> instance
22
+ | (table: Symbol?, primary_key: Symbol, columns: Array[Symbol], references: Array[Reference], defaults: Hash[Symbol, untyped], checks: Array[Check], uniques: Array[Array[Symbol]], indexes: Array[Array[Symbol]]) -> instance
23
+
24
+ def self.members: () -> [ :table, :primary_key, :columns, :references, :defaults, :checks, :uniques, :indexes ]
25
+
26
+ def members: () -> [ :table, :primary_key, :columns, :references, :defaults, :checks, :uniques, :indexes ]
27
+ end
28
+ end
@@ -0,0 +1,14 @@
1
+ # Generated from lib/skyward/orm/tables/sql.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables
4
+ class SQL < Data
5
+ attr_reader expression(): String
6
+
7
+ def self.new: (String expression) -> instance
8
+ | (expression: String) -> instance
9
+
10
+ def self.members: () -> [ :expression ]
11
+
12
+ def members: () -> [ :expression ]
13
+ end
14
+ end
@@ -0,0 +1,9 @@
1
+ # Generated from lib/skyward/orm/tables/validation.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables::Validation
4
+ # A declaration can come before the attr_reader that defines its column, so
5
+ # the columns it names are checked once the class has loaded.
6
+ # @rbs klass: singleton(Skyward::ORM::Record)
7
+ # @rbs return: void
8
+ def validate: (singleton(Skyward::ORM::Record) klass) -> void
9
+ end
@@ -0,0 +1,49 @@
1
+ # Generated from lib/skyward/orm/tables/values.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables::Values
4
+ ACCEPTED: Hash[Symbol, Array[Module]]
5
+
6
+ WRITTEN: Hash[Symbol, String]
7
+
8
+ UNTYPED: String
9
+
10
+ UNTYPED_WRITE: String
11
+
12
+ # @rbs table: singleton(Skyward::ORM::Record)
13
+ # @rbs column: Skyward::ORM::Tables::Column
14
+ # @rbs value: untyped
15
+ # @rbs return: String?
16
+ def mismatch: (singleton(Skyward::ORM::Record) table, Skyward::ORM::Tables::Column column, untyped value) -> String?
17
+
18
+ # A write binds each value to one placeholder, so an Array or a Range, which
19
+ # a where unpacks, is never one value, and the driver can't bind a Range.
20
+ # @rbs table: singleton(Skyward::ORM::Record)
21
+ # @rbs column: Skyward::ORM::Tables::Column
22
+ # @rbs value: untyped
23
+ # @rbs return: String?
24
+ def write_mismatch: (singleton(Skyward::ORM::Record) table, Skyward::ORM::Tables::Column column, untyped value) -> String?
25
+
26
+ private
27
+
28
+ # @rbs table: singleton(Skyward::ORM::Record)
29
+ # @rbs column: Skyward::ORM::Tables::Column
30
+ # @rbs value: untyped
31
+ # @rbs untyped: String
32
+ # @rbs return: String
33
+ def refusal: (singleton(Skyward::ORM::Record) table, Skyward::ORM::Tables::Column column, untyped value, String untyped) -> String
34
+
35
+ # A range's nil end leaves it open, so it isn't a NULL to check.
36
+ # @rbs value: untyped
37
+ # @rbs return: Array[untyped]
38
+ def candidates: (untyped value) -> Array[untyped]
39
+
40
+ # @rbs column: Skyward::ORM::Tables::Column
41
+ # @rbs value: untyped
42
+ # @rbs return: bool
43
+ def accepts?: (Skyward::ORM::Tables::Column column, untyped value) -> bool
44
+
45
+ # @rbs column: Skyward::ORM::Tables::Column
46
+ # @rbs untyped: String
47
+ # @rbs return: String
48
+ def written: (Skyward::ORM::Tables::Column column, String untyped) -> String
49
+ end
@@ -0,0 +1,7 @@
1
+ # Generated from lib/skyward/orm/tables.rb with RBS::Inline
2
+
3
+ module Skyward::ORM::Tables
4
+ type on_delete = :cascade | :restrict | :set_null | :set_default | :no_action
5
+
6
+ type column_type = Skyward::Core::Types::scalar | :enum
7
+ end
@@ -0,0 +1,11 @@
1
+ # Generated from lib/skyward/orm/transactional.rb with RBS::Inline
2
+
3
+ # @rbs module-self Minitest::Test::LifecycleHooks
4
+ module Skyward::ORM::Transactional : Minitest::Test::LifecycleHooks
5
+ # @rbs return: void
6
+ def before_setup: () -> void
7
+
8
+ # Minitest calls this even when setup or the test raised.
9
+ # @rbs return: void
10
+ def after_teardown: () -> void
11
+ end
@@ -0,0 +1,22 @@
1
+ # Generated from lib/skyward/orm/violation.rb with RBS::Inline
2
+
3
+ module Skyward::ORM
4
+ type violation_kind = :unique | :foreign_key | :not_null | :check
5
+
6
+ class Violation < Data
7
+ attr_reader kind(): violation_kind
8
+
9
+ attr_reader constraint(): String?
10
+
11
+ attr_reader columns(): Array[Symbol]
12
+
13
+ attr_reader message(): String
14
+
15
+ def self.new: (violation_kind kind, String? constraint, Array[Symbol] columns, String message) -> instance
16
+ | (kind: violation_kind, constraint: String?, columns: Array[Symbol], message: String) -> instance
17
+
18
+ def self.members: () -> [ :kind, :constraint, :columns, :message ]
19
+
20
+ def members: () -> [ :kind, :constraint, :columns, :message ]
21
+ end
22
+ end
@@ -0,0 +1,10 @@
1
+ # Generated from lib/skyward/orm/violation_error.rb with RBS::Inline
2
+
3
+ class Skyward::ORM::ViolationError < StandardError
4
+ # @dynamic violation
5
+ attr_reader violation: Skyward::ORM::Violation
6
+
7
+ # @rbs violation: Skyward::ORM::Violation
8
+ # @rbs return: void
9
+ def initialize: (Skyward::ORM::Violation violation) -> void
10
+ end
@@ -1,2 +1,31 @@
1
1
  # Generated from lib/skyward/orm.rb with RBS::Inline
2
2
 
3
+ module Skyward
4
+ # @rbs url: String
5
+ # @rbs signatures: String
6
+ # @rbs pool: Integer
7
+ # @rbs check: bool
8
+ # @rbs return: ORM::Connection::Database
9
+ def self.connect: (String url, ?signatures: String, ?pool: Integer, ?check: bool) -> ORM::Connection::Database
10
+
11
+ # @rbs [T] () { () -> T } -> T
12
+ def self.transaction: [T] () { () -> T } -> T
13
+
14
+ # @rbs return: bool
15
+ def self.transaction?: () -> bool
16
+
17
+ # @rbs [T] (ORM::_Row[T] row, String sql, *untyped values) -> Array[T]
18
+ # | (String sql, *untyped values) -> Array[Hash[Symbol, untyped]]
19
+ # Steep checks the body against both overloads at once, as one whose second
20
+ # parameter is optional, which neither overload's is.
21
+ def self.query: [T] (ORM::_Row[T] row, String sql, *untyped values) -> Array[T]
22
+ | (String sql, *untyped values) -> Array[Hash[Symbol, untyped]]
23
+
24
+ # @rbs directory: String
25
+ # @rbs return: Array[String]
26
+ def self.migrate: (String directory) -> Array[String]
27
+
28
+ # @rbs expression: String
29
+ # @rbs return: ORM::Tables::SQL
30
+ def self.sql: (String expression) -> ORM::Tables::SQL
31
+ end
data/sig/manual/pg.rbs ADDED
@@ -0,0 +1,31 @@
1
+ # Neither the pg gem nor the collection has signatures, so these declare only
2
+ # what the PostgreSQL adapter uses.
3
+ module PG
4
+ PG_DIAG_SQLSTATE: Integer
5
+ PG_DIAG_MESSAGE_PRIMARY: Integer
6
+ PG_DIAG_TABLE_NAME: Integer
7
+ PG_DIAG_COLUMN_NAME: Integer
8
+ PG_DIAG_CONSTRAINT_NAME: Integer
9
+ PQTRANS_IDLE: Integer
10
+
11
+ def self.connect: (String url) -> Connection
12
+
13
+ class Connection
14
+ def exec: (String sql) -> Result
15
+ def exec_params: [T] (String sql, Array[untyped] params) { (Result result) -> T } -> T
16
+ def transaction_status: () -> Integer
17
+ def close: () -> void
18
+ end
19
+
20
+ class Result
21
+ def fields: () -> Array[String]
22
+ def values: () -> Array[Array[String?]]
23
+ def cmd_tuples: () -> Integer
24
+ def error_field: (Integer field) -> String?
25
+ def clear: () -> void
26
+ end
27
+
28
+ class Error < StandardError
29
+ def result: () -> Result?
30
+ end
31
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Adapters::PostgreSQL
2
+ extend ::Skyward::ORM::Adapters::PostgreSQL
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Adapters::SQLite::Constraints
2
+ extend ::Skyward::ORM::Adapters::SQLite::Constraints
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Adapters::SQLite
2
+ extend ::Skyward::ORM::Adapters::SQLite
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Adapters
2
+ extend ::Skyward::ORM::Adapters
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::CLI::BootFile
2
+ extend ::Skyward::ORM::CLI::BootFile
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::CLI::Migrate
2
+ extend ::Skyward::ORM::CLI::Migrate
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::CLI::Migration
2
+ extend ::Skyward::ORM::CLI::Migration
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::CLI::Rollback
2
+ extend ::Skyward::ORM::CLI::Rollback
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::CLI::Status
2
+ extend ::Skyward::ORM::CLI::Status
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Connection::Database::SchemaCheck
2
+ extend ::Skyward::ORM::Connection::Database::SchemaCheck
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Members
2
+ extend ::Skyward::ORM::Members
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Definitions
2
+ extend ::Skyward::ORM::Migrations::Definitions
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Diff
2
+ extend ::Skyward::ORM::Migrations::Diff
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Directory
2
+ extend ::Skyward::ORM::Migrations::Directory
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Discovery
2
+ extend ::Skyward::ORM::Migrations::Discovery
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Runner
2
+ extend ::Skyward::ORM::Migrations::Runner
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Script
2
+ extend ::Skyward::ORM::Migrations::Script
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Status
2
+ extend ::Skyward::ORM::Migrations::Status
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Summary
2
+ extend ::Skyward::ORM::Migrations::Summary
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Migrations::Versions
2
+ extend ::Skyward::ORM::Migrations::Versions
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Placeholders
2
+ extend ::Skyward::ORM::Placeholders
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Statements
2
+ extend ::Skyward::ORM::Statements
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Tables::Loaded
2
+ extend ::Skyward::ORM::Tables::Loaded
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Tables::Rows
2
+ extend ::Skyward::ORM::Tables::Rows
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Tables::Validation
2
+ extend ::Skyward::ORM::Tables::Validation
3
+ end
@@ -0,0 +1,3 @@
1
+ module Skyward::ORM::Tables::Values
2
+ extend ::Skyward::ORM::Tables::Values
3
+ end
@@ -0,0 +1,45 @@
1
+ module Skyward::ORM
2
+ # Each adapter's connection: SQLite3::Database, and Adapters::PostgreSQL::Connection.
3
+ interface _Connection
4
+ def execute: (String sql, ?Array[untyped] binds) -> Array[Array[untyped]]
5
+ # Its first row is the result's column names, even when it has no rows.
6
+ def execute2: (String sql, *untyped binds) -> Array[Array[untyped]]
7
+ def execute_batch: (String sql) -> void
8
+ # The rows the latest INSERT, UPDATE or DELETE that execute ran changed.
9
+ def changes: () -> Integer
10
+ def transaction_active?: () -> bool
11
+ def close: () -> void
12
+ end
13
+
14
+ # Everything that differs between databases: Adapters::SQLite and Adapters::PostgreSQL.
15
+ interface _Adapter
16
+ def driver: () -> String
17
+ def connect: (String location) -> _Connection
18
+ def pool_size: (String location, Integer size) -> Integer
19
+ def placeholder: (Integer position) -> String
20
+ def unlimited: () -> String?
21
+ def sql_type: (Tables::column_type type) -> String?
22
+ def identity: () -> String?
23
+ def alters_in_place?: () -> bool
24
+ def default_expression: (String expression) -> String
25
+ def compatible?: (Tables::column_type type, String sql_type) -> bool
26
+ def encode: (untyped value) -> untyped
27
+ def decode: (Tables::column_type type, untyped value) -> untyped
28
+ def tables: (_Connection connection) -> Array[Catalog::Table]
29
+ def violation: (StandardError error, Array[Catalog::Table] tables, Symbol? table) -> Violation?
30
+ # Begins a migration's transaction, first taking a lock that one migrator
31
+ # holds at a time and that ending the transaction releases.
32
+ def begin_migration: () -> String
33
+ # Each row the migration left referring to a missing one, before it
34
+ # commits. None on a database that enforces foreign keys as it goes.
35
+ def foreign_key_violations: (_Connection connection) -> Array[String]
36
+ # Undoes what begin_migration set on the connection, once the transaction has ended.
37
+ def end_migration: () -> String
38
+ end
39
+
40
+ # A class whose rows Skyward.query returns: a Data class, a table class, or
41
+ # any class built from keyword arguments.
42
+ interface _Row[T]
43
+ def new: (?) -> T
44
+ end
45
+ end
@@ -0,0 +1,23 @@
1
+ # The collection's signatures leave out the errors, whose extended result codes
2
+ # classify a violation, extended_result_codes=, which turns those codes on,
3
+ # busy_handler_timeout=, which waits on a lock without holding the GVL,
4
+ # execute2, which returns a result's column names, execute_batch, which runs a
5
+ # migration, and transaction_active? and close, with which the pool finds a
6
+ # connection that comes back mid-transaction, and closes one it can't roll back.
7
+ module SQLite3
8
+ class Exception < ::StandardError
9
+ def code: () -> Integer
10
+ end
11
+
12
+ class ConstraintException < Exception
13
+ end
14
+
15
+ class Database[ResultType]
16
+ def extended_result_codes=: (bool enabled) -> void
17
+ def busy_handler_timeout=: (Integer milliseconds) -> void
18
+ def execute2: (String sql, *untyped bind_vars) -> Array[Array[untyped]]
19
+ def execute_batch: (String sql) -> void
20
+ def transaction_active?: () -> bool
21
+ def close: () -> void
22
+ end
23
+ end