cf-colo-hint 0.1.988

Cloudflare colo to Durable Objects location hint mapping
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

# cf-colo-hint

A Rust library that maps Cloudflare edge locations (colos) to Durable Objects location hints.

## Usage

```rust
use cf_colo_hint::{Colo, LocationHint};

// Parse a colo from the cf-ray header or request metadata
let colo = Colo::from_code("LAX").expect("unknown colo");

// Get the recommended location hint for Durable Objects
if let Some(hint) = colo.location_hint() {
    println!("Use location hint: {}", hint.as_str());
}

// Work with location hints directly
let hint = LocationHint::WNam;
assert_eq!(hint.as_str(), "wnam");
assert_eq!(hint.name(), "Western North America");
```

## Features

- `no_std` compatible
- Zero dependencies
- Auto-generated from Cloudflare's status page and measured latency data

## Data Sources

Colo data is sourced from:

- [Cloudflare Status](https://www.cloudflarestatus.com/) - colo names and regions
- [where.durableobjects.live](https://where.durableobjects.live/) - measured latency data for DO region mapping

## Updating Data

Run the refresh script to pull the latest data and regenerate the Rust code:

```bash
./refresh.sh
```

## License

MIT