1"""
2Charset-Normalizer
3~~~~~~~~~~~~~~
4The Real First Universal Charset Detector.
5A library that helps you read text from an unknown charset encoding.
6Motivated by chardet, This package is trying to resolve the issue by taking a new approach.
7All IANA character set names for which the Python core library provides codecs are supported.
8
9Basic usage:
10 >>> from charset_normalizer import from_bytes
11 >>> results = from_bytes('Bсеки човек има право на образование. Oбразованието!'.encode('utf_8'))
12 >>> best_guess = results.best()
13 >>> str(best_guess)
14 'Bсеки човек има право на образование. Oбразованието!'
15
16Others methods and usages are available - see the full documentation
17at <https://github.com/Ousret/charset_normalizer>.
18:copyright: (c) 2021 by Ahmed TAHRI
19:license: MIT, see LICENSE for more details.
20"""
21
22from __future__ import annotations
23
24import logging
25
26from .api import from_bytes, from_fp, from_path, is_binary
27from .legacy import detect
28from .models import CharsetMatch, CharsetMatches
29from .utils import set_logging_handler
30from .version import VERSION, __version__
31
32__all__ = (
33 "from_fp",
34 "from_path",
35 "from_bytes",
36 "is_binary",
37 "detect",
38 "CharsetMatch",
39 "CharsetMatches",
40 "__version__",
41 "VERSION",
42 "set_logging_handler",
43)
44
45# Attach a NullHandler to the top level logger by default
46# https://docs.python.org/3.3/howto/logging.html#configuring-logging-for-a-library
47
48logging.getLogger("charset_normalizer").addHandler(logging.NullHandler())