unix-recursive: Fast and flexible primitives for recursive file system IO on Posix systems

[ bsd3, filesystem, library, system ] [ Propose Tags ]

Blazingly fast functions for recursive file system operations. Utilizing lazy IO for constant space & computation efficiant bindigns to Posix dirstream.h api.


[Skip to Readme]
Versions [RSS] [faq] 0.1.0.0
Change log ChangeLog.md
Dependencies base (>=4.7 && <5), bytestring, dir-traverse (==0.2.3.0), directory, dirstream, pipes, pipes-safe, system-filepath, unix, unix-recursive, utf8-string [details]
License BSD-3-Clause
Copyright 2021 Marek Fajkus
Author Marek Fajkus <marek.faj@gmail.com>
Maintainer Marek Fajkus <marek.faj@gmail.com>
Category System, Filesystem
Home page https://github.com/turboMaCk/unix-recursive
Bug tracker https://github.com/turboMaCk/unix-recursive/issues
Source repo head: git clone https://github.com/turboMaCk/unix-recursive
Uploaded by MarekFajkus at 2021-02-21T21:13:18Z
Distributions NixOS:0.1.0.0
Executables unix-recursive-bytestring-bin, unix-recursive-string-bin, dirstream-bin, dir-traverse-bin
Downloads 44 total (5 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Hackage Matrix CI
Docs available [build log]
Last success reported on 2021-02-21 [all 1 reports]

Modules

[Index] [Quick Jump]

Flags

NameDescriptionDefaultType
binDisabledManual

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Candidates


Readme for unix-recursive-0.1.0.0

[back to package description]

Unix Recursive

build

Blazingly fast functions for recursive file system operations. Utilizing lazy IO for constant space & computation efficiant bindigns to Posix dirstream.h api.

Comparision with other libraries:

Tests were performed on relatively modern consumer grade HW with relatively modern consumer grade M.2 SSD drive. All done on binaries compiled with optimization that are listing the same directory with 1,705,184 items.

[this lib] Unix Recursive RawFilePath/ByteString

[this lib] Unix Recursive FilePath/String

[alternative] Dir Traverse (FilePath/String is the only option)

[alternative] Dirstream (Filesystem.Path is the only option)

Testing performance

Cabal flag bin is being used for building the example binaries that can be used for measurement.

make bin

or to build and run one of the binaries:

$ stack build --flag unix-recursive:bin --exec "unix-recursive-bytestring-bin ${path-to-directory}"

Hacking

This project uses the "Perfect Haskell Preprocessor" (PHP) for generating haskell source from meta module hs. See gen directory and MakeFile before you start hackking on stuff.