crispy-stalker 0.1.1

Async Stalker/MAG portal API client
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

# crispy-stalker

Async Stalker/MAG portal API client.

## What This Crate Is

`crispy-stalker` targets legacy Stalker / MAG middleware portals. It handles portal discovery, MAC-based authentication, paginated content retrieval, and stream URL resolution in a reusable client crate.

## What It Provides

- `StalkerClient`
- `StalkerCredentials`
- `StalkerSession`
- typed models for channels, VOD, series, profile, and EPG entries
- stream URL resolution helpers
- retry/backoff support

## Installation

```toml
[dependencies]
crispy-stalker = "0.1.1"
```

MSRV: Rust `1.85`

## Quick Start

```rust
use crispy_stalker::{StalkerClient, StalkerCredentials};

# async fn demo() -> Result<(), Box<dyn std::error::Error>> {
let creds = StalkerCredentials {
    base_url: "http://portal.example.com".into(),
    mac_address: "00:1A:79:AB:CD:EF".into(),
    timezone: None,
};

let mut client = StalkerClient::new(creds, false)?;
client.authenticate().await?;

let _genres = client.get_genres().await?;
# Ok(())
# }
```

## Typical Uses

- Stalker portal integration
- channel/VOD sync jobs
- MAG stream URL resolution

## Current Limitations

- provider-side inconsistencies are common in Stalker ecosystems; callers should still expect some portals to diverge from the happy path
- no persistence layer
- no playback probing or media diagnostics

## License

See `LICENSE.md` and `NOTICE.md`.