rubydb 0.1.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 (436) hide show
  1. checksums.yaml +7 -0
  2. data/.gitattributes +20 -0
  3. data/.github/ISSUE_TEMPLATE/bug.yml +0 -0
  4. data/.github/ISSUE_TEMPLATE/feature.yml +0 -0
  5. data/.github/ISSUE_TEMPLATE/performance.yml +0 -0
  6. data/.github/ISSUE_TEMPLATE/security.yml +0 -0
  7. data/.github/PULL_REQUEST_TEMPLATE.md +15 -0
  8. data/.github/dependabot.yml +0 -0
  9. data/.github/workflows/benchmark.yml +26 -0
  10. data/.github/workflows/compatibility.yml +63 -0
  11. data/.github/workflows/fuzz.yml +33 -0
  12. data/.github/workflows/lint.yml +21 -0
  13. data/.github/workflows/operations.yml +24 -0
  14. data/.github/workflows/production-validation.yml +111 -0
  15. data/.github/workflows/release.yml +77 -0
  16. data/.github/workflows/security.yml +37 -0
  17. data/.github/workflows/test.yml +26 -0
  18. data/.github/workflows/workload.yml +58 -0
  19. data/.gitignore +43 -0
  20. data/.rspec +4 -0
  21. data/.rubocop.yml +44 -0
  22. data/.ruby-version +1 -0
  23. data/.standard.yml +14 -0
  24. data/ARCHITECTURE.md +21 -0
  25. data/CHANGELOG.md +31 -0
  26. data/CODE_OF_CONDUCT.md +13 -0
  27. data/CONTRIBUTING.md +29 -0
  28. data/GOVERNANCE.md +16 -0
  29. data/Gemfile +17 -0
  30. data/Gemfile.lock +71 -0
  31. data/LICENSE +60 -0
  32. data/README.md +162 -0
  33. data/ROADMAP.md +27 -0
  34. data/Rakefile +71 -0
  35. data/SECURITY.md +54 -0
  36. data/SUPPORT.md +14 -0
  37. data/adapters/activerecord/Gemfile +11 -0
  38. data/adapters/activerecord/README.md +9 -0
  39. data/adapters/activerecord/lib/active_record/connection_adapters/rubydb_adapter.rb +887 -0
  40. data/adapters/activerecord/rubydb-activerecord.gemspec +27 -0
  41. data/adapters/activerecord/spec/rubydb_adapter_integration_spec.rb +151 -0
  42. data/adapters/ruby/README.md +18 -0
  43. data/adapters/sequel/README.md +11 -0
  44. data/bin/rubydb +19 -0
  45. data/bin/rubydb-server +126 -0
  46. data/config/development.yml +0 -0
  47. data/config/monitoring/prometheus-alerts.yml +39 -0
  48. data/config/production.yml +36 -0
  49. data/config/test.yml +0 -0
  50. data/docs/README.md +71 -0
  51. data/docs/architecture/concurrency.md +14 -0
  52. data/docs/architecture/current-state.md +125 -0
  53. data/docs/architecture/execution-engine.md +25 -0
  54. data/docs/architecture/indexes.md +19 -0
  55. data/docs/architecture/mvcc.md +19 -0
  56. data/docs/architecture/overview.md +13 -0
  57. data/docs/architecture/pages.md +11 -0
  58. data/docs/architecture/production-roadmap.md +82 -0
  59. data/docs/architecture/query-planner.md +20 -0
  60. data/docs/architecture/recovery.md +18 -0
  61. data/docs/architecture/sql-engine.md +12 -0
  62. data/docs/architecture/storage-engine.md +14 -0
  63. data/docs/architecture/transactions.md +10 -0
  64. data/docs/architecture/wal.md +28 -0
  65. data/docs/cli-cheatsheet.md +98 -0
  66. data/docs/cli.md +275 -0
  67. data/docs/contributing/architecture.md +9 -0
  68. data/docs/contributing/benchmarking.md +14 -0
  69. data/docs/contributing/development.md +16 -0
  70. data/docs/contributing/release-process.md +49 -0
  71. data/docs/contributing/testing.md +16 -0
  72. data/docs/debugging.md +229 -0
  73. data/docs/developer/branching.md +10 -0
  74. data/docs/developer/database-diff.md +10 -0
  75. data/docs/developer/local-development.md +17 -0
  76. data/docs/developer/snapshots.md +9 -0
  77. data/docs/developer/temporal-data.md +10 -0
  78. data/docs/developer-guide.md +297 -0
  79. data/docs/getting-started/first-database.md +16 -0
  80. data/docs/getting-started/first-query.md +13 -0
  81. data/docs/getting-started/installation.md +19 -0
  82. data/docs/getting-started/local-to-production.md +300 -0
  83. data/docs/getting-started/quickstart.md +17 -0
  84. data/docs/getting-started/rails.md +16 -0
  85. data/docs/hardening_backlog.md +93 -0
  86. data/docs/lessons-learned.md +112 -0
  87. data/docs/operations/backups.md +33 -0
  88. data/docs/operations/disaster-recovery.md +31 -0
  89. data/docs/operations/failover.md +30 -0
  90. data/docs/operations/monitoring.md +25 -0
  91. data/docs/operations/production-guide.md +295 -0
  92. data/docs/operations/production-runbook.md +45 -0
  93. data/docs/operations/replication.md +33 -0
  94. data/docs/operations/restore.md +6 -0
  95. data/docs/operations/runbook.md +34 -0
  96. data/docs/operations/upgrades.md +14 -0
  97. data/docs/operations/workload-testing.md +17 -0
  98. data/docs/production-readiness.md +118 -0
  99. data/docs/production_validation.md +150 -0
  100. data/docs/rails/active-record.md +11 -0
  101. data/docs/rails/compatibility-guide.md +90 -0
  102. data/docs/rails/database-yml.md +92 -0
  103. data/docs/rails/installation.md +17 -0
  104. data/docs/rails/migrations.md +17 -0
  105. data/docs/rails/production.md +82 -0
  106. data/docs/rails/troubleshooting.md +18 -0
  107. data/docs/release.md +59 -0
  108. data/docs/server/architecture.md +10 -0
  109. data/docs/server/authentication.md +10 -0
  110. data/docs/server/configuration.md +16 -0
  111. data/docs/server/connection-pooling.md +10 -0
  112. data/docs/server/deployment.md +10 -0
  113. data/docs/server/protocol.md +12 -0
  114. data/docs/sql/compatibility-guide.md +82 -0
  115. data/docs/sql/compatibility.md +39 -0
  116. data/docs/sql/data-types.md +10 -0
  117. data/docs/sql/functions.md +9 -0
  118. data/docs/sql/joins.md +9 -0
  119. data/docs/sql/operators.md +9 -0
  120. data/docs/sql/sqlite-compatibility.md +21 -0
  121. data/docs/sql/syntax.md +10 -0
  122. data/docs/sql/transactions.md +10 -0
  123. data/docs/troubleshooting.md +244 -0
  124. data/exe/rubydb +23 -0
  125. data/lib/rubydb/backup/archive.rb +334 -0
  126. data/lib/rubydb/backup/backup.rb +401 -0
  127. data/lib/rubydb/backup/incremental.rb +353 -0
  128. data/lib/rubydb/backup/restore.rb +290 -0
  129. data/lib/rubydb/backup/snapshot.rb +267 -0
  130. data/lib/rubydb/backup/verification.rb +279 -0
  131. data/lib/rubydb/branching/branch.rb +181 -0
  132. data/lib/rubydb/branching/branch_manager.rb +311 -0
  133. data/lib/rubydb/branching/branch_metadata.rb +140 -0
  134. data/lib/rubydb/branching/checkout.rb +166 -0
  135. data/lib/rubydb/branching/copy_on_write.rb +272 -0
  136. data/lib/rubydb/branching/diff.rb +138 -0
  137. data/lib/rubydb/branching/merge.rb +285 -0
  138. data/lib/rubydb/build_info.rb +15 -0
  139. data/lib/rubydb/catalog/catalog.rb +391 -0
  140. data/lib/rubydb/catalog/column.rb +112 -0
  141. data/lib/rubydb/catalog/constraint.rb +180 -0
  142. data/lib/rubydb/catalog/database.rb +184 -0
  143. data/lib/rubydb/catalog/index.rb +97 -0
  144. data/lib/rubydb/catalog/schema.rb +103 -0
  145. data/lib/rubydb/catalog/sequence.rb +90 -0
  146. data/lib/rubydb/catalog/system_catalog.rb +698 -0
  147. data/lib/rubydb/catalog/table.rb +178 -0
  148. data/lib/rubydb/catalog/trigger.rb +102 -0
  149. data/lib/rubydb/catalog/view.rb +66 -0
  150. data/lib/rubydb/cli/application.rb +163 -0
  151. data/lib/rubydb/cli/commands/backup.rb +81 -0
  152. data/lib/rubydb/cli/commands/branch.rb +72 -0
  153. data/lib/rubydb/cli/commands/checkout.rb +54 -0
  154. data/lib/rubydb/cli/commands/create.rb +58 -0
  155. data/lib/rubydb/cli/commands/diff.rb +77 -0
  156. data/lib/rubydb/cli/commands/doctor.rb +74 -0
  157. data/lib/rubydb/cli/commands/drop.rb +57 -0
  158. data/lib/rubydb/cli/commands/init.rb +102 -0
  159. data/lib/rubydb/cli/commands/inspect.rb +95 -0
  160. data/lib/rubydb/cli/commands/merge.rb +63 -0
  161. data/lib/rubydb/cli/commands/migrate.rb +62 -0
  162. data/lib/rubydb/cli/commands/restart.rb +39 -0
  163. data/lib/rubydb/cli/commands/restore.rb +121 -0
  164. data/lib/rubydb/cli/commands/shell.rb +365 -0
  165. data/lib/rubydb/cli/commands/snapshot.rb +79 -0
  166. data/lib/rubydb/cli/commands/start.rb +82 -0
  167. data/lib/rubydb/cli/commands/status.rb +92 -0
  168. data/lib/rubydb/cli/commands/stop.rb +47 -0
  169. data/lib/rubydb/cli/commands/vacuum.rb +58 -0
  170. data/lib/rubydb/cli/formatter.rb +221 -0
  171. data/lib/rubydb/cli/output.rb +168 -0
  172. data/lib/rubydb/client/client.rb +304 -0
  173. data/lib/rubydb/client/connection.rb +415 -0
  174. data/lib/rubydb/client/connection_pool.rb +168 -0
  175. data/lib/rubydb/client/connection_url.rb +96 -0
  176. data/lib/rubydb/client/prepared_statement.rb +60 -0
  177. data/lib/rubydb/client/result.rb +123 -0
  178. data/lib/rubydb/client/statement.rb +52 -0
  179. data/lib/rubydb/client/transaction.rb +130 -0
  180. data/lib/rubydb/concurrency/concurrency.rb +19 -0
  181. data/lib/rubydb/concurrency/deadlock_detector.rb +150 -0
  182. data/lib/rubydb/concurrency/latch.rb +101 -0
  183. data/lib/rubydb/concurrency/lock_graph.rb +165 -0
  184. data/lib/rubydb/concurrency/mutex.rb +183 -0
  185. data/lib/rubydb/concurrency/rw_lock.rb +180 -0
  186. data/lib/rubydb/concurrency/scheduler.rb +250 -0
  187. data/lib/rubydb/concurrency/worker_pool.rb +143 -0
  188. data/lib/rubydb/configuration/config.rb +170 -0
  189. data/lib/rubydb/configuration/defaults.rb +179 -0
  190. data/lib/rubydb/configuration/environment.rb +152 -0
  191. data/lib/rubydb/configuration/parser.rb +185 -0
  192. data/lib/rubydb/configuration/validation.rb +221 -0
  193. data/lib/rubydb/constants.rb +74 -0
  194. data/lib/rubydb/constraints/check.rb +181 -0
  195. data/lib/rubydb/constraints/constraint.rb +101 -0
  196. data/lib/rubydb/constraints/foreign_key.rb +130 -0
  197. data/lib/rubydb/constraints/not_null.rb +64 -0
  198. data/lib/rubydb/constraints/primary_key.rb +99 -0
  199. data/lib/rubydb/constraints/unique.rb +108 -0
  200. data/lib/rubydb/constraints/validator.rb +350 -0
  201. data/lib/rubydb/errors/authentication_error.rb +10 -0
  202. data/lib/rubydb/errors/authorization_error.rb +23 -0
  203. data/lib/rubydb/errors/client_error.rb +10 -0
  204. data/lib/rubydb/errors/configuration_error.rb +10 -0
  205. data/lib/rubydb/errors/connection_error.rb +10 -0
  206. data/lib/rubydb/errors/constraint_error.rb +23 -0
  207. data/lib/rubydb/errors/corruption_error.rb +10 -0
  208. data/lib/rubydb/errors/database_error.rb +10 -0
  209. data/lib/rubydb/errors/error.rb +20 -0
  210. data/lib/rubydb/errors/execution_error.rb +10 -0
  211. data/lib/rubydb/errors/parser_error.rb +10 -0
  212. data/lib/rubydb/errors/recovery_error.rb +10 -0
  213. data/lib/rubydb/errors/replication_error.rb +10 -0
  214. data/lib/rubydb/errors/server_error.rb +6 -0
  215. data/lib/rubydb/errors/storage_error.rb +10 -0
  216. data/lib/rubydb/errors/transaction_error.rb +10 -0
  217. data/lib/rubydb/execution/aggregate_executor.rb +138 -0
  218. data/lib/rubydb/execution/delete_executor.rb +112 -0
  219. data/lib/rubydb/execution/distinct_executor.rb +135 -0
  220. data/lib/rubydb/execution/executor.rb +1192 -0
  221. data/lib/rubydb/execution/expression.rb +193 -0
  222. data/lib/rubydb/execution/index_scan.rb +142 -0
  223. data/lib/rubydb/execution/insert_executor.rb +217 -0
  224. data/lib/rubydb/execution/join_executor.rb +249 -0
  225. data/lib/rubydb/execution/limit_executor.rb +85 -0
  226. data/lib/rubydb/execution/optimizer.rb +215 -0
  227. data/lib/rubydb/execution/plan.rb +361 -0
  228. data/lib/rubydb/execution/planner.rb +546 -0
  229. data/lib/rubydb/execution/predicate.rb +235 -0
  230. data/lib/rubydb/execution/scan.rb +49 -0
  231. data/lib/rubydb/execution/sequential_scan.rb +63 -0
  232. data/lib/rubydb/execution/sort_executor.rb +185 -0
  233. data/lib/rubydb/execution/update_executor.rb +162 -0
  234. data/lib/rubydb/functions/aggregate.rb +70 -0
  235. data/lib/rubydb/functions/date_functions.rb +278 -0
  236. data/lib/rubydb/functions/function.rb +85 -0
  237. data/lib/rubydb/functions/json_functions.rb +215 -0
  238. data/lib/rubydb/functions/numeric_functions.rb +346 -0
  239. data/lib/rubydb/functions/scalar.rb +52 -0
  240. data/lib/rubydb/functions/string_functions.rb +383 -0
  241. data/lib/rubydb/functions/system_functions.rb +246 -0
  242. data/lib/rubydb/history/as_of.rb +238 -0
  243. data/lib/rubydb/history/change.rb +105 -0
  244. data/lib/rubydb/history/history.rb +131 -0
  245. data/lib/rubydb/history/history_manager.rb +229 -0
  246. data/lib/rubydb/history/temporal_query.rb +202 -0
  247. data/lib/rubydb/history/timeline.rb +144 -0
  248. data/lib/rubydb/indexes/btree.rb +186 -0
  249. data/lib/rubydb/indexes/btree_cursor.rb +258 -0
  250. data/lib/rubydb/indexes/btree_node.rb +385 -0
  251. data/lib/rubydb/indexes/hash_index.rb +150 -0
  252. data/lib/rubydb/indexes/index.rb +71 -0
  253. data/lib/rubydb/indexes/index_manager.rb +406 -0
  254. data/lib/rubydb/indexes/index_scan.rb +470 -0
  255. data/lib/rubydb/migrations/migration.rb +254 -0
  256. data/lib/rubydb/migrations/migration_lock.rb +146 -0
  257. data/lib/rubydb/migrations/migration_manager.rb +176 -0
  258. data/lib/rubydb/migrations/migration_version.rb +71 -0
  259. data/lib/rubydb/migrations/schema_diff.rb +211 -0
  260. data/lib/rubydb/migrations/schema_version.rb +64 -0
  261. data/lib/rubydb/monitoring/events.rb +160 -0
  262. data/lib/rubydb/monitoring/health.rb +222 -0
  263. data/lib/rubydb/monitoring/logger.rb +193 -0
  264. data/lib/rubydb/monitoring/metrics.rb +359 -0
  265. data/lib/rubydb/monitoring/performance.rb +176 -0
  266. data/lib/rubydb/monitoring/statistics.rb +170 -0
  267. data/lib/rubydb/mvcc/garbage_collector.rb +199 -0
  268. data/lib/rubydb/mvcc/mvcc.rb +16 -0
  269. data/lib/rubydb/mvcc/snapshot.rb +147 -0
  270. data/lib/rubydb/mvcc/vacuum.rb +180 -0
  271. data/lib/rubydb/mvcc/version.rb +106 -0
  272. data/lib/rubydb/mvcc/version_store.rb +398 -0
  273. data/lib/rubydb/mvcc/visibility.rb +109 -0
  274. data/lib/rubydb/protocol/capabilities.rb +125 -0
  275. data/lib/rubydb/protocol/decoder.rb +145 -0
  276. data/lib/rubydb/protocol/encoder.rb +136 -0
  277. data/lib/rubydb/protocol/handshake.rb +305 -0
  278. data/lib/rubydb/protocol/message.rb +121 -0
  279. data/lib/rubydb/protocol/protocol.rb +277 -0
  280. data/lib/rubydb/protocol/version.rb +54 -0
  281. data/lib/rubydb/rails/adapter.rb +239 -0
  282. data/lib/rubydb/rails/connection.rb +314 -0
  283. data/lib/rubydb/rails/database_statements.rb +122 -0
  284. data/lib/rubydb/rails/migration.rb +131 -0
  285. data/lib/rubydb/rails/quoting.rb +109 -0
  286. data/lib/rubydb/rails/result.rb +120 -0
  287. data/lib/rubydb/rails/schema_statements.rb +339 -0
  288. data/lib/rubydb/rails/transaction.rb +105 -0
  289. data/lib/rubydb/rails/type.rb +126 -0
  290. data/lib/rubydb/recovery/checkpoint.rb +257 -0
  291. data/lib/rubydb/recovery/consistency.rb +467 -0
  292. data/lib/rubydb/recovery/corruption_detector.rb +5 -0
  293. data/lib/rubydb/recovery/crash_recovery.rb +387 -0
  294. data/lib/rubydb/recovery/recovery_manager.rb +206 -0
  295. data/lib/rubydb/recovery/redo.rb +237 -0
  296. data/lib/rubydb/recovery/undo.rb +206 -0
  297. data/lib/rubydb/replication/failover.rb +5 -0
  298. data/lib/rubydb/replication/fencing.rb +63 -0
  299. data/lib/rubydb/replication/primary.rb +450 -0
  300. data/lib/rubydb/replication/replica.rb +384 -0
  301. data/lib/rubydb/replication/replication_log.rb +200 -0
  302. data/lib/rubydb/replication/replication_manager.rb +308 -0
  303. data/lib/rubydb/replication/replication_slot.rb +295 -0
  304. data/lib/rubydb/replication/replication_stream.rb +201 -0
  305. data/lib/rubydb/rubydb.rb +560 -0
  306. data/lib/rubydb/security/access_control.rb +254 -0
  307. data/lib/rubydb/security/audit_log.rb +213 -0
  308. data/lib/rubydb/security/authentication.rb +302 -0
  309. data/lib/rubydb/security/authorization.rb +282 -0
  310. data/lib/rubydb/security/credentials.rb +196 -0
  311. data/lib/rubydb/security/password.rb +215 -0
  312. data/lib/rubydb/security/permissions.rb +74 -0
  313. data/lib/rubydb/security/role.rb +101 -0
  314. data/lib/rubydb/security/user.rb +86 -0
  315. data/lib/rubydb/server/connection.rb +366 -0
  316. data/lib/rubydb/server/connection_pool.rb +193 -0
  317. data/lib/rubydb/server/lifecycle.rb +228 -0
  318. data/lib/rubydb/server/listener.rb +136 -0
  319. data/lib/rubydb/server/request_handler.rb +276 -0
  320. data/lib/rubydb/server/server.rb +364 -0
  321. data/lib/rubydb/server/session.rb +369 -0
  322. data/lib/rubydb/server/worker.rb +210 -0
  323. data/lib/rubydb/server/worker_pool.rb +168 -0
  324. data/lib/rubydb/sql/ast/alter_table.rb +169 -0
  325. data/lib/rubydb/sql/ast/begin_transaction.rb +47 -0
  326. data/lib/rubydb/sql/ast/commit.rb +37 -0
  327. data/lib/rubydb/sql/ast/constraint.rb +83 -0
  328. data/lib/rubydb/sql/ast/create_database.rb +41 -0
  329. data/lib/rubydb/sql/ast/create_index.rb +61 -0
  330. data/lib/rubydb/sql/ast/create_schema.rb +52 -0
  331. data/lib/rubydb/sql/ast/create_table.rb +187 -0
  332. data/lib/rubydb/sql/ast/delete.rb +54 -0
  333. data/lib/rubydb/sql/ast/drop_database.rb +41 -0
  334. data/lib/rubydb/sql/ast/drop_index.rb +41 -0
  335. data/lib/rubydb/sql/ast/drop_schema.rb +49 -0
  336. data/lib/rubydb/sql/ast/drop_table.rb +49 -0
  337. data/lib/rubydb/sql/ast/explain.rb +64 -0
  338. data/lib/rubydb/sql/ast/expression.rb +604 -0
  339. data/lib/rubydb/sql/ast/insert.rb +82 -0
  340. data/lib/rubydb/sql/ast/node.rb +42 -0
  341. data/lib/rubydb/sql/ast/rollback.rb +63 -0
  342. data/lib/rubydb/sql/ast/savepoint.rb +59 -0
  343. data/lib/rubydb/sql/ast/select.rb +88 -0
  344. data/lib/rubydb/sql/ast/set_operation.rb +20 -0
  345. data/lib/rubydb/sql/ast/trigger.rb +29 -0
  346. data/lib/rubydb/sql/ast/update.rb +88 -0
  347. data/lib/rubydb/sql/ast/vacuum.rb +19 -0
  348. data/lib/rubydb/sql/ast/view.rb +32 -0
  349. data/lib/rubydb/sql/ast/with.rb +32 -0
  350. data/lib/rubydb/sql/grammar.rb +86 -0
  351. data/lib/rubydb/sql/keywords.rb +156 -0
  352. data/lib/rubydb/sql/lexer.rb +214 -0
  353. data/lib/rubydb/sql/operators.rb +100 -0
  354. data/lib/rubydb/sql/parser.rb +1185 -0
  355. data/lib/rubydb/sql/planner/analyzer.rb +302 -0
  356. data/lib/rubydb/sql/planner/binder.rb +550 -0
  357. data/lib/rubydb/sql/planner/type_checker.rb +431 -0
  358. data/lib/rubydb/sql/token.rb +210 -0
  359. data/lib/rubydb/storage/buffer_frame.rb +44 -0
  360. data/lib/rubydb/storage/buffer_pool.rb +155 -0
  361. data/lib/rubydb/storage/database_lock.rb +74 -0
  362. data/lib/rubydb/storage/deserializer.rb +342 -0
  363. data/lib/rubydb/storage/engine.rb +2338 -0
  364. data/lib/rubydb/storage/file_manager.rb +187 -0
  365. data/lib/rubydb/storage/free_space_map.rb +81 -0
  366. data/lib/rubydb/storage/page.rb +94 -0
  367. data/lib/rubydb/storage/page_allocator.rb +855 -0
  368. data/lib/rubydb/storage/page_header.rb +67 -0
  369. data/lib/rubydb/storage/page_manager.rb +131 -0
  370. data/lib/rubydb/storage/record.rb +58 -0
  371. data/lib/rubydb/storage/row.rb +78 -0
  372. data/lib/rubydb/storage/serializer.rb +51 -0
  373. data/lib/rubydb/storage/storage_layout.rb +151 -0
  374. data/lib/rubydb/storage/storage_manager.rb +114 -0
  375. data/lib/rubydb/storage/tuple.rb +461 -0
  376. data/lib/rubydb/storage/visibility_map.rb +984 -0
  377. data/lib/rubydb/transactions/commit_manager.rb +220 -0
  378. data/lib/rubydb/transactions/isolation.rb +98 -0
  379. data/lib/rubydb/transactions/lock.rb +76 -0
  380. data/lib/rubydb/transactions/lock_manager.rb +362 -0
  381. data/lib/rubydb/transactions/savepoint.rb +143 -0
  382. data/lib/rubydb/transactions/transaction.rb +215 -0
  383. data/lib/rubydb/transactions/transaction_id.rb +84 -0
  384. data/lib/rubydb/transactions/transaction_log.rb +257 -0
  385. data/lib/rubydb/transactions/transaction_manager.rb +435 -0
  386. data/lib/rubydb/types/bigint.rb +36 -0
  387. data/lib/rubydb/types/blob.rb +37 -0
  388. data/lib/rubydb/types/boolean.rb +34 -0
  389. data/lib/rubydb/types/date.rb +39 -0
  390. data/lib/rubydb/types/decimal.rb +48 -0
  391. data/lib/rubydb/types/float.rb +34 -0
  392. data/lib/rubydb/types/integer.rb +36 -0
  393. data/lib/rubydb/types/json.rb +41 -0
  394. data/lib/rubydb/types/null.rb +34 -0
  395. data/lib/rubydb/types/smallint.rb +36 -0
  396. data/lib/rubydb/types/text.rb +37 -0
  397. data/lib/rubydb/types/time.rb +46 -0
  398. data/lib/rubydb/types/timestamp.rb +39 -0
  399. data/lib/rubydb/types/type.rb +119 -0
  400. data/lib/rubydb/types/uuid.rb +47 -0
  401. data/lib/rubydb/types/varchar.rb +37 -0
  402. data/lib/rubydb/version.rb +33 -0
  403. data/lib/rubydb/wal/archive.rb +193 -0
  404. data/lib/rubydb/wal/checkpoint.rb +183 -0
  405. data/lib/rubydb/wal/lsn.rb +94 -0
  406. data/lib/rubydb/wal/reader.rb +260 -0
  407. data/lib/rubydb/wal/record.rb +105 -0
  408. data/lib/rubydb/wal/segment.rb +193 -0
  409. data/lib/rubydb/wal/wal.rb +452 -0
  410. data/lib/rubydb/wal/writer.rb +236 -0
  411. data/lib/rubydb.rb +7 -0
  412. data/packaging/docker/Dockerfile +36 -0
  413. data/packaging/docker/docker-compose.failover.yml +43 -0
  414. data/packaging/docker/entrypoint.sh +15 -0
  415. data/packaging/homebrew/rubydb.rb +19 -0
  416. data/packaging/systemd/rubydb.service +22 -0
  417. data/rubydb.gemspec +57 -0
  418. data/scripts/benchmark +7 -0
  419. data/scripts/durability_drill +37 -0
  420. data/scripts/format +0 -0
  421. data/scripts/fuzz +63 -0
  422. data/scripts/lint +0 -0
  423. data/scripts/release +50 -0
  424. data/scripts/release_check +43 -0
  425. data/scripts/replication_failover_drill +250 -0
  426. data/scripts/replication_network_failover_drill +255 -0
  427. data/scripts/restore_drill +45 -0
  428. data/scripts/security +0 -0
  429. data/scripts/setup +0 -0
  430. data/scripts/test +0 -0
  431. data/scripts/test-chaos +0 -0
  432. data/scripts/test-crash +0 -0
  433. data/scripts/test-integration +0 -0
  434. data/scripts/test-unit +0 -0
  435. data/visibility_map.json +1 -0
  436. metadata +538 -0
