sway-utils 0.72.0

Sway common utils.
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

use serde::{Deserialize, Serialize};

#[derive(Clone, Debug, Deserialize, Serialize)]
pub struct CompilationPhaseMetrics {
    pub phase: String,
    pub elapsed: f64,
    pub memory_usage: Option<u64>,
}

#[derive(Clone, Debug, Deserialize, Serialize)]
pub struct ConcurrentSlabMetrics {
    pub slab: String,
    pub length: usize,
    pub capacity: usize,
    /// Approximate memory usage of the content of the slab [Vec].
    pub memory_usage: usize,
    /// Approximate memory usage of the total content of elements of type `T`
    /// the slab slots point to via `Arc<T>`. **This does not
    /// include any additional memory allocated by individual `T` elements,
    /// just the raw size of each `T`.**
    pub content_memory_usage: usize,
    pub free_slots_length: usize,
    pub free_slots_capacity: usize,
}

#[derive(Clone, Debug, Default, Deserialize, Serialize)]
pub struct DeclEngineMetrics {
    pub slabs: Vec<ConcurrentSlabMetrics>,
}

#[derive(Clone, Debug, Default, Deserialize, Serialize)]
pub struct PerformanceMetrics {
    pub bytecode_size: usize,
    pub reused_programs: u64,
    pub compilation_phases: Vec<CompilationPhaseMetrics>,
    pub decl_engine: DeclEngineMetrics,
}

#[derive(serde::Serialize, Clone)]
pub struct FunctionEntryPoint {
    /// The original entry point function name.
    pub fn_name: String,
    /// The immediate instruction offset at which the entry function begins.
    pub imm: u64,
    /// The function selector (only `Some` for contract ABI methods).
    pub selector: Option<[u8; 4]>,
}

#[macro_export]
// Time the given expression and print/save the result.
macro_rules! time_expr {
    ($pkg_name:expr, $description:expr, $key:expr, $expression:expr, $build_config:expr, $data:expr) => {{
        use std::io::{BufRead, Read, Write};
        if let Some(cfg) = $build_config {
            if cfg.profile {
                println!("/dyno start {} {}", $pkg_name, $description);
                let output = { $expression };
                println!("/dyno stop {} {}", $pkg_name, $description);
                output
            } else if cfg.time_phases || cfg.metrics_outfile.is_some() {
                let expr_start = std::time::Instant::now();
                let output = { $expression };
                let elapsed = expr_start.elapsed();
                if cfg.time_phases {
                    println!("  Time elapsed to {}: {:?}", $description, elapsed);
                }
                if cfg.metrics_outfile.is_some() {
                    #[cfg(not(target_os = "macos"))]
                    let memory_usage = {
                        use sysinfo::{System, SystemExt};
                        let mut sys = System::new();
                        sys.refresh_system();
                        Some(sys.used_memory())
                    };
                    #[cfg(target_os = "macos")]
                    let memory_usage = None;

                    $data.compilation_phases.push(CompilationPhaseMetrics {
                        phase: $key.to_string(),
                        elapsed: elapsed.as_secs_f64(),
                        memory_usage,
                    });
                }
                output
            } else {
                $expression
            }
        } else {
            $expression
        }
    }};
}