suppress_warnings.record(category=<type 'exceptions.Warning'>, message='', module=None)[source]

Append a new recording filter or apply it if the state is entered.

All warnings matching will be appended to the log attribute.


category : class, optional

Warning class to filter

message : string, optional

Regular expression matching the warning message.

module : module, optional

Module to filter for. Note that the module (and its file) must match exactly and cannot be a submodule. This may make it unreliable for external modules.


log : list

A list which will be filled with all matched warnings.


When added within a context, filters are only added inside the context and will be forgotten when the context is exited.