add new api to reuse static exporter

Signed-off-by: Andrei Gherghescu <[email protected]>

Author: andrei-ng

examples/static_export_example/Cargo.toml

@@ -0,0 +1,10 @@
+[package]
+name = "static_export_example"
+version = "0.1.0"
+authors = ["Andrei Gherghescu [email protected]"]
+edition = "2021"
+
+[dependencies]
+plotly = { path = "../../plotly", features = ["static_export_default"] }
+env_logger = "0.10"
+log = "0.4" 

examples/static_export_example/src/main.rs

@@ -0,0 +1,52 @@
+use env_logger;
+use log::info;
+use plotly::plotly_static::{ImageFormat, StaticExporterBuilder};
+use plotly::{Plot, Scatter};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Initialize logging
+    env_logger::init();
+
+    // Create multiple plots
+    let mut plot1 = Plot::new();
+    plot1.add_trace(Scatter::new(vec![1, 2, 3, 4], vec![10, 15, 13, 17]).name("trace1"));
+
+    let mut plot2 = Plot::new();
+    plot2.add_trace(Scatter::new(vec![2, 3, 4, 5], vec![16, 5, 11, 9]).name("trace2"));
+
+    let mut plot3 = Plot::new();
+    plot3.add_trace(Scatter::new(vec![1, 2, 3, 4], vec![12, 9, 15, 12]).name("trace3"));
+
+    // Create a single StaticExporter to reuse across all plots
+    let mut exporter = StaticExporterBuilder::default()
+        .build()
+        .expect("Failed to create StaticExporter");
+
+    info!("Exporting multiple plots using a single StaticExporter...");
+
+    // Export all plots using the same exporter (more efficient)
+    plot1.write_image_with_exporter(&mut exporter, "plot1", ImageFormat::PNG, 800, 600, 1.0)?;
+    plot2.write_image_with_exporter(&mut exporter, "plot2", ImageFormat::JPEG, 800, 600, 1.0)?;
+    plot3.write_image_with_exporter(&mut exporter, "plot3", ImageFormat::SVG, 800, 600, 1.0)?;
+
+    // Export to PDF
+    plot1.write_image_with_exporter(&mut exporter, "plot1", ImageFormat::PDF, 800, 600, 1.0)?;
+
+    // Get base64 data
+    let base64_data =
+        plot1.to_base64_with_exporter(&mut exporter, ImageFormat::PNG, 400, 300, 1.0)?;
+    info!("Base64 data length: {}", base64_data.len());
+
+    // Get SVG data
+    let svg_data = plot1.to_svg_with_exporter(&mut exporter, 400, 300, 1.0)?;
+    info!("SVG data starts with: {}", &svg_data[..50]);
+
+    info!("All exports completed successfully!");
+    info!("Generated files:");
+    info!("  - plot1.png");
+    info!("  - plot2.jpeg");
+    info!("  - plot3.svg");
+    info!("  - plot1.pdf");
+
+    Ok(())
+}

plotly/Cargo.toml

@@ -19,10 +19,10 @@ kaleido = ["plotly_kaleido"]
 # DEPRECATED: kaleido_download feature will be removed in version 0.14.0. Use plotly_static_download instead.
 kaleido_download = ["plotly_kaleido/download"]
 
-plotly_static_download = ["plotly_static/download"]
-plotly_static_chromedriver = ["plotly_static", "plotly_static/chromedriver"]
-plotly_static_geckodriver = ["plotly_static", "plotly_static/geckodriver"]
-plotly_static = []
+static_export_downloader = ["plotly_static/webdriver_download"]
+static_export_chromedriver = ["plotly_static", "plotly_static/chromedriver"]
+static_export_geckodriver = ["plotly_static", "plotly_static/geckodriver"]
+static_export_default = ["plotly_static", "plotly_static/geckodriver", "plotly_static/webdriver_download"]
 
 plotly_ndarray = ["ndarray"]
 plotly_image = ["image"]

plotly/src/lib.rs

@@ -4,20 +4,26 @@
 //!
 //! ## Feature Deprecation Notice
 //!
-//! The `kaleido` and `kaleido_download` features are deprecated since version 0.13.0 
-//! and will be removed in version 0.14.0. Please migrate to the `plotly_static` and 
-//! `plotly_static_download` features instead.
+//! The `kaleido` and `kaleido_download` features are deprecated since version
+//! 0.13.0 and will be removed in version 0.14.0. Please migrate to the
+//! `plotly_static` and `plotly_static_download` features instead.
 #![recursion_limit = "256"] // lets us use a large serde_json::json! macro for testing crate::layout::Axis
 extern crate askama;
 extern crate rand;
 extern crate serde;
 
 #[cfg(feature = "kaleido")]
-#[deprecated(since = "0.13.0", note = "kaleido feature is deprecated and will be removed in version 0.14.0. Use plotly_static feature instead")]
+#[deprecated(
+    since = "0.13.0",
+    note = "kaleido feature is deprecated and will be removed in version 0.14.0. Use plotly_static feature instead"
+)]
 const _KALEIDO_DEPRECATED: () = ();
 
 #[cfg(feature = "kaleido_download")]
-#[deprecated(since = "0.13.0", note = "kaleido_download feature is deprecated and will be removed in version 0.14.0. Use plotly_static_download feature instead")]
+#[deprecated(
+    since = "0.13.0",
+    note = "kaleido_download feature is deprecated and will be removed in version 0.14.0. Use plotly_static_download feature instead"
+)]
 const _KALEIDO_DOWNLOAD_DEPRECATED: () = ();
 
 #[cfg(all(feature = "kaleido", target_family = "wasm"))]
@@ -51,13 +57,10 @@ pub use common::color;
 pub use configuration::Configuration;
 pub use layout::Layout;
 pub use plot::{Plot, Trace};
-
 #[cfg(feature = "kaleido")]
 pub use plotly_kaleido::ImageFormat;
-
 #[cfg(feature = "plotly_static")]
-pub use plotly_static::{StaticExporterBuilder, ImageFormat};
-
+pub use plotly_static;
 // Also provide easy access to modules which contain additional trace-specific types
 pub use traces::{
     box_plot, contour, heat_map, histogram, image, mesh3d, sankey, scatter, scatter3d,