attributes:

dates:
* accessed
* changed
* modified

what formats? unixtime? w3cdtf?

size: 
* in bytes
* human readable?

abspath (i.e. relative to /)
uripath
relpath (relative to what? current directory? docroot?)
size

media type? - won't work if .htaccess overrides it
(same with paths though, really)

encoding?

robots.txt public?

path... relative to:
1) sysroot - /
2) current - .
3) docroot - $DOCUMENT_ROOT

abspath, relpath, webpath?

y/n modifications:
* add trailing directory slashes
* trim known suffixes?

trim known suffixes is really only appropriate for webpath
but relpath can be thought of as a webpath too
(webpath is relative to docroot... so a bit of a misnomer)

semi-absolute_uri
relative_uri
absolute_path
semi-absolute_path
relative_path

server_uri? server_path?

* absolute_uri (requires server name)
* server_uri
* relative_uri
* absolute_path
* server_path
* relative_path

* basename_path
* basename_uri

config.uri = False
config.uri.absolute = False
(or conf)

conf.modified.format = [etc.]

conf.attributes = ['absolute_uri']

can get DOCUMENT_ROOT and SERVER_NAME from env or args

title of HTML documents?
suffix/extension (what about .tar.gz?)
extensions?

files.py
docs.py

options:

recursive, children - recurse into child directories?
raw - don't normalise? any point of this? (only applies to rel)
robots - obey robots.txt or not
suffixes - strip superfluous suffixes

include .? include ..?
include directories?
what about executable?

ignore certain filetypes? .pyc etc.

directory index vs. the directory itself