unison-fsmonitor 0.3.2

unison-fsmonitor implementation
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

# unison-fsmonitor

[![Github Actions Status](https://github.com/autozimu/unison-fsmonitor/workflows/build-and-test/badge.svg)](https://github.com/autozimu/unison-fsmonitor/actions?query=workflow%3Abuild-and-test)

## Why

`unison` doesn't include `unison-fsmonitor` for macOS, thus `-repeat watch` option doesn't work out of the box. This utility fills the gap. This implementation was originally made for macOS but shall work on other platforms as well like Linux, Windows.

## Install

```sh
brew install autozimu/homebrew-formulas/unison-fsmonitor
```

Alternatively if you have [cargo](https://github.com/rust-lang/cargo) installed,

```sh
cargo install unison-fsmonitor
```

## Usage

Simply run unison with `-repeat watch` as argument or `repeat=watch` in config file.

## File watch limits 

You might need to update file watch limits in both hosts if watching limit reached. See <https://facebook.github.io/watchman/docs/install#system-specific-preparation> for more details.

## Debug

```
RUST_LOG=debug unison
```

## References

- Protocol <https://github.com/bcpierce00/unison/blob/af8669bb26f88e85bdc37cb1ff23d9bb0685a1e2/src/fswatch.ml>
- <https://github.com/bcpierce00/unison/blob/master/src/fsmonitor/watchercommon.ml>
- <https://github.com/hnsl/unox>