🐀 ATproto XRPC client for gleam
possum.hexdocs.pm
gleam
atproto
xrpc-client
library
readme: add README.md
kacaii.dev
(Jun 28, 2026, 9:53 PM -0300)
f4a22235
15993753
+27
+27
README.md
+27
README.md
···
1
+
# Possum
2
+
3
+
HTTP request helpers for querying data from your [Personal Data Server](https://docs.bsky.app/docs/advanced-guides/atproto#achieving-scale).
4
+
The user is responsible for deciding how to send the request and decode the response.
5
+
6
+
## Example
7
+
8
+
```sh
9
+
gleam add gleam_http
10
+
```
11
+
12
+
```toml
13
+
possum = { git = "https://tangled.org/kacaii.dev/possum", ref = "commit-hash" }
14
+
```
15
+
16
+
```gleam
17
+
import gleam/http/request
18
+
import possum
19
+
20
+
/// This builds a request to:
21
+
/// https://bsky.social/xrpc/com.atproto.identity.resolveHandle?handle=kacaii.dev
22
+
pub fn build_request() -> request.Request(_) {
23
+
request.new()
24
+
|> request.set_host("bsky.social") // or eurosky.social
25
+
|> possum.resolve_handle("kacaii.dev") // use your handle
26
+
}
27
+
```