safety-parser 0.4.3

use crate::{
    Str,
    configuration::{ANY, Tag, TagType, doc_option, env::need_check, get_tag, get_tag_opt},
};
use indexmap::IndexMap;
use proc_macro2::TokenStream;
use quote::quote;
use serde::{Deserialize, Serialize};
use std::fmt;
use syn::{
    parse::{Parse, ParseStream},
    punctuated::Punctuated,
    token::{Brace, Paren},
    *,
};

mod utils;

#[cfg(test)]
mod tests;

#[derive(Debug)]
pub struct SafetyAttr {
    pub attr: Attribute,
    pub args: SafetyAttrArgs,
}

impl Parse for SafetyAttr {
    fn parse(input: ParseStream) -> Result<Self> {
        let mut attrs = Attribute::parse_outer(input)?;

        if attrs.len() != 1 {
            return Err(syn::Error::new(
                input.span(),
                "Given input must be a single #[safety] attribute.",
            ));
        }
        let attr = attrs.remove(0);
        drop(attrs);

        // We don't check attribute name. Normally, it's #[safety { ... }],
        // but it can be #[path::to::safety {}], or #[reexported {}], or #[rapx::inner {}].

        let args = attr.parse_args()?;
        Ok(SafetyAttr { attr, args })
    }
}

/// Parse a full attribute such as `#[rapx::inner { ... }]` to get properties.
pub fn parse_attr_and_get_properties(attr: &str) -> Box<[PropertiesAndReason]> {
    let Ok(attr) = parse_str::<SafetyAttr>(attr) else { return Box::new([]) };
    attr.args.args.into_iter().collect()
}

#[derive(Debug)]
pub struct SafetyAttrArgs {
    pub args: Punctuated<PropertiesAndReason, Token![;]>,
}

impl Parse for SafetyAttrArgs {
    fn parse(input: ParseStream) -> Result<Self> {
        Ok(SafetyAttrArgs { args: Punctuated::parse_terminated(input)? })
    }
}

impl SafetyAttrArgs {
    pub fn property_reason(&self) -> impl Iterator<Item = (&Property, Option<&str>)> {
        self.args.iter().flat_map(|arg| arg.tags.iter().map(|prop| (prop, arg.desc.as_deref())))
    }
}

#[derive(Debug, Deserialize, Serialize)]
pub struct PropertiesAndReason {
    pub tags: Box<[Property]>,
    pub desc: Option<Str>,
}

impl Parse for PropertiesAndReason {
    fn parse(input: ParseStream) -> Result<Self> {
        let mut tags = Vec::<Property>::new();
        let mut desc = None;

        while !input.cursor().eof() {
            let tag: TagNameType = input.parse()?;
            if need_check() {
                tag.check_type();
            }
            let args = if input.peek(Paren) {
                let content;
                parenthesized!(content in input);
                let args = Punctuated::<Expr, Token![,]>::parse_terminated(&content)?;
                args.into_iter().collect()
            } else if input.peek(Brace) {
                let content;
                braced!(content in input);
                let args = Punctuated::<Expr, Token![,]>::parse_terminated(&content)?;
                args.into_iter().collect()
            } else {
                Default::default()
            };
            tags.push(Property { tag, args });

            if input.peek(Token![,]) {
                // consume `,` in multiple tags
                let _: Token![,] = input.parse()?;
            }
            if input.peek(Token![:]) {
                let _: Token![:] = input.parse()?;
                // `:` isn't in args, thus parse desc
                let s: LitStr = input.parse()?;
                desc = Some(s.value().into());
                break;
            }
            if input.peek(Token![;]) {
                // new grouped SPs
                break;
            }
        }
        Ok(PropertiesAndReason { tags: tags.into(), desc })
    }
}

