diaryx_core 1.4.4

Core library for Diaryx - a tool to manage markdown files with YAML frontmatter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

---
title: Utils module
description: Utility functions for date and path handling
part_of: '[README](/crates/diaryx_core/src/README.md)'
exclude:
  - '*.lock'
  - '**/*.rs'
---

# Utils Module

Utility functions for date parsing and path manipulation.

## Files

- `mod.rs` - Module exports
- `date.rs` - Natural language date parsing with chrono
- `naming.rs` - Workspace naming, URL normalization, and publishing slug validation
- `path.rs` - Path utilities (relative paths, normalization)

## Sync Path Canonicalization

`path.rs` includes `normalize_sync_path(path: &str) -> String`, a shared
canonicalization helper used by sync-critical modules.

Behavior:

- Strips leading `./` and `/`
- Normalizes separators to `/`
- Preserves nested relative structure

This makes sync keys stable across path aliases (for example `README.md`,
`./README.md`, and `/README.md`) and avoids duplicate or missed sync state for
the same logical file.

`path.rs` also includes
`strip_workspace_root_prefix(path: &str, workspace_root: &Path) -> Option<String>`.
This helper strips workspace-root prefixes from absolute paths and from the
corrupted absolute form where the leading slash is missing (for example
`Users/alice/workspace/README.md`), returning workspace-relative paths when a
prefix match is found.