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.
- checksums.yaml +4 -4
- data/README.md +182 -75
- data/lib/skyward/orm/adapters/postgresql/connection.rb +52 -0
- data/lib/skyward/orm/adapters/postgresql.rb +283 -0
- data/lib/skyward/orm/adapters/sqlite/constraints.rb +172 -0
- data/lib/skyward/orm/adapters/sqlite.rb +317 -0
- data/lib/skyward/orm/adapters.rb +38 -0
- data/lib/skyward/orm/catalog/column.rb +12 -0
- data/lib/skyward/orm/catalog/constraint.rb +13 -0
- data/lib/skyward/orm/catalog/index.rb +11 -0
- data/lib/skyward/orm/catalog/table.rb +10 -0
- data/lib/skyward/orm/catalog.rb +6 -0
- data/lib/skyward/orm/cli/boot_file.rb +43 -0
- data/lib/skyward/orm/cli/migrate.rb +30 -0
- data/lib/skyward/orm/cli/migration.rb +111 -0
- data/lib/skyward/orm/cli/rollback.rb +18 -0
- data/lib/skyward/orm/cli/status.rb +36 -0
- data/lib/skyward/orm/cli.rb +4 -0
- data/lib/skyward/orm/commands.rb +64 -0
- data/lib/skyward/orm/connection/database/schema_check.rb +67 -0
- data/lib/skyward/orm/connection/database.rb +357 -0
- data/lib/skyward/orm/connection/pool.rb +102 -0
- data/lib/skyward/orm/connection/session.rb +38 -0
- data/lib/skyward/orm/connection.rb +7 -0
- data/lib/skyward/orm/members.rb +16 -0
- data/lib/skyward/orm/migration_error.rb +4 -0
- data/lib/skyward/orm/migrations/add_column.rb +7 -0
- data/lib/skyward/orm/migrations/add_constraint.rb +7 -0
- data/lib/skyward/orm/migrations/add_index.rb +7 -0
- data/lib/skyward/orm/migrations/alter_table.rb +12 -0
- data/lib/skyward/orm/migrations/change_default.rb +9 -0
- data/lib/skyward/orm/migrations/change_nullable.rb +8 -0
- data/lib/skyward/orm/migrations/change_type.rb +9 -0
- data/lib/skyward/orm/migrations/create_table.rb +8 -0
- data/lib/skyward/orm/migrations/definitions.rb +176 -0
- data/lib/skyward/orm/migrations/diff.rb +213 -0
- data/lib/skyward/orm/migrations/directory.rb +48 -0
- data/lib/skyward/orm/migrations/discovery.rb +14 -0
- data/lib/skyward/orm/migrations/drop_column.rb +7 -0
- data/lib/skyward/orm/migrations/drop_constraint.rb +7 -0
- data/lib/skyward/orm/migrations/drop_index.rb +7 -0
- data/lib/skyward/orm/migrations/rename_column.rb +8 -0
- data/lib/skyward/orm/migrations/runner/edited.rb +7 -0
- data/lib/skyward/orm/migrations/runner/failed.rb +8 -0
- data/lib/skyward/orm/migrations/runner/irreversible.rb +7 -0
- data/lib/skyward/orm/migrations/runner/locked.rb +8 -0
- data/lib/skyward/orm/migrations/runner/migration.rb +11 -0
- data/lib/skyward/orm/migrations/runner/missing.rb +7 -0
- data/lib/skyward/orm/migrations/runner/raced.rb +7 -0
- data/lib/skyward/orm/migrations/runner.rb +227 -0
- data/lib/skyward/orm/migrations/script.rb +350 -0
- data/lib/skyward/orm/migrations/status.rb +93 -0
- data/lib/skyward/orm/migrations/summary.rb +110 -0
- data/lib/skyward/orm/migrations/versions.rb +19 -0
- data/lib/skyward/orm/migrations.rb +8 -0
- data/lib/skyward/orm/placeholders.rb +37 -0
- data/lib/skyward/orm/pool_timeout.rb +4 -0
- data/lib/skyward/orm/projection.rb +67 -0
- data/lib/skyward/orm/queries/clauses.rb +588 -0
- data/lib/skyward/orm/queries.rb +4 -0
- data/lib/skyward/orm/query.rb +26 -0
- data/lib/skyward/orm/record.rb +96 -0
- data/lib/skyward/orm/schema_mismatch.rb +4 -0
- data/lib/skyward/orm/statements.rb +97 -0
- data/lib/skyward/orm/tables/check.rb +8 -0
- data/lib/skyward/orm/tables/column.rb +10 -0
- data/lib/skyward/orm/tables/column_types.rb +74 -0
- data/lib/skyward/orm/tables/declarations.rb +172 -0
- data/lib/skyward/orm/tables/length.rb +8 -0
- data/lib/skyward/orm/tables/loaded.rb +21 -0
- data/lib/skyward/orm/tables/reference.rb +9 -0
- data/lib/skyward/orm/tables/rows.rb +52 -0
- data/lib/skyward/orm/tables/schema.rb +14 -0
- data/lib/skyward/orm/tables/sql.rb +7 -0
- data/lib/skyward/orm/tables/validation.rb +29 -0
- data/lib/skyward/orm/tables/values.rb +102 -0
- data/lib/skyward/orm/tables.rb +7 -0
- data/lib/skyward/orm/transactional.rb +18 -0
- data/lib/skyward/orm/version.rb +1 -1
- data/lib/skyward/orm/violation.rb +13 -0
- data/lib/skyward/orm/violation_error.rb +13 -0
- data/lib/skyward/orm.rb +72 -1
- data/sig/generated/skyward/orm/adapters/postgresql/connection.rbs +41 -0
- data/sig/generated/skyward/orm/adapters/postgresql.rbs +138 -0
- data/sig/generated/skyward/orm/adapters/sqlite/constraints.rbs +87 -0
- data/sig/generated/skyward/orm/adapters/sqlite.rbs +166 -0
- data/sig/generated/skyward/orm/adapters.rbs +15 -0
- data/sig/generated/skyward/orm/catalog/column.rbs +20 -0
- data/sig/generated/skyward/orm/catalog/constraint.rbs +22 -0
- data/sig/generated/skyward/orm/catalog/index.rbs +20 -0
- data/sig/generated/skyward/orm/catalog/table.rbs +20 -0
- data/sig/generated/skyward/orm/catalog.rbs +5 -0
- data/sig/generated/skyward/orm/cli/boot_file.rbs +21 -0
- data/sig/generated/skyward/orm/cli/migrate.rbs +15 -0
- data/sig/generated/skyward/orm/cli/migration.rbs +45 -0
- data/sig/generated/skyward/orm/cli/rollback.rbs +7 -0
- data/sig/generated/skyward/orm/cli/status.rbs +17 -0
- data/sig/generated/skyward/orm/cli.rbs +4 -0
- data/sig/generated/skyward/orm/commands.rbs +2 -0
- data/sig/generated/skyward/orm/connection/database/schema_check.rbs +31 -0
- data/sig/generated/skyward/orm/connection/database.rbs +226 -0
- data/sig/generated/skyward/orm/connection/pool.rbs +54 -0
- data/sig/generated/skyward/orm/connection/session.rbs +25 -0
- data/sig/generated/skyward/orm/connection.rbs +7 -0
- data/sig/generated/skyward/orm/members.rbs +9 -0
- data/sig/generated/skyward/orm/migration_error.rbs +4 -0
- data/sig/generated/skyward/orm/migrations/add_column.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/add_constraint.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/add_index.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/alter_table.rbs +22 -0
- data/sig/generated/skyward/orm/migrations/change_default.rbs +18 -0
- data/sig/generated/skyward/orm/migrations/change_nullable.rbs +16 -0
- data/sig/generated/skyward/orm/migrations/change_type.rbs +18 -0
- data/sig/generated/skyward/orm/migrations/create_table.rbs +16 -0
- data/sig/generated/skyward/orm/migrations/definitions.rbs +81 -0
- data/sig/generated/skyward/orm/migrations/diff.rbs +99 -0
- data/sig/generated/skyward/orm/migrations/directory.rbs +37 -0
- data/sig/generated/skyward/orm/migrations/discovery.rbs +9 -0
- data/sig/generated/skyward/orm/migrations/drop_column.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/drop_constraint.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/drop_index.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/rename_column.rbs +16 -0
- data/sig/generated/skyward/orm/migrations/runner/edited.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/runner/failed.rbs +16 -0
- data/sig/generated/skyward/orm/migrations/runner/irreversible.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/runner/locked.rbs +16 -0
- data/sig/generated/skyward/orm/migrations/runner/migration.rbs +22 -0
- data/sig/generated/skyward/orm/migrations/runner/missing.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/runner/raced.rbs +14 -0
- data/sig/generated/skyward/orm/migrations/runner.rbs +73 -0
- data/sig/generated/skyward/orm/migrations/script.rbs +161 -0
- data/sig/generated/skyward/orm/migrations/status.rbs +49 -0
- data/sig/generated/skyward/orm/migrations/summary.rbs +50 -0
- data/sig/generated/skyward/orm/migrations/versions.rbs +11 -0
- data/sig/generated/skyward/orm/migrations.rbs +7 -0
- data/sig/generated/skyward/orm/placeholders.rbs +21 -0
- data/sig/generated/skyward/orm/pool_timeout.rbs +4 -0
- data/sig/generated/skyward/orm/projection.rbs +42 -0
- data/sig/generated/skyward/orm/queries/clauses.rbs +367 -0
- data/sig/generated/skyward/orm/queries.rbs +4 -0
- data/sig/generated/skyward/orm/query.rbs +20 -0
- data/sig/generated/skyward/orm/record.rbs +80 -0
- data/sig/generated/skyward/orm/schema_mismatch.rbs +4 -0
- data/sig/generated/skyward/orm/statements.rbs +53 -0
- data/sig/generated/skyward/orm/tables/check.rbs +16 -0
- data/sig/generated/skyward/orm/tables/column.rbs +20 -0
- data/sig/generated/skyward/orm/tables/column_types.rbs +39 -0
- data/sig/generated/skyward/orm/tables/declarations.rbs +87 -0
- data/sig/generated/skyward/orm/tables/length.rbs +16 -0
- data/sig/generated/skyward/orm/tables/loaded.rbs +14 -0
- data/sig/generated/skyward/orm/tables/reference.rbs +18 -0
- data/sig/generated/skyward/orm/tables/rows.rbs +24 -0
- data/sig/generated/skyward/orm/tables/schema.rbs +28 -0
- data/sig/generated/skyward/orm/tables/sql.rbs +14 -0
- data/sig/generated/skyward/orm/tables/validation.rbs +9 -0
- data/sig/generated/skyward/orm/tables/values.rbs +49 -0
- data/sig/generated/skyward/orm/tables.rbs +7 -0
- data/sig/generated/skyward/orm/transactional.rbs +11 -0
- data/sig/generated/skyward/orm/violation.rbs +22 -0
- data/sig/generated/skyward/orm/violation_error.rbs +10 -0
- data/sig/generated/skyward/orm.rbs +29 -0
- data/sig/manual/pg.rbs +31 -0
- data/sig/manual/skyward/orm/adapters/postgresql.rbs +3 -0
- data/sig/manual/skyward/orm/adapters/sqlite/constraints.rbs +3 -0
- data/sig/manual/skyward/orm/adapters/sqlite.rbs +3 -0
- data/sig/manual/skyward/orm/adapters.rbs +3 -0
- data/sig/manual/skyward/orm/cli/boot_file.rbs +3 -0
- data/sig/manual/skyward/orm/cli/migrate.rbs +3 -0
- data/sig/manual/skyward/orm/cli/migration.rbs +3 -0
- data/sig/manual/skyward/orm/cli/rollback.rbs +3 -0
- data/sig/manual/skyward/orm/cli/status.rbs +3 -0
- data/sig/manual/skyward/orm/connection/database/schema_check.rbs +3 -0
- data/sig/manual/skyward/orm/members.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/definitions.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/diff.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/directory.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/discovery.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/runner.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/script.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/status.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/summary.rbs +3 -0
- data/sig/manual/skyward/orm/migrations/versions.rbs +3 -0
- data/sig/manual/skyward/orm/placeholders.rbs +3 -0
- data/sig/manual/skyward/orm/statements.rbs +3 -0
- data/sig/manual/skyward/orm/tables/loaded.rbs +3 -0
- data/sig/manual/skyward/orm/tables/rows.rbs +3 -0
- data/sig/manual/skyward/orm/tables/validation.rbs +3 -0
- data/sig/manual/skyward/orm/tables/values.rbs +3 -0
- data/sig/manual/skyward/orm.rbs +45 -0
- data/sig/manual/sqlite3.rbs +23 -0
- metadata +188 -3
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Skyward::ORM::Migrations::Summary
|
|
4
|
+
extend self
|
|
5
|
+
|
|
6
|
+
# @rbs changes: Array[Skyward::ORM::Migrations::change]
|
|
7
|
+
# @rbs adapter: Skyward::ORM::_Adapter
|
|
8
|
+
# @rbs return: String
|
|
9
|
+
def text(changes, adapter) = changes.map { |change| section(change, adapter) }.join
|
|
10
|
+
|
|
11
|
+
private
|
|
12
|
+
|
|
13
|
+
# Each change is a line, marked + for what's added, - for what's dropped,
|
|
14
|
+
# and ~ for what's changed, and the lines line up after what each names.
|
|
15
|
+
# @rbs change: Skyward::ORM::Migrations::change
|
|
16
|
+
# @rbs adapter: Skyward::ORM::_Adapter
|
|
17
|
+
# @rbs return: String
|
|
18
|
+
def section(change, adapter)
|
|
19
|
+
klass = change.klass
|
|
20
|
+
table = klass.table_name
|
|
21
|
+
case change
|
|
22
|
+
when Skyward::ORM::Migrations::CreateTable
|
|
23
|
+
"#{klass} has no table yet:\n + #{table} #{counts(change)}\n"
|
|
24
|
+
else
|
|
25
|
+
lines = change.edits.map { |edit| line(edit, adapter) }
|
|
26
|
+
width = lines.map { |_, name, _| name.length }.max || 0
|
|
27
|
+
["#{klass} differs from the #{table} table:\n", *lines.map do |mark, name, text|
|
|
28
|
+
" #{mark} #{name.ljust(width)} #{text}\n"
|
|
29
|
+
end].join
|
|
30
|
+
end
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
# @rbs edit: Skyward::ORM::Migrations::edit
|
|
34
|
+
# @rbs adapter: Skyward::ORM::_Adapter
|
|
35
|
+
# @rbs return: [String, String, String]
|
|
36
|
+
def line(edit, adapter)
|
|
37
|
+
case edit
|
|
38
|
+
when Skyward::ORM::Migrations::AddColumn then ["+", edit.column.name.name, column(edit.column, adapter)]
|
|
39
|
+
when Skyward::ORM::Migrations::DropColumn
|
|
40
|
+
["-", edit.column.name.name, "#{edit.column.type} #{edit.column.nullable ? "NULL" : "NOT NULL"}".lstrip]
|
|
41
|
+
when Skyward::ORM::Migrations::RenameColumn then ["~", edit.to.name, "renamed from #{edit.from}"]
|
|
42
|
+
when Skyward::ORM::Migrations::ChangeType then ["~", edit.column.name, "#{edit.to}, was #{edit.from}"]
|
|
43
|
+
when Skyward::ORM::Migrations::ChangeNullable
|
|
44
|
+
["~", edit.column.name, edit.nullable ? "NULL, was NOT NULL" : "NOT NULL, was NULL"]
|
|
45
|
+
when Skyward::ORM::Migrations::ChangeDefault then ["~", edit.column.name,
|
|
46
|
+
"#{default(edit.to)}, was #{default(edit.from)}"]
|
|
47
|
+
when Skyward::ORM::Migrations::AddConstraint then ["+", edit.constraint.name.to_s, constraint(edit.constraint)]
|
|
48
|
+
when Skyward::ORM::Migrations::DropConstraint then ["-", edit.constraint.name || "unnamed",
|
|
49
|
+
constraint(edit.constraint)]
|
|
50
|
+
when Skyward::ORM::Migrations::AddIndex then ["+", edit.index.name, index(edit.index)]
|
|
51
|
+
else ["-", edit.index.name, index(edit.index)]
|
|
52
|
+
end
|
|
53
|
+
end
|
|
54
|
+
|
|
55
|
+
# @rbs change: Skyward::ORM::Migrations::CreateTable
|
|
56
|
+
# @rbs return: String
|
|
57
|
+
def counts(change)
|
|
58
|
+
schema = change.klass.schema
|
|
59
|
+
declared = [
|
|
60
|
+
[schema.references.size, "reference", "references"],
|
|
61
|
+
[schema.checks.size + change.columns.count { |column| column.type == :enum }, "check", "checks"],
|
|
62
|
+
[schema.uniques.size, "unique", "uniques"],
|
|
63
|
+
[schema.indexes.size, "index", "indexes"]
|
|
64
|
+
] #: Array[[Integer, String, String]]
|
|
65
|
+
[
|
|
66
|
+
count(change.columns.size, "column", "columns"),
|
|
67
|
+
*declared.filter_map { |size, one, many| count(size, one, many) if size.positive? }
|
|
68
|
+
].join(", ")
|
|
69
|
+
end
|
|
70
|
+
|
|
71
|
+
# @rbs size: Integer
|
|
72
|
+
# @rbs one: String
|
|
73
|
+
# @rbs many: String
|
|
74
|
+
# @rbs return: String
|
|
75
|
+
def count(size, one, many) = "#{size} #{size == 1 ? one : many}"
|
|
76
|
+
|
|
77
|
+
# @rbs column: Skyward::ORM::Tables::Column
|
|
78
|
+
# @rbs adapter: Skyward::ORM::_Adapter
|
|
79
|
+
# @rbs return: String
|
|
80
|
+
def column(column, adapter)
|
|
81
|
+
sql_type = adapter.sql_type(column.type)
|
|
82
|
+
return "needs a type" unless sql_type
|
|
83
|
+
|
|
84
|
+
"#{sql_type} #{column.nullable ? "NULL" : "NOT NULL"}"
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
# @rbs default: String?
|
|
88
|
+
# @rbs return: String
|
|
89
|
+
def default(default) = default ? "DEFAULT #{default}" : "no default"
|
|
90
|
+
|
|
91
|
+
# @rbs constraint: Skyward::ORM::Catalog::Constraint
|
|
92
|
+
# @rbs return: String
|
|
93
|
+
def constraint(constraint)
|
|
94
|
+
columns = "(#{constraint.columns.join(", ")})"
|
|
95
|
+
case constraint.kind
|
|
96
|
+
when :primary_key then "primary key #{columns}"
|
|
97
|
+
when :unique then "unique #{columns}"
|
|
98
|
+
when :check then "check #{columns}"
|
|
99
|
+
else "reference #{columns} to #{constraint.references}"
|
|
100
|
+
end
|
|
101
|
+
end
|
|
102
|
+
|
|
103
|
+
# An index on an expression has no columns to name.
|
|
104
|
+
# @rbs index: Skyward::ORM::Catalog::Index
|
|
105
|
+
# @rbs return: String
|
|
106
|
+
def index(index)
|
|
107
|
+
kind = index.unique ? "unique index" : "index"
|
|
108
|
+
index.columns.empty? ? "#{kind} on an expression" : "#{kind} (#{index.columns.join(", ")})"
|
|
109
|
+
end
|
|
110
|
+
end
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Skyward::ORM::Migrations::Versions
|
|
4
|
+
extend self
|
|
5
|
+
|
|
6
|
+
# Running a migration records its version here, and a database that's
|
|
7
|
+
# never been migrated doesn't have the table yet.
|
|
8
|
+
TABLE = :schema_migrations #: Symbol
|
|
9
|
+
|
|
10
|
+
# @rbs database: Skyward::ORM::Connection::Database
|
|
11
|
+
# @rbs return: Hash[String, String]
|
|
12
|
+
def checksums(database)
|
|
13
|
+
return {} unless database.tables.any? { |table| table.name == TABLE }
|
|
14
|
+
|
|
15
|
+
database.execute("SELECT version, checksum FROM #{TABLE}").to_h do |version, checksum|
|
|
16
|
+
[version.to_s, checksum.to_s]
|
|
17
|
+
end
|
|
18
|
+
end
|
|
19
|
+
end
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Skyward::ORM::Migrations
|
|
4
|
+
# @rbs!
|
|
5
|
+
# type change = CreateTable | AlterTable
|
|
6
|
+
# type edit = AddColumn | DropColumn | RenameColumn | ChangeType | ChangeNullable | ChangeDefault
|
|
7
|
+
# | AddConstraint | DropConstraint | AddIndex | DropIndex
|
|
8
|
+
end
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
module Skyward::ORM::Placeholders
|
|
4
|
+
extend self
|
|
5
|
+
|
|
6
|
+
# A ? in a string, a quoted name or a comment is the SQL's own, so those
|
|
7
|
+
# match whole and are kept. SQL escapes a quote by doubling it, which reads
|
|
8
|
+
# here as two strings side by side.
|
|
9
|
+
MARKS = %r{'[^']*'|"[^"]*"|--[^\n]*|/\*.*?\*/|\?}m #: Regexp
|
|
10
|
+
|
|
11
|
+
# @rbs sql: String
|
|
12
|
+
# @rbs count: Integer
|
|
13
|
+
# @rbs &: (Integer position) -> String
|
|
14
|
+
# @rbs return: String
|
|
15
|
+
def replace(sql, count)
|
|
16
|
+
marks = 0
|
|
17
|
+
replaced = sql.gsub(MARKS) { |match| match == "?" ? yield(marks += 1) : match }
|
|
18
|
+
return replaced if marks == count
|
|
19
|
+
|
|
20
|
+
raise ArgumentError, "The SQL has #{marks} ?, each taking one value, but was given #{count}"
|
|
21
|
+
end
|
|
22
|
+
|
|
23
|
+
# The driver spreads an Array or Hash across several placeholders, or none,
|
|
24
|
+
# moving every value after it to another `?`.
|
|
25
|
+
# @rbs binds: Array[untyped]
|
|
26
|
+
# @rbs subject: String
|
|
27
|
+
# @rbs return: void
|
|
28
|
+
def require_scalars(binds, subject)
|
|
29
|
+
binds.each.with_index(1) do |bind, index|
|
|
30
|
+
kind = case bind
|
|
31
|
+
when Array then "an Array"
|
|
32
|
+
when Hash then "a Hash"
|
|
33
|
+
end
|
|
34
|
+
raise ArgumentError, "#{subject} binds one value to each ?, but value #{index} is #{kind}" if kind
|
|
35
|
+
end
|
|
36
|
+
end
|
|
37
|
+
end
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
# @rbs generic R
|
|
4
|
+
class Skyward::ORM::Projection
|
|
5
|
+
include Skyward::ORM::Queries::Clauses #[R]
|
|
6
|
+
|
|
7
|
+
# @rbs **values: untyped
|
|
8
|
+
# @rbs return: R | Skyward::ORM::Violation
|
|
9
|
+
def insert(**values)
|
|
10
|
+
require_insertable
|
|
11
|
+
database = @session.database
|
|
12
|
+
sql, binds = Skyward::ORM::Statements.insert(database.adapter, database.column_types, @table, values)
|
|
13
|
+
written = returning(sql, binds)
|
|
14
|
+
case written
|
|
15
|
+
when Skyward::ORM::Violation then written
|
|
16
|
+
else written.fetch(0)
|
|
17
|
+
end
|
|
18
|
+
end
|
|
19
|
+
|
|
20
|
+
# @rbs **values: untyped
|
|
21
|
+
# @rbs return: R
|
|
22
|
+
def insert!(**values) = unviolated(insert(**values))
|
|
23
|
+
|
|
24
|
+
# @rbs **values: untyped
|
|
25
|
+
# @rbs return: Array[R] | Skyward::ORM::Violation
|
|
26
|
+
def update(**values)
|
|
27
|
+
sql, binds = updating(values)
|
|
28
|
+
returning(sql, binds)
|
|
29
|
+
end
|
|
30
|
+
|
|
31
|
+
# @rbs **values: untyped
|
|
32
|
+
# @rbs return: Array[R]
|
|
33
|
+
def update!(**values) = unviolated(update(**values))
|
|
34
|
+
|
|
35
|
+
# @rbs return: Array[R] | Skyward::ORM::Violation
|
|
36
|
+
def delete
|
|
37
|
+
sql, binds = deleting
|
|
38
|
+
returning(sql, binds)
|
|
39
|
+
end
|
|
40
|
+
|
|
41
|
+
# @rbs return: Array[R]
|
|
42
|
+
def delete! = unviolated(delete)
|
|
43
|
+
|
|
44
|
+
private
|
|
45
|
+
|
|
46
|
+
# An INSERT writes one row and takes none of a query's clauses, so the query
|
|
47
|
+
# can only say what comes back.
|
|
48
|
+
# @rbs return: void
|
|
49
|
+
def require_insertable
|
|
50
|
+
refused = [("conditions" if @scope == :narrowed), *clauses].compact
|
|
51
|
+
return if refused.empty?
|
|
52
|
+
|
|
53
|
+
raise ArgumentError,
|
|
54
|
+
"#{@table} can't insert through a query with #{listing(refused)}. " \
|
|
55
|
+
"Start from #{@table}.into, with nothing else on it."
|
|
56
|
+
end
|
|
57
|
+
|
|
58
|
+
# Steep can't tie the row class to R, so the rows are untyped here and each
|
|
59
|
+
# public method types them.
|
|
60
|
+
# @rbs sql: String
|
|
61
|
+
# @rbs binds: Array[untyped]
|
|
62
|
+
# @rbs return: Array[untyped] | Skyward::ORM::Violation
|
|
63
|
+
def returning(sql, binds)
|
|
64
|
+
returned = Skyward::ORM::Statements.returning(Skyward::ORM::Members.of(@row))
|
|
65
|
+
@session.database.write_returning(@table, @row, "#{sql} #{returned}", binds)
|
|
66
|
+
end
|
|
67
|
+
end
|