'Select test cases and remove others from this suite.
Parameters have the same semantics as ``--suite``, ``--test``,
``--include``, and ``--exclude`` command line options. All of them
can be given as a list of strings, or when selecting only one, as
a single string.
Child suites that contain no tests after filtering are automatically
removed.
Example::
suite.filter(included_tests=[\'Test 1\', \'* Example\'],
included_tags=\'priority-1\')'

def filter(self, included_suites=None, included_tests=None, included_tags=None, excluded_tags=None):

    self.visit(Filter(included_suites, included_tests, included_tags, excluded_tags))
