ruviz 0.4.2

High-performance 2D plotting library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

//! Unified style module for consistent theming and styling across all plot types
//!
//! This module consolidates all styling-related types and utilities that were
//! previously scattered across `render` and `core` modules. It provides a
//! single import point for all styling needs.
//!
//! # Organization
//!
//! The style module re-exports types from their original locations for
//! backward compatibility, while providing a unified namespace:
//!
//! - **Colors**: [`Color`] - RGB/RGBA color representation
//! - **Themes**: [`Theme`] - Complete plot theming
//! - **Line styles**: [`LineStyle`] - Solid, dashed, dotted, etc.
//! - **Marker styles**: [`MarkerStyle`] - Circle, square, triangle, etc.
//! - **Grid styles**: [`GridStyle`] - Grid line configuration
//! - **Plot styles**: [`PlotStyle`] - High-level style presets
//! - **Style resolution**: [`StyleResolver`] - Theme-aware style resolution
//!
//! # Example
//!
//! ```rust,ignore
//! use ruviz::style::{Color, Theme, LineStyle, MarkerStyle, GridStyle};
//!
//! // Create a custom theme
//! let theme = Theme::dark();
//!
//! // Use style presets
//! let style = PlotStyle::Publication;
//!
//! // Configure grid appearance
//! let grid = GridStyle::default()
//!     .color(Color::LIGHT_GRAY)
//!     .alpha(0.3);
//! ```
//!
//! # Migration from Previous Imports
//!
//! Previous import paths continue to work:
//! ```rust,ignore
//! // Old paths (still work)
//! use ruviz::render::{Color, Theme, LineStyle, MarkerStyle};
//! use ruviz::core::{GridStyle, PlotStyle, StyleResolver};
//!
//! // New unified path (recommended)
//! use ruviz::style::{Color, Theme, LineStyle, MarkerStyle, GridStyle, PlotStyle, StyleResolver};
//! ```

// Re-export from render module
pub use crate::render::color::Color;
pub use crate::render::style::{LineStyle, MarkerStyle};
pub use crate::render::theme::Theme;

// Re-export from core module
pub use crate::core::grid_style::GridStyle;
pub use crate::core::style::PlotStyle;
pub use crate::core::style_utils::{StyleResolver, defaults};

// Re-export font types for styling
pub use crate::render::text::{FontFamily, FontWeight};

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_color_reexport() {
        let color = Color::new(255, 128, 64);
        assert_eq!(color.r, 255);
        assert_eq!(color.g, 128);
        assert_eq!(color.b, 64);
    }

    #[test]
    fn test_theme_reexport() {
        let light = Theme::light();
        let dark = Theme::dark();
        assert_ne!(light.background, dark.background);
    }

    #[test]
    fn test_line_style_reexport() {
        let solid = LineStyle::Solid;
        let dashed = LineStyle::Dashed;
        assert!(solid.to_dash_array().is_none());
        assert!(dashed.to_dash_array().is_some());
    }

    #[test]
    fn test_marker_style_reexport() {
        let circle = MarkerStyle::Circle;
        let square = MarkerStyle::Square;
        assert_ne!(format!("{:?}", circle), format!("{:?}", square));
    }

    #[test]
    fn test_grid_style_reexport() {
        let grid = GridStyle::default();
        assert!(grid.visible);

        let hidden = GridStyle::hidden();
        assert!(!hidden.visible);
    }

    #[test]
    fn test_plot_style_reexport() {
        let default = PlotStyle::Default;
        let publication = PlotStyle::Publication;
        assert_ne!(default.config().figure.dpi, publication.config().figure.dpi);
    }

    #[test]
    fn test_style_resolver_reexport() {
        let theme = Theme::light();
        let resolver = StyleResolver::new(&theme);
        assert_eq!(resolver.line_width(None), theme.line_width);
    }

    #[test]
    fn test_defaults_reexport() {
        let violin_alpha = std::hint::black_box(defaults::VIOLIN_FILL_ALPHA);
        let boxplot_alpha = std::hint::black_box(defaults::BOXPLOT_FILL_ALPHA);
        assert!(violin_alpha > 0.0);
        assert!(boxplot_alpha > 0.0);
    }
}