Here is a patch with the proposed API. The API for convenience:

    def files(self, include_symlinks=True):
        """Iterate over the regular files in this directory.
        """

    def subdirs(self, include_symlinks=True):
        """Iterate over the subdirectories in this directory.
        """