runng 0.3

[jeikabu]

Breaking Changes (relative to 0.1/0.2)

runng-sys:

• runng-sys bindgen generated enum are rust enum (instead of const int)
• Running bindgen and clang dependency are now optional and disabled by default. To enable use runng-sys build-bindgen feature
• NNG 1.2.3

runng:

• Using futures-preview 0.3.0-alpha crate
• Canonical naming: NngResult-> Result, NngFail -> Error, NngReturn -> Result<()>,
• factory::Compat and factory::Latest are now factory::compat::ProtocolFactory and factory::latest::ProtocolFactory
• runng_examples/ moved to https://github.com/jeikabu/runng_examples. runng_sys/ move to https://github.com/jeikabu/nng-rust/tree/dev
• fn from_i32(value: i32) -> Result<()> are now fn try_from(value: i32) -> Result<Self, TryFromIntError> for std::convert::TryFrom that stabilized in Rust 1.34
• nng_errno_enum flags NNG_ESYSERR and NNG_ETRANERR are not in enum NngErrno they are handled as Error::SysErr() and Error::TranErr()
• NngMsg methods like insert(&mut self, data: *const u8, ...) are now insert_ptr(...)
• NngAio no longer has explicit NngSocket, NngCtx no longer has explicit NngAio
• getopt/setopt functions replaced with shorter get/set versions
• Unify API regarding moving vs returning references; i.e. fn func(self) -> Result<Self> vs fn func(&mut self) -> Result<&mut Self>
  • SetOpts methods (e.g. set_bool) are -> Result<&mut Self> instead of -> Result<()> to facilitate chaining
  • listen() and dial() from Listen and Dial traits no longer consume self
  • This was a tough decision to make with respect to API design. For simplicity, the rule I'll try to follow is: create/open (like new and default) methods return new objects, everything else takes and returns references (i.e. Result<&mut Self>). See Socket::with for helper to create "one-liners".

Non-Breaking Changes:

runng-sys:

• runng-sys bindgen generated structs #[derive(Default)]
• NNG supplemental/compat APIs available (enable nng-supplemental/nng-compat features)

runng:

• Alloc to wrap memory allocations made with nng_alloc()
• All public structs are #[derive(Debug), all sockets derive(Clone), NngMsg and Alloc are AsRef/AsMut<[u8]>, NngMsg/Alloc/String are PartialEq
• Support NNG_FLAG_ALLOC and NNG_FLAG_NONBLOCK
• NngMsg has more slice methods: as_slice(&self) -> &[u8], as_mut_slice(&mut self) -> &mut [u8], fn insert_slice(&mut self, data: &[u8]), etc.
• ARM32/64 added to CI
• Support vectored I/O (nng_iov) and stream API (nng_stream_*)
• SetOpts trait has set_duration(..., _: std::time::Duration) convenience method
• trait GetSocket is for types that are associated with and expose a socket (NngSocket), trait Socket is for types which are a socket

[sphinxc0re]

why are you using https://github.com/jeikabu/nng-rust.git as a submodule? You could just use it as a crate:

[dependencies]
nng-rust = { git = "https://github.com/jeikabu/nng-rust.git" }

[jeikabu]

No reason in particular. Guess I didn't feel adventurous in figuring out how easy it would be to make changes, deal with the sub-submodule, etc. =) . And making it work with CI.

[codecov[bot]]

Codecov Report

:exclamation: No coverage uploaded for pull request base (master@8eeef46). Click here to learn what that means. The diff coverage is 93.85%.

@@           Coverage Diff            @@
##             master     #36   +/-   ##
========================================
  Coverage          ?   92.1%           
========================================
  Files             ?      49           
  Lines             ?    2356           
  Branches          ?       0           
========================================
  Hits              ?    2170           
  Misses            ?     186           
  Partials          ?       0

Impacted Files	Coverage Δ
runng/src/lib.rs	83.33% <ø> (ø)
runng/src/protocol/pull0.rs	100% <100%> (ø)
runng/src/protocol/pair1.rs	100% <100%> (ø)
runng/src/protocol/pub0.rs	100% <100%> (ø)
runng/src/listener.rs	100% <100%> (ø)
runng/tests/tests/msg_tests.rs	100% <100%> (ø)
runng/src/protocol/sub0.rs	100% <100%> (ø)
runng/src/protocol/push0.rs	100% <100%> (ø)
runng/src/protocol/pair0.rs	100% <100%> (ø)
runng/src/factory.rs	100% <100%> (ø)
... and 39 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update 8eeef46...ce4c699. Read the comment docs.