PyObjC - API Notes for the Foundation framework

NSFastEnumeration

• PyObjC doesn't use or implement this protocol yet.

NSAppleEventDescriptor

• -initWithAEDescNoCopy:, -aeDesc

  These methods are not supported.

NSArray

• -getObjects:

  This method is not supported. Either use the NSArray like a normal python sequence or use -getObjects:inRange:.

NSException

• raise:format:arguments:

  This method is not supported.

• NSGetUncaughtExceptionHandler, NSSetUncaughtExceptionHandler

  These functions are not yet supported.

NSGarbageCollector

PyObjC doesn't really support the GC yet. I've tried to code defensively, but have never tested a GC-enabled Python build and PyObjC relies on the usage of -dealloc in a number of cases.

• -disableCollectorForPointer:, -enableCollectorForPointer:

  These methods are not yet supported.

NSHashTable

PyObjC only supports NSHashTable instances that have been configured to store objects (as opposed to arbitrary pointers).

NSIndexPath

• -getIndexes:

  Use the indexPath as a python sequence instead.

• NSIndexPath supports a number of convenience methods:

  path[idx] <==> path.indexAtPosition_(idx)
  len(path) <==> path.length()
  path + 4 <==> path.indexPathByAddingIndex_(4)
  

NSMapTable

PyObjC only supports NSMapTable instances that have been configured to store objects (as opposed to arbitrary pointers).

NSPointerArray

PyObjC only supports NSPointerArray instances that have been configured to store objects (as opposed to arbitrary pointers).

NSPointerFunctions

Accessing properties of this class is not supported.

NSMachPort

The delegate protocol of NSMachPort is not supported at the moment.

NSPredicate

• -predicateWithFormat:arguments:

  This method is not supported.

NSProcessInfo

PyObjC defines a context named NSDisabledSuddenTermination. This can be used to disable sudden termination for a block of code. The context works on all versions of OSX, but only has a real side effect on OSX 10.6 or later.

Usage:

with NSDisabledSuddenTermination:
    # sudden termination is disabled here
    pass

NSSet

• +setWithObects:, -initWithObject:

  These methods are not supported, use other constructors instead.

NSOutputStream

• -initToBuffer:capacity:, outputStreamToBuffer:capacity:

  This method is barely supported. The method only works when you pass a writable buffer argument as the buffer, and manually ensure that the buffer stays alive.

NSString

• -getCharacters:

  This method is not supported.

NSValue

• -getValue:

  This method is not supported

NSGetUncaughtExceptionHandler

This function is not yet supported.