efb 0.7.1

Electronic Flight Bag library to plan and conduct a flight.
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

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 Joe Pearson
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! Encoding helpers for types that span multiple SQL columns.

use crate::VerticalDistance;

/// Returns the `kind` column value for a vertical distance.
pub fn vd_kind(vd: &VerticalDistance) -> &'static str {
    match vd {
        VerticalDistance::Agl(_) => "agl",
        VerticalDistance::Altitude(_) => "alt",
        VerticalDistance::PressureAltitude(_) => "pa",
        VerticalDistance::Fl(_) => "fl",
        VerticalDistance::Gnd => "gnd",
        VerticalDistance::Msl(_) => "msl",
        VerticalDistance::Unlimited => "unlimited",
    }
}

/// Returns the `value` column for a vertical distance, or `None` for unit
/// variants (`Gnd`, `Unlimited`) that carry no quantity.
pub fn vd_value(vd: &VerticalDistance) -> Option<i64> {
    match vd {
        VerticalDistance::Agl(n) => Some(*n as i64),
        VerticalDistance::Altitude(n) => Some(*n as i64),
        VerticalDistance::PressureAltitude(n) => Some(*n as i64),
        VerticalDistance::Fl(n) => Some(*n as i64),
        VerticalDistance::Msl(n) => Some(*n as i64),
        VerticalDistance::Gnd | VerticalDistance::Unlimited => None,
    }
}

/// Reconstructs a vertical distance from a `(kind, value)` column pair.
///
/// Returns `None` when `kind` is not recognised.
pub fn vd_from_row(kind: &str, value: Option<i64>) -> Option<VerticalDistance> {
    match (kind, value) {
        ("agl", Some(n)) => u16::try_from(n).ok().map(VerticalDistance::Agl),
        ("alt", Some(n)) => u16::try_from(n).ok().map(VerticalDistance::Altitude),
        ("pa", Some(n)) => i16::try_from(n)
            .ok()
            .map(VerticalDistance::PressureAltitude),
        ("fl", Some(n)) => u16::try_from(n).ok().map(VerticalDistance::Fl),
        ("msl", Some(n)) => u16::try_from(n).ok().map(VerticalDistance::Msl),
        ("gnd", _) => Some(VerticalDistance::Gnd),
        ("unlimited", _) => Some(VerticalDistance::Unlimited),
        _ => None,
    }
}