keycloak 26.6.1

use std::borrow::Cow;

use clap::{Parser, ValueEnum};
use heck::{ToKebabCase, ToUpperCamelCase};

/// Generate Rust code from Keycloak REST Description in HTML
#[derive(Parser)]
#[command(author, version, about, long_about = None)]
struct Cli {
    #[command(subcommand)]
    command: Command,
}

#[derive(Parser)]
enum Command {
    /// Generate types
    Types,
    /// Generate low level REST method callers
    Rest {
        /// Generate REST methods without tags
        #[arg(short, long, default_value_t = false)]
        no_tag: bool,
        /// Generate REST methods with specific tag (kebab variant of tag name)
        #[arg(short, long)]
        tag: Option<String>,
    },
    /// Specs
    Specs,
    /// Tags
    Tags { format: Option<TagsFormat> },
    /// Methods
    Methods {
        /// Generate methods without tags
        #[arg(short, long, default_value_t = false)]
        no_tag: bool,
        /// Generate methods with specific tag (kebab variant of tag name)
        #[arg(short, long)]
        tag: Option<String>,
    },
}

#[derive(Clone, Default, Parser, ValueEnum)]
enum TagsFormat {
    Cargo,
    #[default]
    Kebab,
    ModResource,
    ModRest,
}

#[derive(Debug)]
struct RealmMethod {
    name: String,
    comments: Vec<String>,
    real_fn_name: String,
    tags: Option<Vec<String>>,
    deprecated: bool,
    has_optional_parameters: bool,
    parameters: Vec<RealmMethodParameter>,
    summary: Option<String>,
    description: Option<String>,
    returns: String,
}

#[derive(Debug)]
struct RealmMethodParameter {
    name: String,
    rust_type: String,
    required: bool,
    deprecated: bool,
    description: Option<String>,
}

const RESERVED_WORDS: &[&str] = &["type", "self", "static", "use", "if"];
const TAG_NONE: &str = "tag-none";

mod openapi {
    use std::{borrow::Cow, collections::HashSet, fmt::Display, str::FromStr, sync::Arc};

    use heck::{ToKebabCase, ToLowerCamelCase, ToSnakeCase, ToUpperCamelCase};
    use indexmap::IndexMap;
    use serde::Deserialize;

    use keycloak::prelude::reqwest;

    use crate::{RESERVED_WORDS, TAG_NONE};

    #[derive(Debug, PartialEq, Eq)]
    pub enum FieldCase {
        CamelCase,
        SnakeCase,
        Custom,
        Unknown,
    }

