findertools (version 1.1)
index
/System/Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/plat-mac/findertools.py
Module Docs

Utility routines depending on the finder,
a combination of code by Jack Jansen and erik@letterror.com.
 
Most events have been captured from
Lasso Capture AE and than translated to python code.
 
IMPORTANT
Note that the processes() function returns different values
depending on the OS version it is running on. On MacOS 9
the Finder returns the process *names* which can then be
used to find out more about them. On MacOS 8.6 and earlier
the Finder returns a code which does not seem to work.
So bottom line: the processes() stuff does not work on < MacOS9
 
Mostly written by erik@letterror.com

 
Modules
       
Carbon.AppleEvents
Carbon
Finder
MacOS
aetools
aetypes
sys

 
Functions
       
OSversion()
return the version of the system software
Print(file)
Print a file thru the finder. Specify file by name or fsspec
closewindow(object)
Close a Finder window for folder, Specify by path.
comment(object, comment=None)
comment: get or set the Finder-comment of the item, displayed in the 'Get Info' window.
copy(src, dstdir)
Copy a file to a folder
emptytrash()
empty the trash
filesharing()
return the current status of filesharing and whether it is starting up or not:
-1  file sharing is off and not starting up
0   file sharing is off and starting up
1   file sharing is on
icon(object, icondata=None)
icon sets the icon of object, if no icondata is given,
icon will return an AE object with binary data for the current icon.
If left untouched, this data can be used to paste the icon on another file.
Development opportunity: get and set the data as PICT.
isactiveprocess(processname)
Check of processname is active. MacOS9
label(object, index=None)
label: set or get the label of the item. Specify file by name or fsspec.
launch(file)
Open a file thru the finder. Specify file by name or fsspec
location(object, pos=None)
Set the position of a Finder window for folder to pos=(w, h). Specify file by name or fsspec.
If pos=None, location will return the current position of the object.
mountvolume(volume, server=None, username=None, password=None)
mount a volume, local or on a server on AppleTalk.
Note: mounting a ASIP server requires a different operation.
server is the name of the server where the volume belongs
username, password belong to a registered user of the volume.
move(src, dstdir)
Move a file to a folder
movetotrash(path)
move the object to the trash
openwindow(object)
Open a Finder window for object, Specify object by name or fsspec.
processes()
processes returns a list of all active processes running on this computer and their creators.
processinfo(processname)
Return an object with all process properties as attributes for processname. MacOS9
putaway(object)
puth the object away, whereever it came from.
restart()
Restart the mac
reveal(file)
Reveal a file in the finder. Specify file by name, fsref or fsspec.
select(file)
select a file in the finder. Specify file by name, fsref or fsspec.
shutdown()
Shut the mac down
sleep()
Put the mac to sleep
unmountvolume(volume)
unmount a volume that's on the desktop
update(file)
Update the display of the specified object(s) to match
their on-disk representation. Specify file by name, fsref or fsspec.
volumelevel(level)
set the audio output level, parameter between 0 (silent) and 7 (full blast)
windowposition(folder, pos=None)
Set the position of a Finder window for folder to pos=(w, h).
windowsize(folder, size=None)
Set the size of a Finder window for folder to size=(w, h), Specify by path.
If size=None, windowsize will return the current size of the window.
Specify file by name or fsspec.
windowview(folder, view=None)
windowview: Set the view of the window for the folder. Specify file by name or fsspec.
0 = by icon (default)
1 = by name
2 = by button

 
Data
        Error = 'findertools.Error'
StringTypes = (<type 'str'>, <type 'unicode'>)
__version__ = '1.1'