ASIMOV Maildir Module

ASIMOV module for Maildir email import.

✨ Features

• Parses email messages from Maildir folders 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 maildir -v

Installation from Source Code

cargo install asimov-maildir-module

👉 Examples

Email Import from a Maildir Folder

Cataloging email messages in the maildir

asimov-maildir-cataloger file:/path/to/maildir/

Exporting email messages in the maildir as JSON

asimov-maildir-cataloger file:/path/to/maildir/ -o json

Fetching a specific email message

asimov-maildir-fetcher file:/path/to/maildir/#mid

⚙ Configuration

This module requires no configuration.

📚 Reference

asimov-maildir-cataloger

asimov-maildir-cataloger

Usage: asimov-maildir-cataloger [OPTIONS] <MAILDIR-FOLDER-URL>

Arguments:
  <MAILDIR-FOLDER-URL>  A `file:/path/to/maildir/` URL to the folder 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-maildir-fetcher

asimov-maildir-fetcher

Usage: asimov-maildir-fetcher [OPTIONS] <MAILDIR-MESSAGE-URL>

Arguments:
  <MAILDIR-MESSAGE-URL>  A `file:/path/to/maildir/#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-maildir-module.git