Skip to content

docs: add migration guide for 0.7.0#85

Merged
deepjoy merged 2 commits into
mainfrom
migration-0.7
Mar 24, 2026
Merged

docs: add migration guide for 0.7.0#85
deepjoy merged 2 commits into
mainfrom
migration-0.7

Conversation

@deepjoy
Copy link
Copy Markdown
Owner

@deepjoy deepjoy commented Mar 24, 2026

Summary

  • Adds docs/migrating-to-0.7.md covering all breaking changes and new features since 0.6 (15 commits from d903234..HEAD)
  • Documents 5 breaking changes: database recreation (timestamp normalization + migration consolidation), typed Memo on TypedExecutor, SubmitOutcome::Inserted struct variant, DispatchGate::admit() returning Admission enum, and tag query method renames
  • Documents 6 new features: group pause/resume, token-bucket rate limiting, priority aging, weighted fair scheduling, fail_fast() builder method, and tag key prefix queries
  • Includes before/after Rust code examples and import guidance, matching existing migration doc style

@deepjoy deepjoy enabled auto-merge (squash) March 24, 2026 14:10
@deepjoy deepjoy merged commit 88dd2aa into main Mar 24, 2026
2 checks passed
@github-actions github-actions Bot mentioned this pull request Mar 24, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Mar 24, 2026

Benchmark Comparison

