Skip to content

Latest commit

 

History

History
140 lines (103 loc) · 4.62 KB

NEWS.md

File metadata and controls

140 lines (103 loc) · 4.62 KB
Raw

0.9.0 (unreleased)

This release will focus on API corrections and improving documentation.

Incompatible API changes

  • The deprecated Constants enum has been removed from the API.

  • Message allocation, e.g. Message::new() directly returns Message instead of Result<Message> and will panic on allocation failure, as is customary in Rust. Reported in #118 and fixed by #130.

New and improved functionality

  • Message now implements From for various types that have an obvious byte-level representation. This is possible due to the message allocation API change (see above).

  • Message::send() now works on Into<Message> types, obsoleting send_msg() and send_str().

Deprecations

  • Message::send_msg() and send_str() are deprecated in favor of Message::send().

0.8.2

New and improved functionality

  • Support for the ZMQ_PROBE_ROUTER and ZMQ_ROUTER_MANDATORY socket options.
  • zmq_disconnect is now exposed as Socket::disconnect.

Bug fixes

  • Fix build on OpenBSD (issue #170).
  • Account for OpenBSD not defining EPROTO.
  • Fix build for 32-bit Windows.
  • Handle EINTR in Error::from_raw (issue #174).
  • Alignment of zmq_msg_t FFI type fixed.
  • Fix build.rs to portably construct paths, instead of hard-coding slash as path separator.

0.8.1

This release fixes the remaining Windows-specific issues exposed by our test suite, as well as improving API convenience a bit.

New and improved functionality

  • Should now work on Windows.
  • Message now provides the Eq trait.
  • From<Error> is now provided for std::io::Error (issue #136).
  • There is now a type alias PollEvents mapping to i16. Use that instead of i16 to refer to a set of poll events; in 0.9, PollEvents will become a separate type.
  • PollItem now has methods is_readable, is_writable and is_error; use those in preference to using bit masking operations when applicable.
  • New example zguide example mspoller.
  • Some documentation improvements.
  • There is now a Unix-specific test integrating zmq with Unix poll(2).

Incompatible API changes

There has been a minor API change that was deemed necessary for cross-platform support and to fix broken parts of the API:

  • There is now an internal RawFd type alias that maps to RawFd on Unixoids and RawSocket on Windows. Socket::get_fd() and PollItem::from_fd() now use that instead of i64 and c_int, respectively.

0.8.0

This is a feature and bugfix release. The API has changed, partially in slightly incompatible ways. Typical code, for some suitable value of "typical", should still compile when it did with 0.7, but expect a lot of warnings due to reduced mutability requirements for Socket and Context.

Note that this release adds initial support for the Windows platform (PR #124). While the code now compiles, the test suite is still broken under Windows (issue #125).

Since these release notes have been assembled post-hoc, they are highly likely to be incomplete.

Incompatible API changes

The following methods of Socket changed:

  • The deprecated close() method has been removed.
  • to_raw() is now known as into_raw().
  • borrow_raw() is known as as_mut_ptr(), and takes a &mut self now.

New and improved functionality

Note that the added CURVE and GSSAPI parts of the API are conditional, depending on the compile-time detected capabilities of libzmq.

  • Most methods of Socket no longer require &mut self.
  • Context now can be shared across threads
  • rust-zmq should now work across a wider range of libzmq versions.
  • More functions now have minimal documentation, but there is still lots of improvements to make in this area.
  • Initial API coverage for encryption via the Mechanism and CurveKeyPair data types.
  • Wrappers for the Z85 codec (z85_encode and z85_decode).
  • New socket option accessors for:
    • ZMQ_LAST_ENDPOINT
    • ZMQ_IMMEDIATE
    • ZMQ_PROBE_ROUTER, ZMQ_ROUTER_MANDATORY
    • ZMQ_RCVTIMEO, ZMQ_SNDTIMEO
    • Various Kerberos (aka GSSAPI) and encryption-related (aka CURVE) options.
  • New zguide examples fileio3, msreader, rtdealer, lvcache, pathopub and pathosub.
  • There now is a test suite.

Deprecations

Constants will be removed from public API in the next release; it should not be needed in client code, since corresponding functionality is provided in a higher-level form.

Bugfixes

Yes, there have been bugs that were fixed; hopefully for the next releases, a reasonably accurate list of those will be provided.

Internals

Some redundancy in error handling and socket option handling has been abstracted over using macros.