🐀 ATproto library for gleam
atproto
library
gleam
docs: update readme and changelog
kacaii.dev
(Jul 13, 2026, 9:25 PM -0300)
80005edf
16383ca3
+6
-8
+2
-2
CHANGELOG.md
+2
-2
CHANGELOG.md
···
5
5
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
8
-
## v3.0.0 - Unreleased
8
+
## [v3.0.0] - Unreleased
9
9
10
10
### Changed
11
11
···
13
13
- [possum] Most functions now create a new request internally when being called,
14
14
there's no need to pipe `request.new()` into them.
15
15
16
-
## v2.1.0 - 2026-07-12
16
+
## [v2.1.0] - 2026-07-12
17
17
18
18
### Added
19
19
+4
-6
README.md
+4
-6
README.md
···
23
23
### Decentralized Identifiers (DIDs)
24
24
25
25
```gleam
26
-
import gleam/http/request
27
26
import possum/did
28
27
import possum/handle
29
28
import possum
···
35
34
// Handle validation
36
35
let assert Ok(handle) = handle.parse("gleam.run")
37
36
38
-
request.new()
39
-
|> request.set_host("slingshot.microcosm.blue")
40
-
|> possum.resolve_handle(handle)
37
+
// Resolve an atproto handle (hostname) to a DID.
38
+
let request =
39
+
possum.resolve_handle(handle, pds: "slingshot.microcosm.blue")
41
40
42
41
// Use `did.parse` to turn strings into valid DID format
43
42
let assert Ok(did) = did.parse("did:plc:ewvi7nxzyoun6zhxrhs64oiz")
···
46
45
### Building HTTP Requests
47
46
48
47
```gleam
49
-
import gleam/http/request
50
48
import possum/did
51
49
import possum/nsid
52
50
import possum
53
51
54
52
let assert Ok(did) = did.parse("did:plc:ewvi7nxzyoun6zhxrhs64oiz")
55
-
let assert Ok(collection) = nsid.parse("sh.tangled.repo")
53
+
let assert Ok(collection) = nsid.parse("site.standard.document")
56
54
57
55
// Reading public data from repositories, no Authorization needed.
58
56
let request =