srvzio

Crates.iosrvzio
lib.rssrvzio
version1.1.1
sourcesrc
created_at2019-04-04 22:04:58.346768
updated_at2019-06-10 20:34:40.384092
descriptionAn helpful crate to implement services
homepage
repositoryhttps://github.com/detro/srvzio
max_upload_size
id125883
size20,101
Ivan De Marino (detro)

documentation

https://docs.rs/crate/srvzio

README

Crates.io Build Status License Doc.rs

srvzio - an helpful crate to implement services

Services? What services?

This crate is inspired by my admiration and attachment to Google's Guava library for Java. Especially the Services.

A Service is then something that I would define as an entity that, when started it does work, and when stopped it does not. Awfully vague, isn't it? OK, here is the definition from the Guava wiki page on the topic:

The Service represents an object with an operational state, with methods to start and stop. For example, webservers, RPC servers, and timers can [be] Services[s].

Managing the state of services like these, which require proper startup and shutdown management, can be nontrivial, especially if multiple threads or scheduling is involved.

srvzio aims to provide a rustic version of this. But, because of the enormous differences between Java and Rust, we will start small, with few and simple abstractions, and then will hopefully grow the crate over time (maybe with your contributions?).

Building blocks

  • Service: a Trait representing an object that can be started and can be stopped
  • ServiceStatusFlag: a type designed to represent the internal state of a Service implementation
  • ServiceManager: a composite of concrete Services

License

BSD 3-Clause License

Commit count: 22

cargo fmt