Skip to content

Simple Elixir file-system directory tree walker. It can handle large filesystems, as the tree is traversed lazily.

Notifications You must be signed in to change notification settings

pragdave/dir_walker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

51 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DirWalker

DirWalker lazily traverses one or more directory trees, depth first, returning successive file names.

Initialize the walker using

{:ok, walker} = DirWalker.start_link(path, [, options ]) # or [path, path...]

Then return the next n path names using

paths = DirWalker.next(walker [, n \\ 1])

Successive calls to next will return successive file names, until all file names have been returned.

These methods have also been wrapped into a Stream resource.

paths = DirWalker.stream(path [, options]) # or [path,path...]

By default DirWalker will follow any symlinks found. With the include_stat option, it will instead simply return the File.Stat of the symlink and it is up to the calling code to handle symlinks.

options is a map containing zero or more of:

  • include_stat: true

    Return tuples containing both the file name and the File.Stat structure for each file. This does not incur a performance penalty but obviously can use more memory. When this option is specified, DirWalker will not follow symlinks.

  • include_dir_names: true

    Include the names of directories that are traversed (normally just the names of regular files are returned). Note that the order is such that directory names will typically be returned after the names of files in those directories.

  • matching: regex

    Only file names matching the regex will be returned. Does not affect directory traversals.

About

Simple Elixir file-system directory tree walker. It can handle large filesystems, as the tree is traversed lazily.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •