Skip to main content

Module util

Module util 

Source
Expand description

Utility functions for unit ID parsing and status conversion.

Structs§

SimilarUnit
A similar unit found during duplicate detection.

Constants§

DEFAULT_SIMILARITY_THRESHOLD
Default similarity threshold for duplicate detection (70% word overlap).

Functions§

atomic_write
Write contents to a file atomically using write-to-temp + rename.
find_similar_titles
Find open/in-progress units with titles similar to the given title.
natural_cmp
Compare two unit IDs using natural ordering. Parses IDs as dot-separated segments and compares them. Numeric segments are compared numerically, alpha segments lexicographically. Numeric segments sort before alpha segments.
parse_status
Convert a status string to a Status enum, or None if invalid.
title_similarity
Compute word-overlap similarity between two titles.
title_to_slug
Convert a unit title into a URL-safe kebab-case slug for use in filenames.
validate_unit_id
Validate a unit ID to prevent path traversal attacks.