@@ -342,7 +342,7 @@ See also: [`set-creation-time`](#babashka.fs/set-creation-time), [`last-modified
342342Function.
343343
344344Returns current working directory path.
345- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1522-L1525 " >Source</a ></sub ></p >
345+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1524-L1527 " >Source</a ></sub ></p >
346346
347347## <a name =" babashka.fs/delete " >` delete ` </a >
348348``` clojure
@@ -423,7 +423,7 @@ Function.
423423
424424Returns a vector of command search paths (from the ` PATH ` environment variable). Same
425425as ` (split-paths (System/getenv "PATH")) ` .
426- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1141-L1145 " >Source</a ></sub ></p >
426+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1143-L1147 " >Source</a ></sub ></p >
427427
428428## <a name =" babashka.fs/executable? " >` executable? ` </a >
429429``` clojure
@@ -464,7 +464,7 @@ assumed to be a username, then naively expanded to `(home username)`.
464464e.g., ` ~someuser/foo ` -> ` /home/someuser/foo `
465465
466466See also: [ ` home ` ] ( #babashka.fs/home )
467- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1495-L1515 " >Source</a ></sub ></p >
467+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1497-L1517 " >Source</a ></sub ></p >
468468
469469## <a name =" babashka.fs/extension " >` extension ` </a >
470470``` clojure
@@ -473,7 +473,7 @@ See also: [`home`](#babashka.fs/home)
473473Function.
474474
475475Returns the extension of ` path ` via [ ` split-ext ` ] ( #babashka.fs/split-ext ) .
476- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1131-L1134 " >Source</a ></sub ></p >
476+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1133-L1136 " >Source</a ></sub ></p >
477477
478478## <a name =" babashka.fs/file " >` file ` </a >
479479``` clojure
@@ -596,7 +596,7 @@ Options:
596596* ` :replace-existing ` - when ` true ` overwrites existing file
597597
598598See also: [ ` gzip ` ] ( #babashka.fs/gzip )
599- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1380-L1412 " >Source</a ></sub ></p >
599+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1382-L1414 " >Source</a ></sub ></p >
600600
601601## <a name =" babashka.fs/gzip " >` gzip ` </a >
602602``` clojure
@@ -617,7 +617,7 @@ Options:
617617* ` :out-file ` - if not specified, defaults to ` source-file ` [ ` file-name ` ] ( #babashka.fs/file-name ) with ` .gz ` extension.
618618
619619See also: [ ` gunzip ` ] ( #babashka.fs/gunzip )
620- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1414-L1444 " >Source</a ></sub ></p >
620+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1416-L1446 " >Source</a ></sub ></p >
621621
622622## <a name =" babashka.fs/hidden? " >` hidden? ` </a >
623623``` clojure
@@ -643,7 +643,7 @@ Returns home dir path.
643643With no arguments, returns the current value of the ` user.home `
644644system property. If a ` user ` is passed, returns that user's home
645645directory as found in the parent of home with no args.
646- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1485-L1493 " >Source</a ></sub ></p >
646+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1487-L1495 " >Source</a ></sub ></p >
647647
648648## <a name =" babashka.fs/instant->file-time " >` instant->file-time ` </a >
649649``` clojure
@@ -687,7 +687,7 @@ Function.
687687
688688Similar to [ ` list-dir ` ] ( #babashka.fs/list-dir ) but accepts multiple roots in ` dirs ` and returns the concatenated results.
689689- ` glob-or-accept ` - a [ ` glob ` ] ( #babashka.fs/glob ) string such as ` "*.edn" ` or a ` (fn accept [^java.nio.file.Path p]) -> truthy `
690- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1091-L1095 " >Source</a ></sub ></p >
690+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1093-L1097 " >Source</a ></sub ></p >
691691
692692## <a name =" babashka.fs/match " >` match ` </a >
693693``` clojure
@@ -738,7 +738,7 @@ the recursive max last modified time stamp is used as the timestamp
738738to compare with. The ` path-set ` may be a regular file, directory or
739739collection of paths (e.g. as returned by [ ` glob ` ] ( #babashka.fs/glob ) ). Directories are
740740searched recursively.
741- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1252-L1261 " >Source</a ></sub ></p >
741+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1254-L1263 " >Source</a ></sub ></p >
742742
743743## <a name =" babashka.fs/move " >` move ` </a >
744744``` clojure
@@ -1074,7 +1074,7 @@ Examples:
10741074- ` (fs/split-ext "foo.bar.baz") ` => ` ["foo.bar" "baz"] `
10751075- ` (fs/split-ext "foo.bar.baz" {:ext "bar.baz"}) ` => ` ["foo" "bar.baz"] `
10761076- ` (fs/split-ext "foo.bar.baz" {:ext "png"}) ` => ` ["foo.bar.baz" nil] `
1077- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1097-L1122 " >Source</a ></sub ></p >
1077+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1099-L1124 " >Source</a ></sub ></p >
10781078
10791079## <a name =" babashka.fs/split-paths " >` split-paths ` </a >
10801080``` clojure
@@ -1083,7 +1083,7 @@ Examples:
10831083Function.
10841084
10851085Splits ` joined-paths ` string into a vector of paths by OS-specific [ ` path-separator ` ] ( #babashka.fs/path-separator ) .
1086- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1136-L1139 " >Source</a ></sub ></p >
1086+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1138-L1141 " >Source</a ></sub ></p >
10871087
10881088## <a name =" babashka.fs/starts-with? " >` starts-with? ` </a >
10891089``` clojure
@@ -1117,7 +1117,7 @@ See also: [`posix->str`](#babashka.fs/posix->str)
11171117Function.
11181118
11191119Strips extension from ` path ` via [ ` split-ext ` ] ( #babashka.fs/split-ext ) .
1120- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1124-L1129 " >Source</a ></sub ></p >
1120+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1126-L1131 " >Source</a ></sub ></p >
11211121
11221122## <a name =" babashka.fs/sym-link? " >` sym-link? ` </a >
11231123``` clojure
@@ -1150,11 +1150,13 @@ If `path` is deleted by some other process/thread before `:time` is set,
11501150a ` NoSuchFileException ` will be thrown. Callers can, if their use case requires it,
11511151implement their own retry loop.
11521152
1153+ Returns ` path ` .
1154+
11531155Options:
11541156* ` :time ` - last modified time (epoch milliseconds (long), [ Instant] ( https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/Instant.html ) ,
11551157or [ FileTime] ( https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/file/attribute/FileTime.html ) ), defaults to current time
11561158* [ ` :nofollow-links ` ] ( /README.md#nofollow-links )
1157- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1061-L1089 " >Source</a ></sub ></p >
1159+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1061-L1091 " >Source</a ></sub ></p >
11581160
11591161## <a name =" babashka.fs/unixify " >` unixify ` </a >
11601162``` clojure
@@ -1163,7 +1165,7 @@ or [FileTime](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/
11631165Function.
11641166
11651167Returns ` path ` as string with Unix-style file separators (` / ` ).
1166- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1618-L1624 " >Source</a ></sub ></p >
1168+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1620-L1626 " >Source</a ></sub ></p >
11671169
11681170## <a name =" babashka.fs/unzip " >` unzip ` </a >
11691171``` clojure
@@ -1186,7 +1188,7 @@ Options:
11861188 * ` :name ` - the name of the ` ZipEntry ` (result of calling ` getName ` )
11871189
11881190See also: [ ` zip ` ] ( #babashka.fs/zip ) .
1189- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1267-L1308 " >Source</a ></sub ></p >
1191+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1269-L1310 " >Source</a ></sub ></p >
11901192
11911193## <a name =" babashka.fs/update-file " >` update-file ` </a >
11921194``` clojure
@@ -1200,7 +1202,7 @@ Returns the new contents.
12001202
12011203Options:
12021204* ` :charset ` - charset of file, default to "utf-8"
1203- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1599-L1616 " >Source</a ></sub ></p >
1205+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1601-L1618 " >Source</a ></sub ></p >
12041206
12051207## <a name =" babashka.fs/walk-file-tree " >` walk-file-tree ` </a >
12061208``` clojure
@@ -1210,6 +1212,8 @@ Function.
12101212
12111213Walks ` path ` via [ Files/walkFileTree] ( https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/nio/file/Files.html#walkFileTree(java.nio.file.Path,java.util.Set,int,java.nio.file.FileVisitor) ) .
12121214
1215+ Returns ` path ` .
1216+
12131217Options:
12141218* [ ` :follow-links ` ] ( /README.md#follow-links )
12151219* ` :max-depth ` - maximum directory depth to walk, defaults is unlimited
@@ -1222,8 +1226,6 @@ Options:
12221226All visitor functions must return one of ` :continue ` , ` :skip-subtree ` , ` :skip-siblings ` or ` :terminate ` .
12231227A different return value will throw. When not supplied, visitor functions default
12241228to ` (constantly :continue) ` .
1225-
1226- Returns ` path ` .
12271229<p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L233-L278 " >Source</a ></sub ></p >
12281230
12291231## <a name =" babashka.fs/which " >` which ` </a >
@@ -1244,7 +1246,7 @@ Options:
12441246* ` :win-exts ` - active on Windows only. Searches for ` program ` with filename extensions specified in ` :win-exts ` option.
12451247If ` program ` already includes an extension from ` :win-exts ` , it will be searched as-is first.
12461248Default is ` ["com" "exe" "bat" "cmd"] ` .
1247- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1154-L1207 " >Source</a ></sub ></p >
1249+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1156-L1209 " >Source</a ></sub ></p >
12481250
12491251## <a name =" babashka.fs/which-all " >` which-all ` </a >
12501252``` clojure
@@ -1254,7 +1256,7 @@ Default is `["com" "exe" "bat" "cmd"]`.
12541256Function.
12551257
12561258Returns a vector of every path to ` program ` found in ([ ` exec-paths ` ] ( #babashka.fs/exec-paths ) ). See [ ` which ` ] ( #babashka.fs/which ) .
1257- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1209-L1213 " >Source</a ></sub ></p >
1259+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1211-L1215 " >Source</a ></sub ></p >
12581260
12591261## <a name =" babashka.fs/windows? " >` windows? ` </a >
12601262``` clojure
@@ -1263,7 +1265,7 @@ Returns a vector of every path to `program` found in ([`exec-paths`](#babashka.f
12631265Function.
12641266
12651267Returns ` true ` if OS is Windows.
1266- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1517-L1520 " >Source</a ></sub ></p >
1268+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1519-L1522 " >Source</a ></sub ></p >
12671269
12681270## <a name =" babashka.fs/with-temp-dir " >` with-temp-dir ` </a >
12691271``` clojure
@@ -1290,7 +1292,7 @@ Example:
12901292;; d no longer exists here
12911293```
12921294
1293- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1448-L1477 " >Source</a ></sub ></p >
1295+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1450-L1479 " >Source</a ></sub ></p >
12941296
12951297## <a name =" babashka.fs/writable? " >` writable? ` </a >
12961298``` clojure
@@ -1325,7 +1327,7 @@ Examples:
13251327(fs/write-bytes f (.getBytes (String. " foo" ))) ; ; overwrites + truncates or creates new file
13261328(fs/write-bytes f (.getBytes (String. " foo" )) {:append true })
13271329```
1328- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1548-L1574 " >Source</a ></sub ></p >
1330+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1550-L1576 " >Source</a ></sub ></p >
13291331
13301332## <a name =" babashka.fs/write-lines " >` write-lines ` </a >
13311333``` clojure
@@ -1347,7 +1349,7 @@ Open options:
13471349* ` :write ` - (default ` true ` )
13481350* ` :append ` - (default ` false ` )
13491351* or any ` java.nio.file.StandardOption ` .
1350- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1576-L1597 " >Source</a ></sub ></p >
1352+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1578-L1599 " >Source</a ></sub ></p >
13511353
13521354## <a name =" babashka.fs/xdg-cache-home " >` xdg-cache-home ` </a >
13531355``` clojure
@@ -1360,7 +1362,7 @@ Returns path to user-specific non-essential data as described in the [XDG Base D
13601362
13611363Uses env-var ` XDG_CACHE_HOME ` (if set and representing an absolute path), else ` (fs/path (fs/home) ".cache") ` .
13621364When provided, appends ` app ` to the returned path.
1363- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1656-L1664 " >Source</a ></sub ></p >
1365+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1658-L1666 " >Source</a ></sub ></p >
13641366
13651367## <a name =" babashka.fs/xdg-config-home " >` xdg-config-home ` </a >
13661368``` clojure
@@ -1373,7 +1375,7 @@ Returns path to user-specific configuration files as described in the [XDG Base
13731375
13741376Uses env-var ` XDG_CONFIG_HOME ` (if set and representing an absolute path), else ` (fs/path (fs/home) ".config") ` .
13751377When provided, appends ` app ` to the returned path.
1376- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1646-L1654 " >Source</a ></sub ></p >
1378+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1648-L1656 " >Source</a ></sub ></p >
13771379
13781380## <a name =" babashka.fs/xdg-data-home " >` xdg-data-home ` </a >
13791381``` clojure
@@ -1386,7 +1388,7 @@ Returns path to user-specific data files as described in the [XDG Base Directory
13861388
13871389Uses env-var ` XDG_DATA_HOME ` (if set and representing an absolute path), else ` (fs/path (fs/home) ".local" "share") ` .
13881390When provided, appends ` app ` to the returned path.
1389- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1666-L1674 " >Source</a ></sub ></p >
1391+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1668-L1676 " >Source</a ></sub ></p >
13901392
13911393## <a name =" babashka.fs/xdg-state-home " >` xdg-state-home ` </a >
13921394``` clojure
@@ -1399,7 +1401,7 @@ Returns path to user-specific state files as described in the [XDG Base Director
13991401
14001402Uses env-var ` XDG_STATE_HOME ` (if set and representing an absolute path), else ` (fs/path (fs/home) ".local" "state") ` .
14011403When provided, appends ` app ` to the returned path.
1402- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1676-L1684 " >Source</a ></sub ></p >
1404+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1678-L1686 " >Source</a ></sub ></p >
14031405
14041406## <a name =" babashka.fs/zip " >` zip ` </a >
14051407``` clojure
@@ -1420,4 +1422,4 @@ Options:
14201422A single-arg function called for each file system path returning the path to be used for the corresponding zip entry.
14211423
14221424See also: [ ` unzip ` ] ( #babashka.fs/unzip ) .
1423- <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1341-L1374 " >Source</a ></sub ></p >
1425+ <p ><sub ><a href =" https://github.com/babashka/fs/blob/master/src/babashka/fs.cljc#L1343-L1376 " >Source</a ></sub ></p >
0 commit comments