Why is the shutil module called shutil?

[rantingrick]

Oh the creative juices are flowing now!!!



class Path:
    def __init__(self, path):
    def __coerce__(self) => File or Dir
    #
    # Properties about the path:
    drive => str
    directory => str
    filename => str
    extension => str
##    uncshare[1]=> ???
    #
    # Mutations.
    def expand_user(self): => ip or Path?
    def expand_vars(self): => ip or Path?
    def to_normpath(self): => ip #normcase/normpath
    def to_abspath(self) => ip #realpath/abspath
    def set_access(self, mode) => None
    def set_owner(self, uid, gid) => None
    def set_root(self, path) => None
    #
    # Introspection.
    def is_accessable(self, mode) => bool #access
    def is_valid(self) => bool # exists
    def is_absolute(self) => bool #isabs
    def is_directory(self) => bool #isdir
    def is_file(self) => bool #isfile
    def is_link(self) => bool #islnk
    def is_mount(self) => bool #ismount
    def is_same(self, path_Dir_or_File) => bool #issamefile
    #
    # Inspection, Extraction
    def get_abspath(self)=> Path
    def get_normpath(self) => Path
##    def get_atime(self) => str #atime
##    def get_mtime(self) => str #mtime
##    def get_ctime(self) => str #ctime
    def get_stat(self) => stat #stat,lstat
##    def get_statvfs(self) => stat #statvfs
##        # do we really need this antiquity?

    ############################################################
    #                         Question                         #
    ############################################################
    # Should all the stat stuff like get_mtime, get_ctime,     #
    # get_atime, etc... be accessed only under get_stat? I     #
    # believe so!                                              #
    ############################################################

    def get_drive(self): => str
    def get_directory(self): => str
    def get_filename(self): => str (empty if is_dir)
    def get_extension(self): => str (empty if is_dir)
    #
    def split(self) => (drive, path, filename, extension)
##    def splitunc(self): ???
##    def splitall(self): ???
##    def relpathto(self, dest): => ???
##    def pathconf(self, name): #pathconfig
    #
    # Modifying operations on links
    def link_new(self, newpath, symbolic=False): ...
    def link_read(self): ...
    def link_readabs(self): ...


class File:
    def new(path)
    (...All existing file methods here...)
    #
    # Mutate, Clone, Destroy.
    def rename(self, newname) => ip or File?
    def delete(self, overwrites=3) => None
    def copy(self, dst) => File
    def unlink(self) => None    #
    #
    # Attribute mutation.
    def update(self) => None #touch
    def copy_mode(src) => None #copymode
    def copy_stat(src) => None #copystat
    def update_mode(dst) => None
    def update_stat(dst) => None
    #
    # Other
    def get_bytes(self): => int => 1292894
    def get_size(self, fmtstr="{0:0.2f}") => str => "1.23 MB"
    def backup(self) => filename.bak{count}


class Dir:
    def new(path)
    def open(path)
    #
    # Mutate, Clone, Destroy.
    def delete(self, onerror=None): => None
    def copy(self, dst, symlinks=True): => Dir
    #
    # Introspection.
    def get_paths(self, pattern=None): [Path, Path, ...]
    def get_dirs(self, pattern=None): => [Dir, Dir, ...]
    def get_files(self, pattern=None): => [File, File, ...]
    def walk_paths(self, pattern=None): itereach->PathObj
    def walk_dirs(self, pattern=None): itereach->DirObj
    def walk_files(self, pattern=None): itereach->FileObj

    ############################################################
    #                         Question                         #
    ############################################################
    # Do we really need "get_*" AND "walk_*"? I believe we     #
    # should choose one set of three                           #
    ############################################################

    def match(self, pattern) => bool
        # Do we need match when re would suffice?
    def glob(self, pattern): => [Path, Path, ...]

    ############################################################
    # Excommunicated Methods.
    ############################################################
    def startfile(self)
        # startfile should part of os anyway.