17 releases
0.3.0 | Mar 24, 2021 |
---|---|
0.2.2 | Mar 12, 2021 |
0.2.1 | Feb 5, 2021 |
0.1.14 | Jan 26, 2021 |
0.1.3 | Dec 22, 2020 |
#17 in #ice
36 downloads per month
175KB
4K
SLoC
ice-rs
The goal of this project is to support Rust in ZeroC Ice.
Quick Start
This quick start guide will cover a client for the ZeroC Ice Minimal Sample. Create a binary application with cargo new minimal-client
and add ice-rs
to your [build-dependencies]
and [dependencies]
. Now add a build.rs
file with the following content:
Minimal client
use ice_rs::slice::parser;
use std::path::Path;
fn main() -> Result<(), Box<dyn std::error::Error>> {
println!("cargo:rerun-if-changed=build.rs");
let ice_files = vec![
String::from("<path/to/Hello.ice>")
];
let root_module = parser::parse_ice_files(&ice_files, "<path/to/ice/include/dir>")?;
root_module.generate(Path::new("./src/gen"), "")
}
Now add the following to you main.rs
:
use ice_rs::communicator::Communicator;
mod gen;
use crate::gen::demo::{Hello,HelloPrx};
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
let mut comm = Communicator::new().await?;
let proxy = comm.string_to_proxy("hello:default -h localhost -p 10000").await?;
let mut hello_prx = HelloPrx::checked_cast(proxy).await?;
hello_prx.say_hello(None).await
}
Minimal server
Based on the same build.rs
file you can add a server for the minimal example.
use ice_rs::communicator::Communicator;
use std::collections::HashMap;
use async_trait::async_trait;
mod gen;
use crate::gen::demo::{HelloServer, HelloI};
struct HelloImpl {}
#[async_trait]
impl HelloI for HelloImpl {
async fn say_hello(&mut self, _context: Option<HashMap<String, String>>) -> ()
{
println!("Hello World!");
()
}
}
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
let comm = Communicator::new().await?;
let mut adapter = comm.create_object_adapter_with_endpoint("hello", "tcp -h localhost -p 10000").await?;
let hello_server = HelloServer::new(Box::new(HelloImpl{}));
adapter.add("hello", Box::new(hello_server));
adapter.activate().await?;
Ok(())
}
Status
The status can be seen in the number of supported ZeroC Ice Demos.
- Ice/minimal
- Ice/optional
- Ice/context (implicit context missing, see Issue)
- IceGrid/simple
Supported transports:
- TCP
- SSL
Roadmap
The main goal is to support all ZeroC Ice Demos.
Dependencies
~11–20MB
~263K SLoC