package bos

v0.3.0 2026-04-22 La Forclaz (VS)

• Require OCaml >= 4.14.
• Move to one directory per library install convention.
• bos library: drop dependency on rresult. But the bos package still depends on it because of the bos.setup library.
• Fix sporadic deadlocks in OS.Cmd.run_io (#105). Thanks to arvidj for the report and the fix.
• Fix OS.File.{read,write,with_ic,with_oc,write_lines} performing newline translation when the file is Fpath.dash (#65). Thanks to Hezekiah M. Carty for the report.
• Add Cmd.if' and deprecate Cmd.on.
• Add OS.Path.[exists_]realpath (#49).
• Add OS.Dir.expand_tilde (#96), Thanks to Favonia for the patch.
• Add OS.Dir.{config,data,cache,runtime,state} looked up according to XDG conventions (#93). Thanks to Favonia for suggesting.
• Tweak OS.Dir.user (#77, #96). On Windows with MSVC++ or MinGW, only USERPROFILE is consulted. On Windows with Cygwin and other operating systems, HOME is consulted first; previously, getpwnam was consulted first. Thanks to Favonia for the patch.
• Internal. More subtle uninterruptible Unix.close function (#72). Thanks to Tom Ridge for reporting.
• Internal. Remove a catch all exception handler in the implementation of a "Unix.close_noerr" function.

v0.2.1 2021-10-04 Zagreb

• Require OCaml >= 4.08.
• OS.Dir.create fix function result on existing files. It returned non-sensical results. The function now errors as it should be. Thanks to Léo Andrès for the report.
• OS.Dir.create fix function returning false instead of true when the directory is created with ~path:false. Thanks to Léo Andrès for the report and patch.
• OS.File.read support for reading character devices and named pipes. Thanks to Rizo Isrof for the patch.

v0.2.0 2017-12-27 La Forclaz (VS)

• Built-in support for tool search. No longer relies on which (unix) or where (Windows).
• OS.Cmd.{exist,must_exist} get an optional ?search argument. This can break existing programs.
• Add OS.Cmd.{find_tool,get_tool,resolve,search_path_dirs}.
• Add OS.File.is_executable.
• Deprecate Cmd.[get_]line_exec in favor of Cmd.[get_]line_tool.
• Fix OS.Path.symlink ~force:true when the forced file is a symbolic link, the operation errored before. Thanks to Anil Madhavapeddy for the report.

v0.1.6 2017-05-04 La Forclaz (VS)

• Fix OS.Dir.create. The documentation says it returns true if the directory was created and false otherwise. The implementation did the converse, the latter was adjusted to match the doc specification.

v0.1.5 2017-03-18 La Forclaz (VS)

• Fix OS.Cmd.{err_file,out_file,to_file}. Files were not truncated on append = false.
• OS.File.with_input, allow to specify the input buffer as an optional argument.

v0.1.4 2016-08-30 Zagreb

• Fix OS.Path.fold on root and relative paths (#61). Thanks to Hezekiah M. Carty for the report and the help.
• Fix OS.File.write on Windows (#59). Thanks to Hezekiah M. Carty for the report and the fix.

v0.1.3 2016-07-12 Cambridge (UK)

• Cmd.dump, make representation cut and paste friendly. This affects logging made by the library.
• Add Cmd.of_values, converts arbitrary list of values to a corresponding argument list.
• Fix OS.Path.exists. Existing file path traversals returned and error rather than false.

v0.1.2 2016-06-17 Cambridge (UK)

• Fix OS.File creation mode from 0o622 to 0o644 (#55).
• Fix semantics of dotfile handling in OS.Path.{matches,query}. ~dotfile:false (default) used to not return any path that had a dot segment, even if this was a constant segment without pattern variables. This is no longer the case, ~dotfile:false now only prevents segments starting with a pattern variable to match against dot files, i.e. it controls the exploration of the file system made by the function. Thanks to David Kaloper for the discussion.

v0.1.1 2016-06-08 Cambridge (UK)

• Fix OS.Cmd combinators on Linux. Thanks to Andreas Hauptmann for the help (#51)
• Fix OS.Dir.delete on Linux and Windows. Thanks to Andreas Hauptmann for the help (#50).
• Fix OS.Cmd.exists on Linux. Thanks to Andreas Hauptmann and Petter Urkedal for the help (#52).

v0.1.0 2016-05-23 La Forclaz (VS)

First release.