Metadata-Version: 2.4
Name: asfml
Version: 0.1.0
Summary: CLI for reading Apache Pony Mail archives
Home-page: https://github.com/Xuanwo/asfml
License: Apache-2.0
Project-URL: Homepage, https://github.com/Xuanwo/asfml
Project-URL: Repository, https://github.com/Xuanwo/asfml
Project-URL: Issues, https://github.com/Xuanwo/asfml/issues
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# 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
```

## 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.
