superstac-core 0.1.0

Domain models, storage trait, and shared utilities for superstac federated STAC search.
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

use chrono::{DateTime, Utc};
use url::{ParseError, Url};

use crate::errors::{SuperSTACError, ValidationError};

/// Current UTC timestamp. Centralized so tests can mock it later.
pub fn get_date_time() -> DateTime<Utc> {
    Utc::now()
}

/// Parse and validate a URL string.
pub fn parse_url(url: &str) -> Result<Url, ParseError> {
    Url::parse(url)
}

/// Validate a catalog/provider identifier. Allowed: ASCII letters, digits,
/// hyphen, underscore. Empty / whitespace-only is rejected.
pub fn validate_identifier(id: &str) -> Result<(), SuperSTACError> {
    if id.trim().is_empty() {
        return Err(ValidationError::MissingField("id".into()).into());
    }

    if !id.chars().all(|c| c.is_ascii_alphanumeric() || c == '-' || c == '_') {
        return Err(ValidationError::InvalidIdentifier(
            "only ASCII letters, digits, hyphen, and underscore are allowed".into(),
        )
        .into());
    }

    Ok(())
}