Add CI to publish OpenAPI file

crates/openapi-generator/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "openapi-generator"
+version = "0.1.0"
+edition = "2021"
+publish = false
+
+[dependencies]
+meilisearch = { path = "../meilisearch" }
+serde_json = "1.0"
+clap = { version = "4.5.40", features = ["derive"] }
+anyhow = "1.0.98"
+utoipa = "5.4.0" 

crates/openapi-generator/src/main.rs

@@ -0,0 +1,42 @@
+use anyhow::Result;
+use clap::Parser;
+use meilisearch::routes::MeilisearchApi;
+use utoipa::OpenApi;
+use std::path::PathBuf;
+
+#[derive(Parser)]
+#[command(name = "openapi-generator")]
+#[command(about = "Generate OpenAPI specification for Meilisearch")]
+struct Cli {
+    /// Output file path (default: meilisearch.json)
+    #[arg(short, long, value_name = "FILE")]
+    output: Option<PathBuf>,
+
+    /// Pretty print the JSON output
+    #[arg(short, long)]
+    pretty: bool,
+}
+
+fn main() -> Result<()> {
+    let cli = Cli::parse();
+
+    // Generate the OpenAPI specification
+    let openapi = MeilisearchApi::openapi();
+
+    // Determine output path
+    let output_path = cli.output.unwrap_or_else(|| PathBuf::from("meilisearch.json"));
+
+    // Serialize to JSON
+    let json = if cli.pretty {
+        serde_json::to_string_pretty(&openapi)?
+    } else {
+        serde_json::to_string(&openapi)?
+    };
+
+    // Write to file
+    std::fs::write(&output_path, json)?;
+
+    println!("OpenAPI specification written to: {}", output_path.display());
+
+    Ok(())
+}