fonttools/Lib/fontTools/__init__.py

from __future__ import print_function, division, absolute_import
from fontTools.misc.py23 import *
import logging
from fontTools.misc.loggingTools import Logger, configLogger

# set the logging.Logger class to one which supports the "last resort" handler,
# to be used when the client doesn't explicitly configure logging.
# It prints the bare message to sys.stderr, only for events of severity WARNING
# or greater.
logging.setLoggerClass(Logger)

log = logging.getLogger(__name__)

version = "3.0"

__all__ = ["version", "log", "configLogger"]
Add standard imports to all python sources Previously, the trivial files didn't have them. 2015-04-14 17:26:59 -07:00			`from __future__ import print_function, division, absolute_import`
			`from fontTools.misc.py23 import *`
[fontTools.__init__] add NullHandler to avoid "no handlers could be found" error. 2016-01-24 14:20:59 +00:00			`import logging`
[fontTools.__init__] use 'lastResort' handler instead of NullHandler I think it's better to follow the current Python 3 behavior in the situation where the user doesn't provide any explicit logging configuration. Before Python 3.2, when no handlers were found when a logging event occurred, either the events would be silently dropped (if logging.raiseExceptions is set to False), or it would throw a single "No handlers could be found" warning (this was the default behavior). With Python 3.2 and later, the default behavior is that the events are output using a "handler of last resort". The latter works like StreamHandler that writes messages (without formatting) to the current value of sys.stderr (thus respecting any redirections which may be in effect). 2016-01-29 18:44:43 +00:00			`from fontTools.misc.loggingTools import Logger, configLogger`
[fontTools.__init__] add NullHandler to avoid "no handlers could be found" error. 2016-01-24 14:20:59 +00:00
[fontTools.__init__] use 'lastResort' handler instead of NullHandler I think it's better to follow the current Python 3 behavior in the situation where the user doesn't provide any explicit logging configuration. Before Python 3.2, when no handlers were found when a logging event occurred, either the events would be silently dropped (if logging.raiseExceptions is set to False), or it would throw a single "No handlers could be found" warning (this was the default behavior). With Python 3.2 and later, the default behavior is that the events are output using a "handler of last resort". The latter works like StreamHandler that writes messages (without formatting) to the current value of sys.stderr (thus respecting any redirections which may be in effect). 2016-01-29 18:44:43 +00:00			`# set the logging.Logger class to one which supports the "last resort" handler,`
			`# to be used when the client doesn't explicitly configure logging.`
			`# It prints the bare message to sys.stderr, only for events of severity WARNING`
			`# or greater.`
			`logging.setLoggerClass(Logger)`
Add standard imports to all python sources Previously, the trivial files didn't have them. 2015-04-14 17:26:59 -07:00
[fontTools.__init__] use 'lastResort' handler instead of NullHandler I think it's better to follow the current Python 3 behavior in the situation where the user doesn't provide any explicit logging configuration. Before Python 3.2, when no handlers were found when a logging event occurred, either the events would be silently dropped (if logging.raiseExceptions is set to False), or it would throw a single "No handlers could be found" warning (this was the default behavior). With Python 3.2 and later, the default behavior is that the events are output using a "handler of last resort". The latter works like StreamHandler that writes messages (without formatting) to the current value of sys.stderr (thus respecting any redirections which may be in effect). 2016-01-29 18:44:43 +00:00			`log = logging.getLogger(__name__)`
[fontTools.__init__] export 'configLogger' in the top-level module to make it easier for clients to import 2016-01-24 14:21:38 +00:00
3.0 2015-08-31 18:57:15 +01:00			`version = "3.0"`
[fontTools.__init__] export 'configLogger' in the top-level module to make it easier for clients to import 2016-01-24 14:21:38 +00:00
			`__all__ = ["version", "log", "configLogger"]`