feat: make kopium usable as a library

Author: the-wondersmith

Cargo.toml

@@ -11,6 +11,7 @@ readme = "./README.md"
 repository = "https://github.com/kube-rs/kopium"
 keywords = ["kubernetes", "openapi"]
 categories = ["command-line-utilities", "parsing"]
+default-run = "kopium"
 
 [package.metadata.binstall]
 pkg-url = "{ repo }/releases/download/{ version }/kopium-{ target }{ archive-suffix }"
@@ -19,12 +20,15 @@ bin-dir = "kopium-{ target }/{ bin }{ format }"
 [[bin]]
 doc = false
 name = "kopium"
-path = "src/main.rs"
+path = "src/bin/kopium.rs"
 
 [lib]
 name = "kopium"
 path = "src/lib.rs"
 
+[lints.clippy]
+uninlined_format_args = "allow"
+
 [dependencies]
 tokio = { version = "1.46.1", features = ["full"] }
 anyhow = "1.0.98"

src/analyzer.rs

@@ -1,11 +1,13 @@
 //! Deals entirely with schema analysis for the purpose of creating output structs + members
-use crate::{Container, MapType, Member, Output};
+use std::collections::{BTreeMap, HashMap};
+
 use anyhow::{bail, Result};
 use heck::ToUpperCamelCase;
 use k8s_openapi::apiextensions_apiserver::pkg::apis::apiextensions::v1::{
     JSONSchemaProps, JSONSchemaPropsOrArray, JSONSchemaPropsOrBool, JSON,
 };
-use std::collections::{BTreeMap, HashMap};
+
+use crate::{Container, MapType, Member, Output};
 
 const IGNORED_KEYS: [&str; 3] = ["metadata", "apiVersion", "kind"];
 
@@ -429,8 +431,10 @@ fn array_recurse_for_type(
                 if s.type_.is_none() && s.x_kubernetes_preserve_unknown_fields == Some(true) {
                     return Ok(("Vec<serde_json::Value>".to_string(), level));
                 }
+
                 let inner_array_type = s.type_.clone().unwrap_or_default();
-                return match inner_array_type.as_ref() {
+
+                match inner_array_type.as_ref() {
                     "object" => {
                         // Same logic as in `extract_container` to simplify types to maps.
                         let mut dict_value = None;
@@ -467,7 +471,7 @@ fn array_recurse_for_type(
                     unknown => {
                         bail!("unsupported recursive array type \"{unknown}\" for {key}")
                     }
-                };
+                }
             }
             // maybe fallback to serde_json::Value
             _ => bail!("only support single schema in array {}", key),
@@ -580,10 +584,11 @@ fn extract_integer_type(value: &JSONSchemaProps) -> Result<String> {
 // unit tests particular schema patterns
 #[cfg(test)]
 mod test {
-    use super::{analyze, Config as Cfg};
+    use std::sync::Once;
+
     use k8s_openapi::apiextensions_apiserver::pkg::apis::apiextensions::v1::JSONSchemaProps;
 
-    use std::sync::Once;
+    use super::{analyze, Config as Cfg};
 
     static START: Once = Once::new();
     fn init() {

src/bin/kopium.rs

@@ -0,0 +1,27 @@
+#[tokio::main]
+async fn main() -> anyhow::Result<()> {
+    env_logger::init();
+
+    // Ignore SIGPIPE errors to avoid having to use let _ = write! everywhere
+    // See https://github.com/rust-lang/rust/issues/46016
+    #[cfg(unix)]
+    unsafe {
+        libc::signal(libc::SIGPIPE, libc::SIG_DFL);
+    }
+
+    let mut args = <kopium::Kopium as clap::Parser>::parse();
+
+    if args.auto {
+        args.docs = true;
+        args.schema = "derived".into();
+    }
+    if args.schema == "derived" {
+        let json_schema = kopium::Derive::all("JsonSchema");
+
+        if !args.derive.contains(&json_schema) {
+            args.derive.push(json_schema)
+        }
+    }
+
+    args.dispatch().await
+}