chars-counter 0.1.0

Chars counter console util

chars-counter

A small Python utility that counts, per ASCII character category, how many characters appear exactly once in a given string.

Requirements

• Python ≥ 3.14

Installation

uv sync

Usage

from src import get_once_seen_chars_categories_count
from src.consts import ASCIICharCategories

result = get_once_seen_chars_categories_count("Hello")
# {'uppercase_letters': 1, 'lowercase_letters': 2}
# 'H' appears once (Uppercase), 'e' and 'o' appear once (Lowercase), 'l' appears twice (ignored)

The returned dictionary maps ASCIICharCategories members to the count of unique characters in that category. Categories with no once-seen characters are omitted.

ASCII character categories

Category	Code points
Control_Characters	0–31, 127
Space	32
Punctuation	33–47, 58–64, 91–96, 123–126
Digits	48–57 (0–9)
Uppercase_Letters	65–90 (A–Z)
Lowercase_Letters	97–122 (a–z)

Passing a string that contains non-ASCII characters raises NotAsciiCharacterProvidedError.

Running tests

pytest

Running with coverage

coverage run -m pytest && coverage report