cpython/Lib/plat-mac/macresource.py

147 lines
5.0 KiB
Python
Raw Normal View History

"""macresource - Locate and open the resources needed for a script."""
from Carbon import Res
import os
import sys
import MacOS
import macostools
class ArgumentError(TypeError): pass
class ResourceFileNotFoundError(ImportError): pass
def need(restype, resid, filename=None, modname=None):
2003-04-09 10:25:43 -03:00
"""Open a resource file, if needed. restype and resid
are required parameters, and identify the resource for which to test. If it
is available we are done. If it is not available we look for a file filename
(default: modname with .rsrc appended) either in the same folder as
where modname was loaded from, or otherwise across sys.path.
2003-04-09 10:25:43 -03:00
Returns the refno of the resource file opened (or None)"""
2003-04-09 10:25:43 -03:00
if modname is None and filename is None:
raise ArgumentError("Either filename or modname argument (or both) must be given")
2003-04-09 10:25:43 -03:00
if type(resid) is type(1):
try:
h = Res.GetResource(restype, resid)
except Res.Error:
pass
else:
return None
else:
try:
h = Res.GetNamedResource(restype, resid)
except Res.Error:
pass
else:
return None
2003-04-09 10:25:43 -03:00
# Construct a filename if we don't have one
if not filename:
if '.' in modname:
filename = modname.split('.')[-1] + '.rsrc'
else:
filename = modname + '.rsrc'
2003-04-09 10:25:43 -03:00
# Now create a list of folders to search
searchdirs = []
if modname == '__main__':
# If we're main we look in the current directory
searchdirs = [os.curdir]
if modname in sys.modules:
2003-04-09 10:25:43 -03:00
mod = sys.modules[modname]
if hasattr(mod, '__file__'):
searchdirs = [os.path.dirname(mod.__file__)]
searchdirs.extend(sys.path)
2003-04-09 10:25:43 -03:00
# And look for the file
for dir in searchdirs:
pathname = os.path.join(dir, filename)
if os.path.exists(pathname):
break
else:
raise ResourceFileNotFoundError(filename)
2003-04-09 10:25:43 -03:00
refno = open_pathname(pathname)
2003-04-09 10:25:43 -03:00
# And check that the resource exists now
if type(resid) is type(1):
h = Res.GetResource(restype, resid)
else:
h = Res.GetNamedResource(restype, resid)
return refno
def open_pathname(pathname, verbose=0):
2003-04-09 10:25:43 -03:00
"""Open a resource file given by pathname, possibly decoding an
AppleSingle file"""
try:
refno = Res.FSpOpenResFile(pathname, 1)
except Res.Error as error:
if error.args[0] in (-37, -39):
2003-04-09 10:25:43 -03:00
# No resource fork. We may be on OSX, and this may be either
# a data-fork based resource file or a AppleSingle file
# from the CVS repository.
try:
refno = Res.FSOpenResourceFile(pathname, '', 1)
except Res.Error as error:
if error.args[0] != -199:
2003-04-09 10:25:43 -03:00
# -199 is "bad resource map"
raise
else:
return refno
# Finally try decoding an AppleSingle file
pathname = _decode(pathname, verbose=verbose)
refno = Res.FSOpenResourceFile(pathname, '', 1)
2003-04-09 10:25:43 -03:00
else:
raise
return refno
def resource_pathname(pathname, verbose=0):
2003-04-09 10:25:43 -03:00
"""Return the pathname for a resource file (either DF or RF based).
If the pathname given already refers to such a file simply return it,
otherwise first decode it."""
try:
refno = Res.FSpOpenResFile(pathname, 1)
Res.CloseResFile(refno)
except Res.Error as error:
if error.args[0] in (-37, -39):
2003-04-09 10:25:43 -03:00
# No resource fork. We may be on OSX, and this may be either
# a data-fork based resource file or a AppleSingle file
# from the CVS repository.
try:
refno = Res.FSOpenResourceFile(pathname, '', 1)
except Res.Error as error:
if error.args[0] != -199:
2003-04-09 10:25:43 -03:00
# -199 is "bad resource map"
raise
else:
return refno
# Finally try decoding an AppleSingle file
pathname = _decode(pathname, verbose=verbose)
else:
raise
return pathname
def open_error_resource():
2003-04-09 10:25:43 -03:00
"""Open the resource file containing the error code to error message
mapping."""
need('Estr', 1, filename="errors.rsrc", modname=__name__)
def _decode(pathname, verbose=0):
2003-04-09 10:25:43 -03:00
# Decode an AppleSingle resource file, return the new pathname.
newpathname = pathname + '.df.rsrc'
if os.path.exists(newpathname) and \
os.stat(newpathname).st_mtime >= os.stat(pathname).st_mtime:
return newpathname
if hasattr(os, 'access') and not \
os.access(os.path.dirname(pathname), os.W_OK|os.X_OK):
# The destination directory isn't writable. Create the file in
2003-04-09 10:25:43 -03:00
# a temporary directory
import tempfile
fd, newpathname = tempfile.mkstemp(".rsrc")
if verbose:
print('Decoding', pathname, 'to', newpathname)
2003-04-09 10:25:43 -03:00
import applesingle
applesingle.decode(pathname, newpathname, resonly=1)
return newpathname