pth 0.36.0

Collection of algorithms and structures to handle paths properly.
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
42
43
44
45
46

/// Type alias for `NormalizedPath`.
///
/// `CanonicalPath` is a maintained alias to `NormalizedPath` for semantic clarity.
/// Use this type when you want to emphasize that a path has been canonicalized.
///
/// The `CanonicalPath` and `NativePath` types were consolidated into `NormalizedPath`
/// as of v0.30.0 to eliminate code duplication. Both aliases remain available as
/// permanent, semantically meaningful type names.
///
/// # Usage
///
/// ```rust,ignore
/// use pth::CanonicalPath;
/// let path: CanonicalPath = CanonicalPath::try_from("/some/path")?;
/// ```
///
/// # Note
///
/// `CanonicalPath`, `NativePath`, and `NormalizedPath` are all the same type.
/// Choose whichever name best expresses your intent in the given context.
mod private
{
  use super::super::normalized_path::NormalizedPath;

  /// Type alias for `NormalizedPath`.
  ///
  /// `CanonicalPath` and `NativePath` were functionally identical types that both represented
  /// paths normalized via `path::canonicalize()`. They have been consolidated into a single
  /// `NormalizedPath` type to eliminate code duplication, with both original names maintained
  /// as permanent aliases for semantic clarity.
  ///
  /// # Rationale
  ///
  /// The anticipated platform-specific differences between `CanonicalPath` and `NativePath`
  /// never materialized. Both types had identical implementations (338 lines of duplicated code),
  /// causing maintenance burden with no functional benefit. Rather than deprecate the names,
  /// they are maintained as aliases to preserve semantic meaning in different contexts.
  ///
  /// See spec ADR-009 for full architectural decision record.
  pub type CanonicalPath = NormalizedPath;
}

crate ::mod_interface!
{
  exposed use CanonicalPath;
}