unicode-stats 0.3.1

Tool to analyze unicode content

Unicode Stats

Fast analysis of Unicode symbols

Purpose: quickly detect hallucinations such as hieroglyphs and Ukrainian language in various benchmarks

Fast and convenient wrapper for https://www.unicode.org/Public/UNIDATA/Blocks.txt

Usage

Extract Unicode Blocks / Detect Language

from unicode_stats import unicode_block_parser

# Get all symbols
example_text = 'краї́中land'
print(unicode_block_parser.get_stats(example_text))
# > {'Cyrillic (Russian)': {'n': 3, 'symbols': 'арк'}, 'Cyrillic (Ukranian)': {'n': 1, 'symbols': 'ї'}, 'Combining Diacritical Marks': {'n': 1, 'symbols': '́'}, 'CJK Unified Ideographs': {'n': 1, 'symbols': '中'}, 'Basic Latin': {'n': 4, 'symbols': 'lnda'}}

# Get main language
example_text = 'краї́'
print(unicode_block_parser.get_lang(example_text))
# > Cyrillic (Ukranian)

# Get all languages
example_text = 'краї́'
print(unicode_block_parser.get_lang(example_text, return_main_lang=False))
# > ru,Cyrillic (Ukranian),Combining Diacritical Marks

unicode_block_parser.get_single_block("х")
# > Cyrillic (Russian)

Generate Statistics for JSONL Files

Python

from unicode_stats.aggregation import AggregatedUnicodeBlockParser
agregated_parser = AggregatedUnicodeBlockParser(columns = "qwen", max_lines=1)
agregated_parser.get_stats("3model_cp.jsonl")

	block	column	n	rate	symbols	n_symbols	rows	example_first	example_last
0	Cyrilic (Russian)	qwen	2161	0.777	оеаи	57234	[0, 1	Чтобы	Для р
1	Basic	qwen	2778	1	оеаи	57234	[0, 1	Чтобы	Для р

Bash

unicode_stats 3model_cp.jsonl --columns="qwen"

Aggregated statistics saved to 3model_cp.csv

Installation

pip install dist/unicode_stats-{version}-py3-none-any.whl

Building from Source

python -m build

If tests fail, the package will not build

Running Tests

pytest