2016-02-23 06:06:55 +00:00
|
|
|
Chardet: The Universal Character Encoding Detector
|
|
|
|
|
--------------------------------------------------
|
|
|
|
|
|
2018-12-15 00:08:54 +00:00
|
|
|
.. image:: https://img.shields.io/travis/chardet/chardet/stable.svg
|
|
|
|
|
:alt: Build status
|
|
|
|
|
:target: https://travis-ci.org/chardet/chardet
|
|
|
|
|
|
|
|
|
|
.. image:: https://img.shields.io/coveralls/chardet/chardet/stable.svg
|
|
|
|
|
:target: https://coveralls.io/r/chardet/chardet
|
|
|
|
|
|
|
|
|
|
.. image:: https://img.shields.io/pypi/v/chardet.svg
|
|
|
|
|
:target: https://warehouse.python.org/project/chardet/
|
|
|
|
|
:alt: Latest version on PyPI
|
|
|
|
|
|
|
|
|
|
.. image:: https://img.shields.io/pypi/l/chardet.svg
|
|
|
|
|
:alt: License
|
|
|
|
|
|
|
|
|
|
|
2016-02-23 06:06:55 +00:00
|
|
|
Detects
|
|
|
|
|
- ASCII, UTF-8, UTF-16 (2 variants), UTF-32 (4 variants)
|
|
|
|
|
- Big5, GB2312, EUC-TW, HZ-GB-2312, ISO-2022-CN (Traditional and Simplified Chinese)
|
|
|
|
|
- EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP (Japanese)
|
|
|
|
|
- EUC-KR, ISO-2022-KR (Korean)
|
|
|
|
|
- KOI8-R, MacCyrillic, IBM855, IBM866, ISO-8859-5, windows-1251 (Cyrillic)
|
|
|
|
|
- ISO-8859-5, windows-1251 (Bulgarian)
|
2018-12-15 00:08:54 +00:00
|
|
|
- ISO-8859-1, windows-1252 (Western European languages)
|
2016-02-23 06:06:55 +00:00
|
|
|
- ISO-8859-7, windows-1253 (Greek)
|
|
|
|
|
- ISO-8859-8, windows-1255 (Visual and Logical Hebrew)
|
|
|
|
|
- TIS-620 (Thai)
|
|
|
|
|
|
2018-12-15 00:08:54 +00:00
|
|
|
.. note::
|
|
|
|
|
Our ISO-8859-2 and windows-1250 (Hungarian) probers have been temporarily
|
|
|
|
|
disabled until we can retrain the models.
|
|
|
|
|
|
|
|
|
|
Requires Python 2.6, 2.7, or 3.3+.
|
2016-02-23 06:06:55 +00:00
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
Install from `PyPI <https://pypi.python.org/pypi/chardet>`_::
|
|
|
|
|
|
|
|
|
|
pip install chardet
|
|
|
|
|
|
2018-12-15 00:08:54 +00:00
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
For users, docs are now available at https://chardet.readthedocs.io/.
|
2016-02-23 06:06:55 +00:00
|
|
|
|
|
|
|
|
Command-line Tool
|
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
|
|
chardet comes with a command-line script which reports on the encodings of one
|
|
|
|
|
or more files::
|
|
|
|
|
|
|
|
|
|
% chardetect somefile someotherfile
|
|
|
|
|
somefile: windows-1252 with confidence 0.5
|
|
|
|
|
someotherfile: ascii with confidence 1.0
|
|
|
|
|
|
|
|
|
|
About
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
This is a continuation of Mark Pilgrim's excellent chardet. Previously, two
|
|
|
|
|
versions needed to be maintained: one that supported python 2.x and one that
|
|
|
|
|
supported python 3.x. We've recently merged with `Ian Cordasco <https://github.com/sigmavirus24>`_'s
|
|
|
|
|
`charade <https://github.com/sigmavirus24/charade>`_ fork, so now we have one
|
|
|
|
|
coherent version that works for Python 2.6+.
|
|
|
|
|
|
|
|
|
|
:maintainer: Dan Blanchard
|
|
|
|
|
|
|
|
|
|
|
