METADATA 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585
  1. Metadata-Version: 2.1
  2. Name: charset-normalizer
  3. Version: 3.0.1
  4. Summary: The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet.
  5. Home-page: https://github.com/Ousret/charset_normalizer
  6. Author: Ahmed TAHRI
  7. Author-email: ahmed.tahri@cloudnursery.dev
  8. License: MIT
  9. Project-URL: Bug Reports, https://github.com/Ousret/charset_normalizer/issues
  10. Project-URL: Documentation, https://charset-normalizer.readthedocs.io/en/latest
  11. Keywords: encoding,charset,charset-detector,detector,normalization,unicode,chardet,detect
  12. Classifier: Development Status :: 5 - Production/Stable
  13. Classifier: License :: OSI Approved :: MIT License
  14. Classifier: Intended Audience :: Developers
  15. Classifier: Topic :: Software Development :: Libraries :: Python Modules
  16. Classifier: Operating System :: OS Independent
  17. Classifier: Programming Language :: Python
  18. Classifier: Programming Language :: Python :: 3
  19. Classifier: Programming Language :: Python :: 3.6
  20. Classifier: Programming Language :: Python :: 3.7
  21. Classifier: Programming Language :: Python :: 3.8
  22. Classifier: Programming Language :: Python :: 3.9
  23. Classifier: Programming Language :: Python :: 3.10
  24. Classifier: Programming Language :: Python :: 3.11
  25. Classifier: Programming Language :: Python :: Implementation :: PyPy
  26. Classifier: Topic :: Text Processing :: Linguistic
  27. Classifier: Topic :: Utilities
  28. Classifier: Typing :: Typed
  29. Description-Content-Type: text/markdown
  30. License-File: LICENSE
  31. Provides-Extra: unicode_backport
  32. <h1 align="center">Charset Detection, for Everyone 👋 <a href="https://twitter.com/intent/tweet?text=The%20Real%20First%20Universal%20Charset%20%26%20Language%20Detector&url=https://www.github.com/Ousret/charset_normalizer&hashtags=python,encoding,chardet,developers"><img src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social"/></a></h1>
  33. <p align="center">
  34. <sup>The Real First Universal Charset Detector</sup><br>
  35. <a href="https://pypi.org/project/charset-normalizer">
  36. <img src="https://img.shields.io/pypi/pyversions/charset_normalizer.svg?orange=blue" />
  37. </a>
  38. <a href="https://codecov.io/gh/Ousret/charset_normalizer">
  39. <img src="https://codecov.io/gh/Ousret/charset_normalizer/branch/master/graph/badge.svg" />
  40. </a>
  41. <a href="https://pepy.tech/project/charset-normalizer/">
  42. <img alt="Download Count Total" src="https://pepy.tech/badge/charset-normalizer/month" />
  43. </a>
  44. </p>
  45. > A library that helps you read text from an unknown charset encoding.<br /> Motivated by `chardet`,
  46. > I'm trying to resolve the issue by taking a new approach.
  47. > All IANA character set names for which the Python core library provides codecs are supported.
  48. <p align="center">
  49. >>>>> <a href="https://charsetnormalizerweb.ousret.now.sh" target="_blank">👉 Try Me Online Now, Then Adopt Me 👈 </a> <<<<<
  50. </p>
  51. This project offers you an alternative to **Universal Charset Encoding Detector**, also known as **Chardet**.
  52. | Feature | [Chardet](https://github.com/chardet/chardet) | Charset Normalizer | [cChardet](https://github.com/PyYoshi/cChardet) |
  53. | ------------- | :-------------: | :------------------: | :------------------: |
  54. | `Fast` | ❌<br> | ✅<br> | ✅ <br> |
  55. | `Universal**` | ❌ | ✅ | ❌ |
  56. | `Reliable` **without** distinguishable standards | ❌ | ✅ | ✅ |
  57. | `Reliable` **with** distinguishable standards | ✅ | ✅ | ✅ |
  58. | `License` | LGPL-2.1<br>_restrictive_ | MIT | MPL-1.1<br>_restrictive_ |
  59. | `Native Python` | ✅ | ✅ | ❌ |
  60. | `Detect spoken language` | ❌ | ✅ | N/A |
  61. | `UnicodeDecodeError Safety` | ❌ | ✅ | ❌ |
  62. | `Whl Size` | 193.6 kB | 39.5 kB | ~200 kB |
  63. | `Supported Encoding` | 33 | :tada: [90](https://charset-normalizer.readthedocs.io/en/latest/user/support.html#supported-encodings) | 40
  64. <p align="center">
  65. <img src="https://i.imgflip.com/373iay.gif" alt="Reading Normalized Text" width="226"/><img src="https://media.tenor.com/images/c0180f70732a18b4965448d33adba3d0/tenor.gif" alt="Cat Reading Text" width="200"/>
  66. *\*\* : They are clearly using specific code for a specific encoding even if covering most of used one*<br>
  67. Did you got there because of the logs? See [https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html](https://charset-normalizer.readthedocs.io/en/latest/user/miscellaneous.html)
  68. ## ⭐ Your support
  69. *Fork, test-it, star-it, submit your ideas! We do listen.*
  70. ## ⚡ Performance
  71. This package offer better performance than its counterpart Chardet. Here are some numbers.
  72. | Package | Accuracy | Mean per file (ms) | File per sec (est) |
  73. | ------------- | :-------------: | :------------------: | :------------------: |
  74. | [chardet](https://github.com/chardet/chardet) | 86 % | 200 ms | 5 file/sec |
  75. | charset-normalizer | **98 %** | **10 ms** | 100 file/sec |
  76. | Package | 99th percentile | 95th percentile | 50th percentile |
  77. | ------------- | :-------------: | :------------------: | :------------------: |
  78. | [chardet](https://github.com/chardet/chardet) | 1200 ms | 287 ms | 23 ms |
  79. | charset-normalizer | 100 ms | 50 ms | 5 ms |
  80. Chardet's performance on larger file (1MB+) are very poor. Expect huge difference on large payload.
  81. > Stats are generated using 400+ files using default parameters. More details on used files, see GHA workflows.
  82. > And yes, these results might change at any time. The dataset can be updated to include more files.
  83. > The actual delays heavily depends on your CPU capabilities. The factors should remain the same.
  84. > Keep in mind that the stats are generous and that Chardet accuracy vs our is measured using Chardet initial capability
  85. > (eg. Supported Encoding) Challenge-them if you want.
  86. ## ✨ Installation
  87. Using PyPi for latest stable
  88. ```sh
  89. pip install charset-normalizer -U
  90. ```
  91. ## 🚀 Basic Usage
  92. ### CLI
  93. This package comes with a CLI.
  94. ```
  95. usage: normalizer [-h] [-v] [-a] [-n] [-m] [-r] [-f] [-t THRESHOLD]
  96. file [file ...]
  97. The Real First Universal Charset Detector. Discover originating encoding used
  98. on text file. Normalize text to unicode.
  99. positional arguments:
  100. files File(s) to be analysed
  101. optional arguments:
  102. -h, --help show this help message and exit
  103. -v, --verbose Display complementary information about file if any.
  104. Stdout will contain logs about the detection process.
  105. -a, --with-alternative
  106. Output complementary possibilities if any. Top-level
  107. JSON WILL be a list.
  108. -n, --normalize Permit to normalize input file. If not set, program
  109. does not write anything.
  110. -m, --minimal Only output the charset detected to STDOUT. Disabling
  111. JSON output.
  112. -r, --replace Replace file when trying to normalize it instead of
  113. creating a new one.
  114. -f, --force Replace file without asking if you are sure, use this
  115. flag with caution.
  116. -t THRESHOLD, --threshold THRESHOLD
  117. Define a custom maximum amount of chaos allowed in
  118. decoded content. 0. <= chaos <= 1.
  119. --version Show version information and exit.
  120. ```
  121. ```bash
  122. normalizer ./data/sample.1.fr.srt
  123. ```
  124. :tada: Since version 1.4.0 the CLI produce easily usable stdout result in JSON format.
  125. ```json
  126. {
  127. "path": "/home/default/projects/charset_normalizer/data/sample.1.fr.srt",
  128. "encoding": "cp1252",
  129. "encoding_aliases": [
  130. "1252",
  131. "windows_1252"
  132. ],
  133. "alternative_encodings": [
  134. "cp1254",
  135. "cp1256",
  136. "cp1258",
  137. "iso8859_14",
  138. "iso8859_15",
  139. "iso8859_16",
  140. "iso8859_3",
  141. "iso8859_9",
  142. "latin_1",
  143. "mbcs"
  144. ],
  145. "language": "French",
  146. "alphabets": [
  147. "Basic Latin",
  148. "Latin-1 Supplement"
  149. ],
  150. "has_sig_or_bom": false,
  151. "chaos": 0.149,
  152. "coherence": 97.152,
  153. "unicode_path": null,
  154. "is_preferred": true
  155. }
  156. ```
  157. ### Python
  158. *Just print out normalized text*
  159. ```python
  160. from charset_normalizer import from_path
  161. results = from_path('./my_subtitle.srt')
  162. print(str(results.best()))
  163. ```
  164. *Upgrade your code without effort*
  165. ```python
  166. from charset_normalizer import detect
  167. ```
  168. The above code will behave the same as **chardet**. We ensure that we offer the best (reasonable) BC result possible.
  169. See the docs for advanced usage : [readthedocs.io](https://charset-normalizer.readthedocs.io/en/latest/)
  170. ## 😇 Why
  171. When I started using Chardet, I noticed that it was not suited to my expectations, and I wanted to propose a
  172. reliable alternative using a completely different method. Also! I never back down on a good challenge!
  173. I **don't care** about the **originating charset** encoding, because **two different tables** can
  174. produce **two identical rendered string.**
  175. What I want is to get readable text, the best I can.
  176. In a way, **I'm brute forcing text decoding.** How cool is that ? 😎
  177. Don't confuse package **ftfy** with charset-normalizer or chardet. ftfy goal is to repair unicode string whereas charset-normalizer to convert raw file in unknown encoding to unicode.
  178. ## 🍰 How
  179. - Discard all charset encoding table that could not fit the binary content.
  180. - Measure chaos, or the mess once opened (by chunks) with a corresponding charset encoding.
  181. - Extract matches with the lowest mess detected.
  182. - Additionally, we measure coherence / probe for a language.
  183. **Wait a minute**, what is chaos/mess and coherence according to **YOU ?**
  184. *Chaos :* I opened hundred of text files, **written by humans**, with the wrong encoding table. **I observed**, then
  185. **I established** some ground rules about **what is obvious** when **it seems like** a mess.
  186. I know that my interpretation of what is chaotic is very subjective, feel free to contribute in order to
  187. improve or rewrite it.
  188. *Coherence :* For each language there is on earth, we have computed ranked letter appearance occurrences (the best we can). So I thought
  189. that intel is worth something here. So I use those records against decoded text to check if I can detect intelligent design.
  190. ## ⚡ Known limitations
  191. - Language detection is unreliable when text contains two or more languages sharing identical letters. (eg. HTML (english tags) + Turkish content (Sharing Latin characters))
  192. - Every charset detector heavily depends on sufficient content. In common cases, do not bother run detection on very tiny content.
  193. ## 👤 Contributing
  194. Contributions, issues and feature requests are very much welcome.<br />
  195. Feel free to check [issues page](https://github.com/ousret/charset_normalizer/issues) if you want to contribute.
  196. ## 📝 License
  197. Copyright © 2019 [Ahmed TAHRI @Ousret](https://github.com/Ousret).<br />
  198. This project is [MIT](https://github.com/Ousret/charset_normalizer/blob/master/LICENSE) licensed.
  199. Characters frequencies used in this project © 2012 [Denny Vrandečić](http://simia.net/letters/)
  200. # Changelog
  201. All notable changes to charset-normalizer will be documented in this file. This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
  202. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
  203. ## [3.0.1](https://github.com/Ousret/charset_normalizer/compare/3.0.0...3.0.1) (2022-11-18)
  204. ### Fixed
  205. - Multi-bytes cutter/chunk generator did not always cut correctly (PR #233)
  206. ### Changed
  207. - Speedup provided by mypy/c 0.990 on Python >= 3.7
  208. ## [3.0.0](https://github.com/Ousret/charset_normalizer/compare/2.1.1...3.0.0) (2022-10-20)
  209. ### Added
  210. - Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results
  211. - Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES
  212. - Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio
  213. - `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl)
  214. ### Changed
  215. - Build with static metadata using 'build' frontend
  216. - Make the language detection stricter
  217. - Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1
  218. ### Fixed
  219. - CLI with opt --normalize fail when using full path for files
  220. - TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it
  221. - Sphinx warnings when generating the documentation
  222. ### Removed
  223. - Coherence detector no longer return 'Simple English' instead return 'English'
  224. - Coherence detector no longer return 'Classical Chinese' instead return 'Chinese'
  225. - Breaking: Method `first()` and `best()` from CharsetMatch
  226. - UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII)
  227. - Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches
  228. - Breaking: Top-level function `normalize`
  229. - Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch
  230. - Support for the backport `unicodedata2`
  231. ## [3.0.0rc1](https://github.com/Ousret/charset_normalizer/compare/3.0.0b2...3.0.0rc1) (2022-10-18)
  232. ### Added
  233. - Extend the capability of explain=True when cp_isolation contains at most two entries (min one), will log in details of the Mess-detector results
  234. - Support for alternative language frequency set in charset_normalizer.assets.FREQUENCIES
  235. - Add parameter `language_threshold` in `from_bytes`, `from_path` and `from_fp` to adjust the minimum expected coherence ratio
  236. ### Changed
  237. - Build with static metadata using 'build' frontend
  238. - Make the language detection stricter
  239. ### Fixed
  240. - CLI with opt --normalize fail when using full path for files
  241. - TooManyAccentuatedPlugin induce false positive on the mess detection when too few alpha character have been fed to it
  242. ### Removed
  243. - Coherence detector no longer return 'Simple English' instead return 'English'
  244. - Coherence detector no longer return 'Classical Chinese' instead return 'Chinese'
  245. ## [3.0.0b2](https://github.com/Ousret/charset_normalizer/compare/3.0.0b1...3.0.0b2) (2022-08-21)
  246. ### Added
  247. - `normalizer --version` now specify if current version provide extra speedup (meaning mypyc compilation whl)
  248. ### Removed
  249. - Breaking: Method `first()` and `best()` from CharsetMatch
  250. - UTF-7 will no longer appear as "detected" without a recognized SIG/mark (is unreliable/conflict with ASCII)
  251. ### Fixed
  252. - Sphinx warnings when generating the documentation
  253. ## [3.0.0b1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...3.0.0b1) (2022-08-15)
  254. ### Changed
  255. - Optional: Module `md.py` can be compiled using Mypyc to provide an extra speedup up to 4x faster than v2.1
  256. ### Removed
  257. - Breaking: Class aliases CharsetDetector, CharsetDoctor, CharsetNormalizerMatch and CharsetNormalizerMatches
  258. - Breaking: Top-level function `normalize`
  259. - Breaking: Properties `chaos_secondary_pass`, `coherence_non_latin` and `w_counter` from CharsetMatch
  260. - Support for the backport `unicodedata2`
  261. ## [2.1.1](https://github.com/Ousret/charset_normalizer/compare/2.1.0...2.1.1) (2022-08-19)
  262. ### Deprecated
  263. - Function `normalize` scheduled for removal in 3.0
  264. ### Changed
  265. - Removed useless call to decode in fn is_unprintable (#206)
  266. ### Fixed
  267. - Third-party library (i18n xgettext) crashing not recognizing utf_8 (PEP 263) with underscore from [@aleksandernovikov](https://github.com/aleksandernovikov) (#204)
  268. ## [2.1.0](https://github.com/Ousret/charset_normalizer/compare/2.0.12...2.1.0) (2022-06-19)
  269. ### Added
  270. - Output the Unicode table version when running the CLI with `--version` (PR #194)
  271. ### Changed
  272. - Re-use decoded buffer for single byte character sets from [@nijel](https://github.com/nijel) (PR #175)
  273. - Fixing some performance bottlenecks from [@deedy5](https://github.com/deedy5) (PR #183)
  274. ### Fixed
  275. - Workaround potential bug in cpython with Zero Width No-Break Space located in Arabic Presentation Forms-B, Unicode 1.1 not acknowledged as space (PR #175)
  276. - CLI default threshold aligned with the API threshold from [@oleksandr-kuzmenko](https://github.com/oleksandr-kuzmenko) (PR #181)
  277. ### Removed
  278. - Support for Python 3.5 (PR #192)
  279. ### Deprecated
  280. - Use of backport unicodedata from `unicodedata2` as Python is quickly catching up, scheduled for removal in 3.0 (PR #194)
  281. ## [2.0.12](https://github.com/Ousret/charset_normalizer/compare/2.0.11...2.0.12) (2022-02-12)
  282. ### Fixed
  283. - ASCII miss-detection on rare cases (PR #170)
  284. ## [2.0.11](https://github.com/Ousret/charset_normalizer/compare/2.0.10...2.0.11) (2022-01-30)
  285. ### Added
  286. - Explicit support for Python 3.11 (PR #164)
  287. ### Changed
  288. - The logging behavior have been completely reviewed, now using only TRACE and DEBUG levels (PR #163 #165)
  289. ## [2.0.10](https://github.com/Ousret/charset_normalizer/compare/2.0.9...2.0.10) (2022-01-04)
  290. ### Fixed
  291. - Fallback match entries might lead to UnicodeDecodeError for large bytes sequence (PR #154)
  292. ### Changed
  293. - Skipping the language-detection (CD) on ASCII (PR #155)
  294. ## [2.0.9](https://github.com/Ousret/charset_normalizer/compare/2.0.8...2.0.9) (2021-12-03)
  295. ### Changed
  296. - Moderating the logging impact (since 2.0.8) for specific environments (PR #147)
  297. ### Fixed
  298. - Wrong logging level applied when setting kwarg `explain` to True (PR #146)
  299. ## [2.0.8](https://github.com/Ousret/charset_normalizer/compare/2.0.7...2.0.8) (2021-11-24)
  300. ### Changed
  301. - Improvement over Vietnamese detection (PR #126)
  302. - MD improvement on trailing data and long foreign (non-pure latin) data (PR #124)
  303. - Efficiency improvements in cd/alphabet_languages from [@adbar](https://github.com/adbar) (PR #122)
  304. - call sum() without an intermediary list following PEP 289 recommendations from [@adbar](https://github.com/adbar) (PR #129)
  305. - Code style as refactored by Sourcery-AI (PR #131)
  306. - Minor adjustment on the MD around european words (PR #133)
  307. - Remove and replace SRTs from assets / tests (PR #139)
  308. - Initialize the library logger with a `NullHandler` by default from [@nmaynes](https://github.com/nmaynes) (PR #135)
  309. - Setting kwarg `explain` to True will add provisionally (bounded to function lifespan) a specific stream handler (PR #135)
  310. ### Fixed
  311. - Fix large (misleading) sequence giving UnicodeDecodeError (PR #137)
  312. - Avoid using too insignificant chunk (PR #137)
  313. ### Added
  314. - Add and expose function `set_logging_handler` to configure a specific StreamHandler from [@nmaynes](https://github.com/nmaynes) (PR #135)
  315. - Add `CHANGELOG.md` entries, format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) (PR #141)
  316. ## [2.0.7](https://github.com/Ousret/charset_normalizer/compare/2.0.6...2.0.7) (2021-10-11)
  317. ### Added
  318. - Add support for Kazakh (Cyrillic) language detection (PR #109)
  319. ### Changed
  320. - Further, improve inferring the language from a given single-byte code page (PR #112)
  321. - Vainly trying to leverage PEP263 when PEP3120 is not supported (PR #116)
  322. - Refactoring for potential performance improvements in loops from [@adbar](https://github.com/adbar) (PR #113)
  323. - Various detection improvement (MD+CD) (PR #117)
  324. ### Removed
  325. - Remove redundant logging entry about detected language(s) (PR #115)
  326. ### Fixed
  327. - Fix a minor inconsistency between Python 3.5 and other versions regarding language detection (PR #117 #102)
  328. ## [2.0.6](https://github.com/Ousret/charset_normalizer/compare/2.0.5...2.0.6) (2021-09-18)
  329. ### Fixed
  330. - Unforeseen regression with the loss of the backward-compatibility with some older minor of Python 3.5.x (PR #100)
  331. - Fix CLI crash when using --minimal output in certain cases (PR #103)
  332. ### Changed
  333. - Minor improvement to the detection efficiency (less than 1%) (PR #106 #101)
  334. ## [2.0.5](https://github.com/Ousret/charset_normalizer/compare/2.0.4...2.0.5) (2021-09-14)
  335. ### Changed
  336. - The project now comply with: flake8, mypy, isort and black to ensure a better overall quality (PR #81)
  337. - The BC-support with v1.x was improved, the old staticmethods are restored (PR #82)
  338. - The Unicode detection is slightly improved (PR #93)
  339. - Add syntax sugar \_\_bool\_\_ for results CharsetMatches list-container (PR #91)
  340. ### Removed
  341. - The project no longer raise warning on tiny content given for detection, will be simply logged as warning instead (PR #92)
  342. ### Fixed
  343. - In some rare case, the chunks extractor could cut in the middle of a multi-byte character and could mislead the mess detection (PR #95)
  344. - Some rare 'space' characters could trip up the UnprintablePlugin/Mess detection (PR #96)
  345. - The MANIFEST.in was not exhaustive (PR #78)
  346. ## [2.0.4](https://github.com/Ousret/charset_normalizer/compare/2.0.3...2.0.4) (2021-07-30)
  347. ### Fixed
  348. - The CLI no longer raise an unexpected exception when no encoding has been found (PR #70)
  349. - Fix accessing the 'alphabets' property when the payload contains surrogate characters (PR #68)
  350. - The logger could mislead (explain=True) on detected languages and the impact of one MBCS match (PR #72)
  351. - Submatch factoring could be wrong in rare edge cases (PR #72)
  352. - Multiple files given to the CLI were ignored when publishing results to STDOUT. (After the first path) (PR #72)
  353. - Fix line endings from CRLF to LF for certain project files (PR #67)
  354. ### Changed
  355. - Adjust the MD to lower the sensitivity, thus improving the global detection reliability (PR #69 #76)
  356. - Allow fallback on specified encoding if any (PR #71)
  357. ## [2.0.3](https://github.com/Ousret/charset_normalizer/compare/2.0.2...2.0.3) (2021-07-16)
  358. ### Changed
  359. - Part of the detection mechanism has been improved to be less sensitive, resulting in more accurate detection results. Especially ASCII. (PR #63)
  360. - According to the community wishes, the detection will fall back on ASCII or UTF-8 in a last-resort case. (PR #64)
  361. ## [2.0.2](https://github.com/Ousret/charset_normalizer/compare/2.0.1...2.0.2) (2021-07-15)
  362. ### Fixed
  363. - Empty/Too small JSON payload miss-detection fixed. Report from [@tseaver](https://github.com/tseaver) (PR #59)
  364. ### Changed
  365. - Don't inject unicodedata2 into sys.modules from [@akx](https://github.com/akx) (PR #57)
  366. ## [2.0.1](https://github.com/Ousret/charset_normalizer/compare/2.0.0...2.0.1) (2021-07-13)
  367. ### Fixed
  368. - Make it work where there isn't a filesystem available, dropping assets frequencies.json. Report from [@sethmlarson](https://github.com/sethmlarson). (PR #55)
  369. - Using explain=False permanently disable the verbose output in the current runtime (PR #47)
  370. - One log entry (language target preemptive) was not show in logs when using explain=True (PR #47)
  371. - Fix undesired exception (ValueError) on getitem of instance CharsetMatches (PR #52)
  372. ### Changed
  373. - Public function normalize default args values were not aligned with from_bytes (PR #53)
  374. ### Added
  375. - You may now use charset aliases in cp_isolation and cp_exclusion arguments (PR #47)
  376. ## [2.0.0](https://github.com/Ousret/charset_normalizer/compare/1.4.1...2.0.0) (2021-07-02)
  377. ### Changed
  378. - 4x to 5 times faster than the previous 1.4.0 release. At least 2x faster than Chardet.
  379. - Accent has been made on UTF-8 detection, should perform rather instantaneous.
  380. - The backward compatibility with Chardet has been greatly improved. The legacy detect function returns an identical charset name whenever possible.
  381. - The detection mechanism has been slightly improved, now Turkish content is detected correctly (most of the time)
  382. - The program has been rewritten to ease the readability and maintainability. (+Using static typing)+
  383. - utf_7 detection has been reinstated.
  384. ### Removed
  385. - This package no longer require anything when used with Python 3.5 (Dropped cached_property)
  386. - Removed support for these languages: Catalan, Esperanto, Kazakh, Baque, Volapük, Azeri, Galician, Nynorsk, Macedonian, and Serbocroatian.
  387. - The exception hook on UnicodeDecodeError has been removed.
  388. ### Deprecated
  389. - Methods coherence_non_latin, w_counter, chaos_secondary_pass of the class CharsetMatch are now deprecated and scheduled for removal in v3.0
  390. ### Fixed
  391. - The CLI output used the relative path of the file(s). Should be absolute.
  392. ## [1.4.1](https://github.com/Ousret/charset_normalizer/compare/1.4.0...1.4.1) (2021-05-28)
  393. ### Fixed
  394. - Logger configuration/usage no longer conflict with others (PR #44)
  395. ## [1.4.0](https://github.com/Ousret/charset_normalizer/compare/1.3.9...1.4.0) (2021-05-21)
  396. ### Removed
  397. - Using standard logging instead of using the package loguru.
  398. - Dropping nose test framework in favor of the maintained pytest.
  399. - Choose to not use dragonmapper package to help with gibberish Chinese/CJK text.
  400. - Require cached_property only for Python 3.5 due to constraint. Dropping for every other interpreter version.
  401. - Stop support for UTF-7 that does not contain a SIG.
  402. - Dropping PrettyTable, replaced with pure JSON output in CLI.
  403. ### Fixed
  404. - BOM marker in a CharsetNormalizerMatch instance could be False in rare cases even if obviously present. Due to the sub-match factoring process.
  405. - Not searching properly for the BOM when trying utf32/16 parent codec.
  406. ### Changed
  407. - Improving the package final size by compressing frequencies.json.
  408. - Huge improvement over the larges payload.
  409. ### Added
  410. - CLI now produces JSON consumable output.
  411. - Return ASCII if given sequences fit. Given reasonable confidence.
  412. ## [1.3.9](https://github.com/Ousret/charset_normalizer/compare/1.3.8...1.3.9) (2021-05-13)
  413. ### Fixed
  414. - In some very rare cases, you may end up getting encode/decode errors due to a bad bytes payload (PR #40)
  415. ## [1.3.8](https://github.com/Ousret/charset_normalizer/compare/1.3.7...1.3.8) (2021-05-12)
  416. ### Fixed
  417. - Empty given payload for detection may cause an exception if trying to access the `alphabets` property. (PR #39)
  418. ## [1.3.7](https://github.com/Ousret/charset_normalizer/compare/1.3.6...1.3.7) (2021-05-12)
  419. ### Fixed
  420. - The legacy detect function should return UTF-8-SIG if sig is present in the payload. (PR #38)
  421. ## [1.3.6](https://github.com/Ousret/charset_normalizer/compare/1.3.5...1.3.6) (2021-02-09)
  422. ### Changed
  423. - Amend the previous release to allow prettytable 2.0 (PR #35)
  424. ## [1.3.5](https://github.com/Ousret/charset_normalizer/compare/1.3.4...1.3.5) (2021-02-08)
  425. ### Fixed
  426. - Fix error while using the package with a python pre-release interpreter (PR #33)
  427. ### Changed
  428. - Dependencies refactoring, constraints revised.
  429. ### Added
  430. - Add python 3.9 and 3.10 to the supported interpreters
  431. MIT License
  432. Copyright (c) 2019 TAHRI Ahmed R.
  433. Permission is hereby granted, free of charge, to any person obtaining a copy
  434. of this software and associated documentation files (the "Software"), to deal
  435. in the Software without restriction, including without limitation the rights
  436. to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  437. copies of the Software, and to permit persons to whom the Software is
  438. furnished to do so, subject to the following conditions:
  439. The above copyright notice and this permission notice shall be included in all
  440. copies or substantial portions of the Software.
  441. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  442. IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  443. FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  444. AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  445. LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  446. OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  447. SOFTWARE.