http directory listing library

This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow to host generated Haddocks.

MIT licensed by Jens Petersen
Maintained by


Hackage MIT license Stackage Lts Stackage Nightly Build status

A simple library for reading http directories.

It uses http-client for http transport, and html-conduit and xml-conduit to parse the html for links.

The library is intended for listing the files in http file directories, but since http directories are just html pages it can also be used to list the links (href’s) on any html webpage.

Usage Example

Network.HTTP.Directory> :type httpDirectory'
httpDirectory' :: String -> IO [Text]
Network.HTTP.Directory> httpDirectory' ""

See more examples and the latest haddock documentation for more usage details.



http-directory uses PVP Versioning.

0.1.8 (2020-03-12)

  • fix regression in 0.1.6 and 0.1.7: do not filter “*/” files
  • more careful filter handling of ‘/’
  • filter infix ‘#’

0.1.7 (2020-01-24)

  • drop </> since it conflicts with filepath
  • deprecates 0.1.6

0.1.6 (2020-01-24)

  • filter relative/paths and relative?queries
  • add url </> file
  • add trailingSlash for url and noTrailingSlash for filename

0.1.5 (2019-06-xx)

  • also filter “..”, “#” and “:” from httpDirectory
  • export Manager
  • add isHttpUrl
  • testsuite added

0.1.4 (2019-06-07)

  • add httpRawDirectory
  • httpDirectory now filters out absolutes hrefs and sort links
  • add httpDirectory’ and httpRedirect’ variants with own Manager

0.1.3 (2019-06-04)

  • add httpExists

0.1.2 (2019-05-07)

  • add httpManager convenient function
  • print url when result not 200
  • add an example

0.1.1 (2019-04-14)

  • add httpLastModified

0.1.0 (2019-04-11)

  • initial release with httpDirectory, httpFileSize, and httpRedirect(s)