dynamodb-lease

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.

Test

Run scripts/init-test.sh to ensure dynamodb-local is running on 8000.

sh cargo test

AWS setup

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