class_docstr: ConfigParser that partially mimics RawConfigParser but for toml files.
  
  See RawConfigParser for more info. Also, please note that not all
  RawConfigParser functionality is implemented, but only the subset that is
  currently used by pydocstyle.
class_docstr_tok: ["ConfigParser","that","partially","mimics","RawConfigParser","but","for","toml","files",".","See","RawConfigParser","for","more","info",".","Also",",","please","note","that","not","all","RawConfigParser","functionality","is","implemented",",","but","only","the","subset","that","is","currently","used","by","pydocstyle","."]
docstr: Read and parse a filename or an iterable of filenames.
  
  Files that cannot be opened are silently ignored; this is
  designed so that you can specify an iterable of potential
  configuration file locations (e.g. current directory, user's
  home directory, systemwide directory), and all existing
  configuration files in the iterable will be read.  A single
  filename may also be given.
  
  Return list of successfully read files.
docstr_tok: ["Read","and","parse","a","filename","or","an","iterable","of","filenames",".","Files","that","can","not","be","opened","are","silently","ignored",";","this","is","designed","so","that","you","can","specify","an","iterable","of","potential","configuration","file","locations","(","e.g",".","current","directory",",","user's","home","directory",",","systemwide","directory",")",",","and","all","existing","configuration","files","in","the","iterable","will","be","read",".","A","single","filename","may","also","be","given",".","Return","list","of","successfully","read","files","."]
code: def read(self, filenames, encoding=None):
      """Read and parse a filename or an iterable of filenames.
  
      Files that cannot be opened are silently ignored; this is
      designed so that you can specify an iterable of potential
      configuration file locations (e.g. current directory, user's
      home directory, systemwide directory), and all existing
      configuration files in the iterable will be read.  A single
      filename may also be given.
  
      Return list of successfully read files.
      """
      if isinstance(filenames, (str, bytes, os.PathLike)):
          filenames = [filenames]
      read_ok = []
      for filename in filenames:
          try:
              with open(filename, "rb") as fp:
                  if not tomllib:
                      log.warning(
                          "The %s configuration file was ignored, "
                          "because the `tomli` package is not installed.",
                          filename,
                      )
                      continue
                  self._config.update(tomllib.load(fp))
          except OSError:
              continue
          if isinstance(filename, os.PathLike):
              filename = os.fspath(filename)
          read_ok.append(filename)
      return read_ok
  
imports: import copy
  import itertools
  import operator
  import os
  import sys
  from collections import namedtuple
  from collections.abc import Set
  from configparser import NoOptionError, NoSectionError, RawConfigParser
  from functools import reduce
  from re import compile
  from ._version import __version__
  from .utils import log
  from .violations import ErrorRegistry, conventions
label_desc: Use image node_id 2 for calling the TomlParser obj's underlying member method code with example usage: obj.read(filenames, encoding) and returns: read_ok