//! Link specifier objects

//!

//! (These are in a separate crate, since they get used both by

//! directory code and protocol code.)

use std::net::{IpAddr, SocketAddr};

use caret::caret_int;

use derive_deftly::Deftly;

use tor_bytes::{EncodeResult, Readable, Reader, Result, Writeable, Writer};

use tor_llcrypto::pk::ed25519;

use tor_llcrypto::pk::rsa::RsaIdentity;

use tor_memquota::derive_deftly_template_HasMemoryCost;

use crate::RelayId;

/// A piece of information about a relay and how to connect to it.

#[non_exhaustive]

#[derive(Debug, Clone, PartialEq, Eq, Deftly)]

#[derive_deftly(HasMemoryCost)]

pub enum LinkSpec {

    /// The TCP address of an OR Port for a relay

    OrPort(IpAddr, u16),

    /// The RSA identity fingerprint of the relay

    RsaId(RsaIdentity),

    /// The Ed25519 identity of the relay

    Ed25519Id(ed25519::Ed25519Identity),

    /// A link specifier that we didn't recognize

    Unrecognized(LinkSpecType, Vec<u8>),

}

caret_int! {

    /// A numeric identifier for the type of a [`LinkSpec`].

    #[derive(Deftly)]

    #[derive_deftly(HasMemoryCost)]

    pub struct LinkSpecType(u8) {

        /// Indicates an IPv4 ORPORT link specifier.

        ORPORT_V4 = 0,

        /// Indicates an IPv6 ORPORT link specifier.

        ORPORT_V6 = 1,

        /// Indicates an RSA ID fingerprint link specifier

        RSAID = 2,

        /// Indicates an Ed25519 link specifier

        ED25519ID = 3,

    }

}

impl Readable for LinkSpec {

}

impl Writeable for LinkSpec {

        {

        }

}

impl From<&SocketAddr> for LinkSpec {

}

impl From<SocketAddr> for LinkSpec {

}

impl From<RsaIdentity> for LinkSpec {

}

impl From<ed25519::Ed25519Identity> for LinkSpec {

}

impl From<ed25519::PublicKey> for LinkSpec {

}

impl From<RelayId> for LinkSpec {

        }

}

impl LinkSpec {

    /// Helper: return the position in the list of identifiers

    /// in which a given linkspec should occur.

        use LinkSpec::*;

        }

    /// Sort a slice of LinkSpec based on the order in which they should

    /// appear in an EXTEND cell.

    /// Try to create a LinkSpec of encoded type `lstype`, taking its body from a

    /// given reader `r`.

    ///

    /// Does not check whether `r` is exhausted at the end of the operation or not.

        use LinkSpecType as LST;

            LST::ORPORT_V4 => {

            }

            LST::ORPORT_V6 => {

            }

        })

    /// Return the command for this linkspec.

        use LinkSpecType as LST;

        }

    /// Try to encode the body of this linkspec onto a given writer.

        use LinkSpec::*;

            }

            }

            }

            }

        }

    /// Return an encoded version of this link specifier.

}

/// An unparsed piece of information about a relay and how to connect to it.

///

/// Unlike [`LinkSpec`], this can't be used directly; we only pass it on.

#[derive(Debug, Clone, PartialEq, Eq, Deftly)]

#[derive_deftly(HasMemoryCost)]

pub struct EncodedLinkSpec {

    /// The link specifier type.

    lstype: LinkSpecType,

    /// The body of the link speciier.

    body: Vec<u8>,

}

impl EncodedLinkSpec {

    /// Create a new `EncodedLinkSpec`.

    /// Try to parse this into a `LinkSpec`, if it appears well-formed.

    /// Return the link spec type for this `EncodedLinkSpec`.

}

impl Readable for EncodedLinkSpec {

}

impl Writeable for EncodedLinkSpec {

}

#[cfg(test)]

mod test {

    // @@ begin test lint list maintained by maint/add_warning @@

    #![allow(clippy::bool_assert_comparison)]

    #![allow(clippy::clone_on_copy)]

    #![allow(clippy::dbg_macro)]

    #![allow(clippy::mixed_attributes_style)]

    #![allow(clippy::print_stderr)]

    #![allow(clippy::print_stdout)]

    #![allow(clippy::single_char_pattern)]

    #![allow(clippy::unwrap_used)]

    #![allow(clippy::unchecked_time_subtraction)]

    #![allow(clippy::useless_vec)]

