restate-sdk 1.2.1 → 1.3.1
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/Cargo.lock +343 -153
- data/README.md +2 -2
- data/ext/restate_internal/Cargo.toml +4 -4
- data/ext/restate_internal/src/lib.rs +73 -44
- data/lib/restate/context.rb +1 -2
- data/lib/restate/version.rb +1 -1
- data/lib/restate/vm.rb +1 -1
- metadata +31 -6
data/README.md
CHANGED
|
@@ -110,7 +110,7 @@ We know that your time is precious and, therefore, deeply value any effort to co
|
|
|
110
110
|
* Ruby >= 3.1
|
|
111
111
|
* [Rust toolchain](https://rustup.rs/)
|
|
112
112
|
* Docker (for integration tests)
|
|
113
|
-
*
|
|
113
|
+
* Docker is all the sdk-test-suite integration tests need (the suite runs in a Java container)
|
|
114
114
|
|
|
115
115
|
Install dependencies and build:
|
|
116
116
|
|
|
@@ -125,7 +125,7 @@ Run the full verification suite (build, lint, typecheck, tests):
|
|
|
125
125
|
make verify
|
|
126
126
|
```
|
|
127
127
|
|
|
128
|
-
Run integration tests (requires Docker
|
|
128
|
+
Run integration tests (requires Docker):
|
|
129
129
|
|
|
130
130
|
```shell
|
|
131
131
|
make test-integration
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
[package]
|
|
2
2
|
name = "restate_internal"
|
|
3
|
-
version = "1.
|
|
4
|
-
edition = "
|
|
3
|
+
version = "1.3.1"
|
|
4
|
+
edition = "2024"
|
|
5
5
|
publish = false
|
|
6
6
|
|
|
7
7
|
[lib]
|
|
@@ -10,7 +10,7 @@ crate-type = ["cdylib"]
|
|
|
10
10
|
doc = false
|
|
11
11
|
|
|
12
12
|
[dependencies]
|
|
13
|
-
magnus = { version = "0.
|
|
13
|
+
magnus = { version = "0.9", features = ["rb-sys"] }
|
|
14
14
|
rb-sys = { version = "0.9", features = ["stable-api-compiled-fallback"] }
|
|
15
|
-
restate-sdk-shared-core = { version = "7.
|
|
15
|
+
restate-sdk-shared-core = { version = "8.7.1", features = ["request_identity", "sha2_random_seed", "rust_crypto"] }
|
|
16
16
|
tracing-subscriber = { version = "0.3", features = ["fmt", "env-filter"] }
|
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
use magnus::{
|
|
2
|
-
function, method,
|
|
3
|
-
value::ReprValue,
|
|
4
2
|
Error, ExceptionClass, Module, Object, RArray, RString, Ruby, Symbol, TryConvert, Value,
|
|
3
|
+
function, method, value::ReprValue,
|
|
5
4
|
};
|
|
6
5
|
use restate_sdk_shared_core::{
|
|
7
|
-
AwaitResponse, CallHandle, CoreVM, Error as CoreError, Header,
|
|
8
|
-
NonEmptyValue, NotificationHandle, OnMaxAttempts, ResponseHead,
|
|
9
|
-
RunHandle, State, Target, TerminalFailure, UnresolvedFuture,
|
|
10
|
-
|
|
6
|
+
AwaitResponse, CANCEL_NOTIFICATION_HANDLE, CallHandle, CoreVM, Error as CoreError, Header,
|
|
7
|
+
IdentityVerifier, Input, NonEmptyValue, NotificationHandle, OnMaxAttempts, ResponseHead,
|
|
8
|
+
RetryPolicy, RunExitResult, RunHandle, State, Target, TerminalFailure, UnresolvedFuture, VM,
|
|
9
|
+
VMOptions, Value as CoreValue,
|
|
11
10
|
};
|
|
12
11
|
use std::cell::RefCell;
|
|
13
12
|
use std::fmt;
|
|
@@ -30,7 +29,10 @@ static IDENTITY_KEY_ERROR_CLASS: OnceLock<SyncExceptionClass> = OnceLock::new();
|
|
|
30
29
|
static IDENTITY_VERIFICATION_ERROR_CLASS: OnceLock<SyncExceptionClass> = OnceLock::new();
|
|
31
30
|
|
|
32
31
|
fn vm_error_class() -> ExceptionClass {
|
|
33
|
-
VM_ERROR_CLASS
|
|
32
|
+
VM_ERROR_CLASS
|
|
33
|
+
.get()
|
|
34
|
+
.expect("VM_ERROR_CLASS not initialized")
|
|
35
|
+
.0
|
|
34
36
|
}
|
|
35
37
|
|
|
36
38
|
fn identity_key_error_class() -> ExceptionClass {
|
|
@@ -420,8 +422,7 @@ impl RbVM {
|
|
|
420
422
|
let v: String = pair.entry(1)?;
|
|
421
423
|
hdr_vec.push((k, v));
|
|
422
424
|
}
|
|
423
|
-
let vm =
|
|
424
|
-
CoreVM::new(hdr_vec, VMOptions::default()).map_err(core_error_to_magnus)?;
|
|
425
|
+
let vm = CoreVM::new(hdr_vec, VMOptions::default()).map_err(core_error_to_magnus)?;
|
|
425
426
|
Ok(Self {
|
|
426
427
|
vm: RefCell::new(vm),
|
|
427
428
|
})
|
|
@@ -488,14 +489,10 @@ impl RbVM {
|
|
|
488
489
|
match res {
|
|
489
490
|
Err(e) if e.is_suspended_error() => Ok(ruby.into_value(RbSuspended)),
|
|
490
491
|
Err(e) => Err(core_error_to_magnus(e)),
|
|
491
|
-
Ok(AwaitResponse::AnyCompleted) =>
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
RbDoProgressExecuteRun {
|
|
496
|
-
handle: handle.into(),
|
|
497
|
-
},
|
|
498
|
-
)),
|
|
492
|
+
Ok(AwaitResponse::AnyCompleted) => Ok(ruby.into_value(RbDoProgressAnyCompleted)),
|
|
493
|
+
Ok(AwaitResponse::ExecuteRun(handle)) => Ok(ruby.into_value(RbDoProgressExecuteRun {
|
|
494
|
+
handle: handle.into(),
|
|
495
|
+
})),
|
|
499
496
|
Ok(AwaitResponse::CancelSignalReceived) => {
|
|
500
497
|
Ok(ruby.into_value(RbDoProgressCancelSignalReceived))
|
|
501
498
|
}
|
|
@@ -506,6 +503,11 @@ impl RbVM {
|
|
|
506
503
|
Ok(ruby.into_value(RbDoWaitForPendingRun))
|
|
507
504
|
}
|
|
508
505
|
}
|
|
506
|
+
// Ephemeral state is not exposed by the Ruby SDK, so this is never returned.
|
|
507
|
+
Ok(AwaitResponse::EphemeralNotificationReady(_)) => Err(Error::new(
|
|
508
|
+
vm_error_class(),
|
|
509
|
+
"Unexpected ephemeral notification, this is an SDK bug",
|
|
510
|
+
)),
|
|
509
511
|
}
|
|
510
512
|
}
|
|
511
513
|
|
|
@@ -523,9 +525,7 @@ impl RbVM {
|
|
|
523
525
|
Ok(Some(CoreValue::Void)) => Ok(ruby.into_value(RbVoid)),
|
|
524
526
|
Ok(Some(CoreValue::Success(b))) => Ok(ruby.str_from_slice(&b).as_value()),
|
|
525
527
|
Ok(Some(CoreValue::Failure(f))) => Ok(ruby.into_value(RbFailure::from(f))),
|
|
526
|
-
Ok(Some(CoreValue::StateKeys(keys))) => {
|
|
527
|
-
Ok(ruby.into_value(RbStateKeys { keys }))
|
|
528
|
-
}
|
|
528
|
+
Ok(Some(CoreValue::StateKeys(keys))) => Ok(ruby.into_value(RbStateKeys { keys })),
|
|
529
529
|
Ok(Some(CoreValue::InvocationId(id))) => Ok(ruby.str_new(&id).as_value()),
|
|
530
530
|
}
|
|
531
531
|
}
|
|
@@ -543,7 +543,7 @@ impl RbVM {
|
|
|
543
543
|
fn sys_get_state(&self, key: String) -> Result<u32, Error> {
|
|
544
544
|
self.vm
|
|
545
545
|
.borrow_mut()
|
|
546
|
-
.sys_state_get(key, Default::default())
|
|
546
|
+
.sys_state_get(key, None, Default::default())
|
|
547
547
|
.map(Into::into)
|
|
548
548
|
.map_err(core_error_to_magnus)
|
|
549
549
|
}
|
|
@@ -551,7 +551,7 @@ impl RbVM {
|
|
|
551
551
|
fn sys_get_state_keys(&self) -> Result<u32, Error> {
|
|
552
552
|
self.vm
|
|
553
553
|
.borrow_mut()
|
|
554
|
-
.sys_state_get_keys()
|
|
554
|
+
.sys_state_get_keys(None)
|
|
555
555
|
.map(Into::into)
|
|
556
556
|
.map_err(core_error_to_magnus)
|
|
557
557
|
}
|
|
@@ -560,21 +560,21 @@ impl RbVM {
|
|
|
560
560
|
let bytes: Vec<u8> = unsafe { buffer.as_slice().to_vec() };
|
|
561
561
|
self.vm
|
|
562
562
|
.borrow_mut()
|
|
563
|
-
.sys_state_set(key, bytes.into(), Default::default())
|
|
563
|
+
.sys_state_set(key, bytes.into(), None, Default::default())
|
|
564
564
|
.map_err(core_error_to_magnus)
|
|
565
565
|
}
|
|
566
566
|
|
|
567
567
|
fn sys_clear_state(&self, key: String) -> Result<(), Error> {
|
|
568
568
|
self.vm
|
|
569
569
|
.borrow_mut()
|
|
570
|
-
.sys_state_clear(key)
|
|
570
|
+
.sys_state_clear(key, None)
|
|
571
571
|
.map_err(core_error_to_magnus)
|
|
572
572
|
}
|
|
573
573
|
|
|
574
574
|
fn sys_clear_all_state(&self) -> Result<(), Error> {
|
|
575
575
|
self.vm
|
|
576
576
|
.borrow_mut()
|
|
577
|
-
.sys_state_clear_all()
|
|
577
|
+
.sys_state_clear_all(None)
|
|
578
578
|
.map_err(core_error_to_magnus)
|
|
579
579
|
}
|
|
580
580
|
|
|
@@ -750,7 +750,11 @@ impl RbVM {
|
|
|
750
750
|
.map_err(core_error_to_magnus)
|
|
751
751
|
}
|
|
752
752
|
|
|
753
|
-
fn propose_run_completion_failure(
|
|
753
|
+
fn propose_run_completion_failure(
|
|
754
|
+
&self,
|
|
755
|
+
handle: u32,
|
|
756
|
+
failure: &RbFailure,
|
|
757
|
+
) -> Result<(), Error> {
|
|
754
758
|
self.vm
|
|
755
759
|
.borrow_mut()
|
|
756
760
|
.propose_run_completion(
|
|
@@ -863,16 +867,16 @@ impl RbVM {
|
|
|
863
867
|
let bytes: Vec<u8> = unsafe { buffer.as_slice().to_vec() };
|
|
864
868
|
self.vm
|
|
865
869
|
.borrow_mut()
|
|
866
|
-
.sys_complete_promise(
|
|
870
|
+
.sys_complete_promise(
|
|
871
|
+
key,
|
|
872
|
+
NonEmptyValue::Success(bytes.into()),
|
|
873
|
+
Default::default(),
|
|
874
|
+
)
|
|
867
875
|
.map(Into::into)
|
|
868
876
|
.map_err(core_error_to_magnus)
|
|
869
877
|
}
|
|
870
878
|
|
|
871
|
-
fn sys_complete_promise_failure(
|
|
872
|
-
&self,
|
|
873
|
-
key: String,
|
|
874
|
-
failure: &RbFailure,
|
|
875
|
-
) -> Result<u32, Error> {
|
|
879
|
+
fn sys_complete_promise_failure(&self, key: String, failure: &RbFailure) -> Result<u32, Error> {
|
|
876
880
|
self.vm
|
|
877
881
|
.borrow_mut()
|
|
878
882
|
.sys_complete_promise(
|
|
@@ -969,7 +973,7 @@ impl RbIdentityVerifier {
|
|
|
969
973
|
|
|
970
974
|
// ── Error formatter ──
|
|
971
975
|
|
|
972
|
-
use restate_sdk_shared_core::fmt::{
|
|
976
|
+
use restate_sdk_shared_core::fmt::{ErrorFormatter, set_error_formatter};
|
|
973
977
|
|
|
974
978
|
#[derive(Debug)]
|
|
975
979
|
struct RubyErrorFormatter;
|
|
@@ -1032,7 +1036,10 @@ fn parse_unresolved_future(value: Value) -> Result<UnresolvedFuture, Error> {
|
|
|
1032
1036
|
children.push(parse_unresolved_future(child)?);
|
|
1033
1037
|
}
|
|
1034
1038
|
let tag_name = tag.name().map_err(|_| {
|
|
1035
|
-
Error::new(
|
|
1039
|
+
Error::new(
|
|
1040
|
+
ruby.exception_arg_error(),
|
|
1041
|
+
"UnresolvedFuture tag is not a Symbol",
|
|
1042
|
+
)
|
|
1036
1043
|
})?;
|
|
1037
1044
|
match tag_name.as_ref() {
|
|
1038
1045
|
"first_completed" => Ok(UnresolvedFuture::FirstCompleted(children)),
|
|
@@ -1107,13 +1114,25 @@ fn rb_exponential_retry_config_new(
|
|
|
1107
1114
|
factor: Value,
|
|
1108
1115
|
) -> RbExponentialRetryConfig {
|
|
1109
1116
|
let to_opt_u64 = |v: Value| -> Option<u64> {
|
|
1110
|
-
if v.is_nil() {
|
|
1117
|
+
if v.is_nil() {
|
|
1118
|
+
None
|
|
1119
|
+
} else {
|
|
1120
|
+
u64::try_convert(v).ok()
|
|
1121
|
+
}
|
|
1111
1122
|
};
|
|
1112
1123
|
let to_opt_u32 = |v: Value| -> Option<u32> {
|
|
1113
|
-
if v.is_nil() {
|
|
1124
|
+
if v.is_nil() {
|
|
1125
|
+
None
|
|
1126
|
+
} else {
|
|
1127
|
+
u32::try_convert(v).ok()
|
|
1128
|
+
}
|
|
1114
1129
|
};
|
|
1115
1130
|
let to_opt_f64 = |v: Value| -> Option<f64> {
|
|
1116
|
-
if v.is_nil() {
|
|
1131
|
+
if v.is_nil() {
|
|
1132
|
+
None
|
|
1133
|
+
} else {
|
|
1134
|
+
f64::try_convert(v).ok()
|
|
1135
|
+
}
|
|
1117
1136
|
};
|
|
1118
1137
|
RbExponentialRetryConfig {
|
|
1119
1138
|
initial_interval: to_opt_u64(initial_interval),
|
|
@@ -1186,13 +1205,23 @@ fn init(ruby: &Ruby) -> Result<(), Error> {
|
|
|
1186
1205
|
|
|
1187
1206
|
// ExponentialRetryConfig - constructor takes all 5 params (nil for unset)
|
|
1188
1207
|
let erc_class = internal.define_class("ExponentialRetryConfig", ruby.class_object())?;
|
|
1189
|
-
erc_class
|
|
1190
|
-
|
|
1191
|
-
|
|
1192
|
-
|
|
1193
|
-
|
|
1194
|
-
erc_class.define_method(
|
|
1195
|
-
|
|
1208
|
+
erc_class.define_singleton_method("new", function!(rb_exponential_retry_config_new, 5))?;
|
|
1209
|
+
erc_class.define_method(
|
|
1210
|
+
"initial_interval",
|
|
1211
|
+
method!(RbExponentialRetryConfig::initial_interval, 0),
|
|
1212
|
+
)?;
|
|
1213
|
+
erc_class.define_method(
|
|
1214
|
+
"max_attempts",
|
|
1215
|
+
method!(RbExponentialRetryConfig::max_attempts, 0),
|
|
1216
|
+
)?;
|
|
1217
|
+
erc_class.define_method(
|
|
1218
|
+
"max_duration",
|
|
1219
|
+
method!(RbExponentialRetryConfig::max_duration, 0),
|
|
1220
|
+
)?;
|
|
1221
|
+
erc_class.define_method(
|
|
1222
|
+
"max_interval",
|
|
1223
|
+
method!(RbExponentialRetryConfig::max_interval, 0),
|
|
1224
|
+
)?;
|
|
1196
1225
|
erc_class.define_method("factor", method!(RbExponentialRetryConfig::factor, 0))?;
|
|
1197
1226
|
|
|
1198
1227
|
// Progress types
|
data/lib/restate/context.rb
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# typed: false
|
|
2
2
|
# frozen_string_literal: true
|
|
3
3
|
|
|
4
|
-
# rubocop:disable Style/EmptyMethod
|
|
4
|
+
# rubocop:disable-next Style/EmptyMethod
|
|
5
5
|
module Restate
|
|
6
6
|
# Signals when the current invocation attempt has finished — either the handler
|
|
7
7
|
# completed, the connection was lost, or a transient error occurred.
|
|
@@ -264,4 +264,3 @@ module Restate
|
|
|
264
264
|
def reject_promise(name, message, code: 500); end
|
|
265
265
|
end
|
|
266
266
|
end
|
|
267
|
-
# rubocop:enable Style/EmptyMethod
|
data/lib/restate/version.rb
CHANGED
data/lib/restate/vm.rb
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
|
|
4
4
|
begin
|
|
5
5
|
# Cross-compiled native gems place the binary in a version-specific directory
|
|
6
|
-
# e.g., lib/restate/
|
|
6
|
+
# e.g., lib/restate/4.0/restate_internal.bundle
|
|
7
7
|
RUBY_VERSION =~ /(\d+\.\d+)/
|
|
8
8
|
require_relative "#{Regexp.last_match(1)}/restate_internal"
|
|
9
9
|
rescue LoadError
|
metadata
CHANGED
|
@@ -1,14 +1,13 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: restate-sdk
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.
|
|
4
|
+
version: 1.3.1
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Restate Developers
|
|
8
|
-
autorequire:
|
|
9
8
|
bindir: bin
|
|
10
9
|
cert_chain: []
|
|
11
|
-
date:
|
|
10
|
+
date: 1980-01-02 00:00:00.000000000 Z
|
|
12
11
|
dependencies:
|
|
13
12
|
- !ruby/object:Gem::Dependency
|
|
14
13
|
name: async
|
|
@@ -24,6 +23,34 @@ dependencies:
|
|
|
24
23
|
- - "~>"
|
|
25
24
|
- !ruby/object:Gem::Version
|
|
26
25
|
version: '2.0'
|
|
26
|
+
- !ruby/object:Gem::Dependency
|
|
27
|
+
name: base64
|
|
28
|
+
requirement: !ruby/object:Gem::Requirement
|
|
29
|
+
requirements:
|
|
30
|
+
- - ">="
|
|
31
|
+
- !ruby/object:Gem::Version
|
|
32
|
+
version: '0'
|
|
33
|
+
type: :runtime
|
|
34
|
+
prerelease: false
|
|
35
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
36
|
+
requirements:
|
|
37
|
+
- - ">="
|
|
38
|
+
- !ruby/object:Gem::Version
|
|
39
|
+
version: '0'
|
|
40
|
+
- !ruby/object:Gem::Dependency
|
|
41
|
+
name: logger
|
|
42
|
+
requirement: !ruby/object:Gem::Requirement
|
|
43
|
+
requirements:
|
|
44
|
+
- - ">="
|
|
45
|
+
- !ruby/object:Gem::Version
|
|
46
|
+
version: '0'
|
|
47
|
+
type: :runtime
|
|
48
|
+
prerelease: false
|
|
49
|
+
version_requirements: !ruby/object:Gem::Requirement
|
|
50
|
+
requirements:
|
|
51
|
+
- - ">="
|
|
52
|
+
- !ruby/object:Gem::Version
|
|
53
|
+
version: '0'
|
|
27
54
|
- !ruby/object:Gem::Dependency
|
|
28
55
|
name: rack
|
|
29
56
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -84,7 +111,6 @@ licenses:
|
|
|
84
111
|
- MIT
|
|
85
112
|
metadata:
|
|
86
113
|
rubygems_mfa_required: 'true'
|
|
87
|
-
post_install_message:
|
|
88
114
|
rdoc_options: []
|
|
89
115
|
require_paths:
|
|
90
116
|
- lib
|
|
@@ -99,8 +125,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
99
125
|
- !ruby/object:Gem::Version
|
|
100
126
|
version: '0'
|
|
101
127
|
requirements: []
|
|
102
|
-
rubygems_version:
|
|
103
|
-
signing_key:
|
|
128
|
+
rubygems_version: 4.0.20
|
|
104
129
|
specification_version: 4
|
|
105
130
|
summary: Restate SDK for Ruby
|
|
106
131
|
test_files: []
|