jaraco.windows aims to provide a pure-python interface to Windows
APIs using ctypes. This package is not designed to be exhaustive, but
rather to supply interfaces as they are needed by the contributors.

You should install this module the normal way using setuptools or distribute.

If you want to monkeypatch the os module to include symlink compatibility, you
should add the following to your usercustomize or sitecustomize module:

import jaraco.windows.filesystem as fs; fs.patch_os_module()

Thereafter, you should be able to use os.symlink and os.readlink in Windows
Vista and later using the same interface as on Unix.

Note that jaraco.windows.filesystem.symlink takes an additional optional
parameter target_is_directory, which must be specified if the target is not
present and is expected to be a directory once present.

NB!! Switched the order of the parameters for symlink and link to match the
signature found in the os module. This will absolutely break any implementations
that worked with jaraco.windows prior to 1.5.

Added more robust support for symlink support (including a symlink traversal
routine that works even when the target is locked). This method uses explicit
reparse point parsing, using the new reparse module.

Added support for hardlinks.

Added jaraco.windows.lib for locating loaded modules.

Added command line parameters to environ to allow override of default
append/replace behavior.

Added power monitoring utilities.

Began work on GUI testing objects in jaraco.windows.gui.test, based on watsup.

Added filesystem.GetBinaryType

Added filesystem.SHFileOperation (useful for sending items to a Recycle Bin).