ttytm / vvatch

vvatch is cross-platform V module to monitor changes in directories. It utilizes the dmon C99 library.

vvatch

vvatch is cross-platform V module to monitor changes in directories. It utilizes the dmon C99 library.

Note

vmon is an already available module. It is the first mover in terms of being a dmon wrapper and served as an inspiration.

_{vvatch is a rewrite that I'm using for a client project that makes opinionated changes. It takes a different approach on the internals to allow a clean working surface. It aims to leverage the C library, increase robustness, and allows to compile programs that use the module in strict mode and with the Clang compiler.}

Installation

v install ttytm.vvatch

Usage

// watch starts to watch the specified directory.
// It receives the directory path, a callback that is executed on directory actions,
// watch flags and a voidptr for additional user arguments.
pub fn watch(path string, cb fn (watch_id WatchID, action Action, root_dir string, file_path string, old_file_path string, args voidptr), flags WatchFlags, user_args voidptr) !WatchID

// unwatch stops to watch the specified directory path.
pub fn (id WatchID) unwatch()

Ref.: src/lib.v

Simple Example

import ttytm.vvatch as w
import time
import os

struct App {
mut:
	triggered bool
}

fn watch_cb(watch_id w.WatchID, action w.Action, root_path string, file_path string, old_file_path string, mut app App) {
	match action {
		.create { println('created `${file_path}`') }
		.delete { println('delated `${file_path}`') }
		.modify { println('modified `${file_path}`') }
		.move { println('moved `${old_file_path}` to `${file_path}`') }
	}
	app.triggered = true
}

fn main() {
	mut app := App{}

	watcher := w.watch(os.join_path(os.home_dir(), 'Downloads'), watch_cb, w.WatchFlag.recursive,
		app)!

	// Wait until an external event is triggered in the monitored directory.
	for {
		if app.triggered {
			break
		}
		// Slow down the loop interval to reduce load.
		time.sleep(100 * time.millisecond)
	}

	watcher.unwatch()
	w.clean()
}

Ref.: examples/simple.v

v run examples/simple.v

# Run with additional debug information
v -g run examples/simple.v

License

Just as with vmon, the V code written for vvatch is licensed under MIT. The utilized dmon C library is licensed under the BSD 2-clause.