specify posix.dirent:
- before:
    dirent = require "posix.dirent"


- describe dir:
  - before:
      dir = dirent.dir

  - context with bad arguments: |
      badargs.diagnose (dir, "(?string)")

      examples {
        ["it diagnoses argument #1 not a valid file"] = function ()
          expect (dir "/not/exists").to_raise.any_of {
            -- Can't be any more accurate, because error message is system specific
            "bad argument #1 to 'dir' (/not/exists: ",
            "bad argument #1 to '?' (/not/exists: ",
          }
        end
      }

- describe files:
  - before:
      # Make and change into a temporary subdirectory where we can
      # control all the contents for self-contained examples.
      link, mkdir, mkdtemp = posix.link, posix.mkdir, posix.mkdtemp
      origwd = posix.getcwd ()
      dir, errmsg = mkdtemp (template)
      mkdir (dir .. "/subdir")
      link ("subdir", dir .. "/soft", true)
      touch (dir .. "/file")
      link (dir .. "/file", dir .. "/hard")
      link ("no such destination", dir .. "/dangling", true)

      files = dirent.files

  - after:
      posix.chdir (origwd)
      rmtmp (dir)

  - context with bad arguments: |
      badargs.diagnose (files, "(?string)")

      examples {
        ["it diagnoses argument #1 not a valid file"] = function ()
          expect (files "/not/exists").to_raise.any_of {
            -- Can't be any more accurate, because error message is system specific
            "bad argument #1 to 'files' (/not/exists: ",
            "bad argument #1 to '?' (/not/exists: ",
          }
        end
      }

  - it returns a table of files in the given directory:
      t = {}
      for f in files (dir) do
        table.insert (t, f)
      end
      table.sort (t)
      expect (t).to_equal {".", "..", "dangling", "file", "hard", "soft", "subdir"}