Process an input source, producing SAX events. The *source* object can be a

system identifier (a string identifying the input source -- typically a file

name or a URL), a file-like object, or an :class:`InputSource` object. When

:meth:`parse` returns, the input is completely processed, and the parser object

can be discarded or reset.

name or a URL), a :class:`~pathlib.Path` object, a file-like object or an

:class:`InputSource` object. When :meth:`parse` returns, the input is

completely processed, and the parser object can be discarded or reset.

.. versionchanged:: 3.5

Added support of character streams.

.. versionchanged:: 3.8

Added support of :class:`~pathlib.Path` objects.

.. method:: XMLReader.getContentHandler()

from io import BytesIO, StringIO

import codecs

import os.path

import pathlib

import shutil

from urllib.error import URLError

from test import support

with self.assertRaises(SAXException):

self.check_parse(f)

def test_parse_path_object(self):

make_xml_file(self.data, 'utf-8', None)

self.check_parse(pathlib.Path(TESTFN))

def test_parse_InputSource(self):

# accept data without declared but with explicitly specified encoding

make_xml_file(self.data, 'iso-8859-1', None)

self.checkContent(prep.getByteStream(),

b"This was read from a file.")

def test_path_objects(self):

# If the source is a Path object, use it as a system ID and open it.

prep = prepare_input_source(pathlib.Path(self.file))

self.assertIsNone(prep.getCharacterStream())

self.checkContent(prep.getByteStream(),

b"This was read from a file.")

def test_binary_file(self):

# If the source is a binary file-like object, use it as a byte

# stream.

"""This function takes an InputSource and an optional base URL and

returns a fully resolved InputSource object ready for reading."""

if isinstance(source, os.PathLike):

source = os.fspath(source)

if isinstance(source, str):

source = xmlreader.InputSource(source)

elif hasattr(source, "read"):

Make xml.sax.parse accepting Path objects. Patch by Mickaël Schoentgen.