@@ -0,0 +1,364 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "socket"
4
+ require "thread"
5
+ require "time"
6
+ require "json"
7
+ require "fileutils"
8
+ require "monitor"
9
+ require "openssl"
10
+
11
+ require_relative "listener"
12
+ require_relative "connection"
13
+ require_relative "session"
14
+ require_relative "connection_pool"
15
+ require_relative "worker_pool"
16
+ require_relative "worker"
17
+ require_relative "request_handler"
18
+ require_relative "lifecycle"
19
+ require_relative "../protocol/protocol"
20
+ require_relative "../protocol/handshake"
21
+ require_relative "../storage/engine"
22
+ require_relative "../transactions/transaction_manager"
23
+
24
+ module RubyDB
25
+ module Server
26
+ # Server - Main database server
27
+ class Server
28
+ attr_reader :config, :engine, :listener, :connection_pool
29
+ attr_reader :worker_pool, :request_handler, :lifecycle, :stats
30
+
31
+ def initialize(config = {})
32
+ @config = {
33
+ host: config[:host] || "localhost",
34
+ port: config[:port] || 7432,
35
+ max_connections: config[:max_connections] || 100,
36
+ min_workers: config[:min_workers] || 2,
37
+ max_workers: config[:max_workers] || 20,
38
+ worker_queue_size: config[:worker_queue_size] || 1000,
39
+ read_timeout: config[:read_timeout] || 30,
40
+ write_timeout: config[:write_timeout] || 30,
41
+ idle_timeout: config[:idle_timeout] || 300,
42
+ max_request_size: config[:max_request_size] || 10 * 1024 * 1024, # 10MB
43
+ data_dir: config[:data_dir] || "data",
44
+ log_dir: config[:log_dir] || "log",
45
+ pid_file: config[:pid_file] || "rubydb.pid",
46
+ daemonize: config[:daemonize] || false,
47
+ authentication: config[:authentication] || { method: "none" },
48
+ ssl: config[:ssl] || { enabled: false }
49
+ }.merge(config)
50
+
51
+ @stats = {
52
+ connections_total: 0,
53
+ connections_active: 0,
54
+ connections_rejected: 0,
55
+ requests_processed: 0,
56
+ requests_failed: 0,
57
+ bytes_received: 0,
58
+ bytes_sent: 0,
59
+ started_at: nil,
60
+ uptime_seconds: 0,
61
+ last_activity: nil
62
+ }
63
+
64
+ @lock = Monitor.new
65
+ @running = false
66
+ @shutdown = false
67
+ @stopping = false
68
+
69
+ validate_authentication_config!
70
+ validate_ssl_config!
71
+ validate_resource_limits!
72
+
73
+ # Setup directories
74
+ setup_directories
75
+
76
+ # Initialize components
77
+ initialize_components
78
+ end
79
+
80
+ def start
81
+ @lock.synchronize do
82
+ return if @running
83
+
84
+ @running = true
85
+ @shutdown = false
86
+ @stats[:started_at] = Time.now
87
+
88
+ # Daemonize if configured
89
+ daemonize if @config[:daemonize]
90
+
91
+ # Write PID file
92
+ write_pid_file
93
+
94
+ # Start components
95
+ @listener.start
96
+ @connection_pool.start
97
+ @worker_pool.start
98
+ @lifecycle.start
99
+
100
+ puts "RubyDB Server v#{RubyDB::VERSION} started on #{@config[:host]}:#{@config[:port]}"
101
+ puts "Data directory: #{@config[:data_dir]}"
102
+ puts "Max connections: #{@config[:max_connections]}"
103
+
104
+ # Update stats thread
105
+ start_stats_thread
106
+
107
+ true
108
+ end
109
+ end
110
+
111
+ def stop
112
+ @lock.synchronize do
113
+ return unless @running
114
+ return true if @stopping
115
+
116
+ @stopping = true
117
+
118
+ @shutdown = true
119
+ puts "Shutting down RubyDB Server..."
120
+
121
+ # Stop accepting new connections
122
+ @listener.stop
123
+
124
+ # Close all connections
125
+ @connection_pool.close_all
126
+
127
+ # Stop workers
128
+ @worker_pool.stop
129
+
130
+ # Stop lifecycle
131
+ @lifecycle.stop
132
+
133
+ # Release the database file handle before the data directory is
134
+ # removed by callers (notably on Windows).
135
+ @engine&.close
136
+
137
+ # Remove PID file
138
+ remove_pid_file
139
+
140
+ @running = false
141
+ @stopping = false
142
+
143
+ puts "RubyDB Server stopped"
144
+ true
145
+ end
146
+ end
147
+
148
+ def restart
149
+ stop
150
+ sleep(1)
151
+ start
152
+ end
153
+
154
+ def running?
155
+ @running
156
+ end
157
+
158
+ def stats
159
+ @lock.synchronize do
160
+ elapsed = @stats[:started_at] ? (Time.now - @stats[:started_at]).to_i : 0
161
+ @stats[:uptime_seconds] = elapsed
162
+ pool_stats = @connection_pool&.stats || {}
163
+ @stats[:connections_active] = pool_stats[:active_connections] || 0
164
+ @stats[:connections_total] = pool_stats[:total_connections] || 0
165
+ @stats[:requests_processed] = pool_stats[:requests_processed] || 0
166
+ @stats[:requests_failed] = pool_stats[:requests_failed] || 0
167
+
168
+ @stats.merge({
169
+ engine_stats: @engine&.stats || {},
170
+ connection_pool_stats: @connection_pool&.stats || {},
171
+ worker_pool_stats: @worker_pool&.stats || {},
172
+ memory_usage: get_memory_usage,
173
+ pid: Process.pid
174
+ })
175
+ end
176
+ end
177
+
178
+ private
179
+
180
+ def initialize_components
181
+ # Initialize storage engine
182
+ db_path = File.join(@config[:data_dir], "rubydb.rdb")
183
+ @engine = Storage::Engine.new(db_path, @config)
184
+
185
+ # Initialize transaction manager
186
+ @transaction_manager = Transactions::TransactionManager.new(@engine, @config)
187
+
188
+ # Initialize protocol
189
+ @protocol = Protocol::Protocol.new(
190
+ format: :json,
191
+ compression: @config[:compression] || false,
192
+ server_info: {
193
+ version: RubyDB::VERSION,
194
+ pid: Process.pid,
195
+ started_at: Time.now.iso8601,
196
+ default_auth: authentication_method,
197
+ authentication_credentials: authentication_credentials
198
+ }
199
+ )
200
+
201
+ # Initialize connection pool
202
+ @connection_pool = ConnectionPool.new(@config, @protocol, @engine)
203
+
204
+ # Initialize worker pool
205
+ @worker_pool = WorkerPool.new(@config, @engine, @transaction_manager)
206
+
207
+ # Initialize request handler
208
+ @request_handler = RequestHandler.new(@engine, @transaction_manager, @config)
209
+
210
+ # Initialize listener
211
+ @listener = Listener.new(@config, @connection_pool, @worker_pool)
212
+
213
+ # Initialize lifecycle
214
+ @lifecycle = Lifecycle.new(self, @config)
215
+ end
216
+
217
+ def setup_directories
218
+ [:data_dir, :log_dir].each do |dir|
219
+ path = @config[dir]
220
+ FileUtils.mkdir_p(path) unless Dir.exist?(path)
221
+ end
222
+ end
223
+
224
+ def authentication_method
225
+ auth = @config[:authentication] || {}
226
+ (auth[:method] || auth["method"] || "none").to_s.tr("_", "-")
227
+ end
228
+
229
+ def authentication_credentials
230
+ auth = @config[:authentication] || {}
231
+ auth[:credentials] || auth["credentials"] || auth
232
+ end
233
+
234
+ def validate_authentication_config!
235
+ method = authentication_method
236
+ supported = %w[none password md5 scram-sha-256]
237
+ raise ServerError, "Unsupported authentication method: #{method}" unless supported.include?(method)
238
+
239
+ return if method == "none"
240
+
241
+ credentials = authentication_credentials
242
+ users = credentials[:users] || credentials["users"]
243
+ complete = users && !users.empty? ||
244
+ ((credentials[:username] || credentials["username"]) &&
245
+ (credentials[:password] || credentials["password"]))
246
+ raise ServerError, "Authentication credentials are required for #{method}" unless complete
247
+ end
248
+
249
+ def validate_ssl_config!
250
+ ssl = @config[:ssl] || {}
251
+ enabled = ssl == true || ssl[:enabled] || ssl["enabled"]
252
+ return unless enabled
253
+
254
+ raise ServerError, "SSL configuration must include certificate and key paths" if ssl == true
255
+
256
+ cert = ssl[:cert_file] || ssl["cert_file"]
257
+ key = ssl[:key_file] || ssl["key_file"]
258
+ raise ServerError, "ssl.cert_file and ssl.key_file are required when SSL is enabled" unless cert && key
259
+ raise ServerError, "SSL certificate file does not exist" unless File.file?(cert)
260
+ raise ServerError, "SSL key file does not exist" unless File.file?(key)
261
+
262
+ begin
263
+ OpenSSL::X509::Certificate.new(File.binread(cert))
264
+ OpenSSL::PKey.read(File.binread(key))
265
+ rescue OpenSSL::SSL::SSLError, OpenSSL::X509::CertificateError, OpenSSL::PKey::PKeyError, ArgumentError => e
266
+ raise ServerError, "SSL certificate or key is invalid: #{e.message}"
267
+ end
268
+
269
+ ca = ssl[:ca_file] || ssl["ca_file"]
270
+ if (ssl[:verify_peer] || ssl["verify_peer"]) && !ca
271
+ raise ServerError, "ssl.ca_file is required when peer verification is enabled"
272
+ end
273
+ raise ServerError, "SSL CA file does not exist" if ca && !File.file?(ca)
274
+
275
+ min_version = ssl[:min_version] || ssl["min_version"] || :TLS1_2
276
+ unless %i[TLS1_2 TLS1_3].include?(min_version.to_s.to_sym)
277
+ raise ServerError, "SSL min_version must be TLS1_2 or TLS1_3"
278
+ end
279
+ end
280
+
281
+ def validate_resource_limits!
282
+ integer_limits = {
283
+ max_connections: 1..10_000,
284
+ min_workers: 1..1_024,
285
+ max_workers: 1..1_024,
286
+ worker_queue_size: 1..100_000,
287
+ max_request_size: 1_024..(64 * 1024 * 1024)
288
+ }
289
+ integer_limits.each do |name, allowed|
290
+ value = Integer(@config[name])
291
+ raise ServerError, "#{name} must be between #{allowed.begin} and #{allowed.end}" unless allowed.cover?(value)
292
+ @config[name] = value
293
+ rescue ArgumentError, TypeError
294
+ raise ServerError, "#{name} must be an integer"
295
+ end
296
+ raise ServerError, "min_workers cannot exceed max_workers" if @config[:min_workers] > @config[:max_workers]
297
+
298
+ %i[read_timeout write_timeout idle_timeout].each do |name|
299
+ value = Float(@config[name])
300
+ raise ServerError, "#{name} must be greater than zero" unless value.positive?
301
+ @config[name] = value
302
+ rescue ArgumentError, TypeError
303
+ raise ServerError, "#{name} must be a number"
304
+ end
305
+ end
306
+
307
+ def daemonize
308
+ return unless @config[:daemonize]
309
+
310
+ Process.daemon(true, true)
311
+ $stdout.reopen(File.join(@config[:log_dir], "rubydb.out"), "a")
312
+ $stderr.reopen(File.join(@config[:log_dir], "rubydb.err"), "a")
313
+ end
314
+
315
+ def write_pid_file
316
+ File.write(@config[:pid_file], Process.pid.to_s)
317
+ end
318
+
319
+ def remove_pid_file
320
+ File.delete(@config[:pid_file]) if File.exist?(@config[:pid_file])
321
+ end
322
+
323
+ def start_stats_thread
324
+ Thread.new do
325
+ while @running
326
+ sleep(10)
327
+ update_stats
328
+ end
329
+ end
330
+ end
331
+
332
+ def update_stats
333
+ @lock.synchronize do
334
+ @stats[:connections_active] = @connection_pool&.active_count || 0
335
+ @stats[:connections_total] = @connection_pool&.total_connections || 0
336
+ @stats[:requests_processed] = @request_handler&.stats&.dig(:requests_processed) || 0
337
+ end
338
+ end
339
+
340
+ def get_memory_usage
341
+ # Get memory usage in MB
342
+ if File.exist?("/proc/self/status")
343
+ File.read("/proc/self/status").each_line do |line|
344
+ if line.start_with?("VmRSS:")
345
+ return line.split[1].to_i / 1024
346
+ end
347
+ end
348
+ end
349
+
350
+ # Fallback - run ps command
351
+ begin
352
+ output = `ps -o rss= -p #{Process.pid}`
353
+ return output.strip.to_i / 1024 if output && !output.empty?
354
+ rescue
355
+ # Ignore
356
+ end
357
+
358
+ 0
359
+ rescue
360
+ 0
361
+ end
362
+ end
363
+ end
364
+ end