All Versions
19
Latest Version
Avg Release Cycle
95 days
Latest Release
1082 days ago

Changelog History
Page 1

  • v0.25.0 Changes

    April 11, 2022

    ➕ Added

    • NewBinary now also available as rustler::NewBinary (thanks @ayrat555)
    • Term::map_from_pairs() to conveniently build a map from a list -of pairs (thanks @philss)
    • 🍎 CI now also tests against macos

    🛠 Fixed

    • Snake-case warening for auto-generated RUSTLER_{}_field_{} variables (renamed to rustler_{}_field_{})

    🔄 Changed

    • 🍎 Abort compilation on macos if macos target configuration is missing

  • v0.24.0 Changes

    February 24, 2022

    ➕ Added

    • A NewBinary type to create binaries in Rust without going through OwnedBinary. This can improve performance. Thanks @dlesl!
    • TermType derives Eq and PartialEq.

    ⚡️ Updated

    • rustler_mix: Bumped required toml dependency to 0.6
    • ⬆️ Bumped rustler_sys dependency to ~2.2.

    🔄 Changed

    • ✅ Rustler supports the latest 3 versions of Elixir and OTP. Currently, those are Elixir => 1.11 and OTP >= 22.

    🛠 Fixed

    • Set library file extension based on the compile target, thanks @cocoa-xu!
    • 😌 Relaxed Jason version requirement to ~> 1.0
    • 📚 Various typos in the documentation, thanks @kianmeng!

  • v0.23.0 Changes

    December 22, 2021

    ➕ Added

    • 👻 NifException for using Elixir exception structs
    • Hashing for term
    • Hash and Equality for Binary and OwnedBinary

    🔄 Changed

    • 👍 Rustler changed its supported range of OTP and Elixir versions. We aim to support the three newest versions of OTP and Elixir.
    • The decoder for Range requires that :step equals 1. The :step field was introduced with Elixir v1.12 and cannot be represented with Rust's RangeInclusive.
    • NIF API bindings are generated using Rust

  • v0.22.2 Changes

    October 07, 2021

    🛠 Fixed

    • 🛠 Fixed a regression introduced with #386: Rustler.Compiler.Config called into cargo when skip_compilation? was set, breaking setups where cargo is not installed. Fixed with #389, thanks @karolsluszniak

  • v0.22.1 Changes

    October 05, 2021

    🛠 Fixed

    • [Breaking change] codegen-generated decoders always raise an error instead of causing the calling NIF to return an atom in some cases
    • 🛠 Fix codegen problem for untagged enums (#370)
    • 🛠 Fix handling local dependencies with @external_resources (#381)

  • v0.22.0 Changes

    September 07, 2019

    ➕ Added

    • Simple Debug impl for rustler::Error
    • 👌 Support newtype and tuple structs for NifTuple and NifRecord
    • rustler::Error::Term encoding an arbitrary boxed encoder, returning {:error, term}
    • Generic encoder/decoder for HashMap<T, U>, where T: Decoder and U: Decoder

    🛠 Fixed

    • Compilation time of generated decoders has been reduced significantly.
    • Fixed a segfault caused by OwnedEnv::send_and_clear

    🔄 Changes

    • 📇 Renamed Pid to LocalPid to clarify that it can't point to a remote process
    • ⚡️ Dependencies have been updated.
    • 🔨 Derive macros have been refactored.
    • 🗄 Macros have been renamed and old ones have been deprecated:
      • rustler_export_nifs! is now rustler::init!
      • rustler_atoms! is now rustler::atoms!
      • resource_struct_init! is now rustler::resource!
    • 🆕 New rustler::atoms! macro removed the atom prefix from the name:
    //
// Before
//
rustler::rustler_atoms! {
    atom ok;
    atom error;
    atom renamed_atom = "Renamed";
}

//
// After
//
rustler::atoms! {
    ok,
    error,
    renamed_atom = "Renamed",
}
    • NIF functions can be initialized with a simplified syntax:
    //
// Before
//
rustler::rustler_export_nifs! {
    "Elixir.Math",
    [
        ("add", 2, add)
    ],
    None
}

//
// After
//
rustler::init!("Elixir.Math", [add]);
    • NIFs can be derived from regular functions, if the arguments implement Decoder and the return type implements Encoder:
    //
// Before
//
fn add<'a>(env: Env<'a>, args: &[Term<'a>]) -> Result<Term<'a>, Error> {
    let num1: i64 = args[0].decode()?;
    let num2: i64 = args[1].decode()?;

    Ok((atoms::ok(), num1 + num2).encode(env))
}

//
// After
//
#[rustler::nif]
fn add(a: i64, b: i64) -> i64 {
  a + b
}
    • 🔧 rustler::nif exposes more options to configure a NIF were the NIF is defined:
    
#[rustler::nif(schedule = "DirtyCpu")]
pub fn dirty_cpu() -> Atom {
    let duration = Duration::from_millis(100);
    std::thread::sleep(duration);

    atoms::ok()
}

#[rustler::nif(name = "my_add")]
fn add(a: i64, b: i64) -> i64 {
  a + b
}

    🗄 Deprecations

    🚚 The rustler compiler has been deprecated and will be removed with v1.0. NIFs 👀 are no longer defined in mix.exs, but are configured with use Rustler. See 📚 the documentation for the Rustler module. To migrate to the new 🔧 configuration:

    • ⬇️ Drop :rustler from the :compilers key in your mix.exs project/0 function
    • ⬇️ Drop :rustler_crates from project/0 and move the configurations into the use Rustler of your NIF module or application config:
      # config/dev.exs
  config :my_app, MyApp.Native,
    mode: :debug

    📚 For more information, see the documentation.

  • v0.22.0-rc.0

    March 02, 2020

  • v0.21.2

    June 18, 2020

  • v0.21.1

    June 06, 2020

  • v0.21.0 Changes

    September 07, 2019

    ➕ Added

    • 👌 Support for OTP22.
    • 👕 Rust linting with clippy.
    • Support for decoding IOLists as binaries, Term::decode_as_binary.

    🔄 Changes

    • rustler_codegen is now reexported by the rustler crate. Depending on the rustler_codegen crate is deprecated.
    • erlang_nif-sys has been renamed to rustler_sys and vendored into the rustler repo.
    • 📦 Replaced the hand-rolled TOML parser in rustler_mix with the toml-elixir package.
    • 👌 Improve error messages for derived encoders/decoders.
    • Rust bool now corresponds only to booleans (false, true) in Elixir. Previously, nil and false were both decodable to bool. To use the previous behaviour, a Truthy newtype was introduced.