https://github.com/kuadrant/infinispan-rs
Rust client for Infinispan
https://github.com/kuadrant/infinispan-rs
infinispan
Last synced: 8 months ago
JSON representation
Rust client for Infinispan
- Host: GitHub
- URL: https://github.com/kuadrant/infinispan-rs
- Owner: Kuadrant
- License: apache-2.0
- Created: 2021-04-15T16:40:58.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-12-24T12:46:06.000Z (over 4 years ago)
- Last Synced: 2025-08-14T13:11:43.677Z (10 months ago)
- Topics: infinispan
- Language: Rust
- Homepage:
- Size: 97.7 KB
- Stars: 1
- Watchers: 7
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# infinispan-rs
[](https://docs.rs/infinispan)
[](https://crates.io/crates/infinispan)
infinispan-rs is a Rust client for the [Infinispan REST
API](https://infinispan.org/docs/stable/titles/rest/rest.html). For now, it
implements a small part of the API.
- [infinispan-rs](#infinispan-rs)
- [Install](#install)
- [Usage](#usage)
- [Development](#development)
- [Build](#build)
- [Run the tests](#run-the-tests)
- [License](#license)
## Install
Add the `infinispan` dependency to your `Cargo.toml`:
```toml
[dependencies]
infinispan = "0.3"
```
## Usage
```rust
use infinispan::Infinispan;
use infinispan::request;
// Create a client
let client = Infinispan::new("http://localhost:11222", "username", "password");
// Create a cache
let req = request::caches::create_local("some_cache");
let _ = client.run(&req).await.unwrap();
// Create an entry
let req = request::entries::create("some_cache", "some_entry").with_value("a_value".into());
let _ = client.run(&req).await.unwrap();
// Read the entry
let req = request::entries::get("some_cache", "some_entry");
let resp = client.run(&req).await.unwrap();
// resp is an instance of `reqwest::Response`
assert!(resp.status().is_success());
assert_eq!("a_value", resp.text_with_charset("utf-8").await.unwrap());
```
Check the [docs](https://docs.rs/infinispan) to learn more.
## Development
### Build
```bash
cargo build
```
### Run the tests
Some tests need Infinispan running in `localhost:11222`. You can run it in
Docker with:
```bash
docker run -it -p 11222:11222 -e USER="username" -e PASS="password" infinispan/server:11.0.9.Final
```
Then, run the tests:
```bash
cargo test
```
## License
[Apache 2.0 License](LICENSE)