Click to expand
group                                       main                                    pr
-----                                       ----                                    --
backoff_delay/constant                      1.00     44.2±0.23ns 431.1 MElem/sec    1.00     44.5±2.01ns 429.0 MElem/sec
backoff_delay/exponential                   1.00    191.0±1.11ns 99.9 MElem/sec     1.00    190.8±0.88ns 100.0 MElem/sec
backoff_delay/exponential_jitter            1.00    408.7±0.78ns 46.7 MElem/sec     1.11    452.0±1.03ns 42.2 MElem/sec
backoff_delay/linear                        1.00     75.9±0.15ns 251.2 MElem/sec    1.00     76.0±0.31ns 251.1 MElem/sec
batch_submit/1000                           1.03     34.0±2.61ms 28.7 KElem/sec     1.00     32.9±2.29ms 29.7 KElem/sec
byte_progress/byte_reporting_500            1.01    194.0±3.97ms  2.5 KElem/sec     1.00    191.7±3.17ms  2.5 KElem/sec
byte_progress/noop_500                      1.01    182.8±4.18ms  2.7 KElem/sec     1.00    180.9±4.27ms  2.7 KElem/sec
byte_progress_snapshot/100_tasks            1.03     82.5±2.22ms  1211 Elem/sec     1.00     80.2±2.13ms  1246 Elem/sec
concurrency_scaling/1                       1.01    377.1±4.71ms  1325 Elem/sec     1.00    375.1±5.71ms  1333 Elem/sec
concurrency_scaling/2                       1.00    276.7±4.92ms  1806 Elem/sec     1.00    277.2±3.90ms  1803 Elem/sec
concurrency_scaling/4                       1.00    230.7±5.80ms  2.1 KElem/sec     1.00    230.1±7.46ms  2.1 KElem/sec
concurrency_scaling/8                       1.02    182.9±3.86ms  2.7 KElem/sec     1.00    180.0±3.19ms  2.7 KElem/sec
count_by_tags/100                           1.01    126.8±3.13µs  7.7 KElem/sec     1.00    126.0±2.71µs  7.7 KElem/sec
count_by_tags/1000                          1.01    216.8±4.58µs  4.5 KElem/sec     1.00    215.4±5.71µs  4.5 KElem/sec
count_by_tags/5000                          1.01    610.8±7.09µs  1637 Elem/sec     1.00    602.5±5.28µs  1659 Elem/sec
dep_chain_dispatch/10                       1.00     10.8±0.16ms   929 Elem/sec     1.02     11.0±0.10ms   908 Elem/sec
dep_chain_dispatch/25                       1.00     26.5±0.56ms   942 Elem/sec     1.02     27.1±0.71ms   922 Elem/sec
dep_chain_dispatch/50                       1.00     53.3±0.80ms   938 Elem/sec     1.01     53.7±0.67ms   931 Elem/sec
dep_chain_submit/10                         1.00      3.0±0.12ms  3.2 KElem/sec     1.02      3.1±0.13ms  3.2 KElem/sec
dep_chain_submit/200                        1.01     77.1±3.50ms  2.5 KElem/sec     1.00     76.3±3.54ms  2.6 KElem/sec
dep_chain_submit/50                         1.00     16.6±0.68ms  2.9 KElem/sec     1.00     16.6±0.79ms  2.9 KElem/sec
dep_fan_in_dispatch/10                      1.00      6.0±0.14ms  1846 Elem/sec     1.00      6.0±0.11ms  1841 Elem/sec
dep_fan_in_dispatch/100                     1.00     40.6±0.87ms  2.4 KElem/sec     1.01     41.0±0.71ms  2.4 KElem/sec
dep_fan_in_dispatch/50                      1.00     21.4±0.32ms  2.3 KElem/sec     1.00     21.5±0.46ms  2.3 KElem/sec
dispatch_and_complete/1000                  1.01    368.8±6.61ms  2.6 KElem/sec     1.00    365.0±4.82ms  2.7 KElem/sec
dispatch_group_scaling/1                    1.01    419.1±7.60ms  1193 Elem/sec     1.00    416.7±5.76ms  1200 Elem/sec
dispatch_group_scaling/10                   1.00    418.9±7.43ms  1193 Elem/sec     1.00    418.0±7.78ms  1196 Elem/sec
dispatch_group_scaling/100                  1.00    421.2±8.04ms  1187 Elem/sec     1.00    419.5±7.43ms  1191 Elem/sec
dispatch_group_scaling/50                   1.00    417.5±7.53ms  1197 Elem/sec     1.00    419.5±7.35ms  1191 Elem/sec
dispatch_no_groups/500                      1.01    182.3±3.90ms  2.7 KElem/sec     1.00    181.0±3.44ms  2.7 KElem/sec
dispatch_one_group/500                      1.00    411.1±8.53ms  1216 Elem/sec     1.02    417.8±4.81ms  1196 Elem/sec
dispatch_permanent_failure/500              1.02    350.4±5.80ms  1426 Elem/sec     1.00    344.5±4.03ms  1451 Elem/sec
history_by_type/100                         1.00    219.5±5.06µs  4.4 KElem/sec     1.01    222.1±8.62µs  4.4 KElem/sec
history_by_type/1000                        1.08   853.2±71.72µs  1172 Elem/sec     1.00   790.4±43.32µs  1265 Elem/sec
history_by_type/5000                        1.07   839.8±48.93µs  1190 Elem/sec     1.00   785.6±48.81µs  1272 Elem/sec
history_query/100                           1.00   420.6±21.28µs  2.3 KElem/sec     1.04   438.9±20.54µs  2.2 KElem/sec
history_query/1000                          1.00   435.6±22.59µs  2.2 KElem/sec     1.00   435.2±24.82µs  2.2 KElem/sec
history_query/5000                          1.01   445.6±21.44µs  2.2 KElem/sec     1.00   440.4±25.56µs  2.2 KElem/sec
history_stats/100                           1.00    125.9±1.06µs  7.8 KElem/sec     1.00    126.3±0.90µs  7.7 KElem/sec
history_stats/1000                          1.01    191.8±0.97µs  5.1 KElem/sec     1.00    190.0±1.44µs  5.1 KElem/sec
history_stats/5000                          1.02    484.9±2.22µs  2.0 KElem/sec     1.00   473.6±11.97µs  2.1 KElem/sec
mixed_priority_dispatch/500                 1.02    232.3±5.45ms  2.1 KElem/sec     1.00    227.5±7.88ms  2.1 KElem/sec
peek_next/100                               1.02    120.2±2.86µs  8.1 KElem/sec     1.00    118.4±2.49µs  8.3 KElem/sec
peek_next/1000                              1.02    120.7±2.93µs  8.1 KElem/sec     1.00    118.3±2.17µs  8.3 KElem/sec
peek_next/5000                              1.01    122.0±2.89µs  8.0 KElem/sec     1.00   121.1±12.75µs  8.1 KElem/sec
query_ids_by_tags/100                       1.02    184.9±3.17µs  5.3 KElem/sec     1.00    181.7±4.02µs  5.4 KElem/sec
query_ids_by_tags/1000                      1.00   815.9±11.14µs  1225 Elem/sec     1.01   826.2±19.42µs  1210 Elem/sec
query_ids_by_tags/5000                      1.04      3.7±0.07ms   267 Elem/sec     1.00      3.6±0.01ms   278 Elem/sec
retryable_dead_letter/constant              1.02    107.1±0.99ms   933 Elem/sec     1.00    105.3±1.90ms   949 Elem/sec
retryable_dead_letter/exponential           1.02    107.6±1.73ms   929 Elem/sec     1.00    105.1±0.83ms   951 Elem/sec
retryable_dead_letter/exponential_jitter    1.01    107.0±0.94ms   934 Elem/sec     1.00    106.1±0.89ms   942 Elem/sec
retryable_dead_letter/linear                1.01    106.9±0.97ms   935 Elem/sec     1.00    106.1±0.86ms   942 Elem/sec
submit_dedup_hit/1000                       1.01    207.8±5.84ms  4.7 KElem/sec     1.00    205.2±5.65ms  4.8 KElem/sec
submit_tasks/1000                           1.02    181.5±5.68ms  5.4 KElem/sec     1.00    178.3±4.21ms  5.5 KElem/sec
submit_with_tags/0                          1.02     90.3±3.49ms  5.4 KElem/sec     1.00     88.7±2.66ms  5.5 KElem/sec
submit_with_tags/10                         1.00   239.8±10.02ms  2.0 KElem/sec     1.00   240.2±10.78ms  2.0 KElem/sec
submit_with_tags/20                         1.00   390.4±16.79ms  1280 Elem/sec     1.01   392.6±17.82ms  1273 Elem/sec
submit_with_tags/5                          1.00    164.1±6.50ms  3.0 KElem/sec     1.00    164.7±6.51ms  3.0 KElem/sec
tag_values/100                              1.00    132.0±3.02µs  7.4 KElem/sec     1.01    132.7±3.32µs  7.4 KElem/sec
tag_values/1000                             1.01    195.9±3.40µs  5.0 KElem/sec     1.00    193.4±3.64µs  5.0 KElem/sec
tag_values/5000                             1.01    460.3±4.95µs  2.1 KElem/sec     1.00    454.5±4.16µs  2.1 KElem/sec

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant