watchexec

• Globset filterer was erroneously passing files with no extension when an extension filter was specified

• Update MSRV (to 1.58) and policy (bump incurs minor semver only)
• Some bugfixes around canonicalisation of paths
• Eliminate context-less IO errors
• Move error types around
• Prep library readme
• Update deps

• More logging, especially around ignore file discovery and filtering
• The const paths::PATH_SEPARATOR is now public, being : on Unix and ; and Windows.
• Add Subversion to discovered ProjectTypes
• Add common (sub)Filterer for ignore files, so they benefit from a single consistent implementation. This also makes ignore file discovery correct and efficient by being able to interpret ignore files which searching for ignore files, or in other words, not descending into directories which are ignored.
• Integrate this new IgnoreFilterer into the GlobsetFilterer and TaggedFilterer. This does mean that some old v1 behaviour of patterns in gitignores will not behave quite the same now, but that was arguably always a bug. The old "buggy" v1 behaviour around folder filtering remains for manual filters, which are those most likely to be surprising if "fixed".

• summarise_events_to_env used to return COMMON_PATH, it now returns COMMON, in keeping with the other variable names.

• summarise_events_to_env returns a HashMap<&str, OsString> rather than HashMap<&OsStr, OsString>, because the expectation is that the variable names are processed, e.g. in the CLI: WATCHEXEC_{}_PATH. OsStr makes that painful for no reason (the strings are static anyway).
• The Action struct's events field changes to be an Arc<Vec<Event>> rather than a Vec<Event>: the intent is for the events to be immutable/read-only (and it also made it easier/cheaper to implement the next change below).
• The PreSpawn and PostSpawn structs got a new events: Arc<Vec<Event>> field so these handlers get read-only access to the events that triggered the command.

• MSRV bumped to 1.56
• Rust 2021 edition
• More documentation around tagged filterer:
  • == and != are case-insensitive
  • the mapping of matcher to tags
  • the mapping of matcher to auto op
• Finished the tagged filterer:
  • Proper path glob matching
  • Signal matching
  • Process completion matching
  • Allowlisting pattern works
  • More matcher aliases to the parser
  • Negated filters
  • Some silly filter parsing bugs
  • File event kind matching
  • Folder filtering (main confusing behaviour in v1)
• Lots of tests:
  • Globset filterer
  • Including the "buggy"/confusing behaviour of v1, for parity/compat
  • Tagged filterer:
    • Paths
    • Including verifying that the v1 confusing behaviour is fixed
    • Non-path filters
    • Filter parsing
  • Ignore files
  • Filter scopes
  • Outcomes
  • Change reporting in the environment
    • ...Specify behaviour a little more precisely through that process
• Prepare the watchexec event type to be serializable
  • A synthetic FileType
  • A synthetic ProcessEnd (ExitStatus replacement)
• Some ease-of-use improvements, mainly removing generics when overkill

• Process handling code replaced with the new command-group crate.
• #158 New option use_process_group (default true) allows disabling use of process groups.
• #168 Default debounce time further decreased to 100ms.
• Binstall configuration and transitional cargo install watchexec stub removed.

• #200: Expose when the process is done running
• ba26999028cfcac410120330800a9a9026ca7274 Pin globset to 0.4.6 to avoid breakage due to a bugfix in 0.4.7

• fdb0cfb Soft-deprecate (in documentation only) Args.debug as it's not used any more.
• #163 Add a manifest on Windows to transparently opt-in to long path support when supported. This is a cli change only and is not present in downstream executables (see associated commits for how to do it for your application).
• #165 Fix help text and documentation to mention that -w can be used to watch files as well as folders.
• #168 Drop default debounce time to 300ms. This is an experiment to gain testing on a lower value! Please report any issues. If it goes well the default will be dropped again later on.

• #157 Error and exit gracefully when the subprocess's environment would be too large (as a result of too many changes being added to the WATCHEXEC_* environment variables instead of throwing a cryptic message ("Argument list too long")
• #157 Add --no-environment to disable the WATCHEXEC_* variables being set, to avoid the above situation completely.
• #157 Add --no-meta to disable only "metadata" events from being reported as above, which mitigates the above situation.
• #160 ⚠️ Stop initialising the logger in the library code. Downstream users will need to initialise their own logger if they want debug/warn output. As a reminder, the library API is not considered in semver here, and downstream users are encouraged to specify exact versions: watchexec = "=1.14.0".

• passcod/cargo-watch#149: if watched directory didn't contain a .git folder, thread would block (infinite loop)

• #147: .gitignore files are now looked at in children as well as parents, the latter being very much not what should happen, but I'm kinda stuck with it at the moment to avoid breaking behaviour, eeech
• #150: clarity around time units in the interface
• Deps: notify (patch), globset (patch), clap (patch), nix (major: 0.15 → 0.17)

• #142: Change ignore globbing to behave as the readme documents: -i foo now matches the foo folder and descendants, instead of having to specify -i foo/**
• #141, #123: Introduce a --watch-when-idle option that ignores events emitted while the command is running. This may help ignore changes made by the command itself (#40), though it of course also ignores all other changes during that time.

• Revert a change that made a type borrowed instead of the more sane (and more flexible) owned

• Support for .ignore files (#127)
• zsh completions in tree and releases (#130)
• Semver policy for library written down (#135)
• A new builder for Args (#135)
• More flexible Handler trait (#133)
• Rust Edition 2018
• MSRV bumped to 1.38
• Builds done with --locked for reproducibility (#131)
• Windows builds moved to Travis
• MSVC release builds are back
• Linux and macOS builds use xz compression
• Lots of lints enabled
• Some typos fixed (#128, #129)

• The man page was brought up-to-date to new options and a hint to use -- (#125)

• Always canonicalise paths, fixing a bug where some ignores would sometimes fail to apply (#113)
• Some dependency updates (#115, #116, 7ed5ea577793d44be574031ba8a408acba8b0699)
• Crate is somewhat smaller (#117)

• Fix crash on some error conditions. (#111)
• Clear the screen on initial run again (4918b12)

New API features

The API now enables:

• parsing a command line string into watchexec Args
• writing one's own handler to react to changes
• a lot more errors to be caught instead of panicking

This also has creates two minor breaking changes:

• Args's paths field is now a Vec<PathBuf> rather than a Vec<String>
• cli::get_args() returns a Result rather than nothing

This was done in #105, prompted by #104 and #103.

Clap update

This formalises the fix to #76.

Support commands that allocate their own TTY

Through setsid, thanks to @Mange (#102).

Fixes #47 and some other issues downstream.

An attempt to fix some issues clearing screens under some Windows configurations

These are hard to guess at / repro. Maybe it helped #99.

Dependency upgrades

• Notify 4.0.7 brings in some fixes, notably a performance/battery-saving optimisation on Linux.
• Regex 1.1.0 brings in some performance improvements for (git)ignore patterns

Some progress towards manual restarts

As part of the API changes, file-triggered runs and manual runs are now explicitly differentiated, which will help when eventually implementing #67.