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
// SPDX-License-Identifier: AGPL-3.0-or-later
// Copyright (C) 2026 Vallés Puig, Ramon
//! # Astronomical Bodies
//!
//! A **central hub** that exposes type definitions, ephemerides, and physical
//! parameters for the natural objects that populate our Universe. Whether you
//! need the sidereal period of *Mars*, the absolute magnitude of *Halley’s Comet*,
//! or the radius of *Betelgeuse*, this module places those numbers at your
//! fingertips while preserving **strong type‑safety** through siderust unit system.
//!
//! The module is intentionally lightweight: all frequently accessed constants
//! (e.g. `SUN`, `MOON`, `JUPITER`) are available at **compile‑time** so they can
//! be used inside `const fn` and embedded targets. More detailed or mutable
//! datasets—such as time‑dependent orbital elements—live in their dedicated
//! sub‑modules but are re‑exported here for convenience.
//!
//! ## Sub‑module overview
//! | Path | Purpose | Highlights |
//! |------|---------|------------|
//! | [`solar_system`] | Canonical Sun, planets, major moons, dwarf planets, and Lagrange points | `SOLAR_SYSTEM` aggregate constant |
//! | [`planets`] | Generic [`Planet`] type plus planet builder utilities | Unit‑safe Keplerian elements |
//! | [`satelite`] | Natural moons and artificial satellites (TLE support) | `MOON` constant, SGP4 propagator |
//! | [`comet`] | Barycentric and heliocentric comet orbits | Halley, Encke, Hale‑Bopp presets |
//! | [`asteroid`] | Minor planets and near‑Earth objects | Ceres, Bennu, Apophis |
//! | [`stars`] | Generic [`Star`] type and stellar parameter helpers | mass, luminosity ... |
//! | [`catalog`] | Hand‑picked bright‑star catalog | [`catalog::VEGA`], [`catalog::SIRIUS`] |
//!
//! ## Quick start
//! ```rust
//! use siderust::bodies::{Star, Planet, EARTH};
//!
//! // Look up Earth in the pre‑baked Solar System constant
//! let earth: &Planet = &EARTH;
//! println!("Earth {:?}", earth);
//!
//! // Grab a famous bright star from the catalog
//! use siderust::bodies::catalog::ALTAIR;
//! println!("{} is {} away", ALTAIR.name, ALTAIR.distance);
//! ```
//!
//! ## Design philosophy
//! * **Type safety first** — every physical quantity carries its unit.
//! * **Zero runtime cost** for built‑in constants.
//! * **Ergonomic**: most commonly used types (`Planet`, `Star`, `Comet`, …) are
//! re‑exported at the crate root to minimise path noise.
//! * **Extensibility**: each sub‑module can be expanded independently as new
//! data become available.
//!
//! ## Re‑exports
//! The following items are publicly re‑exported so you can write, for example,
//! `use astro::bodies::Star;` instead of `use astro::bodies::stars::Star;`:
//!
//! * [`Comet`]
//! * [`Asteroid`]
//! * [`Satellite`]
//! * [`Planet`]
//! * [`Star`]
//! * Everything inside [`solar_system`]
//!
//! ---
pub use Asteroid;
pub use Comet;
pub use Planet;
pub use Satellite;
pub use Star;
pub use *;
pub use *;