asteroid-tui 1.1.1

Tools for minor planets researchers: observation scheduling and planning
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

# Architecture

asteroid-tui is a terminal application built in Rust. The binary drives interactive menus; library modules fetch external data and read observatory settings from disk.

## Component overview

```mermaid
flowchart TB
    main[main.rs] --> tui[tui]
    tui --> settings_tui[settings_tui]
    tui --> scheduling_tui[scheduling_tui]
    scheduling_tui --> weather[weather]
    scheduling_tui --> sun_moon_times[sun_moon_times]
    scheduling_tui --> observing_target_list[observing_target_list]
    weather --> settings[settings]
    sun_moon_times --> settings
    observing_target_list --> settings
    settings_tui --> settings
    tui --> i18n[i18n]
    observing_target_list --> utils[utils]
```

## Modules

| Module | Role |
|--------|------|
| `tui` | Main and settings menu loops |
| `settings_tui` | In-app editors for general and observatory options |
| `scheduling_tui` | Weather, sun/moon, and target-list flows |
| `settings` | Load/save `~/.config/asteroid_tui/config.toml` |
| `weather` | 7timer forecast API client and table rendering |
| `sun_moon_times` | sunrise-sunset.org API client |
| `observing_target_list` | MPC What's Up HTML parsing and tables |
| `utils` | Coordinate and visibility helpers |
| `i18n` | English/Italian UI strings |

## Configuration

On first run, `Settings::new()` creates `~/.config/asteroid_tui/config.toml` with defaults if the file is missing. See [config.example.toml](config.example.toml) for a commented template.

What's Up uses a scraped `authenticity_token` from the MPC form page, with a built-in fallback if scraping fails.

## External services

| Service | Used by | Requires |
|---------|---------|----------|
| [7timer.info](http://www.7timer.info/) | `weather` | Observatory lat/lon |
| [api.sunrise-sunset.org](https://api.sunrise-sunset.org/) | `sun_moon_times` | Observatory lat/lon |
| [MPC What's Up](https://www.minorplanetcenter.net/whatsup/) | `observing_target_list` | Network; observatory site parameters in config |

## Release and CI

- Local releases: `release.sh` (version bump, changelog, tag, push)
- Jenkins (`Jenkinsfile`): tests, build, optional crates.io/GitHub release on tagged commits
- GitHub Actions (`.github/workflows/`): build, clippy, rustdoc checks