partition_gardener 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 (82) hide show
  1. checksums.yaml +7 -0
  2. data/CHANGELOG.md +36 -0
  3. data/LICENSE.md +21 -0
  4. data/README.md +203 -0
  5. data/SECURITY.md +27 -0
  6. data/docs/THIRD_PARTY_LICENSE_MANIFEST.tsv +60 -0
  7. data/docs/application_contract.md +82 -0
  8. data/docs/audit_reference.md +125 -0
  9. data/docs/background_job.md +161 -0
  10. data/docs/cli.md +71 -0
  11. data/docs/configuration.md +261 -0
  12. data/docs/cutover.md +180 -0
  13. data/docs/decision_flow.md +154 -0
  14. data/docs/host_testing.md +91 -0
  15. data/docs/monitoring.md +110 -0
  16. data/docs/naming.md +71 -0
  17. data/docs/operations.md +131 -0
  18. data/docs/partition_landscape.md +323 -0
  19. data/docs/pg_party_recipe.md +44 -0
  20. data/docs/related_postgres_tooling.md +195 -0
  21. data/docs/retention.md +65 -0
  22. data/docs/schemas/partition_garden.schema.json +114 -0
  23. data/docs/schemas/plan_report.schema.json +82 -0
  24. data/docs/tooling_split.md +79 -0
  25. data/exe/partition_gardener +6 -0
  26. data/lib/partition_gardener/active_record_run_record_store.rb +1 -0
  27. data/lib/partition_gardener/advisory_lock.rb +48 -0
  28. data/lib/partition_gardener/archive_retention.rb +88 -0
  29. data/lib/partition_gardener/audit.rb +93 -0
  30. data/lib/partition_gardener/blank.rb +13 -0
  31. data/lib/partition_gardener/cli.rb +190 -0
  32. data/lib/partition_gardener/config_document.rb +240 -0
  33. data/lib/partition_gardener/configuration.rb +102 -0
  34. data/lib/partition_gardener/connection.rb +260 -0
  35. data/lib/partition_gardener/date_bucket.rb +117 -0
  36. data/lib/partition_gardener/date_calendar.rb +65 -0
  37. data/lib/partition_gardener/date_range_maintenance.rb +297 -0
  38. data/lib/partition_gardener/default_partition.rb +54 -0
  39. data/lib/partition_gardener/executor.rb +324 -0
  40. data/lib/partition_gardener/gap_detection.rb +59 -0
  41. data/lib/partition_gardener/hash_routing.rb +70 -0
  42. data/lib/partition_gardener/layout/calendar_year.rb +28 -0
  43. data/lib/partition_gardener/layout/integer_window.rb +28 -0
  44. data/lib/partition_gardener/layout/sliding_window.rb +28 -0
  45. data/lib/partition_gardener/layout/three_area.rb +27 -0
  46. data/lib/partition_gardener/layout/zone_segments.rb +62 -0
  47. data/lib/partition_gardener/lock_not_acquired.rb +3 -0
  48. data/lib/partition_gardener/maintenance_backend.rb +73 -0
  49. data/lib/partition_gardener/memory_run_record_store.rb +19 -0
  50. data/lib/partition_gardener/migration/hot_switch_concern.rb +445 -0
  51. data/lib/partition_gardener/missing_conflict_index.rb +3 -0
  52. data/lib/partition_gardener/naming.rb +29 -0
  53. data/lib/partition_gardener/orphaned_rebalance_staging.rb +3 -0
  54. data/lib/partition_gardener/pg_connection.rb +94 -0
  55. data/lib/partition_gardener/plan.rb +49 -0
  56. data/lib/partition_gardener/plan_applier.rb +289 -0
  57. data/lib/partition_gardener/plan_diff.rb +51 -0
  58. data/lib/partition_gardener/plan_report.rb +95 -0
  59. data/lib/partition_gardener/planner.rb +21 -0
  60. data/lib/partition_gardener/predicate.rb +85 -0
  61. data/lib/partition_gardener/premake_monthly_maintenance.rb +44 -0
  62. data/lib/partition_gardener/rails.rb +12 -0
  63. data/lib/partition_gardener/registry.rb +84 -0
  64. data/lib/partition_gardener/run_failed.rb +10 -0
  65. data/lib/partition_gardener/run_metrics.rb +65 -0
  66. data/lib/partition_gardener/run_record.rb +76 -0
  67. data/lib/partition_gardener/sql_run_record_store.rb +106 -0
  68. data/lib/partition_gardener/stdlib_extensions.rb +15 -0
  69. data/lib/partition_gardener/strategy/composite.rb +27 -0
  70. data/lib/partition_gardener/strategy/cursor_columns.rb +18 -0
  71. data/lib/partition_gardener/strategy/date_range.rb +303 -0
  72. data/lib/partition_gardener/strategy/hash_branches.rb +161 -0
  73. data/lib/partition_gardener/strategy/integer_range.rb +261 -0
  74. data/lib/partition_gardener/strategy/list_split.rb +125 -0
  75. data/lib/partition_gardener/strategy/requires_default_partition.rb +19 -0
  76. data/lib/partition_gardener/strategy.rb +26 -0
  77. data/lib/partition_gardener/templates.rb +373 -0
  78. data/lib/partition_gardener/unmoved_rows_remaining.rb +15 -0
  79. data/lib/partition_gardener/version.rb +3 -0
  80. data/lib/partition_gardener.rb +215 -0
  81. data/sig/partition_gardener.rbs +19 -0
  82. metadata +367 -0
