Crate tauri_interop

Tauri-Interop is a library that provides macros to improve developing tauri apps with a rust frontend by generating frontend implementation out of the backend definitions.

The main macros intended to be used are:

• command, which is intended to be used as replacement to tauri::command
• Event, that provides an easier usage of the Events feature of tauri
  • derives event::Listen when compiling to wasm and event::Emit otherwise

Additionally, some QOL macros (host_usage and wasm_usage) are provided that reduce some drawbacks when simultaneously compiling to wasm and the host architecture.

Explanation and Examples

Detail explanations and example can be found on the respected traits or macros. Some examples are ignored because they are only valid when compiling to wasm.

Note

The library uses resolver 2 features to allow easy inclusion without configuration. When working with virtual workspaces the resolver defaults to 1 in which case it is required to set the resolver manually to version 2, otherwise the target specific compilation will not resolve correctly. When the wrong resolver is used, an error should state that the event::Listen trait is missing.

Modules

• command
  wrapped bindings for easier use in the generated wasm commands
• eventevent
  event traits and overall logic for event emitting and listening

Macros

• collect_commandsNon-target_family="wasm"
  Collects all commands annotated with tauri_interop::command and provides these with a get_handlers() in the current mod
• combine_handlersNon-target_family="wasm"
  Combines multiple modules containing commands
• host_usage
  Simple macro to include multiple imports (seperated by |) not in wasm
• wasm_usage
  Simple macro to include multiple imports (seperated by |) only in wasm

Attribute Macros

• bindingtarget_family="wasm"
  Generates the wasm counterpart to a defined tauri::command
• command
  Conditionally adds the macro binding or tauri::command to a struct
• commandsNon-target_family="wasm"
  Marks a mod that contains commands

Derive Macros

• Emitevent
  Generates a default Emit implementation for the given struct.
• EmitFieldevent
  Generates a default EmitField implementation for the given struct.
• Eventevent
  Conditionally adds Listen or Emit to a struct.
• Listenevent
  Generates a default Listen implementation for the given struct.
• ListenFieldevent
  Generates a default ListenField implementation for the given struct.