skymath 0.3.2

Planning-grade astronomy math for astrophotography tooling: angles, equatorial coordinates, sexagesimal parsing and formatting, angular separation and offsets, precession, MJD/JD/calendar conversions, sidereal time, and observer-local quantities (alt-az, airmass, transit).
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

//! Exercises the optional `serde` feature end-to-end (FR-X3).
//! Only compiled/run with `--features serde`.
#![cfg(feature = "serde")]

use skymath::{
    Angle, Constellation, CrossingOutcome, Ecliptic, Epoch, Equatorial, Galactic, Horizontal,
    Location, Twilight, TwilightOutcome,
};
use time::macros::datetime;

fn round_trip<T>(value: &T) -> T
where
    T: serde::Serialize + serde::de::DeserializeOwned,
{
    serde_json::from_str(&serde_json::to_string(value).unwrap()).unwrap()
}

#[test]
fn public_types_round_trip_through_json() {
    let pos = Equatorial::at_epoch(
        Angle::from_degrees(10.6847),
        Angle::from_degrees(41.2688),
        Epoch::OfDate(2026.5),
    )
    .unwrap();
    assert_eq!(pos, round_trip(&pos));

    let site = Location::new(Angle::from_degrees(52.155), Angle::from_degrees(4.485), 6.0).unwrap();
    assert_eq!(site, round_trip(&site));

    let horizontal = Horizontal {
        altitude: Angle::from_degrees(48.5),
        azimuth: Angle::from_degrees(307.4),
    };
    assert_eq!(horizontal, round_trip(&horizontal));

    let crossing = CrossingOutcome::Crosses {
        rise: datetime!(2026-07-11 21:12:03 UTC),
        set: datetime!(2026-07-12 03:41:59 UTC),
    };
    assert_eq!(crossing, round_trip(&crossing));
    assert_eq!(
        CrossingOutcome::AlwaysAbove,
        round_trip(&CrossingOutcome::AlwaysAbove)
    );

    let galactic = Galactic {
        l: Angle::from_degrees(121.17),
        b: Angle::from_degrees(-21.57),
    };
    assert_eq!(galactic, round_trip(&galactic));

    let ecliptic = Ecliptic {
        lambda: Angle::from_degrees(113.22),
        beta: Angle::from_degrees(6.68),
    };
    assert_eq!(ecliptic, round_trip(&ecliptic));

    assert_eq!(Twilight::Astronomical, round_trip(&Twilight::Astronomical));
    let night = TwilightOutcome::Night {
        dusk: datetime!(2026-10-15 18:55:00 UTC),
        dawn: datetime!(2026-10-16 05:10:00 UTC),
    };
    assert_eq!(night, round_trip(&night));
    assert_eq!(
        TwilightOutcome::NeverDark,
        round_trip(&TwilightOutcome::NeverDark)
    );
}

#[test]
fn constellation_wire_form_is_the_iau_abbreviation() {
    for c in Constellation::ALL {
        assert_eq!(c, round_trip(&c));
        assert_eq!(
            serde_json::to_string(&c).unwrap(),
            format!("\"{}\"", c.abbreviation())
        );
    }
}