cairo-language-server 2.20.0

The Cairo Language Server
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

//! Handling of LS configuration via environment variables.
//!
//! The [`report_to_logs`] function logs each variable value as a debug message.
//!
//! **Note**: Each variable should be described by a name constant, accessor function and entry
//! in the [`report_to_logs`] function.

use std::env;
use std::ffi::OsString;
use std::path::PathBuf;
use std::time::Duration;

use tracing::debug;

pub const CAIRO_LS_DB_REPLACE_INACTIVE_INTERVAL: &'_ str = "CAIRO_LS_DB_REPLACE_INACTIVE_INTERVAL";
pub const CAIRO_LS_DB_REPLACE_MUTATIONS: &'_ str = "CAIRO_LS_DB_REPLACE_MUTATIONS";
pub const CAIRO_LS_LOG: &'_ str = "CAIRO_LS_LOG";
pub const CAIRO_LS_PROFILE: &'_ str = "CAIRO_LS_PROFILE";
pub const SCARB: &'_ str = "SCARB";
pub const SCARB_CACHE: &'_ str = "SCARB_CACHE";
pub const SCARB_TARGET_DIR: &'_ str = "SCARB_TARGET_DIR";

/// Wall-clock inactivity time after which a database swap is triggered (to free unused memory).
pub fn db_replace_inactive_interval() -> Duration {
    const DEFAULT: u64 = 3 * 60;

    env::var(CAIRO_LS_DB_REPLACE_INACTIVE_INTERVAL)
        .ok()
        .and_then(|v| v.parse().ok())
        .map(Duration::from_secs)
        .unwrap_or_else(|| Duration::from_secs(DEFAULT))
}

/// Number of mutations required to refresh the compiler database (to free unused memory).
pub fn db_replace_mutations() -> u64 {
    const DEFAULT: u64 = 200;

    env::var(CAIRO_LS_DB_REPLACE_MUTATIONS).ok().and_then(|v| v.parse().ok()).unwrap_or(DEFAULT)
}

/// LS tracing filter, see [`tracing_subscriber::EnvFilter`] for more.
pub fn log_env_filter() -> String {
    env::var(CAIRO_LS_LOG).unwrap_or_default()
}

/// Whether to generate LS tracing profile in the opened project directory.
pub fn tracing_profile() -> bool {
    env::var_os(CAIRO_LS_PROFILE).map(env_to_bool).unwrap_or_default()
}

/// Path to the Scarb binary to call during analysis.
pub fn scarb_path() -> Option<PathBuf> {
    env::var_os(SCARB).map(PathBuf::from)
}

/// Path to the Scarb cache directory. Available if LS is run via `scarb cairo-language-server`.
pub fn scarb_cache_path() -> Option<PathBuf> {
    env::var_os(SCARB_CACHE).map(PathBuf::from)
}

/// Path to the Scarb target directory. Available if LS is run via `scarb cairo-language-server`.
pub fn scarb_target_path() -> Option<PathBuf> {
    env::var_os(SCARB_TARGET_DIR).map(PathBuf::from)
}

/// Print all environment variables values (or defaults) as debug messages in logs.
pub fn report_to_logs() {
    debug!("{CAIRO_LS_DB_REPLACE_INACTIVE_INTERVAL}={:?}", db_replace_inactive_interval());
    debug!("{CAIRO_LS_DB_REPLACE_MUTATIONS}={}", db_replace_mutations());
    debug!("{CAIRO_LS_LOG}={}", log_env_filter());
    debug!("{CAIRO_LS_PROFILE}={}", tracing_profile());
    debug!("{SCARB}={}", scarb_path().map(|p| p.display().to_string()).unwrap_or_default());
}

fn env_to_bool(os: OsString) -> bool {
    matches!(os.to_str(), Some("1") | Some("true"))
}