init_static 0.1.0

A Rust library for explicit static initialization.
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

# init_static

[![Crates.io](https://img.shields.io/crates/v/init_static.svg)](https://crates.io/crates/init_static)
[![Documentation](https://docs.rs/init_static/badge.svg)](https://docs.rs/init_static)

A Rust library for explicit static initialization.

## Overview

`init_static` provides a macro similar to [`lazy_static`](https://crates.io/crates/lazy_static), but with **explicit initialization control**. This means you decide **when** your statics are initialized, rather than having them lazily
evaluate on first use.

Unlike `lazy_static`, `init_static` uses [`std::sync::OnceLock`](https://doc.rust-lang.org/std/sync/struct.OnceLock.html) internally and **does not** initialize your static values automatically. Instead, it gathers your initialization functions at compile-time using
[`linkme`](https://crates.io/crates/linkme), and provides a function to run them all at once early in your program (for example, inside `main()`).

## Compare to `lazy_static`

| Feature            | `lazy_static`           | `init_static`                     |
| ------------------ | ----------------------- | --------------------------------- |
| Initialization     | Implicit (on first use) | Explicit (`init_static()` call)   |
| `Result` Support   | Not supported           | Supported                         |
| Early failure      | No (fail at runtime)    | Yes (optional, before app starts) |

<!-- | Async support      | Not supported                     | Possible (run async init in main)     | -->

## Installation

Add this to your `Cargo.toml`:

```toml
[dependencies]
init_static = { version = "0.1" }
```

# Example

```rust
use init_static::init_static;
use std::error::Error;

init_static! {
    static VALUE: u32 = "42".parse()?;
}

fn main() -> Result<(), Box<dyn Error + Send + Sync>> {
    init_static()?;
    println!("{}", *VALUE);
    Ok(())
}
```