solar_interface/
lib.rs

1#![doc = include_str!("../README.md")]
2#![doc(
3    html_logo_url = "https://raw.githubusercontent.com/paradigmxyz/solar/main/assets/logo.png",
4    html_favicon_url = "https://raw.githubusercontent.com/paradigmxyz/solar/main/assets/favicon.ico"
5)]
6#![cfg_attr(docsrs, feature(doc_cfg, doc_auto_cfg))]
7#![cfg_attr(feature = "nightly", feature(panic_update_hook))]
8
9#[macro_use]
10extern crate tracing;
11
12pub mod diagnostics;
13use diagnostics::ErrorGuaranteed;
14
15mod globals;
16pub use globals::SessionGlobals;
17
18mod pos;
19pub use pos::{BytePos, CharPos, RelativeBytePos};
20
21mod session;
22pub use session::{Session, SessionBuilder};
23
24pub mod source_map;
25pub use source_map::SourceMap;
26
27mod span;
28pub use span::Span;
29
30mod symbol;
31pub use symbol::{kw, sym, Ident, Symbol};
32
33pub mod panic_hook;
34
35pub use anstream::ColorChoice;
36pub use dunce::canonicalize;
37pub use solar_config as config;
38pub use solar_data_structures as data_structures;
39
40/// The current version of the Solar compiler.
41pub const VERSION: &str = env!("CARGO_PKG_VERSION");
42
43/// Compiler result type.
44pub type Result<T = (), E = ErrorGuaranteed> = std::result::Result<T, E>;
45
46/// Pluralize a word based on a count.
47#[macro_export]
48#[rustfmt::skip]
49macro_rules! pluralize {
50    // Pluralize based on count (e.g., apples)
51    ($x:expr) => {
52        if $x == 1 { "" } else { "s" }
53    };
54    ("has", $x:expr) => {
55        if $x == 1 { "has" } else { "have" }
56    };
57    ("is", $x:expr) => {
58        if $x == 1 { "is" } else { "are" }
59    };
60    ("was", $x:expr) => {
61        if $x == 1 { "was" } else { "were" }
62    };
63    ("this", $x:expr) => {
64        if $x == 1 { "this" } else { "these" }
65    };
66}
67
68/// Creates new session globals on the current thread if they doesn't exist already and then
69/// executes the given closure.
70///
71/// Prefer [`Session::enter`] to this function if possible to also set the source map and thread
72/// pool.
73///
74/// Using this instead of [`Session::enter`] may cause unexpected panics.
75#[inline]
76pub fn enter<R>(f: impl FnOnce() -> R) -> R {
77    SessionGlobals::with_or_default(|_| f())
78}
solar_interface/lib.rs

solar_interface/
lib.rs
