jaraco.windows 1.6

Windows Routines by Jason R. Coombs

Contents

• Status and License

• Package Contents

• Installation

• Contribute

• Changes

  • 1.6

  • 1.5

  • 1.4

  • 1.3

  • 1.2

  • 1.1

  • 1.0

Status and License

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.

jaraco.windows is written by Jason R. Coombs. It is licensed under an MIT-style permissive license.

You can install it with easy_install jaraco.windows, or from the subversion repository with easy_install jaraco.windows==dev.

Package Contents

jaraco.windows contains several modules for different purposes. For now, read the source. Eventually, I will put high-level descriptions of the modules here.

Installation

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.

Contribute

If jaraco.windows doesn’t supply the interface you require for your application, consider creating the interface and providing a patch to the author.

Changes

1.6

• Added monkeypatch for os.symlink and os.readlink.

• Added find-symlinks command.

1.5

• 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.

1.4

• 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).

• Updated enver to support appending to a non-existent variable.

• Added a ‘show’ option to xmouse

• Added routines to support the Microsoft Data Protection API (DPAPI).

1.3

• Added -U option to enver

1.2

• Added this documentation

• Updated the project website to use PYPI directly.

• Improved deployment support (fixes issues with easy_install)

• Fixed issue with PATH and PATHEXT handling in enver.

1.1

• Added support for persistent environment variable setting (inspired by enver.py)

1.0

• Initial release

• Includes xmouse script for enabling/disabling focus-follows-mouse