1 ######################## BEGIN LICENSE BLOCK ########################
2 # The Original Code is Mozilla Universal charset detector code.
4 # The Initial Developer of the Original Code is
5 # Netscape Communications Corporation.
6 # Portions created by the Initial Developer are Copyright (C) 2001
7 # the Initial Developer. All Rights Reserved.
10 # Mark Pilgrim - port to Python
11 # Shy Shalom - original C code
13 # This library is free software; you can redistribute it and/or
14 # modify it under the terms of the GNU Lesser General Public
15 # License as published by the Free Software Foundation; either
16 # version 2.1 of the License, or (at your option) any later version.
18 # This library is distributed in the hope that it will be useful,
19 # but WITHOUT ANY WARRANTY; without even the implied warranty of
20 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
21 # Lesser General Public License for more details.
23 # You should have received a copy of the GNU Lesser General Public
24 # License along with this library; if not, write to the Free Software
25 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
27 ######################### END LICENSE BLOCK #########################
29 from . import constants
32 from .latin1prober import Latin1Prober # windows-1252
33 from .mbcsgroupprober import MBCSGroupProber # multi-byte character sets
34 from .sbcsgroupprober import SBCSGroupProber # single-byte character sets
35 from .escprober import EscCharSetProber # ISO-2122, etc.
38 MINIMUM_THRESHOLD = 0.20
44 class UniversalDetector:
46 self._highBitDetector = re.compile(b'[\x80-\xFF]')
47 self._escDetector = re.compile(b'(\033|~{)')
48 self._mEscCharSetProber = None
49 self._mCharSetProbers = []
53 self.result = {'encoding': None, 'confidence': 0.0}
56 self._mGotData = False
57 self._mInputState = ePureAscii
59 if self._mEscCharSetProber:
60 self._mEscCharSetProber.reset()
61 for prober in self._mCharSetProbers:
72 if not self._mGotData:
73 # If the data starts with BOM, we know it is UTF
74 if aBuf[:3] == codecs.BOM_UTF8:
75 # EF BB BF UTF-8 with BOM
76 self.result = {'encoding': "UTF-8-SIG", 'confidence': 1.0}
77 elif aBuf[:4] == codecs.BOM_UTF32_LE:
78 # FF FE 00 00 UTF-32, little-endian BOM
79 self.result = {'encoding': "UTF-32LE", 'confidence': 1.0}
80 elif aBuf[:4] == codecs.BOM_UTF32_BE:
81 # 00 00 FE FF UTF-32, big-endian BOM
82 self.result = {'encoding': "UTF-32BE", 'confidence': 1.0}
83 elif aBuf[:4] == b'\xFE\xFF\x00\x00':
84 # FE FF 00 00 UCS-4, unusual octet order BOM (3412)
86 'encoding': "X-ISO-10646-UCS-4-3412",
89 elif aBuf[:4] == b'\x00\x00\xFF\xFE':
90 # 00 00 FF FE UCS-4, unusual octet order BOM (2143)
92 'encoding': "X-ISO-10646-UCS-4-2143",
95 elif aBuf[:2] == codecs.BOM_LE:
96 # FF FE UTF-16, little endian BOM
97 self.result = {'encoding': "UTF-16LE", 'confidence': 1.0}
98 elif aBuf[:2] == codecs.BOM_BE:
99 # FE FF UTF-16, big endian BOM
100 self.result = {'encoding': "UTF-16BE", 'confidence': 1.0}
102 self._mGotData = True
103 if self.result['encoding'] and (self.result['confidence'] > 0.0):
107 if self._mInputState == ePureAscii:
108 if self._highBitDetector.search(aBuf):
109 self._mInputState = eHighbyte
110 elif ((self._mInputState == ePureAscii) and
111 self._escDetector.search(self._mLastChar + aBuf)):
112 self._mInputState = eEscAscii
114 self._mLastChar = aBuf[-1:]
116 if self._mInputState == eEscAscii:
117 if not self._mEscCharSetProber:
118 self._mEscCharSetProber = EscCharSetProber()
119 if self._mEscCharSetProber.feed(aBuf) == constants.eFoundIt:
120 self.result = {'encoding': self._mEscCharSetProber.get_charset_name(),
121 'confidence': self._mEscCharSetProber.get_confidence()}
123 elif self._mInputState == eHighbyte:
124 if not self._mCharSetProbers:
125 self._mCharSetProbers = [MBCSGroupProber(), SBCSGroupProber(),
127 for prober in self._mCharSetProbers:
128 if prober.feed(aBuf) == constants.eFoundIt:
129 self.result = {'encoding': prober.get_charset_name(),
130 'confidence': prober.get_confidence()}
137 if not self._mGotData:
139 sys.stderr.write('no data received!\n')
143 if self._mInputState == ePureAscii:
144 self.result = {'encoding': 'ascii', 'confidence': 1.0}
147 if self._mInputState == eHighbyte:
148 proberConfidence = None
149 maxProberConfidence = 0.0
151 for prober in self._mCharSetProbers:
154 proberConfidence = prober.get_confidence()
155 if proberConfidence > maxProberConfidence:
156 maxProberConfidence = proberConfidence
158 if maxProber and (maxProberConfidence > MINIMUM_THRESHOLD):
159 self.result = {'encoding': maxProber.get_charset_name(),
160 'confidence': maxProber.get_confidence()}
164 sys.stderr.write('no probers hit minimum threshhold\n')
165 for prober in self._mCharSetProbers[0].mProbers:
168 sys.stderr.write('%s confidence = %s\n' %
169 (prober.get_charset_name(),
170 prober.get_confidence()))