fproxy 0.0.3

Facilitate safe rust-to-rust ffi by generating proxies around required types. Useful when a library is loaded at runtime (i.e., dynamic).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45


/// Traits and impl related to generating proxies.
pub mod proxy;
/// Conversions of types from rust to C to proxies and visa versa.
pub mod convert;
/// Module containing mappings for rust's std types.
pub mod std;

pub use fproxy_derive::*;
pub use libloading;
pub use delegate;
pub use proxy::{FAllocated, FProxy, FOwned, FRef, FRefMut};
pub use convert::{FProxyFrom, FAsProxy, FToC, FFromC};
use ::std::{path::Path};
// Users should be able to `use fproxy::iter::...`
pub use std::*;

use libloading::Library;

pub struct FLib(pub Library);
impl FLib {
  /// Create a new library object, it is needed when a proxy
  /// was annotated with `"lib"` as it will take the library as argument.
  /// Panics if the underlying `libloading::Library` constructor 
  /// returns `Err`.
  pub fn new(path: impl AsRef<Path>) -> Self {
    unsafe {
      let mut lib = path.as_ref().to_path_buf();
      #[cfg(target_os = "windows")]
      lib.set_extension("dll");
      #[cfg(target_os = "macos")] {
        let name = lib.file_name().unwrap().to_str().unwrap();
        let name = format!("lib{name}");
        lib.set_file_name(name);
        lib.set_extension("dylib");
      }
      FLib(Library::new(lib.into_os_string().as_os_str()).unwrap())
    }
  }
}