2.8 findertools -- The finder's Apple Events interface
Keywords: mac

# 2.8 `findertools` -- The finder's Apple Events interface

Availability: Macintosh.

This module contains routines that give Python programs access to some functionality provided by the finder. They are implemented as wrappers around the AppleEvent interface to the finder.

All file and folder parameters can be specified either as full pathnames or as FSSpec objects.

The `findertools` module defines the following functions:

`launch`(file)
  Tell the finder to launch file. What launching means depends on the file: applications are started, folders are opened and documents are opened in the correct application.

`Print`(file)
  Tell the finder to print a file (again specified by full pathname or FSSpec). The behaviour is identical to selecting the file and using the print command in the finder's file menu.

`copy`(file, destdir)
  Tell the finder to copy a file or folder file to folder destdir. The function returns an Alias object pointing to the new file.

`move`(file, destdir)
  Tell the finder to move a file or folder file to folder destdir. The function returns an Alias object pointing to the new file.

`sleep`()
  Tell the finder to put the Macintosh to sleep, if your machine supports it.

`restart`()
  Tell the finder to perform an orderly restart of the machine.

`shutdown`()
  Tell the finder to perform an orderly shutdown of the machine.