Client that acquires distributed locks in dynamodb that expire (aka "leases"). Uses aws-sdk-dynamodb & tokio.
```rust let client = dynamodblease::Client::builder() .tablename("example-leases") .leasettlseconds(60) .buildandcheckdb(dynamodbclient) .await?;
// acquire a lease for "important-job-123" // waits for any other holders to release if necessary let lease = client.acquire("important-job-123").await?;
// lease periodically extends itself in a background tokio task
// until dropped others will not be able to acquire this lease assert!(client.tryacquire("important-job-123").await?.isnone());
// Dropping the lease will asynchronously release it, so others may acquire it drop(lease); ```
See the design doc & source for how it works under the hood.
Run scripts/init-test.sh to ensure dynamodb-local is running on 8000.
sh
cargo test
You may also need to setup some aws config, e.g.
- setup ~/.aws/config
[default]
region = eu-west-1
- setup ~/.aws/credentials with fakes values
[default]
aws_access_key_id=access_key
aws_secret_access_key=secret_access_key