metadata ADDED
@@ -0,0 +1,367 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: partition_gardener
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.3.0
5
+ platform: ruby
6
+ authors:
7
+ - Andrei Makarov
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: pg
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.5'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.5'
26
+ - !ruby/object:Gem::Dependency
27
+ name: activesupport
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: '7.1'
33
+ type: :development
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: '7.1'
40
+ - !ruby/object:Gem::Dependency
41
+ name: activerecord
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - ">="
45
+ - !ruby/object:Gem::Version
46
+ version: '7.1'
47
+ type: :development
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - ">="
52
+ - !ruby/object:Gem::Version
53
+ version: '7.1'
54
+ - !ruby/object:Gem::Dependency
55
+ name: rake
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '13'
61
+ type: :development
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '13'
68
+ - !ruby/object:Gem::Dependency
69
+ name: rspec
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: '3'
75
+ type: :development
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: '3'
82
+ - !ruby/object:Gem::Dependency
83
+ name: polyrun
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - "~>"
87
+ - !ruby/object:Gem::Version
88
+ version: 1.5.0
89
+ type: :development
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - "~>"
94
+ - !ruby/object:Gem::Version
95
+ version: 1.5.0
96
+ - !ruby/object:Gem::Dependency
97
+ name: rspec_junit_formatter
98
+ requirement: !ruby/object:Gem::Requirement
99
+ requirements:
100
+ - - "~>"
101
+ - !ruby/object:Gem::Version
102
+ version: '0.6'
103
+ type: :development
104
+ prerelease: false
105
+ version_requirements: !ruby/object:Gem::Requirement
106
+ requirements:
107
+ - - "~>"
108
+ - !ruby/object:Gem::Version
109
+ version: '0.6'
110
+ - !ruby/object:Gem::Dependency
111
+ name: standard
112
+ requirement: !ruby/object:Gem::Requirement
113
+ requirements:
114
+ - - "~>"
115
+ - !ruby/object:Gem::Version
116
+ version: '1.52'
117
+ type: :development
118
+ prerelease: false
119
+ version_requirements: !ruby/object:Gem::Requirement
120
+ requirements:
121
+ - - "~>"
122
+ - !ruby/object:Gem::Version
123
+ version: '1.52'
124
+ - !ruby/object:Gem::Dependency
125
+ name: standard-custom
126
+ requirement: !ruby/object:Gem::Requirement
127
+ requirements:
128
+ - - "~>"
129
+ - !ruby/object:Gem::Version
130
+ version: '1.0'
131
+ type: :development
132
+ prerelease: false
133
+ version_requirements: !ruby/object:Gem::Requirement
134
+ requirements:
135
+ - - "~>"
136
+ - !ruby/object:Gem::Version
137
+ version: '1.0'
138
+ - !ruby/object:Gem::Dependency
139
+ name: standard-performance
140
+ requirement: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - "~>"
143
+ - !ruby/object:Gem::Version
144
+ version: '1.8'
145
+ type: :development
146
+ prerelease: false
147
+ version_requirements: !ruby/object:Gem::Requirement
148
+ requirements:
149
+ - - "~>"
150
+ - !ruby/object:Gem::Version
151
+ version: '1.8'
152
+ - !ruby/object:Gem::Dependency
153
+ name: standard-rails
154
+ requirement: !ruby/object:Gem::Requirement
155
+ requirements:
156
+ - - "~>"
157
+ - !ruby/object:Gem::Version
158
+ version: '1.5'
159
+ type: :development
160
+ prerelease: false
161
+ version_requirements: !ruby/object:Gem::Requirement
162
+ requirements:
163
+ - - "~>"
164
+ - !ruby/object:Gem::Version
165
+ version: '1.5'
166
+ - !ruby/object:Gem::Dependency
167
+ name: standard-rspec
168
+ requirement: !ruby/object:Gem::Requirement
169
+ requirements:
170
+ - - "~>"
171
+ - !ruby/object:Gem::Version
172
+ version: '0.3'
173
+ type: :development
174
+ prerelease: false
175
+ version_requirements: !ruby/object:Gem::Requirement
176
+ requirements:
177
+ - - "~>"
178
+ - !ruby/object:Gem::Version
179
+ version: '0.3'
180
+ - !ruby/object:Gem::Dependency
181
+ name: rubocop-rails
182
+ requirement: !ruby/object:Gem::Requirement
183
+ requirements:
184
+ - - "~>"
185
+ - !ruby/object:Gem::Version
186
+ version: '2.33'
187
+ type: :development
188
+ prerelease: false
189
+ version_requirements: !ruby/object:Gem::Requirement
190
+ requirements:
191
+ - - "~>"
192
+ - !ruby/object:Gem::Version
193
+ version: '2.33'
194
+ - !ruby/object:Gem::Dependency
195
+ name: rubocop-rspec
196
+ requirement: !ruby/object:Gem::Requirement
197
+ requirements:
198
+ - - "~>"
199
+ - !ruby/object:Gem::Version
200
+ version: '3.8'
201
+ type: :development
202
+ prerelease: false
203
+ version_requirements: !ruby/object:Gem::Requirement
204
+ requirements:
205
+ - - "~>"
206
+ - !ruby/object:Gem::Version
207
+ version: '3.8'
208
+ - !ruby/object:Gem::Dependency
209
+ name: rubocop-thread_safety
210
+ requirement: !ruby/object:Gem::Requirement
211
+ requirements:
212
+ - - "~>"
213
+ - !ruby/object:Gem::Version
214
+ version: '0.7'
215
+ type: :development
216
+ prerelease: false
217
+ version_requirements: !ruby/object:Gem::Requirement
218
+ requirements:
219
+ - - "~>"
220
+ - !ruby/object:Gem::Version
221
+ version: '0.7'
222
+ - !ruby/object:Gem::Dependency
223
+ name: appraisal
224
+ requirement: !ruby/object:Gem::Requirement
225
+ requirements:
226
+ - - "~>"
227
+ - !ruby/object:Gem::Version
228
+ version: '2'
229
+ type: :development
230
+ prerelease: false
231
+ version_requirements: !ruby/object:Gem::Requirement
232
+ requirements:
233
+ - - "~>"
234
+ - !ruby/object:Gem::Version
235
+ version: '2'
236
+ - !ruby/object:Gem::Dependency
237
+ name: rbs
238
+ requirement: !ruby/object:Gem::Requirement
239
+ requirements:
240
+ - - "~>"
241
+ - !ruby/object:Gem::Version
242
+ version: '3'
243
+ type: :development
244
+ prerelease: false
245
+ version_requirements: !ruby/object:Gem::Requirement
246
+ requirements:
247
+ - - "~>"
248
+ - !ruby/object:Gem::Version
249
+ version: '3'
250
+ description: Runtime maintenance for PostgreSQL declarative partitions — archive /
251
+ current / future zones, heat-driven splits, mandatory default drain, hot-switch
252
+ migrations, and strategy templates.
253
+ email:
254
+ - andrei@kiskolabs.com
255
+ executables:
256
+ - partition_gardener
257
+ extensions: []
258
+ extra_rdoc_files: []
259
+ files:
260
+ - CHANGELOG.md
261
+ - LICENSE.md
262
+ - README.md
263
+ - SECURITY.md
264
+ - docs/THIRD_PARTY_LICENSE_MANIFEST.tsv
265
+ - docs/application_contract.md
266
+ - docs/audit_reference.md
267
+ - docs/background_job.md
268
+ - docs/cli.md
269
+ - docs/configuration.md
270
+ - docs/cutover.md
271
+ - docs/decision_flow.md
272
+ - docs/host_testing.md
273
+ - docs/monitoring.md
274
+ - docs/naming.md
275
+ - docs/operations.md
276
+ - docs/partition_landscape.md
277
+ - docs/pg_party_recipe.md
278
+ - docs/related_postgres_tooling.md
279
+ - docs/retention.md
280
+ - docs/schemas/partition_garden.schema.json
281
+ - docs/schemas/plan_report.schema.json
282
+ - docs/tooling_split.md
283
+ - exe/partition_gardener
284
+ - lib/partition_gardener.rb
285
+ - lib/partition_gardener/active_record_run_record_store.rb
286
+ - lib/partition_gardener/advisory_lock.rb
287
+ - lib/partition_gardener/archive_retention.rb
288
+ - lib/partition_gardener/audit.rb
289
+ - lib/partition_gardener/blank.rb
290
+ - lib/partition_gardener/cli.rb
291
+ - lib/partition_gardener/config_document.rb
292
+ - lib/partition_gardener/configuration.rb
293
+ - lib/partition_gardener/connection.rb
294
+ - lib/partition_gardener/date_bucket.rb
295
+ - lib/partition_gardener/date_calendar.rb
296
+ - lib/partition_gardener/date_range_maintenance.rb
297
+ - lib/partition_gardener/default_partition.rb
298
+ - lib/partition_gardener/executor.rb
299
+ - lib/partition_gardener/gap_detection.rb
300
+ - lib/partition_gardener/hash_routing.rb
301
+ - lib/partition_gardener/layout/calendar_year.rb
302
+ - lib/partition_gardener/layout/integer_window.rb
303
+ - lib/partition_gardener/layout/sliding_window.rb
304
+ - lib/partition_gardener/layout/three_area.rb
305
+ - lib/partition_gardener/layout/zone_segments.rb
306
+ - lib/partition_gardener/lock_not_acquired.rb
307
+ - lib/partition_gardener/maintenance_backend.rb
308
+ - lib/partition_gardener/memory_run_record_store.rb
309
+ - lib/partition_gardener/migration/hot_switch_concern.rb
310
+ - lib/partition_gardener/missing_conflict_index.rb
311
+ - lib/partition_gardener/naming.rb
312
+ - lib/partition_gardener/orphaned_rebalance_staging.rb
313
+ - lib/partition_gardener/pg_connection.rb
314
+ - lib/partition_gardener/plan.rb
315
+ - lib/partition_gardener/plan_applier.rb
316
+ - lib/partition_gardener/plan_diff.rb
317
+ - lib/partition_gardener/plan_report.rb
318
+ - lib/partition_gardener/planner.rb
319
+ - lib/partition_gardener/predicate.rb
320
+ - lib/partition_gardener/premake_monthly_maintenance.rb
321
+ - lib/partition_gardener/rails.rb
322
+ - lib/partition_gardener/registry.rb
323
+ - lib/partition_gardener/run_failed.rb
324
+ - lib/partition_gardener/run_metrics.rb
325
+ - lib/partition_gardener/run_record.rb
326
+ - lib/partition_gardener/sql_run_record_store.rb
327
+ - lib/partition_gardener/stdlib_extensions.rb
328
+ - lib/partition_gardener/strategy.rb
329
+ - lib/partition_gardener/strategy/composite.rb
330
+ - lib/partition_gardener/strategy/cursor_columns.rb
331
+ - lib/partition_gardener/strategy/date_range.rb
332
+ - lib/partition_gardener/strategy/hash_branches.rb
333
+ - lib/partition_gardener/strategy/integer_range.rb
334
+ - lib/partition_gardener/strategy/list_split.rb
335
+ - lib/partition_gardener/strategy/requires_default_partition.rb
336
+ - lib/partition_gardener/templates.rb
337
+ - lib/partition_gardener/unmoved_rows_remaining.rb
338
+ - lib/partition_gardener/version.rb
339
+ - sig/partition_gardener.rbs
340
+ homepage: https://github.com/amkisko/partition_gardener.rb
341
+ licenses:
342
+ - MIT
343
+ metadata:
344
+ homepage_uri: https://github.com/amkisko/partition_gardener.rb
345
+ source_code_uri: https://github.com/amkisko/partition_gardener.rb
346
+ changelog_uri: https://github.com/amkisko/partition_gardener.rb/blob/main/CHANGELOG.md
347
+ bug_tracker_uri: https://github.com/amkisko/partition_gardener.rb/issues
348
+ documentation_uri: https://github.com/amkisko/partition_gardener.rb#readme
349
+ rubygems_mfa_required: 'true'
350
+ rdoc_options: []
351
+ require_paths:
352
+ - lib
353
+ required_ruby_version: !ruby/object:Gem::Requirement
354
+ requirements:
355
+ - - ">="
356
+ - !ruby/object:Gem::Version
357
+ version: 3.2.0
358
+ required_rubygems_version: !ruby/object:Gem::Requirement
359
+ requirements:
360
+ - - ">="
361
+ - !ruby/object:Gem::Version
362
+ version: '0'
363
+ requirements: []
364
+ rubygems_version: 4.0.3
365
+ specification_version: 4
366
+ summary: Partition Gardener — PostgreSQL partition lifecycle maintenance
367
+ test_files: []