asfml-core 0.1.1

Core library for reading Apache Pony Mail archives
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
62
63
64
65
66
67
68
69

# asfml

`asfml` is a CLI for reading Apache Pony Mail archives from `lists.apache.org`.

It supports public archives directly and private archives through a manually
provided Pony Mail session cookie.

## Installation

```bash
brew tap xuanwo/tap && brew install asfml   # Homebrew
cargo install asfml                         # Cargo
uv tool install asfml                       # Python / uv
npm install -g asfml                        # npm
```

## Quick Start

Run `asfml` directly without installing it first:

```bash
uvx asfml list dev@opendal.apache.org --limit 5
npx asfml list dev@opendal.apache.org --limit 5
```

Or use an installed binary:

```bash
asfml list dev@opendal.apache.org --limit 5
asfml search dev@opendal.apache.org release --limit 5
asfml read <mid>
```

## Usage

List recent messages:

```bash
asfml list dev@opendal.apache.org --limit 5
```

Search messages:

```bash
asfml search dev@opendal.apache.org release --limit 5
```

Read a message:

```bash
asfml read <mid>
asfml read <mid> --parent
asfml read <mid> --root
asfml read <mid> --thread
```

Authenticate for private archives:

```bash
asfml auth set
asfml auth status private@opendal.apache.org
```

`asfml auth set` accepts a raw `ponymail` cookie value, `ponymail=<value>`, a
full `Cookie:` header, or Netscape cookies.txt content.

## License

Licensed under the Apache License, Version 2.0.