WebServer::DirIndex

Directory index data for web server listings.

Synopsis

use WebServer::DirIndex;

my $di = WebServer::DirIndex->new(
  dir     => '/path/to/dir',
  dir_url => '/some/dir/',
);

# Get the list of file entries
my @files = $di->files;

# Generate an HTML directory index page
my $html = $di->to_html('/some/dir/');

# Generate a prettified HTML directory index page
my $html = $di->to_html('/some/dir/', 1);

Description

This module reads a filesystem directory and builds the data required to render a directory index page for a web server. It provides access to the list of file entries and can generate an HTML page via WebServer::DirIndex::HTML.

The distribution includes three modules:

• WebServer::DirIndex — reads a directory and exposes file entries.
• WebServer::DirIndex::HTML — renders the HTML directory index page.
• WebServer::DirIndex::CSS — provides standard and "pretty" CSS stylesheets.

Installation

perl Makefile.PL
make
make test
make install

Dependencies

• HTTP::Date
• Plack
• URI::Escape

Author

Dave Cross dave@perlhacks.com

Copyright and Licence

Copyright (c) 2026 Magnum Solutions Limited. All rights reserved.

This is free software; you can redistribute it and/or modify it under the same terms as Perl itself.