Handler instances dispatch logging events to specific destinations. The base handler class. Acts as a placeholder which defines the Handler interface. Handlers can optionally use Formatter instances to format records as desired. By default, no formatter is specified; in this c
| 871 | _releaseLock() |
| 872 | |
| 873 | class Handler(Filterer): |
| 874 | """ |
| 875 | Handler instances dispatch logging events to specific destinations. |
| 876 | |
| 877 | The base handler class. Acts as a placeholder which defines the Handler |
| 878 | interface. Handlers can optionally use Formatter instances to format |
| 879 | records as desired. By default, no formatter is specified; in this case, |
| 880 | the 'raw' message as determined by record.message is logged. |
| 881 | """ |
| 882 | def __init__(self, level=NOTSET): |
| 883 | """ |
| 884 | Initializes the instance - basically setting the formatter to None |
| 885 | and the filter list to empty. |
| 886 | """ |
| 887 | Filterer.__init__(self) |
| 888 | self._name = None |
| 889 | self.level = _checkLevel(level) |
| 890 | self.formatter = None |
| 891 | self._closed = False |
| 892 | # Add the handler to the global _handlerList (for cleanup on shutdown) |
| 893 | _addHandlerRef(self) |
| 894 | self.createLock() |
| 895 | |
| 896 | def get_name(self): |
| 897 | return self._name |
| 898 | |
| 899 | def set_name(self, name): |
| 900 | _acquireLock() |
| 901 | try: |
| 902 | if self._name in _handlers: |
| 903 | del _handlers[self._name] |
| 904 | self._name = name |
| 905 | if name: |
| 906 | _handlers[name] = self |
| 907 | finally: |
| 908 | _releaseLock() |
| 909 | |
| 910 | name = property(get_name, set_name) |
| 911 | |
| 912 | def createLock(self): |
| 913 | """ |
| 914 | Acquire a thread lock for serializing access to the underlying I/O. |
| 915 | """ |
| 916 | self.lock = threading.RLock() |
| 917 | _register_at_fork_reinit_lock(self) |
| 918 | |
| 919 | def _at_fork_reinit(self): |
| 920 | self.lock._at_fork_reinit() |
| 921 | |
| 922 | def acquire(self): |
| 923 | """ |
| 924 | Acquire the I/O thread lock. |
| 925 | """ |
| 926 | if self.lock: |
| 927 | self.lock.acquire() |
| 928 | |
| 929 | def release(self): |
| 930 | """ |