Expose a way to create a `Loop` from a `uv_loop_t`

libuv-rs

A safe rust wrapper for libuv.

Getting Started

Include libuv-rs as a dependency in your Cargo.toml:

[dependencies]
libuv = "~1.0.0"

libuv-rs uses semantic versioning.

As of v2.0.1, libuv-rs supports the skip-pkg-config feature. This is passed to libuv-sys2 to skip searching for a local install of libuv via pkg-config and, instead, causes libuv-sys2 to build libuv from source.

You'll want to make sure to familiarize yourself with libuv by reading libuv's documentation. You can then familiarize yourself with libuv-rs by reading the examples and documentation.

Unimplemented

libuv-rs strives to implement wrappers for all libuv functionality. However, some functionality was purposefully excluded as rust provides implementations of its own. That is: threads and synchronization (mutexes, locks, semaphores, conditional variables, barriers, etc).

If your rust project would benefit from libuv's threading or synchronization primitives, please file an Issue on github and I'll implement wrappers for it!

Cross-Platform Considerations

libuv-rs depends on libuv-sys2, which depends on bindgen. On Windows, bindgen requires rust's msvc toolchain.

	/// Start the handle with the given callback, which will watch the specified path for changes.
	///
	/// Note: Currently the only supported flag is RECURSIVE and only on OSX and Windows.
	pub fn start<CB: Into<FsEventCB<'static>>>(
	&mut self,
	path: &str,
	flags: FsEventFlags,
	cb: CB,
	) -> Result<(), Box<dyn std::error::Error>> {
	let path = CString::new(path)?;

	// uv_cb is either Some(fs_event_cb) or None
	let cb = cb.into();
	let uv_cb = use_c_callback!(uv_fs_event_cb, cb);

	// cb is either Some(closure) or None - it is saved into data
	let dataptr = crate::Handle::get_data(uv_handle!(self.handle));
	if !dataptr.is_null() {
	if let super::FsEventData(d) = unsafe { &mut (*dataptr).addl } {
	d.fs_event_cb = cb;
	}
	}

	crate::uvret(unsafe { uv_fs_event_start(self.handle, uv_cb, path.as_ptr(), flags.bits()) })
	.map_err(\|e\| Box::new(e) as _)
	}

bmatcuk / libuv-rs Goto Github PK

libuv-rs's Introduction

libuv-rs

Getting Started

Unimplemented

Cross-Platform Considerations

libuv-rs's People

Contributors

Stargazers

Watchers

Forkers

libuv-rs's Issues

Expose a way to create a `Loop` from a `uv_loop_t`

examples/tcp-echo-server.rs Incorrect result

Build failure: mismatched types

Error code instead of Box<dyn Error>

Segmentation fault

Recommend Projects

React

Vue.js

Typescript

TensorFlow

Django

Laravel

D3

Recommend Topics

javascript

web

server

Machine learning

Visualization

Game

Recommend Org

Facebook

Microsoft

Google

Alibaba

D3

Tencent