    #![allow(clippy::needless_pass_by_value)]

    #![allow(clippy::string_slice)] // See arti#2571

    //! <!-- @@ end test lint list maintained by maint/add_warning @@ -->

    use super::*;

    use hex_literal::hex;

    use std::net::{IpAddr, Ipv4Addr, Ipv6Addr};

    use tor_bytes::{Reader, Writer};

    #[test]

    fn test_parse_enc() {

        fn t(b: &[u8], val: &LinkSpec) {

            let mut r = Reader::from_slice_for_test(b);

            let got: LinkSpec = r.extract().unwrap();

            assert_eq!(r.remaining(), 0);

            assert_eq!(&got, val);

            let mut v = Vec::new();

            v.write(val).expect("Encoding failure");

            assert_eq!(&v[..], b);

        }

        t(

            &hex!("00 06 01020304 0050"),

            &LinkSpec::OrPort(IpAddr::V4(Ipv4Addr::new(1, 2, 3, 4)), 80),

        );

        t(

            &hex!("01 12 0001 0002 0003 0004 0005 0006 0007 0008 01bb"),

            &LinkSpec::OrPort(IpAddr::V6(Ipv6Addr::new(1, 2, 3, 4, 5, 6, 7, 8)), 443),

        );

        t(

            &[

                2, 20, 104, 101, 108, 108, 111, 32, 119, 111, 114, 108, 100, 33, 33, 33, 33, 33,

                33, 33, 33, 33,

            ],

            &LinkSpec::RsaId(RsaIdentity::from_bytes(b"hello world!!!!!!!!!").unwrap()),

        );

        let key = ed25519::PublicKey::from_bytes(&hex!(

            "B440EEDB32D5C89EF21D6B16BE85A658774CE5992355737411678EE1041BDFBA"

        ))

        .unwrap()

        .into();

        t(

            &hex!("03 20 B440EEDB32D5C89EF21D6B16BE85A658774CE5992355737411678EE1041BDFBA"),

            &LinkSpec::Ed25519Id(key),

        );

        t(

            &[77, 7, 115, 116, 114, 97, 110, 103, 101],

            &LinkSpec::Unrecognized(77.into(), (&b"strange"[..]).into()),

        );

    }

    #[test]

    fn test_parse_bad() {

        use tor_bytes::Error;

        fn t(b: &[u8]) -> Error {

            let mut r = Reader::from_slice_for_test(b);

            let got: Result<LinkSpec> = r.extract();

            got.err().unwrap()

        }

        assert_eq!(t(&hex!("00 03")), Error::new_incomplete_for_test(3));

        assert_eq!(

            t(&hex!("00 06 01020304")),

            Error::new_incomplete_for_test(2)

        );

        assert_eq!(t(&hex!("99 07 010203")), Error::new_incomplete_for_test(4));

    }

    #[test]

    fn test_unparsed() {

        fn t(b: &[u8], val: &EncodedLinkSpec) {

            let mut r = Reader::from_slice_for_test(b);

            let got: EncodedLinkSpec = r.extract().unwrap();

            assert_eq!(r.remaining(), 0);

            assert_eq!(&got, val);

            let mut v = Vec::new();

            v.write(val).expect("Encoding failure");

            assert_eq!(&v[..], b);

        }

        // Note that these are not valid linkspecs, but we accept them here.

        t(

            &hex!("00 00"),

            &EncodedLinkSpec {

                lstype: 0.into(),

                body: vec![],

            },

        );

        t(

            &hex!("00 03 010203"),

            &EncodedLinkSpec {

                lstype: 0.into(),

                body: vec![1, 2, 3],

            },

        );

        t(

            &hex!("99 10 000102030405060708090a0b0c0d0e0f"),

            &EncodedLinkSpec {

                lstype: 0x99.into(),

                body: (0..=15).collect(),

            },

        );

    }

    #[test]

    fn test_unparsed_bad() {

        use tor_bytes::Error;

        fn t(b: &[u8]) -> Error {

            let mut r = Reader::from_slice_for_test(b);

            let got: Result<EncodedLinkSpec> = r.extract();

            got.err().unwrap()

        }

        assert_eq!(t(&hex!("00")), Error::new_incomplete_for_test(1));

        assert_eq!(t(&hex!("00 04 010203")), Error::new_incomplete_for_test(1));

        assert_eq!(

            t(&hex!("00 05 01020304")),

            Error::new_incomplete_for_test(1)

        );

    }

}