4. Debugging

TODO: Info about logging & Xcode SDK tools.

Log(msg, debugOnly=True, encoding=None)

This function writes a line to the plug-in’s log file and console.

Parameters:

• msg – The message to write to the log file. The argument will automatically be converted to a string.
• debugOnly (boolean) – Specifies whether the line should be logged only when the plug-in is in debug mode.
• encoding – The string encoding to use.

LogChildren(dir, debugOnly=True, encoding=None)

Logs information about the children of a MediaContainer object.

Parameters:

• dir (MediaContainer) – The object to log the children of.
• debugOnly – See the Log() function above.
• encoding – See the Log() function above.

LogSelfAndChildren(dir, debugOnly=True, encoding=None)

Logs information about a MediaContainer object and its’ children.

Parameters:

• dir (MediaContainer) – The object to log information about.
• debugOnly – See the Log() function above.
• encoding – See the Log() function above.

LogSelfAndDescendants(dir, debugOnly=True, encoding=None)

Logs information about a MediaContainer object and its’ descendants.

Parameters:

• dir (MediaContainer) – The object to log information about.
• debugOnly – See the Log() function above.
• encoding – See the Log() function above.