impl PropertiesAndReason {
    /// Generate
    ///
    /// ```text
    /// /// Grouped desc
    /// /// * SP1: desc
    /// /// * SP2: desc
    /// ```
    pub fn gen_doc(&self) -> TokenStream {
        let mut ts = TokenStream::default();

        if doc_option().heading_safety_title && self.need_gen_doc() {
            ts.extend(quote! { #[doc = "# Safety\n\n"] });
        }

        if let Some(desc) = self.desc.as_deref() {
            ts.extend(quote! { #[doc = #desc] });
        }

        let heading_tag = doc_option().heading_tag;

        for tag in &self.tags {
            let name = tag.tag.name();
            let tokens = match (heading_tag, tag.gen_doc()) {
                (true, None) => quote! { #[doc = concat!("* ", #name)] },
                (true, Some(desc)) => quote! { #[doc = concat!("* ", #name, ": ", #desc)] },
                (false, None) => quote! {},
                (false, Some(desc)) => quote! { #[doc = concat!("* ", #desc)] },
            };
            ts.extend(tokens);
        }
        ts
    }

    /// Safety doc rendered through LSP hover.
    pub fn gen_hover_doc(&self) -> Box<str> {
        use std::fmt::Write;

        let mut doc = String::with_capacity(512);

        if let Some(desc) = &self.desc {
            doc.push_str(desc);
            doc.push_str("\n\n");
        }

        for tag in &self.tags {
            let name = tag.tag.name();
            if let Some(desc) = tag.gen_doc() {
                _ = writeln!(&mut doc, "* {name}: {desc}");
            } else {
                _ = writeln!(&mut doc, "* {name}");
            }
        }

        doc.into()
    }

    fn gen_sp_in_any_doc(&self) -> String {
        let mut doc = String::new();
        let heading_tag = doc_option().heading_tag;

        for tag in &self.tags {
            let name = tag.tag.name();
            let item = match (heading_tag, tag.gen_doc()) {
                (true, None) => format!("    * {name}"),
                (true, Some(desc)) => format!("    * {name}: {desc}"),
                (false, None) => String::new(),
                (false, Some(desc)) => format!("    * {desc}"),
            };
            doc.push_str(&item);
            doc.push('\n');
        }
        doc.pop();
        doc
    }

    pub fn need_gen_doc(&self) -> bool {
        self.desc.is_some() || !self.tags.is_empty()
    }

    /// Direct construct the string as a single property, without validating the spec.
    pub fn new_single_sp(name: &str) -> Self {
        PropertiesAndReason {
            tags: Box::new([Property {
                tag: TagNameType { typ: None, name: name.into() },
                args: Box::default(),
            }]),
            desc: None,
        }
    }

    /// The argument must be in the syntax of `Tag` or `any(Tag1, Tag2, ...)`,
    /// with optional reasons, but without validating the spec.
    /// This is identical to be `syn::parse_str::<PropertiesAndReason>(s)`.
    pub fn parse_sp_str(s: &str) -> syn::Result<Self> {
        parse_str(s)
    }
}

#[derive(Clone, Deserialize, Serialize)]
pub struct Property {
    /// `SP` or `type.SP`. The type of single `SP` is unkown until queried from definition.
    pub tag: TagNameType,
    /// Args in `SP(args)` such as `arg1, arg2`.
    #[serde(deserialize_with = "utils::deserialize_str_to_expr")]
    #[serde(serialize_with = "utils::serialize_expr_to_str")]
    pub args: Box<[Expr]>,
}

impl fmt::Debug for Property {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let args = &*self.args;
        let args = quote! { #(#args),* }.to_string();
        f.debug_struct("Property").field("tag", &self.tag).field("args", &args).finish()
    }
}

impl Property {
    /// Generate `#[doc]` for this property from its desc string interpolation.
    /// None means SP is not defined with desc, thus nothing to generate.
    pub fn gen_doc(&self) -> Option<String> {
        let name = self.tag.name();

        if name == ANY {
            if self.args.is_empty() {
                return None;
            }
            let mut doc =
                "Only one of the following properties requires being satisfied:\n".to_owned();
            // validate SPs in `any(SP1, SP2, ...)` exist
            for prop in utils::parse_args_in_any_tag(&self.args) {
                doc.push_str(&prop.gen_sp_in_any_doc());
            }
            return Some(doc);
        }

        let defined_tag = get_tag_opt(name)?;
        // NOTE: this tolerates missing args, but position matters.
        let args_len = self.args.len().min(defined_tag.args.len());

        // map defined arg names to user inputs
        let defined_args = defined_tag.args[..args_len].iter().map(|s| &**s);
        let input_args = self.args[..args_len].iter().map(utils::expr_to_string);
        let mut map_defined_arg_input_arg: IndexMap<_, _> = defined_args.zip(input_args).collect();
        // if input arg is missing, defined arg will be an empty string
        for defined_arg in &defined_tag.args {
            if !map_defined_arg_input_arg.contains_key(&**defined_arg) {
                map_defined_arg_input_arg.insert(defined_arg, String::new());
            }
        }

        defined_tag.desc.as_deref().map(|desc| utils::template(desc, &map_defined_arg_input_arg))
    }

    /// SPs in `any` tag. None means the tag is not `any` or empty args.
    pub fn args_in_any_tag(&self) -> Option<Vec<PropertiesAndReason>> {
        (self.tag.name() == ANY && !self.args.is_empty())
            .then(|| utils::parse_args_in_any_tag(&self.args))
    }

    pub fn args_as_string(&self) -> Box<[String]> {
        self.args.iter().map(utils::expr_to_string).collect()
    }
}

/// Typed SP: `type.SP`
#[derive(Clone, Debug, Deserialize, Serialize)]
pub struct TagNameType {
    /// Default tag type is the one in single defined_types.
    //
    /// Deserialization will fill the default tag type as Precond.
    typ: Option<TagType>,
    /// Single ident string.
    name: Str,
}

impl Parse for TagNameType {
    fn parse(input: ParseStream) -> Result<Self> {
        let ident: Ident = input.parse()?;
        let first = ident.to_string();
        Ok(if input.peek(Token![.]) {
            let _: Token![.] = input.parse()?;
            let second: Ident = input.parse()?;
            let name = second.to_string().into();
            TagNameType { name, typ: Some(TagType::new(&first)) }
        } else {
            TagNameType { name: first.into(), typ: None }
        })
    }
}

impl TagNameType {
    pub fn name(&self) -> &str {
        &self.name
    }

    // FIXME: no pinned default tag, because we want default tag to be
    // the one in single defined_types. Deserialization will fill the
    // default tag type as Precond.
    pub fn typ(&self) -> Option<TagType> {
        self.typ
    }

    pub fn name_type(&self) -> (&str, Option<TagType>) {
        (&self.name, self.typ)
    }

    /// Check if the tag in macro is wrongly specified.
    pub fn check_type(&self) {
        let (name, typ) = self.name_type();
        if name == ANY {
            // FIXME: check SP args here
            return;
        }
        let defined_types = &get_tag(name).types;
        if let Some(typ) = typ {
            assert!(
                defined_types.contains(&typ),
                "For tag {name:?}, defined_types is {defined_types:?}, \
                 while user's {typ:?} doesn't exist."
            );
        } else {
            assert_eq!(
                defined_types.len(),
                1,
                "For tag {name:?} without explicit type, \
                 the default type is the single defined type.\n\
                 But defined_types has multiple types: {defined_types:?}.\n\
                 So choose a type to be `type.{name}`."
            );
        }
    }

    /// Get specification of the tag in TOML.
    pub fn get_spec(&self) -> Option<&'static Tag> {
        get_tag_opt(&self.name)
    }
}