ASIMOV Mbox Module

ASIMOV module for Mbox email import.

✨ Features

• Parses email messages from .mbox files and outputs them as JSON-LD.
• Constructs a semantic knowledge graph based on the KNOW ontology.
• Distributed as a standalone static binary with zero runtime dependencies.

🛠️ Prerequisites

• Rust 1.85+ (2024 edition) if building from source code

⬇️ Installation

Installation with the ASIMOV CLI

asimov module install mbox -v

Installation from Source Code

cargo install asimov-mbox-module

👉 Examples

Email Import from an Mbox File

Cataloging email messages in the mbox

asimov-mbox-cataloger file:/path/to/messages.mbox

Exporting email messages in the mbox as JSON

asimov-mbox-cataloger file:/path/to/messages.mbox -o json

Fetching a specific email message

asimov-mbox-fetcher file:/path/to/messages.mbox#mid

⚙ Configuration

This module requires no configuration.

📚 Reference

asimov-mbox-cataloger

asimov-mbox-cataloger

Usage: asimov-mbox-cataloger [OPTIONS] <MBOX-FILE-URL>

Arguments:
  <MBOX-FILE-URL>  A `file:/path/to/messages.mbox` URL to the file to catalog

Options:
  -d, --debug            Enable debugging output
      --license          Show license information
  -v, --verbose...       Enable verbose output (may be repeated for more verbosity)
  -V, --version          Print version information
  -n, --limit <COUNT>    Limit the number of messages to catalog
  -o, --output <FORMAT>  Set the output format [default: cli] [possible values: cli, json, jsonld, jsonl]
  -h, --help             Print help

asimov-mbox-fetcher

asimov-mbox-fetcher

Usage: asimov-mbox-fetcher [OPTIONS] <MBOX-MESSAGE-URL>

Arguments:
  <MBOX-MESSAGE-URL>  A `file:/path/to/messages.mbox#mid` URL to the message to fetch

Options:
  -d, --debug            Enable debugging output
      --license          Show license information
  -v, --verbose...       Enable verbose output (may be repeated for more verbosity)
  -V, --version          Print version information
  -o, --output <FORMAT>  The output format
  -h, --help             Print help

👨‍💻 Development

git clone https://github.com/asimov-modules/asimov-mbox-module.git