Mountain/Environment/Utility/
UriParsing.rs

1//! # URI Parsing Utilities
2//!
3//! Functions for parsing and converting URI/URL representations.
4
5use url::Url;
6use CommonLibrary::Error::CommonError::CommonError;
7
8/// Helper to get a `Url` from a `serde_json::Value` which is expected to be a
9/// `UriComponents` DTO from VS Code, a plain URI string, or a UriComponents
10/// object without the `external` convenience field.
11///
12/// Cocoon's wire shapes vary by call site:
13///   - `Diagnostic.Set` and a few others send the URI as a plain string (the
14///     canonical form returned by `Uri.toString()`).
15///   - `MainThread*` boundaries send the `{scheme, authority, path, query,
16///     fragment, external}` object that vs/base/common/uri.ts emits via
17///     `URI.toJSON()`.
18///   - Some legacy paths send `{scheme, path}` with no `external`.
19///
20/// All three are valid; Mountain accepts whichever arrives. Without this the
21/// Diagnostic.Set call from `vscode.languages.createDiagnosticCollection().set`
22/// trips the breaker after 5 publishes and silences every linter / compiler
23/// across all language extensions.
24pub fn GetURLFromURIComponentsDTO(URIDTO:&serde_json::Value) -> Result<Url, CommonError> {
25	// 1. Plain string: parse directly.
26	if let Some(URIString) = URIDTO.as_str() {
27		return Url::parse(URIString).map_err(|Error| {
28			CommonError::InvalidArgument {
29				ArgumentName:"URIDTO".to_string(),
30				Reason:format!("Failed to parse URI string '{}': {}", URIString, Error),
31			}
32		});
33	}
34
35	// 2. Object with `external` field (VS Code's UriComponents).
36	if let Some(URIString) = URIDTO.get("external").and_then(serde_json::Value::as_str) {
37		return Url::parse(URIString).map_err(|Error| {
38			CommonError::InvalidArgument {
39				ArgumentName:"URIDTO.external".to_string(),
40				Reason:format!("Failed to parse URI string '{}': {}", URIString, Error),
41			}
42		});
43	}
44
45	// 3. Object with scheme/authority/path - reconstruct the URI string.
46	let Scheme = URIDTO.get("scheme").and_then(serde_json::Value::as_str);
47
48	let Path = URIDTO.get("path").and_then(serde_json::Value::as_str);
49
50	if let (Some(Scheme), Some(Path)) = (Scheme, Path) {
51		let Authority = URIDTO.get("authority").and_then(serde_json::Value::as_str).unwrap_or("");
52
53		let Query = URIDTO.get("query").and_then(serde_json::Value::as_str).unwrap_or("");
54
55		let Fragment = URIDTO.get("fragment").and_then(serde_json::Value::as_str).unwrap_or("");
56
57		let mut Reconstructed = format!("{}://{}{}", Scheme, Authority, Path);
58
59		if !Query.is_empty() {
60			Reconstructed.push('?');
61
62			Reconstructed.push_str(Query);
63		}
64
65		if !Fragment.is_empty() {
66			Reconstructed.push('#');
67
68			Reconstructed.push_str(Fragment);
69		}
70
71		return Url::parse(&Reconstructed).map_err(|Error| {
72			CommonError::InvalidArgument {
73				ArgumentName:"URIDTO".to_string(),
74				Reason:format!("Failed to parse reconstructed URI '{}': {}", Reconstructed, Error),
75			}
76		});
77	}
78
79	Err(CommonError::InvalidArgument {
80		ArgumentName:"URIDTO".to_string(),
81		Reason:"Expected a URI string, an object with 'external', or an object with 'scheme' + 'path'".to_string(),
82	})
83}
Mountain/Environment/Utility/UriParsing.rs

Mountain/Environment/Utility/
UriParsing.rs