    #[derive(Debug, Deserialize)]
    pub struct Spec<'s> {
        pub openapi: String,
        pub info: Info,
        pub tags: Vec<Tag<'s>>,
        pub paths: IndexMap<String, SpecPath<'s>>,
        pub components: Components,
    }

    #[derive(Debug, Deserialize)]
    pub struct Info {
        pub title: String,
        pub description: String,
        pub version: String,
    }

    #[derive(Debug, Deserialize)]
    pub struct Tag<'t> {
        pub name: Cow<'t, str>,
    }

    #[derive(Debug, Deserialize)]
    pub struct SpecPath<'s> {
        #[serde(flatten)]
        pub calls: IndexMap<Method, Call<'s>>,
        pub parameters: Option<Vec<Parameter>>,
    }

    impl<'s> SpecPath<'s> {
        pub fn to_rust_rest_client_method(&self, path: &str, add_cfg: bool) -> String {
            self.calls
                .iter()
                .map(|(method, call)| {
                    call.to_rust_method(path, method, self.parameters.as_deref(), add_cfg)
                })
                .collect::<Vec<_>>()
                .join("\n")
        }

        pub fn to_rust_realm_methods(&self, path: &str) -> Vec<super::RealmMethod> {
            self.calls
                .iter()
                .map(|(method, call)| {
                    call.to_rust_realm_method(path, method, self.parameters.as_deref())
                })
                .collect()
        }
    }

    #[derive(Debug, Deserialize)]
    struct RequestBody {
        content: Content,
    }

    impl RequestBody {
        fn to_rust_return_type_and_parse_calls<'a>(
            &'a self,
            body_name: &str,
        ) -> Option<ReturnType<'a>> {
            self.content
                .to_rust_parameter_type()
                .zip(self.content.to_rust_reqwest_body_call(body_name))
                .map(|(value, body)| ReturnType {
                    value,
                    body: Some(body.into()),
                    convert: None,
                })
        }

        fn to_parameter(&self, name: String) -> Option<Parameter> {
            Some(Parameter {
                name,
                position: ParameterPosition::Path,
                deprecated: false,
                required: true,
                description: None,
                schema: self.content.as_content_schema()?.schema.clone(),
            })
        }
    }

    #[derive(Debug, Deserialize)]
    struct Response {
        content: Option<Content>,
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash)]
    enum ContentType {
        #[serde(rename = "application/json")]
        ApplicationJson,
        #[serde(rename = "application/octet-stream")]
        ApplicationOctetStream,
        #[serde(rename = "application/yaml")]
        ApplicationYaml,
        #[serde(rename = "application/xml")]
        ApplicationXml,
        #[serde(rename = "text/plain")]
        TextPlain,
        #[serde(rename = "application/x-www-form-urlencoded")]
        HtmlForm,
        #[serde(rename = "*/*")]
        Any,
    }

    #[derive(Debug, Deserialize)]
    struct Content(IndexMap<ContentType, ContentSchema>);

    impl Content {
        fn as_json(&self) -> Option<&ContentSchema> {
            self.0.get(&ContentType::ApplicationJson)
        }

        fn as_text_plain(&self) -> Option<&ContentSchema> {
            self.0.get(&ContentType::TextPlain)
        }

        fn as_binary_text(&self) -> Option<&ContentSchema> {
            self.as_binary_blob()
                .filter(|content_schema| content_schema.is_string())
        }

        fn as_binary_blob(&self) -> Option<&ContentSchema> {
            self.0.get(&ContentType::ApplicationOctetStream)
        }

        fn as_html_form(&self) -> Option<&ContentSchema> {
            self.0.get(&ContentType::HtmlForm)
        }

        fn as_any(&self) -> Option<&ContentSchema> {
            self.0.get(&ContentType::Any)
        }

        fn as_content_schema(&self) -> Option<&ContentSchema> {
            self.as_json()
                .or(self.as_html_form())
                .or(self.as_text_plain())
                .or(self.as_binary_text())
                .or(self.as_any())
        }

        fn to_rust_parameter_type(&self) -> Option<Cow<'_, str>> {
            self.as_content_schema()
                .map(|content_schema| content_schema.to_rust_parameter_body_type())
        }

        fn to_rust_return_type(&self) -> Option<Cow<'_, str>> {
            self.as_content_schema()
                .map(|content_schema| content_schema.to_rust_return_type())
        }

        fn to_rust_reqwest_body_call(&self, body_name: &str) -> Option<String> {
            self.as_json()
                .map(|_| format!("json(&{body_name})"))
                .or(self.as_text_plain().map(|_| format!("body({body_name})")))
                .or(self.as_html_form().map(|_| format!("form(&{body_name})")))
        }

        fn to_rust_reqwest_parse_body_call(&self) -> Option<(Cow<'_, str>, Option<Cow<'_, str>>)> {
            self.as_json()
                .or(self.as_any())
                .map(|_| ("json", None))
                .or(self
                    .as_binary_text()
                    .or(self.as_text_plain())
                    .map(|_| ("text", Some(".map(From::from)"))))
                .or(self.as_binary_blob().map(|_| ("bytes", None)))
                .or(self.as_html_form().map(|_| ("form", None)))
                .map(|(method, conv)| (method.into(), conv.map(From::from)))
        }
    }

    #[derive(Debug, Deserialize)]
    struct ContentSchema {
        schema: Kind,
    }

    impl ContentSchema {
        fn to_rust_parameter_body_type(&self) -> Cow<'_, str> {
            self.schema.to_rust_type_ref(RefMode::Std)
        }

        fn to_rust_return_type(&self) -> Cow<'_, str> {
            self.schema.to_rust_type_ref(RefMode::Owned)
        }

        fn is_string(&self) -> bool {
            matches!(self.schema, Kind::Generic(Generic::String))
        }
    }

    #[derive(Debug, Deserialize)]
    struct Responses(IndexMap<String, Response>);

    #[derive(Debug)]
    struct ReturnType<'rt> {
        value: Cow<'rt, str>,
        body: Option<Cow<'rt, str>>,
        convert: Option<Cow<'rt, str>>,
    }

    impl Responses {
        fn to_reqwest_status_response(&self) -> Option<(reqwest::StatusCode, &Response)> {
            self.0
                .iter()
                .find(|(status, _)| *status == "200")
                .or_else(|| self.0.iter().find(|(status, _)| status.starts_with("2")))
                .and_then(|(status, response)| {
                    let status = reqwest::StatusCode::from_str(status.as_str()).ok()?;
                    Some((status, response))
                })
        }

        fn to_rust_return_type_and_parse_calls(&self) -> Option<ReturnType<'_>> {
            let (_, response) = self.to_reqwest_status_response()?;
            let content = response.content.as_ref()?;
            content
                .to_rust_return_type()
                .zip(content.to_rust_reqwest_parse_body_call())
                .map(|(value, (body, convert))| ReturnType {
                    value,
                    body: body.into(),
                    convert,
                })
        }
    }

    #[derive(Debug, Deserialize)]
    #[serde(rename_all = "camelCase")]
    pub struct Call<'c> {
        pub tags: Option<Vec<Cow<'c, str>>>,
        summary: Option<String>,
        description: Option<String>,
        #[serde(default)]
        deprecated: bool,
        parameters: Option<Vec<Parameter>>,
        request_body: Option<RequestBody>,
        responses: Responses,
    }

    impl<'c> Call<'c> {
        fn to_rust_method(
            &self,
            path: &str,
            method: &Method,
            parameters: Option<&[Parameter]>,
            add_cfg: bool,
        ) -> String {
            let mut method_name = path
                .strip_prefix("/admin/realms")
                .unwrap_or(path)
                .to_string();

            let mut path_snake_case = path.to_string();

            let call_parameters = parameters.into_iter().flatten().collect::<Vec<_>>();

            let parameters = call_parameters
                .clone()
                .into_iter()
                .chain(
                    self.parameters
                        .as_deref()
                        .into_iter()
                        .flatten()
                        .filter(|p| !call_parameters.iter().any(|cp| cp.name == p.name)),
                )
                .map(|parameter| {
                    let mut param_name = parameter.name.to_snake_case();
                    while RESERVED_WORDS.contains(&param_name.as_str()) {
                        param_name += "_";
                    }

                    (parameter, param_name)
                })
                .collect::<Vec<_>>();
            for (parameter, parameter_name) in &parameters {
                if parameter.position == ParameterPosition::Path {
                    let parameter_with = if parameter.name == "realm" {
                        ""
                    } else {
                        "with_"
                    }
                    .to_string()
                        + parameter_name.as_str();
                    method_name =
                        method_name.replace(&format!("{{{}}}", parameter.name), &parameter_with);
                }
                if parameter_name != &parameter.name {
                    path_snake_case = path_snake_case.replace(
                        &format!("{{{}}}", parameter.name),
                        &format!("{{{parameter_name}}}"),
                    );
                }
            }

            let method_string = method.to_string();

            method_name = (method_name + &method_string).to_snake_case();

            let mut result_type = self.responses.to_rust_return_type_and_parse_calls();

            let mut result_type_value = result_type
                .as_ref()
                .map(|rt| rt.value.as_ref())
                .unwrap_or("DefaultResponse");

            let use_default_response = result_type.is_none();

            let (method_string_lc, comments) = self.comments(
                &parameters,
                method_string,
                path,
                &path_snake_case,
                use_default_response,
            );

            let mut output = vec![];

            output.extend(comments);

            let tag = self
                .tags
                .as_deref()
                .and_then(|tags| tags.first())
                .map(|tag| "tag-".to_string() + &tag.as_ref().to_kebab_case())
                .unwrap_or_else(|| TAG_NONE.to_string());

            if add_cfg {
                output.push(format!(r#"#[cfg(feature = "{tag}")]"#));
            }

            if self.deprecated {
                output.push("#[deprecated]".into());
            }

            let request_body = self.request_body.as_ref();

            let body_parameter_name = "body";

            let body_return_type = request_body.and_then(|request_body| {
                request_body.to_rust_return_type_and_parse_calls(body_parameter_name)
            });
            let body_parameter = request_body.and_then(|request_body| {
                request_body.to_parameter(body_parameter_name.to_string())
            });

            let parameters_of_method = prepare_method_parameters(
                path,
                &parameters,
                &method_string_lc,
                body_parameter.as_ref(),
            )
            .map(|(_, param_name, param_type)| format!("    {param_name}: {param_type},"))
            .collect::<Vec<_>>();

            if parameters_of_method.len() > 6 {
                output.push("#[allow(clippy::too_many_arguments)]".into());
            }

            output.push(format!("pub async fn {method_name}("));
            output.push("    &self,".into());

            // fill parameters

            output.extend(parameters_of_method);

            let desc = Toml::desc::<_, _, String>(path, &method_string_lc, None);
            if let Some(desc) = desc.as_ref() {
                let from_type = desc.from_type.as_str();
                if from_type != result_type_value {
                    let redundant = result_type_value == desc.rust_type;
                    let full_header = format!(r#"[path."{path}:{method_string_lc}:"]"#);
                    if redundant {
                        delete_mapping(&full_header);
                    } else {
                        eprintln!(
                            "warn: type info changed in {full_header} : was {from_type} now {result_type_value} (mapped {})",
                            &desc.rust_type
                        );
                    }
                }
                result_type_value = desc.rust_type.as_str();
                result_type = Some(ReturnType {
                    value: result_type_value.into(),
                    body: desc.method.as_deref().map(From::from),
                    convert: desc.convert.as_deref().map(From::from),
                });
            } else if result_type_value == "Value" {
                eprintln!(r#"warn: Value as result in [path."{path}:{method_string_lc}:"]"#);
            }

            output.push(format!(
                ") -> Result<{result_type_value}, KeycloakError> {{"
            ));

            let query_parameters = parameters
                .iter()
                .filter(|(parameter, _)| parameter.position == ParameterPosition::Query)
                .collect::<Vec<_>>();
            let has_query_parameters = !query_parameters.is_empty();

            for (parameter, parameter_name) in &parameters {
                if parameter.position == ParameterPosition::Path {
                    output.push(format!("    let {parameter_name} = p({parameter_name});"));
                }
            }

            output.push(
                if has_query_parameters {
                    "    let mut builder = self"
                } else {
                    "    let builder = self"
                }
                .into(),
            );
            output.push("        .client".into());
            output.push(format!("        .{method_string_lc}(format!("));
            output.push(format!(r#"            "{{}}{path_snake_case}","#));
            output.push("            self.url".into());
            output.push("        ))".into());
            if let Some(reqwest_body) = request_body {
                let Some(reqwest_body_call) =
                    body_return_type.map(|return_type: ReturnType<'_>| {
                        return_type
                            .body
                            .unwrap_or_else(|| format!("json(&{body_parameter_name})").into())
                    })
                else {
                    panic!("could not convert reqwest body: {reqwest_body:?}")
                };
                output.push(format!("        .{reqwest_body_call}"));
            } else if matches!(method, Method::Put) {
                output.push(r#"        .header(CONTENT_LENGTH, "0")"#.into());
            }
            output.push("        .bearer_auth(self.token_supplier.get(&self.url).await?);".into());

            output.extend(query_parameters.into_iter().flat_map(
                |(query_parameter, query_parameter_name)| {
                    let value = match query_parameter.schema {
                        Kind::Generic(Generic::Array { .. }) => format!(
                            r#"v.into_iter().map(|e| ("{}", e)).collect::<Vec<_>>()"#,
                            query_parameter.name
                        ),
                        _ => format!(r#"[("{}", v)]"#, query_parameter.name),
                    };
                    [
                        format!("if let Some(v) = {query_parameter_name} {{"),
                        format!(r#"    builder = builder.query(&{value});"#,),
                        "}".into(),
                    ]
                    .map(|line| format!("    {line}"))
                },
            ));

            if let Some(ReturnType { body, convert, .. }) = result_type.as_ref() {
                let body = body.as_deref().unwrap_or("json");
                output.push("    let response = builder.send().await?;".into());
                output.push(format!(
                    "    Ok(error_check(response).await?.{body}().await{}?)",
                    convert.as_deref().unwrap_or_default()
                ));
            } else if use_default_response {
                output.push("    let response = builder.send().await?;".into());
                output.push("    error_check(response).await.map(From::from)".into());
            } else {
                output.push("    let response = builder.send().await?;".into());
                output.push("    error_check(response).await?;".into());
                output.push("    Ok(())".into());
            }

            output.push("}".into());

            output
                .into_iter()
                .map(|s| "    ".to_string() + &s)
                .collect::<Vec<_>>()
                .join("\n")
                + "\n"
        }

        fn to_rust_realm_method(
            &self,
            path: &str,
            method: &Method,
            parameters: Option<&[Parameter]>,
        ) -> super::RealmMethod {
            let mut method_name = path
                .strip_prefix("/admin/realms")
                .unwrap_or(path)
                .to_string();

            let mut path_snake_case = path.to_string();

            let call_parameters = parameters.into_iter().flatten().collect::<Vec<_>>();

            let parameters = call_parameters
                .clone()
                .into_iter()
                .chain(
                    self.parameters
                        .as_deref()
                        .into_iter()
                        .flatten()
                        .filter(|p| !call_parameters.iter().any(|cp| cp.name == p.name)),
                )
                .map(|parameter| {
                    let mut param_name = parameter.name.to_snake_case();
                    while RESERVED_WORDS.contains(&param_name.as_str()) {
                        param_name += "_";
                    }

                    (parameter, param_name)
                })
                .collect::<Vec<_>>();
            for (parameter, parameter_name) in &parameters {
                if parameter.position == ParameterPosition::Path {
                    let parameter_with = if parameter.name == "realm" {
                        ""
                    } else {
                        "with_"
                    }
                    .to_string()
                        + parameter_name.as_str();
                    method_name =
                        method_name.replace(&format!("{{{}}}", parameter.name), &parameter_with);
                }
                if parameter_name != &parameter.name {
                    path_snake_case = path_snake_case.replace(
                        &format!("{{{}}}", parameter.name),
                        &format!("{{{parameter_name}}}"),
                    );
                }
            }

            let method_string = method.to_string();

            let method_draft_name = method_name + &method_string;
            let real_fn_name = method_draft_name.to_snake_case();
            let result_type = self.responses.to_rust_return_type_and_parse_calls();

            let mut result_type_value = result_type
                .as_ref()
                .map(|rt| rt.value.as_ref())
                .unwrap_or("DefaultResponse");

            let use_default_response = result_type.is_none();

            let (method_string_lc, comments) = self.comments(
                &parameters,
                method_string,
                path,
                &path_snake_case,
                use_default_response,
            );

            let request_body = self.request_body.as_ref();

            let body_parameter_name = "body";

            let body_parameter = request_body.and_then(|request_body| {
                request_body.to_parameter(body_parameter_name.to_string())
            });

            let parameters_of_method = prepare_method_parameters(
                path,
                &parameters,
                &method_string_lc,
                body_parameter.as_ref(),
            )
            .map(
                |(param, param_name, param_type)| super::RealmMethodParameter {
                    name: param_name.into(),
                    rust_type: param_type.into(),
                    required: param.required,
                    description: param.description.clone(),
                    deprecated: param.deprecated,
                },
            )
            .collect::<Vec<_>>();

            let desc = Toml::desc::<_, _, String>(path, &method_string_lc, None);
            if let Some(desc) = desc.as_ref() {
                let from_type = desc.from_type.as_str();
                if from_type != result_type_value {
                    let redundant = result_type_value == desc.rust_type;
                    let full_header = format!(r#"[path."{path}:{method_string_lc}:"]"#);
                    if redundant {
                        delete_mapping(&full_header);
                    } else {
                        eprintln!(
                            "warn: type info changed in {full_header} : was {from_type} now {result_type_value} (mapped {})",
                            &desc.rust_type
                        );
                    }
                }
                result_type_value = desc.rust_type.as_str();
            } else if result_type_value == "Value" {
                eprintln!(r#"warn: Value as result in [path."{path}:{method_string_lc}:"]"#);
            }

            super::RealmMethod {
                name: real_fn_name
                    .strip_prefix("realm_")
                    .unwrap_or(real_fn_name.as_str())
                    .to_string(),
                comments,
                real_fn_name,
                tags: self
                    .tags
                    .as_ref()
                    .map(|tags| tags.iter().map(|tag| tag.to_kebab_case()).collect()),
                deprecated: self.deprecated,
                has_optional_parameters: parameters
                    .iter()
                    .any(|(parameter, _)| !parameter.required),
                parameters: parameters_of_method,
                summary: self.summary.clone(),
                description: self.description.clone(),
                returns: result_type_value.into(),
            }
        }

        fn comments(
            &self,
            parameters: &[(&Parameter, String)],
            method_string: String,
            path: &str,
            path_snake_case: &String,
            default_response: bool,
        ) -> (String, Vec<String>) {
            let mut comments: Vec<Vec<Cow<str>>> = vec![];

            if let Some(comment) = self
                .summary
                .as_ref()
                .map(|s| s.trim().lines().map(Cow::Borrowed).collect())
            {
                comments.push(comment);
            }
            let has_request_body = self.request_body.is_some();
            if !parameters.is_empty() || has_request_body {
                comments.push(vec!["Parameters:".into()]);
                comments.push(
                    parameters
                        .iter()
                        .map(|(parameter, parameter_name)| {
                            format!(
                                "- `{parameter_name}`{}",
                                parameter
                                    .description
                                    .as_ref()
                                    .map(|comment| format!(": {}", comment.replace('\n', "")))
                                    .unwrap_or_default()
                            )
                        })
                        .map(Cow::Owned)
                        .chain(if has_request_body {
                            vec![Cow::Borrowed("- `body`")]
                        } else {
                            vec![]
                        })
                        .collect(),
                );
            }
            if default_response {
                comments.push(vec!["Returns response for future processing.".into()]);
            }
            if let [tag] = self.tags.as_deref().unwrap_or(&[]) {
                comments.push(vec![format!("Resource: `{tag}`").into()]);
            }
            comments.push(vec![format!(
                "`{} {path_snake_case}`",
                method_string.to_ascii_uppercase()
            )
            .into()]);

            let mut anchor_suffix = path.replace('-', "_");
            anchor_suffix.retain(|c| !"{}/".contains(c));
            let anchor_suffix = anchor_suffix.to_ascii_lowercase();
            let keycloak_version = format!(
                "{}.{}.{}",
                env!("CARGO_PKG_VERSION_MAJOR"),
                env!("CARGO_PKG_VERSION_MINOR"),
                env!("CARGO_PKG_VERSION_PATCH")
                    .parse::<u64>()
                    .expect("number")
                    / 100,
            );

            let method_string_lc = method_string.to_ascii_lowercase();
            let anchor = format!("_{method_string_lc}_{anchor_suffix}");
            comments.push(vec![format!(
                "Documentation: <https://www.keycloak.org/docs-api/{keycloak_version}/rest-api/index.html#{anchor}>"
            )
            .into()]);

            if *path_snake_case != path {
                comments.push(vec![format!(
                    "REST method: `{} {path}`",
                    method_string.to_ascii_uppercase()
                )
                .into()]);
            }

            let comments: Vec<_> = comments
                .into_iter()
                .map(|c| {
                    c.into_iter()
                        .map(|l| format!("/// {l}\n"))
                        .collect::<Vec<_>>()
                        .join("")
                })
                .collect::<Vec<_>>()
                .join("///\n")
                .lines()
                .map(ToString::to_string)
                .collect();
            (method_string_lc, comments)
        }
    }

    fn prepare_method_parameters<'p>(
        path: &'p str,
        parameters: &'p Vec<(&'p Parameter, String)>,
        method_string_lc: &'p str,
        body_parameter: Option<&'p Parameter>,
    ) -> impl Iterator<Item = (&'p Parameter, Cow<'p, str>, Cow<'p, str>)> + use<'p> {
        parameters
            .iter()
            .map(|(parameter, param_name)| {
                let param_type = parameter.schema.to_rust_parameter_type(parameter.required);

                (*parameter, Cow::Borrowed(param_name.as_str()), param_type)
            })
            .chain(
                body_parameter
                    .map(|param| (param, param.name.as_str().into(), param.schema.to_rust_type(RefMode::Std))),
            )
            .map(move |(param, param_name, param_type)| {
                let desc = Toml::desc(path, method_string_lc, Some(param_name.as_ref()));

                let param_type = if let Some(desc) = desc.as_ref() {
                    let from_type = desc.from_type.as_str();
                    if from_type != param_type {
                        let redundant = param_type == desc.rust_type;
                        let full_header = format!(r#"[path."{path}:{method_string_lc}:{param_name}"]"#);
                        if redundant {
                            delete_mapping(&full_header);
                        } else {
                            eprintln!(
                                "warn: body type info changed in {full_header} : was {from_type} now {param_type} (mapped {})",
                                &desc.rust_type
                            );
                        }
                    }
                    desc.rust_type.clone().into()
                } else {
                    param_type
                };
                (param, param_name, param_type)
            })
    }

    fn delete_mapping(header: &str) {
        let mut in_header = false;
        std::fs::write(
            "examples/openapi.patch.toml",
            std::fs::read_to_string("examples/openapi.patch.toml")
                .expect("could not read examples/openapi.patch.toml")
                .split('\n')
                .fold(Vec::<&'_ str>::new(), |mut acc, x| {
                    if !in_header {
                        if x == header {
                            in_header = true;
                        } else {
                            acc.push(x);
                        }
                    } else if x.starts_with("[path.") {
                        in_header = false;
                        acc.push(x);
                    }
                    acc
                })
                .join("\n"),
        )
        .expect("write to examples/openapi.patch.toml");
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, PartialOrd, Ord, Hash)]
    #[serde(rename_all = "lowercase")]
    pub enum Method {
        Delete,
        Get,
        Post,
        Put,
    }

    impl Display for Method {
        fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
            write!(f, "{self:?}")
        }
    }

    #[derive(Debug, Deserialize)]
    pub struct Parameter {
        pub name: String,
        #[serde(rename = "in")]
        pub position: ParameterPosition,
        pub description: Option<String>,
        #[serde(default)]
        pub required: bool,
        #[serde(default)]
        pub deprecated: bool,
        pub schema: Kind,
    }

    #[derive(Debug, Deserialize, PartialEq, Eq)]
    #[serde(rename_all = "lowercase")]
    pub enum ParameterPosition {
        Path,
        Query,
    }

    #[derive(Debug, Deserialize)]
    pub struct Components {
        pub schemas: IndexMap<String, SchemaObj>,
    }

    #[derive(Debug, Deserialize)]
    pub struct SchemaObj {
        #[serde(default)]
        deprecated: bool,
        #[serde(flatten)]
        schema: Schema,
    }

    impl SchemaObj {
        pub fn to_rust_type_definition(&self, name: &str, ref_mode: RefMode) -> String {
            format!(
                "{}{}",
                if self.deprecated {
                    "#[deprecated]\n"
                } else {
                    ""
                },
                self.schema.to_rust_type_definition(name, ref_mode)
            )
        }
    }

    #[derive(Debug, Deserialize)]
    #[serde(rename_all = "lowercase", tag = "type")]
    pub enum Schema {
        Object(ObjectSchema<Property>),
        String(StringSchema),
    }

    impl Schema {
        pub fn to_rust_type_definition(&self, name: &str, ref_mode: RefMode) -> String {
            match self {
                Schema::Object(schema_obj) => schema_obj.to_rust_type_definition(name, ref_mode),
                Schema::String(schema_str) => schema_str.to_rust_type_definition(name),
            }
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(untagged)]
    pub enum ObjectSchema<P> {
        Struct(SchemaStruct<P>),
        Map(SchemaMap<P>),
        AllOf(SchemaAllOf<P>),
        Value {},
    }

    impl ObjectSchema<Property> {
        fn to_rust_type_definition(&self, name: &str, ref_mode: RefMode) -> String {
            match self {
                ObjectSchema::Struct(schema_struct) => {
                    schema_struct.to_rust_type_definition(name, ref_mode)
                }
                ObjectSchema::Map(schema_map) => schema_map.to_rust_type_definition(name, ref_mode),
                ObjectSchema::AllOf(_) => todo!(),
                ObjectSchema::Value {} => {
                    format!("pub type {name} = TypeMap<String, TypeValue>;\n")
                }
            }
        }
    }

    impl ObjectSchema<Kind> {
        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            match self {
                ObjectSchema::Struct(schema_struct) => schema_struct.to_rust_type(ref_mode),
                ObjectSchema::Map(schema_map) => schema_map.to_rust_type(ref_mode),
                ObjectSchema::AllOf(schema_all_of) => schema_all_of.to_rust_type(ref_mode),
                ObjectSchema::Value {} => "Value".into(),
            }
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Clone)]
    pub struct SchemaStruct<P> {
        pub properties: IndexMap<String, P>,
    }

    impl<P: std::hash::Hash> std::hash::Hash for SchemaStruct<P> {
        fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
            self.properties.as_slice().hash(state);
        }
    }

    impl SchemaStruct<Property> {
        fn to_rust_type_definition(&self, name: &str, ref_mode: RefMode) -> String {
            let mut fields = self
                .properties
                .iter()
                .map(|(field, prop)| {
                    let mut field_name = field.to_snake_case();

                    let field_case = if RESERVED_WORDS.contains(&field_name.as_str()) {
                        field_name += "_";
                        FieldCase::Custom
                    } else if field == &field_name {
                        if field.contains('_') {
                            FieldCase::SnakeCase
                        } else {
                            FieldCase::Unknown
                        }
                    } else if field == &field.to_lower_camel_case() {
                        FieldCase::CamelCase
                    } else {
                        FieldCase::Custom
                    };
                    if field != &field_name {
                        while self.properties.contains_key(&field_name) {
                            field_name += "_";
                        }
                    }

                    (
                        field.as_str(),
                        field_name,
                        field_case,
                        prop.to_rust_type_opt(ref_mode),
                        prop.deprecated,
                    )
                })
                .collect::<Vec<_>>();

            fields.sort_by(|a, b| a.0.cmp(b.0));

            let count_snake_case = fields
                .iter()
                .filter(|(_, _, field_case, _, _)| &FieldCase::SnakeCase == field_case)
                .count();
            let count_camel_case = fields
                .iter()
                .filter(|(_, _, field_case, _, _)| &FieldCase::CamelCase == field_case)
                .count();

            let (rename_to_camel_case, type_prefix) = if count_camel_case > count_snake_case {
                (
                    true,
                    r##"
#[serde(rename_all = "camelCase")]"##,
                )
            } else {
                (false, "")
            };
            format!(
                r##"#[skip_serializing_none]
#[derive(Clone, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
#[cfg_attr(feature = "schemars", derive(JsonSchema))]{}
pub struct {name} {{
{}
}}
"##,
                type_prefix,
                fields
                    .into_iter()
                    .map(|(field, field_name, field_case, field_type, deprecated)| {
                        let field_desc = Toml::field(name, &field_name);
                        let fld_type = field_desc
                            .as_ref()
                            .map(|field_desc| Cow::Borrowed(field_desc.rust_type.as_str()))
                            .unwrap_or(field_type);
                        let is_rename = match field_case {
                            FieldCase::Custom => true,
                            FieldCase::Unknown => false,
                            FieldCase::CamelCase => !rename_to_camel_case,
                            FieldCase::SnakeCase => rename_to_camel_case,
                        };

                        let field_desc = if !is_rename {
                            format!(r##"    pub {field_name}: {fld_type},"##)
                        } else {
                            format!(
                                r##"    #[serde(rename = "{field}")]
    pub {field_name}: {fld_type},"##,
                            )
                        };
                        if !deprecated {
                            field_desc
                        } else {
                            format!("    #[deprecated]\n{field_desc}")
                        }
                    })
                    .collect::<Vec<_>>()
                    .join("\n")
            )
        }
    }

    impl SchemaStruct<Kind> {
        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            let property_types: HashSet<&Kind> = self.properties.values().collect();
            let property_type = match property_types.into_iter().collect::<Vec<_>>().as_slice() {
                &[property_type_kind] => property_type_kind.to_rust_type(ref_mode),
                _ => "Value".into(),
            };
            format!("TypeMap<String, {property_type}>",).into()
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(rename_all = "camelCase")]
    pub struct SchemaMap<P> {
        pub additional_properties: P,
    }

    impl SchemaMap<Property> {
        fn to_rust_type_definition(&self, name: &str, ref_mode: RefMode) -> String {
            format!(
                "pub type {name} = TypeMap<String, {}>;\n",
                self.additional_properties.to_rust_type(ref_mode)
            )
        }
    }

    impl SchemaMap<Kind> {
        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            format!(
                "TypeMap<String, {}>",
                self.additional_properties.to_rust_type(ref_mode)
            )
            .into()
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(rename_all = "camelCase")]
    pub struct SchemaAllOf<P> {
        pub all_of: Vec<P>,
    }

    impl SchemaAllOf<Kind> {
        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            match &self.all_of.as_slice() {
                &[property] => property.to_rust_type(ref_mode),
                _ => todo!(),
            }
        }
    }

    #[derive(Debug, Deserialize)]
    #[serde(rename_all = "lowercase")]
    pub enum StringSchema {
        Enum(Vec<String>),
    }

    impl StringSchema {
        fn to_rust_type_definition(&self, name: &str) -> String {
            match self {
                StringSchema::Enum(variants) => {
                    let is_uppercase = !variants
                        .iter()
                        .any(|variant| variant.chars().any(|c| c.is_lowercase()));
                    format!(
                        r##"#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Deserialize, Serialize)]
#[cfg_attr(feature = "schemars", derive(JsonSchema))]{}
pub enum {name} {{
{}
}}
"##,
                        if is_uppercase {
                            "\n#[serde(rename_all = \"SCREAMING_SNAKE_CASE\")]"
                        } else {
                            ""
                        },
                        variants
                            .iter()
                            .map(|variant| format!("    {},", variant.to_upper_camel_case()))
                            .collect::<Vec<_>>()
                            .join("\n")
                    )
                }
            }
        }
    }

    #[derive(Clone, Copy)]
    pub enum RefMode {
        Owned,
        Borrowed,
        Std,
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(untagged)]
    pub enum Kind {
        Generic(Generic),
        Ref(Ref),
        DefaultValue {},
    }

    impl Kind {
        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            self.to_rust_type_ref(ref_mode)
        }

        fn to_rust_parameter_type(&self, required: bool) -> Cow<'_, str> {
            let parameter_type = self.to_rust_type_ref(if required {
                RefMode::Borrowed
            } else {
                RefMode::Std
            });
            if required {
                parameter_type
            } else {
                Cow::Owned(format!("Option<{parameter_type}>"))
            }
        }

        fn to_rust_type_ref(&self, ref_mode: RefMode) -> Cow<'_, str> {
            match self {
                Kind::Generic(obj) => match obj {
                    Generic::Array {
                        items,
                        unique_items: _,
                    } => {
                        let item_type = if let Some(items) = items {
                            items.to_rust_type(RefMode::Std)
                        } else {
                            "TypeValue".into()
                        };
                        match ref_mode {
                            RefMode::Owned => format!("TypeVec<{item_type}>"),
                            RefMode::Borrowed => format!("&[{item_type}]"),
                            RefMode::Std => format!("Vec<{item_type}>"),
                        }
                        .into()
                    }
                    Generic::Boolean => "bool".into(),
                    Generic::Integer { format } => match format {
                        IntegerFormat::Int32 => "i32".into(),
                        IntegerFormat::Int64 => "i64".into(),
                    },
                    Generic::Object(obj) => obj.to_rust_type(ref_mode),
                    Generic::String => match ref_mode {
                        RefMode::Owned => "TypeString",
                        RefMode::Borrowed => "&str",
                        RefMode::Std => "String",
                    }
                    .into(),
                },
                Kind::Ref(Ref { reference }) => reference
                    .strip_prefix("#/components/schemas/")
                    .expect("#/components/schemas/ prefixed type name")
                    .into(),
                Kind::DefaultValue {} => "Value".into(),
            }
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    pub struct Property {
        #[serde(default)]
        deprecated: bool,
        #[serde(default)]
        required: bool,
        #[serde(flatten)]
        kind: Kind,
    }

    impl Property {
        fn to_rust_type_opt(&self, ref_mode: RefMode) -> Cow<'_, str> {
            let rust_type = self.to_rust_type(ref_mode);
            if self.required {
                rust_type
            } else {
                format!("Option<{rust_type}>").into()
            }
        }

        fn to_rust_type(&self, ref_mode: RefMode) -> Cow<'_, str> {
            self.kind.to_rust_type(ref_mode)
        }
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(rename_all = "lowercase", tag = "type")]
    pub enum Generic {
        Array {
            items: Option<Box<Property>>,
            #[serde(rename = "uniqueItems", default)]
            unique_items: bool,
        },
        Boolean,
        Integer {
            format: IntegerFormat,
        },
        Object(Box<ObjectSchema<Kind>>),
        String,
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    pub struct Ref {
        #[serde(rename = "$ref")]
        pub reference: String,
    }

    #[derive(Debug, Deserialize, PartialEq, Eq, Hash, Clone)]
    #[serde(rename_all = "lowercase")]
    pub enum IntegerFormat {
        Int32,
        Int64,
    }

    #[derive(Debug, Deserialize)]
    struct PathDesc {
        from_type: String,
        rust_type: String,
        method: Option<String>,
        convert: Option<String>,
    }

    #[derive(Debug, Deserialize)]
    struct FieldDesc {
        rust_type: String,
    }

    #[derive(Debug, Deserialize)]
    struct Toml {
        #[serde(default)]
        path: IndexMap<String, Arc<PathDesc>>,
        #[serde(default)]
        r#type: IndexMap<String, Arc<FieldDesc>>,
    }

    impl Toml {
        fn desc<P, M, A>(path: P, method: M, parameter: Option<A>) -> Option<Arc<PathDesc>>
        where
            P: Display,
            M: Display,
            A: Display + Default,
        {
            OPENAPI_PATCH.with(|toml| {
                toml.path
                    .get(&format!(
                        "{path}:{method}:{}",
                        parameter.unwrap_or_default()
                    ))
                    .cloned()
            })
        }

        fn field<S, F>(structure: S, field: F) -> Option<Arc<FieldDesc>>
        where
            S: Display,
            F: Display,
        {
            OPENAPI_PATCH.with(|toml| toml.r#type.get(&format!("{structure}:{field}",)).cloned())
        }
    }

    thread_local! {
        static OPENAPI_PATCH: Toml = toml::from_str(include_str!("openapi.patch.toml")).unwrap();
    }
}

fn main() {
    let cli = Cli::parse();

    let specs: openapi::Spec = serde_json::from_slice(include_bytes!("../api/openapi.json"))
        .expect("valid openapi json specs");

    match cli.command {
        Command::Types => generate_types(&specs),
        Command::Rest { no_tag, tag } => generate_rest(&specs, no_tag, tag),
        Command::Methods { no_tag, tag } => generate_methods(&specs, no_tag, tag),
        Command::Tags { format } => match format.unwrap_or_default() {
            TagsFormat::Cargo => list_tags_for_cargo(&specs),
            TagsFormat::Kebab => list_tags_as_kebab(&specs),
            TagsFormat::ModResource => list_tags_for_mod_resource(
                &specs,
                std::env::var("OTHER_METHODS_MOD")
                    .ok()
                    .as_deref()
                    .unwrap_or("other_methods"),
            ),
            TagsFormat::ModRest => list_tags_for_mod_rest(
                &specs,
                std::env::var("OTHER_METHODS_MOD")
                    .ok()
                    .as_deref()
                    .unwrap_or("other_methods"),
            ),
        },
        Command::Specs => {
            println!("{specs:#?}");
        }
    }
}

fn generate_rest(spec: &openapi::Spec, no_tag: bool, tag_as_kebab: Option<String>) {
    let (add_cfg, tag_paths) = collect_tag_paths(spec, no_tag, tag_as_kebab);
    print!(
        r###"use super::*;

impl<TS: KeycloakTokenSupplier> KeycloakAdmin<TS> {{
"###
    );
    let mut path_counts = spec.paths.len();
    for (tag, paths) in tag_paths {
        println!("    // <h4>{tag}</h4>\n");

        for (path, path_spec) in paths {
            println!("{}", path_spec.to_rust_rest_client_method(path, add_cfg));
            path_counts -= 1;
        }
    }
    println!("}}");
    if path_counts > 0 {
        println!("// not all paths processed");
        println!("// left {path_counts}");
    }
}

fn spec_paths_without_tag<'s>(
    spec: &'s openapi::Spec<'s>,
) -> Vec<(&'s String, &'s openapi::SpecPath<'s>)> {
    spec.paths
        .iter()
        .filter(|(_, path_spec)| {
            path_spec.calls.iter().all(|(_, call)| {
                call.tags
                    .as_ref()
                    .map(|tags| tags.is_empty())
                    .unwrap_or(true)
            })
        })
        .collect()
}

fn spec_paths_by_tag<'s>(
    spec: &'s openapi::Spec<'s>,
    tag: &str,
) -> Vec<(&'s String, &'s openapi::SpecPath<'s>)> {
    spec.paths
        .iter()
        .filter(|(_, path_spec)| {
            path_spec.calls.iter().all(|(_, call)| {
                let call_tags = call.tags.as_deref();
                let call_tags_ref = call_tags.as_ref();
                matches!(call_tags_ref, Some(&[tag_name]) if tag_name == tag)
            })
        })
        .collect()
}

fn generate_types(spec: &openapi::Spec) {
    println!(
        r###"use std::collections::HashMap;
#[cfg(any(feature = "rc-str", feature = "rc-vec"))]
use std::sync::Arc;

#[cfg(feature = "schemars")]
use schemars::JsonSchema;
use serde::{{Deserialize, Serialize}};
use serde_json::Value;
use serde_with::skip_serializing_none;

#[cfg(not(feature = "rc-map"))]
pub type TypeMap<K, V> = HashMap<K, V>;
#[cfg(not(feature = "rc-str"))]
pub type TypeString = String;
#[cfg(not(feature = "rc-val"))]
pub type TypeValue = Value;
#[cfg(not(feature = "rc-vec"))]
pub type TypeVec<I> = Vec<I>;

#[cfg(feature = "rc-map")]
pub type TypeMap<K, V> = Arc<HashMap<K, V>>;
#[cfg(feature = "rc-str")]
pub type TypeString = Arc<str>;
#[cfg(feature = "rc-val")]
pub type TypeValue = Arc<Value>;
#[cfg(feature = "rc-vec")]
pub type TypeVec<I> = Arc<[I]>;"###
    );

    for (schema_name, schema_obj) in &spec.components.schemas {
        print!(
            "\n{}",
            schema_obj.to_rust_type_definition(schema_name, openapi::RefMode::Owned)
        );
    }
}

const DEFAULT: Cow<'static, str> = Cow::Borrowed("default");

fn generate_methods(spec: &openapi::Spec, no_tag: bool, tag_as_kebab: Option<String>) {
    let (add_cfg, tag_paths) = collect_tag_paths(spec, no_tag, tag_as_kebab);

    let tag_realm_methods: Vec<_> = tag_paths
        .into_iter()
        .map(|(tag, paths)| {
            (
                tag,
                paths
                    .into_iter()
                    .flat_map(|(path, path_spec)| path_spec.to_rust_realm_methods(path))
                    .collect::<Vec<_>>(),
            )
        })
        .collect();

    generate_method_impl(add_cfg, &tag_realm_methods);

    generate_method_structs(add_cfg, &tag_realm_methods);

    generate_method_builder(add_cfg, &tag_realm_methods);
}

fn collect_tag_paths<'s>(
    spec: &'s openapi::Spec<'s>,
    no_tag: bool,
    tag_as_kebab: Option<String>,
) -> (
    bool,
    Vec<(
        &'s Cow<'s, str>,
        Vec<(&'s String, &'s openapi::SpecPath<'s>)>,
    )>,
) {
    let tags_iter = spec.tags.iter();
    let (tags, add_cfg): (Vec<_>, _) = if let Some(tag) = tag_as_kebab.as_deref() {
        (
            tags_iter
                .filter(|t| t.name.to_kebab_case() == tag)
                .collect(),
            no_tag,
        )
    } else if !no_tag {
        (tags_iter.collect(), true)
    } else {
        (Vec::new(), false)
    };

    let mut tag_paths: Vec<_> = tags
        .into_iter()
        .map(|tag| (&tag.name, spec_paths_by_tag(spec, &tag.name)))
        .collect();

    if no_tag || tag_as_kebab.is_none() {
        tag_paths.extend([(&DEFAULT, spec_paths_without_tag(spec))]);
    }
    (add_cfg, tag_paths)
}

fn generate_method_builder(add_cfg: bool, tag_realm_methods: &[(&Cow<'_, str>, Vec<RealmMethod>)]) {
    if !tag_realm_methods
        .iter()
        .any(|(_, methods)| methods.iter().any(|method| method.has_optional_parameters))
    {
        return;
    }
    println!("#[cfg(feature = \"builder\")]");
    println!("mod builder {{");
    println!("use crate::builder::Builder;\n");
    println!("use super::*;\n");

    for (tag, realm_methods) in tag_realm_methods {
        println!("\n// <h4>{tag}</h4>");
        for RealmMethod {
            real_fn_name,
            tags,
            parameters,
            ..
        } in realm_methods
            .iter()
            .filter(|method| method.has_optional_parameters)
        {
            let no_realm_parameter = !parameters.iter().any(|p| p.name == "realm");
            if no_realm_parameter {
                continue;
            }
            let tag = tags
                .as_ref()
                .and_then(|tags| tags.first())
                .map(|tag| tag.to_kebab_case());
            let tag_str = tag.as_deref().unwrap_or("none");
            let struct_name = real_fn_name.to_upper_camel_case();
            let optional_parameters = parameters
                .iter()
                .filter(|p| !p.required && p.name != "realm")
                .collect::<Vec<_>>();
            if add_cfg {
                println!("#[cfg(feature = \"tag-{tag_str}\")]",);
            }
            println!("impl <'a, TS> {struct_name}<'a, TS>");
            println!("where");
            println!("    TS: KeycloakTokenSupplier + Send + Sync,");
            println!("{{");
            for parameter in &optional_parameters {
                if let Some(comment) = &parameter.description {
                    println!("    /// {comment}",);
                }
                let parameter_name = &parameter.name;
                let rust_type = &parameter.rust_type;
                println!("    pub fn {parameter_name}(self, value: impl Into<{rust_type}>) -> Builder<'a, Self> {{");
                println!("        self.builder().{parameter_name}(value)");
                println!("    }}");
            }
            println!("}}\n");

            println!("impl<TS> Builder<'_, {struct_name}<'_, TS>>");
            println!("where");
            println!("    TS: KeycloakTokenSupplier + Send + Sync,");
            println!("{{");
            for parameter in &optional_parameters {
                if let Some(comment) = &parameter.description {
                    println!("    /// {comment}",);
                }
                let parameter_name = &parameter.name;
                let rust_type = &parameter.rust_type;
                println!(
                    "    pub fn {parameter_name}(mut self, value: impl Into<{rust_type}>) -> Self {{"
                );
                println!("        self.args.{parameter_name} = value.into();");
                println!("        self");
                println!("    }}");
            }
            println!("}}\n");
        }
    }
    println!("}}");
}

fn generate_method_structs(add_cfg: bool, tag_realm_methods: &[(&Cow<'_, str>, Vec<RealmMethod>)]) {
    for (tag, realm_methods) in tag_realm_methods {
        if !realm_methods
            .iter()
            .any(|method| method.has_optional_parameters)
        {
            continue;
        }
        println!("\n// <h4>{tag}</h4>");
        for RealmMethod {
            real_fn_name,
            tags,
            parameters,
            returns,
            ..
        } in realm_methods
            .iter()
            .filter(|method| method.has_optional_parameters)
        {
            let no_realm_parameter = !parameters.iter().any(|p| p.name == "realm");
            if no_realm_parameter {
                continue;
            }
            let tag = tags
                .as_ref()
                .and_then(|tags| tags.first())
                .map(|tag| tag.to_kebab_case());
            let tag_str = tag.as_deref().unwrap_or("none");
            let struct_name = real_fn_name.to_upper_camel_case();
            let required_parameters = parameters
                .iter()
                .filter(|p| p.required && p.name != "realm")
                .collect::<Vec<_>>();
            let optional_parameters = parameters
                .iter()
                .filter(|p| !p.required && p.name != "realm")
                .collect::<Vec<_>>();
            if add_cfg {
                println!("#[cfg(feature = \"tag-{tag_str}\")]",);
            }
            println!("pub struct {struct_name}<'a, TS: KeycloakTokenSupplier> {{");
            println!("    /// Realm admin client");
            println!("    pub realm_admin: &'a KeycloakRealmAdmin<'a, TS>,");
            for parameter in &required_parameters {
                if let Some(comment) = &parameter.description {
                    println!("    /// {comment}",);
                }
                println!(
                    "    pub {}: {},",
                    parameter.name,
                    parameter.rust_type.replace("&", "&'a ")
                );
            }
            println!("}}\n");
            if add_cfg {
                println!("#[cfg(feature = \"tag-{tag_str}\")]",);
            }
            println!("#[derive(Default)]");
            println!("pub struct {struct_name}Args {{");
            for parameter in &optional_parameters {
                if let Some(comment) = &parameter.description {
                    println!("    /// {comment}",);
                }
                println!("    pub {}: {},", parameter.name, parameter.rust_type);
            }
            println!("}}\n");
            if add_cfg {
                println!("#[cfg(feature = \"tag-{tag_str}\")]",);
            }
            println!("impl<'a, TS: KeycloakTokenSupplier + Send + Sync> KeycloakRealmAdminMethod");
            println!("    for {struct_name}<'a, TS>");
            println!("{{");
            println!("    type Output = {returns};");
            println!("    type Args = {struct_name}Args;");
            println!();
            println!("    fn opts(");
            println!("        self,");
            println!("        Self::Args {{");
            for parameter in &optional_parameters {
                println!("            {},", parameter.name,);
            }
            println!("        }}: Self::Args,");
            println!("    ) -> impl Future<Output = Result<Self::Output, KeycloakError>> + use<'a, TS> {{");
            println!("        self.realm_admin");
            println!("            .admin");
            println!("            .{real_fn_name}(");
            println!("                self.realm_admin.realm,");
            for parameter in parameters.iter().filter(|p| p.name != "realm") {
                if parameter.required {
                    println!("                self.{},", parameter.name,);
                } else {
                    println!("                {},", parameter.name,);
                }
            }
            println!("            )");
            println!("    }}");
            println!("}}\n");
            if add_cfg {
                println!("#[cfg(feature = \"tag-{tag_str}\")]",);
            }
            println!("impl<'a, TS> IntoFuture for {struct_name}<'a, TS>");
            println!("where");
            println!("    TS: KeycloakTokenSupplier + Send + Sync,");
            println!("{{");
            println!("    type Output = Result<{returns}, KeycloakError>;");
            println!(
                "    type IntoFuture = Pin<Box<dyn 'a + Future<Output = Self::Output> + Send>>;"
            );

            println!("    fn into_future(self) -> Self::IntoFuture {{");
            println!("        Box::pin(self.opts(Default::default()))");
            println!("    }}");
            println!("}}\n");
        }
    }
}

fn generate_method_impl(add_cfg: bool, tag_realm_methods: &[(&Cow<'_, str>, Vec<RealmMethod>)]) {
    print!(
        r###"use super::*;

impl<'a, TS: KeycloakTokenSupplier> KeycloakRealmAdmin<'a, TS> {{
"###
    );

    for (tag, realm_methods) in tag_realm_methods {
        println!("    // <h4>{tag}</h4>");

        for RealmMethod {
            name,
            comments,
            real_fn_name,
            tags,
            deprecated,
            has_optional_parameters,
            parameters,
            summary: _,
            description: _,
            returns,
        } in realm_methods
        {
            let no_realm_parameter = !parameters.iter().any(|p| p.name == "realm");
            if no_realm_parameter {
                continue;
            }
            for comment in comments {
                println!("    {comment}");
            }
            if add_cfg {
                let tag = tags
                    .as_ref()
                    .and_then(|tags| tags.first())
                    .map(|tag| tag.to_kebab_case());
                let tag_str = tag.as_deref().unwrap_or("none");
                println!("    #[cfg(feature = \"tag-{tag_str}\")]",);
            }
            if *deprecated {
                println!("    #[deprecated]");
            }

            let struct_name = real_fn_name.to_upper_camel_case();
            let required_parameters = parameters
                .iter()
                .filter(|p| p.required && p.name != "realm")
                .collect::<Vec<_>>();
            println!("    pub fn {name}(");
            println!("        &'a self,");
            for parameter in &required_parameters {
                println!(
                    "        {}: {},",
                    parameter.name,
                    parameter.rust_type.replace("&", "&'a ")
                );
            }
            if *has_optional_parameters {
                println!("    ) -> {struct_name}<'a, TS> {{");
                println!("        {struct_name} {{");
                println!("            realm_admin: self,");
                for parameter in &required_parameters {
                    println!("            {},", parameter.name,);
                }
                println!("        }}");
            } else {
                println!("    ) -> impl Future<Output = Result<{returns}, KeycloakError>> + use<'a, TS> {{");
                println!("        self.admin");
                println!("            .{real_fn_name}(");
                println!("                self.realm,");
                for parameter in &required_parameters {
                    println!("                {},", parameter.name,);
                }
                println!("            )");
            }
            println!("    }}\n");
        }
    }

    println!("}}");
}

fn list_tags_for_cargo(spec: &openapi::Spec) {
    use heck::ToKebabCase;
    let tags = spec
        .tags
        .iter()
        .map(|tag| "tag-".to_string() + tag.name.to_kebab_case().as_str())
        .chain(Some(TAG_NONE.to_string()))
        .collect::<Vec<_>>();
    println!(
        "tags-all = [{}]",
        tags.iter()
            .map(|tag| format!("{tag:?}"))
            .collect::<Vec<_>>()
            .join(", ")
    );
    tags.iter().for_each(|line| println!("{line} = []"));
}

fn list_tags_as_kebab(spec: &openapi::Spec) {
    use heck::ToKebabCase;
    for tag in &spec.tags {
        println!("{}", tag.name.to_kebab_case());
    }
}

fn list_tags_for_mod_resource(spec: &openapi::Spec, other_methods: &str) {
    use heck::{ToKebabCase, ToSnakeCase};
    println!(
        "use std::{{
    future::{{Future, IntoFuture}},
    pin::Pin,
}};

use serde_json::Value;

use crate::{{
    types::*, DefaultResponse, KeycloakError, KeycloakRealmAdmin, KeycloakRealmAdminMethod,
    KeycloakTokenSupplier,
}};
"
    );
    for tag in &spec.tags {
        println!("/// {}", tag.name);
        println!("#[cfg(feature = \"tag-{}\")]", tag.name.to_kebab_case());
        println!("pub mod {};", tag.name.to_snake_case());
    }
    println!("/// Other (non tagged) methods");
    println!("#[cfg(feature = \"{TAG_NONE}\")]");
    println!("pub mod {other_methods};");
}

fn list_tags_for_mod_rest(spec: &openapi::Spec, other_methods: &str) {
    use heck::{ToKebabCase, ToSnakeCase};
    println!(
        "use reqwest::header::CONTENT_LENGTH;
use serde_json::Value;

use super::{{url_enc::encode_url_param as p, *}};
"
    );
    for tag in &spec.tags {
        println!("/// {}", tag.name);
        println!("#[cfg(feature = \"tag-{}\")]", tag.name.to_kebab_case());
        println!("pub mod {};", tag.name.to_snake_case());
    }
    println!("/// Other (non tagged) methods");
    println!("#[cfg(feature = \"{TAG_NONE}\")]");
    println!("pub mod {other_methods};");
}