JMAP WIP #5

.cargo/config.toml

@@ -1,2 +0,0 @@
-[env]
-PCRE2_SYS_STATIC = "1"

.git-blame-ignore-revs

@@ -1,2 +0,0 @@
-# Use cargo-derivefmt to sort derives alphabetically
-f900dbea468e822c5a510a72ecc6367549443927

.gitea/PULL_REQUEST_TEMPLATE.md

@@ -1,25 +0,0 @@
----
-
-name: "Pull Request"
-about: "Standard pull request template."
-title: "WIP: "
-ref: "master"
-
----
-
-<!-- If your PR is ready to merge/review, remove the `WIP: ` prefix from the title. -->
-
-### Summary of the PR
-
-<!-- Changes introduced in this PR. -->
-
-### Requirements
-
-Before submitting your PR, please make sure you have addressed the following requirements:
-
-* [ ] All commits in this PR are signed (with `git commit -s`), and the commit has a message describing the motivation behind the change, if appropriate.
-* [ ] All added/changed public-facing functionality, especially configuration options, are documented in the manual pages.
-* [ ] Any newly added `unsafe` code is properly documented.
-* [ ] Each commit has been formatted with `rustfmt`. Run `make fmt` in the project root.
-* [ ] Each commit has been linted with `clippy`. Run `make lint` in the project root.
-* [ ] Each commit does not break any test. Run `make test` in the project root. If you have `cargo-nextest` installed, you can run `cargo nextest run --all --no-fail-fast --all-features --future-incompat-report` instead.

.gitea/workflows/build_debian_package.yaml

@@ -1,65 +0,0 @@
-# SPDX-License-Identifier: EUPL-1.2
-name: Build .deb package
-
-env:
-  CARGO_INCREMENTAL: 0
-  CARGO_NET_RETRY: 10
-  CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
-  RUSTFLAGS: "-D warnings -W unreachable-pub -W rust-2021-compatibility"
-  RUSTUP_MAX_RETRIES: 10
-  RUST_BACKTRACE: short
-
-on:
-  workflow_dispatch:
-  push:
-    tags:
-      - v*
-
-jobs:
-  build:
-    name: Package for debian on ${{ matrix.arch }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        build: [linux-amd64, ]
-        include:
-          - build: linux-amd64
-            arch: amd64
-            os: ubuntu-latest
-            rust: stable
-            artifact_name: 'linux-amd64'
-            target: x86_64-unknown-linux-gnu
-    steps:
-      - uses: actions/checkout@v3
-      - id: os-deps
-        name: install OS dependencies
-        run: |
-          apt-get update
-          apt-get install -y mandoc debhelper quilt build-essential
-      - id: rustup-setup
-        name: Install rustup and toolchains
-        shell: bash
-        run: |
-          if ! command -v rustup &>/dev/null; then
-            curl --proto '=https' --tlsv1.2 --retry 10 --retry-connrefused --location --silent --show-error --fail "https://sh.rustup.rs" | sh -s -- --default-toolchain none -y
-            source "${HOME}/.cargo/env"
-            echo "${CARGO_HOME:-$HOME/.cargo}/bin" >> $GITHUB_PATH
-            echo "CARGO_HOME=${CARGO_HOME:-$HOME/.cargo}" >> $GITHUB_ENV
-            rustup toolchain install --profile minimal ${{ matrix.rust }} --target ${{ matrix.target }}
-            rustup default ${{ matrix.rust }}
-          fi
-      - name: Build binary
-        run: |
-          VERSION=$(grep -m1 version meli/Cargo.toml | head -n1 | cut -d'"' -f 2 | head -n1)
-          make deb-dist
-          mkdir artifacts
-          echo "VERSION=${VERSION}" >> $GITHUB_ENV
-          mv ../meli_*.deb artifacts/meli-${VERSION}-${{ matrix.artifact_name }}.deb
-      - name: Upload Artifacts
-        uses: actions/upload-artifact@v3
-        with:
-          name: meli-${{env.VERSION}}-${{ matrix.artifact_name }}.deb
-          path: artifacts/meli-${{env.VERSION}}-${{ matrix.artifact_name }}.deb
-          if-no-files-found: error
-          retention-days: 30

.gitea/workflows/builds.yaml

@@ -1,90 +0,0 @@
-# SPDX-License-Identifier: EUPL-1.2
-name: Build release binary
-
-env:
-  CARGO_INCREMENTAL: 0
-  CARGO_NET_RETRY: 10
-  CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
-  RUSTFLAGS: "-D warnings -W unreachable-pub -W rust-2021-compatibility"
-  RUSTUP_MAX_RETRIES: 10
-  RUST_BACKTRACE: short
-
-on:
-  workflow_dispatch:
-  push:
-    tags:
-      - v*
-
-jobs:
-  build:
-    name: Build on ${{ matrix.build }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        build: [linux-amd64, ]
-        include:
-          - build: linux-amd64
-            os: ubuntu-latest
-            rust: stable
-            artifact_name: 'meli-linux-amd64'
-            target: x86_64-unknown-linux-gnu
-    steps:
-      - uses: actions/checkout@v3
-      - id: os-deps
-        name: install OS dependencies
-        run: |
-          apt-get update
-          apt-get install -y libdbus-1-dev pkg-config mandoc libssl-dev
-          #- id: cache-rustup
-          #  name: Cache Rust toolchain
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ~/.rustup
-          #    key: toolchain-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-rustup.outputs.cache-hit != 'true' }}
-      - id: rustup-setup
-        name: Install rustup and toolchains
-        shell: bash
-        run: |
-          if ! command -v rustup &>/dev/null; then
-            curl --proto '=https' --tlsv1.2 --retry 10 --retry-connrefused --location --silent --show-error --fail "https://sh.rustup.rs" | sh -s -- --default-toolchain none -y
-            source "${HOME}/.cargo/env"
-            echo "${CARGO_HOME:-$HOME/.cargo}/bin" >> $GITHUB_PATH
-            rustup toolchain install --profile minimal ${{ matrix.rust }} --target ${{ matrix.target }}
-          fi
-      - name: Configure cargo data directory
-        # After this point, all cargo registry and crate data is stored in
-        # $GITHUB_WORKSPACE/.cargo_home. This allows us to cache only the files
-        # that are needed during the build process. Additionally, this works
-        # around a bug in the 'cache' action that causes directories outside of
-        # the workspace dir to be saved/restored incorrectly.
-        run: echo "CARGO_HOME=$(pwd)/.cargo_home" >> $GITHUB_ENV
-          #- id: cache-cargo
-          #  name: Cache cargo configuration and installations
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ${{ env.CARGO_HOME }}
-          #    key: cargo-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-      - name: Setup Rust target
-        run: |
-          mkdir -p "${{ env.CARGO_HOME }}"
-          cat << EOF > "${{ env.CARGO_HOME }}"/config.toml
-          [build]
-          target = "${{ matrix.target }}"
-          EOF
-      - name: Build binary
-        run: |
-          make
-          mkdir artifacts
-          mv target/*/release/* target/ || true
-          mv target/release/* target/ || true
-          mv target/meli  artifacts/
-      - name: Upload Artifacts
-        uses: actions/upload-artifact@v3
-        with:
-          name: ${{ matrix.artifact_name }}
-          path: artifacts/meli
-          if-no-files-found: error
-          retention-days: 30

.gitea/workflows/lints.yaml

@@ -1,111 +0,0 @@
-# SPDX-License-Identifier: EUPL-1.2
-name: Run cargo lints
-
-env:
-  CARGO_INCREMENTAL: 0
-  CARGO_NET_RETRY: 10
-  CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
-  RUSTFLAGS: "-D warnings -W unreachable-pub -W rust-2021-compatibility -C debuginfo=0"
-  RUSTUP_MAX_RETRIES: 10
-  RUST_BACKTRACE: short
-
-on:
-  workflow_dispatch:
-  pull_request:
-    paths:
-      - '.gitea/**'
-      - 'melib/src/**'
-      - 'melib/Cargo.toml'
-      - 'meli/src/**'
-      - 'meli/Cargo.toml'
-      - 'Cargo.toml'
-      - 'Cargo.lock'
-
-jobs:
-  test:
-    name: Lint on ${{ matrix.build }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        build: [linux-amd64, ]
-        include:
-          - build: linux-amd64
-            os: ubuntu-latest
-            rust: stable
-            target: x86_64-unknown-linux-gnu
-    steps:
-      - uses: actions/checkout@v3
-      - id: os-deps
-        name: install OS dependencies
-        run: |
-          apt-get update
-          apt-get install -y libdbus-1-dev pkg-config mandoc libssl-dev
-          #- id: cache-rustup
-          #  name: Cache Rust toolchain
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ~/.rustup
-          #    key: toolchain-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-rustup.outputs.cache-hit != 'true' }}
-      - id: rustup-setup
-        name: Install Rustup and toolchains
-        shell: bash
-        run: |
-          if ! command -v rustup &>/dev/null; then
-            curl --proto '=https' --tlsv1.2 --retry 10 --retry-connrefused --location --silent --show-error --fail "https://sh.rustup.rs" | sh -s -- --default-toolchain none -y
-            source "${HOME}/.cargo/env"
-            echo "${CARGO_HOME:-$HOME/.cargo}/bin" >> $GITHUB_PATH
-            rustup toolchain install --profile minimal --component clippy,rustfmt --target ${{ matrix.target }} -- "${{ matrix.rust }}"
-            rustup default ${{ matrix.rust }}
-          fi
-      - name: Configure cargo data directory
-        # After this point, all cargo registry and crate data is stored in
-        # $GITHUB_WORKSPACE/.cargo_home. This allows us to cache only the files
-        # that are needed during the build process. Additionally, this works
-        # around a bug in the 'cache' action that causes directories outside of
-        # the workspace dir to be saved/restored incorrectly.
-        run: echo "CARGO_HOME=$(pwd)/.cargo_home" >> $GITHUB_ENV
-          #- id: cache-cargo
-          #  name: Cache cargo configuration and installations
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ${{ env.CARGO_HOME }}
-          #    key: cargo-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-      - name: Setup Rust target
-        run: |
-          mkdir -p "${{ env.CARGO_HOME }}"
-          cat << EOF > "${{ env.CARGO_HOME }}"/config.toml
-          [build]
-          target = "${{ matrix.target }}"
-          EOF
-      - if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-        name: Add lint dependencies
-        run: |
-          cargo install --quiet --version 1.0.9 --target "${{ matrix.target }}" cargo-sort
-          RUSTFLAGS="" cargo install --locked --target "${{ matrix.target }}" --git https://github.com/dcchut/cargo-derivefmt --rev 2ff93de7fb418180458dd1ba27e5655607c23ab6 --bin cargo-derivefmt
-      - name: rustfmt
-        if: success() || failure()
-        run: |
-          cargo fmt --check --all
-      - name: clippy
-        if: success() || failure()
-        run: |
-          cargo clippy --no-deps --all-features --all --tests --examples --benches --bins
-      - name: cargo-derivefmt melib
-        if: success() || failure()
-        run: |
-          cargo derivefmt --manifest-path ./melib/Cargo.toml
-      - name: cargo-derivefmt meli
-        if: success() || failure()
-        run: |
-          cargo derivefmt --manifest-path ./meli/Cargo.toml
-      - name: cargo-derivefmt fuzz
-        if: success() || failure()
-        run: |
-          cargo derivefmt --manifest-path ./fuzz/Cargo.toml
-      - name: cargo-derivefmt tools
-        if: success() || failure()
-        run: |
-          cargo derivefmt --manifest-path ./tools/Cargo.toml

.gitea/workflows/manifest_lints.yaml

@@ -1,91 +0,0 @@
-# SPDX-License-Identifier: EUPL-1.2
-name: Cargo manifest lints
-
-env:
-  CARGO_INCREMENTAL: 0
-  CARGO_NET_RETRY: 10
-  CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
-  RUSTFLAGS: "-D warnings -W unreachable-pub -W rust-2021-compatibility -C debuginfo=0"
-  RUSTUP_MAX_RETRIES: 10
-  RUST_BACKTRACE: short
-
-on:
-  workflow_dispatch:
-  pull_request:
-    paths:
-      - '.gitea/**'
-      - 'melib/Cargo.toml'
-      - 'meli/Cargo.toml'
-      - 'fuzz/Cargo.toml'
-      - 'tool/Cargo.toml'
-      - 'Cargo.toml'
-      - 'Cargo.lock'
-      - '.cargo/config.toml'
-
-jobs:
-  manifest_lint:
-    name: Lint Cargo manifests on ${{ matrix.build }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        build: [linux-amd64, ]
-        include:
-          - build: linux-amd64
-            os: ubuntu-latest
-            rust: stable
-            target: x86_64-unknown-linux-gnu
-    steps:
-      - uses: actions/checkout@v3
-      - id: os-deps
-        name: install OS dependencies
-        run: |
-          apt-get update
-          apt-get install -y mandoc
-      - name: Find meli MSRV from meli/Cargo.toml.
-        run: echo MELI_MSRV=$(grep -m1 rust-version meli/Cargo.toml | head -n1 | cut -d'"' -f 2 | head -n1) >> $GITHUB_ENV
-      - id: rustup-setup
-        name: Install Rustup and toolchains
-        shell: bash
-        run: |
-          if ! command -v rustup &>/dev/null; then
-            curl --proto '=https' --tlsv1.2 --retry 10 --retry-connrefused --location --silent --show-error --fail "https://sh.rustup.rs" | sh -s -- --default-toolchain none -y
-            source "${HOME}/.cargo/env"
-            echo "${CARGO_HOME:-$HOME/.cargo}/bin" >> $GITHUB_PATH
-            echo "CARGO_HOME=${CARGO_HOME:-$HOME/.cargo}" >> $GITHUB_ENV
-            rustup toolchain install --profile minimal --component "rustfmt" --target "${{ matrix.target }}" -- "${{ env.MELI_MSRV }}"
-            rustup component add rustfmt --toolchain ${{ env.MELI_MSRV }}-${{ matrix.target }}
-            rustup toolchain install --profile minimal --component "rustfmt" --target "${{ matrix.target }}" -- "${{ matrix.rust }}"
-            rustup component add rustfmt --toolchain ${{ matrix.rust }}-${{ matrix.target }}
-            rustup default ${{ matrix.rust }}
-          fi
-      - name: Setup Rust target
-        run: |
-          mkdir -p "${{ env.CARGO_HOME }}"
-          cat << EOF > "${{ env.CARGO_HOME }}"/config.toml
-          [build]
-          target = "${{ matrix.target }}"
-          EOF
-      - if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-        name: Add manifest lint dependencies
-        run: |
-          source "${HOME}/.cargo/env"
-          cargo install --quiet --version 1.0.9 --target "${{ matrix.target }}" cargo-sort
-          cargo install --quiet --version 0.15.1 --target "${{ matrix.target }}" cargo-msrv
-      - name: cargo-msrv verify melib MSRV
-        if: success() || failure()
-        run: |
-          source "${HOME}/.cargo/env"
-          cargo-msrv --output-format json --log-level trace --log-target stdout --path meli verify
-          cargo-msrv --output-format json --log-level trace --log-target stdout --path melib verify
-      - name: cargo-sort
-        if: success() || failure()
-        run: |
-          source "${HOME}/.cargo/env"
-          cargo-sort --check --check-format --grouped --order package,bin,lib,dependencies,features,build-dependencies,dev-dependencies,workspace fuzz
-          cargo-sort --check --check-format --grouped --order package,bin,lib,dependencies,features,build-dependencies,dev-dependencies,workspace tools
-          cargo-sort --check --check-format --grouped --order package,bin,lib,dependencies,features,build-dependencies,dev-dependencies,workspace --workspace
-      - name: Check debian/changelog is up-to-date.
-        if: success() || failure()
-        run: |
-          ./scripts/check_debian_changelog.sh

.gitea/workflows/test.yaml

@@ -1,103 +0,0 @@
-# SPDX-License-Identifier: EUPL-1.2
-name: Run Tests
-
-env:
-  CARGO_INCREMENTAL: 0
-  CARGO_NET_RETRY: 10
-  CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
-  RUSTFLAGS: "-D warnings -W unreachable-pub -W rust-2021-compatibility -C debuginfo=0"
-  RUSTUP_MAX_RETRIES: 10
-  RUST_BACKTRACE: short
-
-on:
-  workflow_dispatch:
-  pull_request:
-    paths:
-      - '.gitea/**'
-      - 'melib/src/**'
-      - 'melib/Cargo.toml'
-      - 'meli/src/**'
-      - 'meli/Cargo.toml'
-      - 'Cargo.toml'
-      - 'Cargo.lock'
-
-jobs:
-  test:
-    name: Test on ${{ matrix.build }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        build: [linux-amd64, ]
-        include:
-          - build: linux-amd64
-            os: ubuntu-latest
-            rust: stable
-            target: x86_64-unknown-linux-gnu
-    steps:
-      - uses: actions/checkout@v3
-      - id: os-deps
-        name: install OS dependencies
-        run: |
-          apt-get update
-          apt-get install -y libdbus-1-dev pkg-config mandoc libssl-dev make
-          #- id: cache-rustup
-          #  name: Cache Rust toolchain
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ~/.rustup
-          #    key: toolchain-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-rustup.outputs.cache-hit != 'true' }}
-      - id: rustup-setup
-        name: Install rustup and toolchains
-        shell: bash
-        run: |
-          if ! command -v rustup &>/dev/null; then
-            curl --proto '=https' --tlsv1.2 --retry 10 --retry-connrefused --location --silent --show-error --fail "https://sh.rustup.rs" | sh -s -- --default-toolchain none -y
-            source "${HOME}/.cargo/env"
-            echo "${CARGO_HOME:-$HOME/.cargo}/bin" >> $GITHUB_PATH
-            rustup toolchain install --profile minimal ${{ matrix.rust }} --target ${{ matrix.target }}
-          fi
-      - name: Configure cargo data directory
-        # After this point, all cargo registry and crate data is stored in
-        # $GITHUB_WORKSPACE/.cargo_home. This allows us to cache only the files
-        # that are needed during the build process. Additionally, this works
-        # around a bug in the 'cache' action that causes directories outside of
-        # the workspace dir to be saved/restored incorrectly.
-        run: echo "CARGO_HOME=$(pwd)/.cargo_home" >> $GITHUB_ENV
-          #- id: cache-cargo
-          #  name: Cache cargo configuration and installations
-          #  uses: https://github.com/actions/cache@v3
-          #  with:
-          #    path: ${{ env.CARGO_HOME }}
-          #    key: cargo-${{ matrix.os }}-${{ matrix.rust }}
-          #- if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-      - name: Setup Rust target
-        run: |
-          mkdir -p "${{ env.CARGO_HOME }}"
-          cat << EOF > "${{ env.CARGO_HOME }}"/config.toml
-          [build]
-          target = "${{ matrix.target }}"
-          EOF
-      - if: ${{ steps.cache-cargo.outputs.cache-hit != 'true' }} && matrix.target
-        name: Add test dependencies
-        run: |
-          cargo install --quiet --version 0.9.54 --target "${{ matrix.target }}" cargo-nextest
-      - name: cargo-check
-        run: |
-          cargo check --all-features --all --tests --examples --benches --bins
-      - name: Compile
-        if: success() || failure()
-        run: cargo test --all --no-fail-fast --all-features --no-run --locked
-      - name: cargo test
-        run: |
-          cargo nextest run --all --no-fail-fast --all-features --future-incompat-report -E 'not (test(smtp::test::test_smtp))'
-          #cargo test --all --no-fail-fast --all-features -- --nocapture --quiet
-      - name: rustdoc build
-        if: success() || failure() # always run even if other steps fail, except when cancelled <https://stackoverflow.com/questions/58858429/how-to-run-a-github-actions-step-even-if-the-previous-step-fails-while-still-f>
-        run: |
-          make build-rustdoc
-      - name: rustdoc tests
-        if: success() || failure()
-        run: |
-          make test-docs

.gitignore

@@ -6,15 +6,3 @@ target/
 **/*.rs.bk
 .gdb_history
 *.log
-
-__pycache__/
-*.py[cod]
-
-debian/.debhelper/
-debian/debhelper-build-stamp
-debian/files
-debian/meli.substvars
-debian/meli/
-
-# CLion IDE
-.idea

BUILD.md

@@ -1,76 +0,0 @@
-# Build `meli`
-
-For a quick start, build and install locally:
-
-```sh
-PREFIX=~/.local make install
-```
-
-Available subcommands for `make` are listed with `make help`.
-The Makefile *should* be POSIX portable and not require a specific `make` version.
-
-`meli` requires rust version 1.68.2 or later and rust's package manager, Cargo.
-Information on how to get it on your system can be found here: <https://doc.rust-lang.org/cargo/getting-started/installation.html>
-
-With Cargo available, the project can be built with `make` and the resulting binary will then be found under `target/release/meli`.
-Run `make install` to install the binary and man pages.
-This requires root, so I suggest you override the default paths and install it in your `$HOME`: `make PREFIX=${HOME}/.local install`.
-
-You can build and run `meli` with one command: `cargo run --release`.
-
-## Build features
-
-Some functionality is held behind "feature gates", or compile-time flags. The following list explains each feature's purpose:
-
-- `gpgme` enables GPG support via `libgpgme` (on by default)
-- `dbus-notifications` enables showing notifications using `dbus` (on by default)
-- `notmuch` provides support for using a notmuch database as a mail backend (on by default)
-- `jmap` provides support for connecting to a jmap server and use it as a mail backend (on by default)
-- `sqlite3` provides support for builting fast search indexes in local sqlite3 databases (on by default)
-- `cli-docs` includes the manpage documentation compiled by either `mandoc` or `man` binary to plain text in `meli`'s command line. Embedded documentation can be viewed with the subcommand `meli man [PAGE]` (on by default).
-- `regexp` provides experimental support for theming some e-mail fields based
-  on regular expressions.
-  It uses the `pcre2` library.
-  Since it's actual use in the code is very limited, it is not recommended to use this (off by default).
-- `static` and `*-static` bundle C libraries in dependencies so that you don't need them installed in your system (on by default).
-
-Though not a feature, the presence of the environment variable `UNICODE_REGENERATE_TABLES` in compile-time of the `melib` crate will force the regeneration of unicode tables.
-Otherwise the tables are included with the source code, and there's no real reason to regenerate them unless you intend to modify the code or update to a new Unicode version.
-
-## Build Debian package (*deb*)
-
-Building with Debian's packaged cargo might require the installation of these two packages: `librust-openssl-sys-dev librust-libdbus-sys-dev`
-
-A `*.deb` package can be built with `make deb-dist`
-
-## Using notmuch
-
-To use the optional notmuch backend feature, you must have `libnotmuch5` installed in your system.
-In Debian-like systems, install the `libnotmuch5` packages.
-`meli` detects the library's presence on runtime.
-If it is not detected, you can use the `library_file_path` setting on your notmuch account to specify the absolute path of the library.
-
-## Using GPG
-
-To use the optional gpg feature, you must have `libgpgme` installed in your system.
-In Debian-like systems, install the `libgpgme11` package.
-`meli` detects the library's presence on runtime.
-
-## Development
-
-Development builds can be built and/or run with
-
-```
-cargo build
-cargo run
-```
-
-There is a debug/tracing log feature that can be enabled by using the flag `--feature debug-tracing` after uncommenting the features in `Cargo.toml`.
-The logs are printed in stderr when the env var `MELI_DEBUG_STDERR` is defined, thus you can run `meli` with a redirection (i.e `2> log`).
-
-To trace network and protocol communications you can enable the following features:
-
-- `imap-trace`
-- `jmap-trace`
-- `nntp-trace`
-- `smtp-trace`

CHANGELOG.md

@@ -1,733 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-
-- [0e3a0c4b](https://git.meli-email.org/meli/meli/commit/0e3a0c4b7049139994a65c6fe914dd3587c6713e) Add safe UI widget area drawing API
-- [0114e695](https://git.meli-email.org/meli/meli/commit/0114e695428579ef4461b289d7372e3b392b5e62) Add next_search_result and previous_search_result shortcuts
-- [c4344529](https://git.meli-email.org/meli/meli/commit/c4344529e30b3385149d6dc3c1c4b34306a85491) Add .git-blame-ignore-revs file
-
-### Fixed
-
-- [bcec745c](https://git.meli-email.org/meli/meli/commit/bcec745c241d7ed5d7d455ccdd65c6c95e1862b0) Fix command and status bar drawing
-- [62b8465f](https://git.meli-email.org/meli/meli/commit/62b8465f2cd99789576d70008f1f321243b81fc3) Fix ThreadView for new TUI API
-- [28fa66cc](https://git.meli-email.org/meli/meli/commit/28fa66cc2ad05e67708377fc99ffd65aa1b14386) Fix ThreadedListing for new TUI API
-- [2c6f180d](https://git.meli-email.org/meli/meli/commit/2c6f180df987976c1f4cba7ceac878e697c73d27) Fix macos compilation
-- [24971d19](https://git.meli-email.org/meli/meli/commit/24971d1960418bad92d89af9eb744933445baf99) Fix compilation with 1.70.0 cargo
-
-### Changed
-
-- [a1cbb198](https://git.meli-email.org/meli/meli/commit/a1cbb1988b34951046045f724f52bed2925b3880) Return Results instead of panicking
-- [7645ff1b](https://git.meli-email.org/meli/meli/commit/7645ff1b875e3920389567eb5e61d800291e8a27) Rename write_string{to_grid,}
-- [c2ae19d1](https://git.meli-email.org/meli/meli/commit/c2ae19d1208f2eb5cca341a04e019c3e285637a8) Return Option from current_pos
-- [b61fc3ab](https://git.meli-email.org/meli/meli/commit/b61fc3ab6482dcef4f5cc1c09db3539b7e401f78) Add HelpView struct for shortcuts widget
-- [ba7a97e9](https://git.meli-email.org/meli/meli/commit/ba7a97e90b4c474299a7b12fa74b7ea06c1535c8) Add x axis scroll support
-- [3495ffd6](https://git.meli-email.org/meli/meli/commit/3495ffd61b5888f8538304ecb6e441819b373bdc) Change UIEvent::Notification structure
-- [ccf6f9a2](https://git.meli-email.org/meli/meli/commit/ccf6f9a26e95437fb24464f90736c653e3f5dfed) Remember previous `set [index_style]]` preferences
-- [23c15261](https://git.meli-email.org/meli/meli/commit/23c15261e79c63791c569f225c1745df1b90ce2d) Abstract envelope view filters away
-- [031d0f7d](https://git.meli-email.org/meli/meli/commit/031d0f7dc76700ac938e1ee4a767fab8deebb9f2) Add area.is_empty() checks in cell iterators
-- [e37997d6](https://git.meli-email.org/meli/meli/commit/e37997d697f1f0b8faaa56a36f43c9f1da4bbb41) Store Link URL value in Link type
-
-### Refactoring
-
-- [0500e451](https://git.meli-email.org/meli/meli/commit/0500e451dab5f129d71a9279913531e77981e868) Add missing EnvelopeRemove event handler
-- [ab14f819](https://git.meli-email.org/meli/meli/commit/ab14f81900a03a07ef00a6b3232cb29d78e8edf5) Make write_string_to_grid a CellBuffer method
-- [e0adcdfe](https://git.meli-email.org/meli/meli/commit/e0adcdfe15b8a78c333de199ba734a83181f53be) Move rest of methods under CellBuffer
-- [0a74c7d0](https://git.meli-email.org/meli/meli/commit/0a74c7d0e5c318dd29c8ace01e588d441e0fcfb6) Overhaul refactor
-- [3b4acc15](https://git.meli-email.org/meli/meli/commit/3b4acc15a535c9bfd084b2e33f2cd00b5b5d4eb0) Add tests
-- [7eedd860](https://git.meli-email.org/meli/meli/commit/7eedd860518e3f7f5000a1888e4fa58ddbfb43bc) Remove address_list! macro
-- [f3e85738](https://git.meli-email.org/meli/meli/commit/f3e85738e7981755e96468213c02af78432f8cdd) Move build.rs scripts to build directory
-- [77325486](https://git.meli-email.org/meli/meli/commit/773254864bd8436712905eeb0c725d1d05277e60) Remove on-push hooks for actions w/ run on-pr
-
-### Documentation
-
-- [d018f07a](https://git.meli-email.org/meli/meli/commit/d018f07aa51fc293bf696fa7d7beff8e59ac91a8) Retouch manual pages
-- [3adba40e](https://git.meli-email.org/meli/meli/commit/3adba40e32a8a66271ea2a8f5ddf27858744ecd6) Add macos manpage mirror url
-
-### Packaging
-
-- [cd2ba80f](https://git.meli-email.org/meli/meli/commit/cd2ba80f8e5424be08421b4dcc5113977418f240) Update metadata
-- [5f8d7c80](https://git.meli-email.org/meli/meli/commit/5f8d7c8039c0623b3950fd1a8eb566f943fc309d) Update deb-dist target command with author metadata
-- [59c99fdc](https://git.meli-email.org/meli/meli/commit/59c99fdc79bb31fb42cb99d4b95613022396a499) Update debian package metadata
-
-### Miscellaneous Tasks
-
-- [6506fffb](https://git.meli-email.org/meli/meli/commit/6506fffb9427ba13ba4368cd6b2c0dba12e5294c) Rewrite email flag modifications
-- [23507932](https://git.meli-email.org/meli/meli/commit/23507932f94257a71f2ca8db23840ee0716072b6) Update cache on set_flags
-- [470cae6b](https://git.meli-email.org/meli/meli/commit/470cae6b885c9b4851195fbb8274b1663bfa75cb) Update thread cache on email flag modifications
-- [c1c41c91](https://git.meli-email.org/meli/meli/commit/c1c41c9126005266f00d4979777718463dddf7b2) Update README.md and add Codeberg mirror
-- [84f3641e](https://git.meli-email.org/meli/meli/commit/84f3641ec1401a0522811add0ed87a131be449b9) Re-add on-screen message display
-- [54d21f25](https://git.meli-email.org/meli/meli/commit/54d21f25fdb716d36fd3678dd149eb880e16698d) Re-add contact list and editor support
-- [458258e1](https://git.meli-email.org/meli/meli/commit/458258e1aab91f3883d6a9201a175462511349e9) Re-enable compact listing style
-- [1c1be7d6](https://git.meli-email.org/meli/meli/commit/1c1be7d6c9bfc9f14c3a62ce464e1e15f2e6c4ec) Add display_name(), display_slice(), display_name_slice() methods
-- [5dd71ef1](https://git.meli-email.org/meli/meli/commit/5dd71ef1cd93aebaadb0554eac692d0a0fa4aecd) Upgrade JobsView component to new TUI API
-- [b5cc2a09](https://git.meli-email.org/meli/meli/commit/b5cc2a095f0268bb90cab150e903b0bbaffe1479) Upgrade MailboxManager component to new TUI API
-- [ed8a5de2](https://git.meli-email.org/meli/meli/commit/ed8a5de2cb4b93ad766803d3590f7041f28cc419) Re-enable EditAttachments component
-- [77a8d9e2](https://git.meli-email.org/meli/meli/commit/77a8d9e2c2094e84e06f5d624cb6f8afda24a400) Make ModSequence publicly accessible
-- [64898a05](https://git.meli-email.org/meli/meli/commit/64898a0583e348fef3cd266a7196425e7015a871) Make UIDStore constructor pub
-- [10c3b0ea](https://git.meli-email.org/meli/meli/commit/10c3b0eabe1684699c775e03c4c58038ea7979af) Bump version to 0.8.5-rc.1
-- [71f3ffe7](https://git.meli-email.org/meli/meli/commit/71f3ffe740276087f20d85d62440ef5d3fe426f6) Update Makefile
-- [63a63253](https://git.meli-email.org/meli/meli/commit/63a63253d77f6e1b9a42ec55ecf0bbc45a011245) Use type alias for c_char
-- [c751b2e8](https://git.meli-email.org/meli/meli/commit/c751b2e8450aa83b7a8f5e8afbeccadf333f74ba) Re-enable conversations listing style
-- [d16afc7d](https://git.meli-email.org/meli/meli/commit/d16afc7d8d9e2eddb81664673e9a4ef82da2e303) Bump version to 0.8.5-rc.2
-- [da251455](https://git.meli-email.org/meli/meli/commit/da251455a0185e207e0ec2d51273f6ddbdb572a8) Bump meli version to 0.8.5-rc.2
-- [3a709794](https://git.meli-email.org/meli/meli/commit/3a7097948308981204132a0eed2d28338f9d6b33) Update minimum rust version from 1.65.0 to 1.68.2
-- [f900dbea](https://git.meli-email.org/meli/meli/commit/f900dbea468e822c5a510a72ecc6367549443927) Use cargo-derivefmt to sort derives alphabetically
-- [5ff4e8ae](https://git.meli-email.org/meli/meli/commit/5ff4e8ae68182db8d4535d8537d26a3f398c815b) Run builds.yaml when any manifest file changes
-- [0a617410](https://git.meli-email.org/meli/meli/commit/0a617410ec1ce5f6fb43772e4ad43f45f58a7f4d) Split test.yaml to test.yaml and lints.yaml
-- [3ba1603a](https://git.meli-email.org/meli/meli/commit/3ba1603af2a9e408659717b9c8dace7406a8b142) Add manifest file only lints workflow
-- [1617212c](https://git.meli-email.org/meli/meli/commit/1617212c5b0948174155ece4a9d0584764bd7dac) Add scripts/check_debian_changelog.sh lint
-- [e19f3e57](https://git.meli-email.org/meli/meli/commit/e19f3e572c0ac585a6c2023e50f8fd0bd2ea2dae) Cargo-sort all Cargo.toml files
-- [c41f35fd](https://git.meli-email.org/meli/meli/commit/c41f35fdd55bf093656b68cc69eab4cf4b9a8ec4) Use actions/checkout@v3
-- [876616d4](https://git.meli-email.org/meli/meli/commit/876616d45b7798131ecdda82bb90d1d481842f5c) Use actions/upload-artifact@v3
-- [2419f4bd](https://git.meli-email.org/meli/meli/commit/2419f4bd40fb1a732cf1df42dde48ba8ca812072) Add debian package build workflow
-
-## [v0.8.4](https://git.meli-email.org/meli/meli/releases/tag/v0.8.4) - 2023-11-22
-
-### Fixed
-
-- [ef30228e](https://git.meli-email.org/meli/meli/commit/ef30228e08efe6e36ab9858a5ba32876d6d8fdae) Fix failing test
-
-### Miscellaneous Tasks
-
-- [f81a1e23](https://git.meli-email.org/meli/meli/commit/f81a1e23382208390394be71e3aaa27ee505cb0f) Bump version to 0.8.4
-
-## [v0.8.3](https://git.meli-email.org/meli/meli/releases/tag/v0.8.3) - 2023-11-22
-
-### Added
-
-- [3105a037](https://git.meli-email.org/meli/meli/commit/3105a0373b8754f37b326239c1cf7129fae06e1b) Add quit command
-
-### Fixed
-
-- [d3cbf184](https://git.meli-email.org/meli/meli/commit/d3cbf184e606d5b7ade9cfb125db01f45d7180ae) Add extra_submission_headers fields in composer form and autocomplete for Newsgroups
-- [7aec5b8e](https://git.meli-email.org/meli/meli/commit/7aec5b8e78d80e7717a9aedd7344db6b108534f5) Fix SMTP example doc
-- [f702dc22](https://git.meli-email.org/meli/meli/commit/f702dc220c9ab97ce0fddfae194d5e2935a20193) Fix new clippy lints.
-- [688e39a6](https://git.meli-email.org/meli/meli/commit/688e39a67e6a467ca649acbe20b1f368fbc1e9f0) Fix clippy lints
-
-### Changed
-
-- [5a7919bb](https://git.meli-email.org/meli/meli/commit/5a7919bb03641be6d7bc5b9002d44e16ee358f12) Use ConversationsListing::format_date
-- [0f3b5294](https://git.meli-email.org/meli/meli/commit/0f3b52945959b53c8d809eb434a91ec4c561b2d4) Hoist format_date() to ListingTrait method
-
-### Refactoring
-
-- [e1b55340](https://git.meli-email.org/meli/meli/commit/e1b55340fa258a2a7b118fd18c11614fb2b5e173) Show error description when TIOCGWINSZ ioctl fails
-- [e95c275d](https://git.meli-email.org/meli/meli/commit/e95c275d68fe3dbd588046c110ae8b3fa966f6de) Remove duplicate end sequence
-- [8a21be21](https://git.meli-email.org/meli/meli/commit/8a21be21775cb474a6b65e1c0bffd771c0df6f2f) Replace splice with truncate
-- [2db021fa](https://git.meli-email.org/meli/meli/commit/2db021fa0a9a707cd7cdb6c8bf140bf5c8acf906) Remove regexp from default features
-- [fa33a946](https://git.meli-email.org/meli/meli/commit/fa33a9468a16c50361353efa269fca79bd58e284) Move managesieve-client binary to tools/
-
-### Miscellaneous Tasks
-
-- [e88957ae](https://git.meli-email.org/meli/meli/commit/e88957ae6edfee7fabb41e9210f9d906866cda8d) Add extra_submission_headers field in MailBackendCapabilities struct
-- [606f487f](https://git.meli-email.org/meli/meli/commit/606f487fc5e227f1727697a5911e27cbec174089) Add IRC channel badge
-- [0e60bdf2](https://git.meli-email.org/meli/meli/commit/0e60bdf26eb842744f59257800ca8e30b1a43836) Add "iterator" feature to signal-hook
-- [ac2a5dcd](https://git.meli-email.org/meli/meli/commit/ac2a5dcdd10d97f5ed9c8a8c83e1641b373dd31a) Add display() method for Address
-- [43bfd413](https://git.meli-email.org/meli/meli/commit/43bfd4131d5cab39319d1943bcad46e929ec4d56) Update ahash dependency
-- [af241d25](https://git.meli-email.org/meli/meli/commit/af241d25cbab20227a88ec4d557222cdeed98dde) Bump version to 0.8.3
-- [7387b67e](https://git.meli-email.org/meli/meli/commit/7387b67eeee27aefbc4d20ca2a1d503aa0fb1838) Enable "static" build for C library dependencies by default
-- [bfc78a08](https://git.meli-email.org/meli/meli/commit/bfc78a0803524e236bc883833838d3ad78918621) Replace CRLF with LF when editing
-- [111a1160](https://git.meli-email.org/meli/meli/commit/111a1160adf2e0fef00a90350784307c859a198b) Bump version to 0.8.3
-
-## [v0.8.2](https://git.meli-email.org/meli/meli/releases/tag/v0.8.2) - 2023-09-22
-
-### Fixed
-
-- [73b3ed55](https://git.meli-email.org/meli/meli/commit/73b3ed559d21dcc7cdee7f96119461e2447c1906) Fix forward dialog not workng
-- [7888d8b2](https://git.meli-email.org/meli/meli/commit/7888d8b2a5dc977f0f18094a32dc73893a5cfc4f) Fix doc test compilation
-
-### Changed
-
-- [22525d40](https://git.meli-email.org/meli/meli/commit/22525d40fb48661f86657151e35fdf9c95c4b45e) Go to end when pressing next/page down for the second time
-- [71474436](https://git.meli-email.org/meli/meli/commit/714744366f5e26fc1b6609e8e785d64489f9a68d) Revert 22525d40 behavior when sidebar not focused
-
-### Miscellaneous Tasks
-
-- [eb5d49c4](https://git.meli-email.org/meli/meli/commit/eb5d49c41ac58c5068011620c22e21b5fa115417) Use Self in self methods
-- [3d85ca2e](https://git.meli-email.org/meli/meli/commit/3d85ca2edfca9abff4b3ffdd837b25e68c6586c2) Bump version to 0.8.2
-
-## [v0.8.1](https://git.meli-email.org/meli/meli/releases/tag/v0.8.1) - 2023-09-13
-
-### Added
-
-- [6476985c](https://git.meli-email.org/meli/meli/commit/6476985ce6abbb9048ba5aec19f6c5144bfe89b7) Add Cross.toml for aarch64-unknown-linux-gnu builds
-- [45d4f611](https://git.meli-email.org/meli/meli/commit/45d4f611b170d7b80afca5810c51fea1bf084c10) Add install-man cli subcommand to install manpages on your system
-- [a4f0dbac](https://git.meli-email.org/meli/meli/commit/a4f0dbac26126c03886115e518b3cd2ede0b88cb) Add current working directory tracking to Context
-
-### Fixed
-
-- [49a38a23](https://git.meli-email.org/meli/meli/commit/49a38a23bf522a18e636385632cfe3533c4f525c) Fix invalid Type link references
-- [85af5244](https://git.meli-email.org/meli/meli/commit/85af524458bc06421ac39689469474efb8164c1c) Fix invalid mailto() results when body field exists
-- [c7825c76](https://git.meli-email.org/meli/meli/commit/c7825c76c3ac6be89f64f1f04afd9c0ca08bdf76) Handle dialog Esc in the parent component
-- [dd4d0b79](https://git.meli-email.org/meli/meli/commit/dd4d0b79721d8cd5b29cdaca9cd01412974f2e13) Fix typo
-- [c43aeb0e](https://git.meli-email.org/meli/meli/commit/c43aeb0eb103f2a8fd802f84eab56551c6e65418) Fix invalid address parse on folded values
-- [7e3e9386](https://git.meli-email.org/meli/meli/commit/7e3e9386316ef344580d9e44edb3f8b0c196c3c5) Fix out-of-bounds draw when terminal is small
-- [7e4ed2fa](https://git.meli-email.org/meli/meli/commit/7e4ed2fa107eca2ef309bcaa211440c315730b6c) Fix some out of bounds drawing.
-
-### Changed
-
-- [1b3bebe3](https://git.meli-email.org/meli/meli/commit/1b3bebe3049ae5c7cb2210ed95c355c9b5c709f8) Open earliest unread email instead of first in thread
-- [49c36009](https://git.meli-email.org/meli/meli/commit/49c36009cec8c88d61d796162787990216bfeeab) Don't initialize entire thread at once
-- [0a9c89b6](https://git.meli-email.org/meli/meli/commit/0a9c89b6b357fc3d002c3eb451fd67e7a49ce7f5) Add toggle_layout shortcut
-- [64ba0459](https://git.meli-email.org/meli/meli/commit/64ba0459ee3652eaf451d10222853a898d85e337) Init cursor at To: header field
-- [81974311](https://git.meli-email.org/meli/meli/commit/81974311c200b8ad66c0e626f8b8db6686e565ff) Show current number command buffer
-
-### Refactoring
-
-- [a337e226](https://git.meli-email.org/meli/meli/commit/a337e2269e584769314cdf325cdeb6e57cb0c622) Refactor module structure
-- [b4f2f335](https://git.meli-email.org/meli/meli/commit/b4f2f3357613729e493e5f41a48def7610dc65aa) Remove deflate feature; make it a hard dependency
-- [2dc29405](https://git.meli-email.org/meli/meli/commit/2dc29405868b9df0dfff25e341814526a478db00) Add feature to use cache instead of downloading unicode data
-- [0132677f](https://git.meli-email.org/meli/meli/commit/0132677ff54a9618d3c59b08a188b73ae0c062c7) Introduce CommandError with context
-- [3344a8db](https://git.meli-email.org/meli/meli/commit/3344a8dbf6b478a85d2b933fc1fa1a6001c600f4) Remove unnecessary Clone derives
-- [b673af02](https://git.meli-email.org/meli/meli/commit/b673af02ac9e9d4be95daa2490ce24d0bc9b10d9) Move to crate root
-- [54862f86](https://git.meli-email.org/meli/meli/commit/54862f8651cb7dfe3bca7f5924fe776b93ac6aee) Add hide_sidebar_on_launch option
-
-### Miscellaneous Tasks
-
-- [a615b470](https://git.meli-email.org/meli/meli/commit/a615b4701b7e852a9112b317e2e31997c6cbe82e) Embed xdg-utils crate
-- [f0075b86](https://git.meli-email.org/meli/meli/commit/f0075b86cf636a3d39d4edf1ff6d58c112bbecf7) Show descriptive tab names for composer and threads
-- [6d5ebb5b](https://git.meli-email.org/meli/meli/commit/6d5ebb5b04279fe6e4fbf598504cae2f012fa494) Split code into submodules, add better error reporting
-- [63abf1e8](https://git.meli-email.org/meli/meli/commit/63abf1e890b93fcadf35f88b3dbea473c0d8f5cd) Update README.md
-- [bb4d2000](https://git.meli-email.org/meli/meli/commit/bb4d20003690d72b62a66d46a1fc5ae914e2bf64) Unify toggle_* parsers
-- [9b9c38f7](https://git.meli-email.org/meli/meli/commit/9b9c38f769abae0ff86e4b71e4db0ad65fdacfb4) Don't flood user with sqlite3 errors if db is corrupted
-- [747e39bf](https://git.meli-email.org/meli/meli/commit/747e39bf55cfc19b6eeece3ca7c71bad98d92389) Add print-used-paths subcommand
-- [39e99770](https://git.meli-email.org/meli/meli/commit/39e99770da4b51d0986a4b561fbe36b27d04565d) Use Context::current_dir() when saving files to relative paths
-- [fe0a96f0](https://git.meli-email.org/meli/meli/commit/fe0a96f0855486207280430064a93cab94dffeb2) Update to 2021 edition
-- [3944e4e6](https://git.meli-email.org/meli/meli/commit/3944e4e60e431247eefc0b3cf35af27fb011f37b) Update to 2021 edition
-- [7eed8278](https://git.meli-email.org/meli/meli/commit/7eed82783a3dbac513e233be4f0bce06904fe8c8) Bump version to 0.8.1
-
-## [v0.8.0](https://git.meli-email.org/meli/meli/releases/tag/v0.8.0) - 2023-08-29
-
-### Added
-
-- [36e29cb6](https://git.meli-email.org/meli/meli/commit/36e29cb6fd00c798ad83e3064e0ff78c8153dced) Add configurable mailbox sort order
-- [81184b18](https://git.meli-email.org/meli/meli/commit/81184b182c5f5d65614653b817981fddc6a84ffa) Add extra_identities configuration flag
-- [b716e438](https://git.meli-email.org/meli/meli/commit/b716e4383ea3163cabe760cd5512b7d70b218915) Add collapse option for mailboxes in sidebar menu
-- [3d92b410](https://git.meli-email.org/meli/meli/commit/3d92b41075fc16214675cf141acd9c89fb6f5c49) Add cli-docs feature to the default set
-- [104352e5](https://git.meli-email.org/meli/meli/commit/104352e5950598f4a659bd593d587910af8adc12) Add table UI widget
-- [7d9cabb0](https://git.meli-email.org/meli/meli/commit/7d9cabb023b510e6175fd6b2523f0414a6da1f3f) Add mailbox manager tab
-- [660bacb9](https://git.meli-email.org/meli/meli/commit/660bacb9262dac7457bd8c421cc70343a0db3cd5) Add `mailto` command to open composer with initial values from mailto template
-- [3adf72ae](https://git.meli-email.org/meli/meli/commit/3adf72aed0772fea39fbd6cbaec680fb2995e92d) Add support for utf-7 encoding
-- [d9c07def](https://git.meli-email.org/meli/meli/commit/d9c07def0f5db655aa11c5981d1419a336c3d91a) Add command to select charset encoding for email
-- [8c671935](https://git.meli-email.org/meli/meli/commit/8c671935f9ad5bd2894c0ecdaec9c2f378e461ca) Add compose (pre-submission) hooks for validation/linting
-- [96537e48](https://git.meli-email.org/meli/meli/commit/96537e48c5f5c8d54076ec5db76e94a499cbe1e6) Add {Timer,Component}Id wrapper types over Uuid
-- [b5f205b7](https://git.meli-email.org/meli/meli/commit/b5f205b77b8911a1fb6019767bb026e5f4a7f79e) Add availability to use server_password_command in the nntp backend like in the IMAP backend
-- [a5770c89](https://git.meli-email.org/meli/meli/commit/a5770c89f46b908d17d6eb4573c8337a952f99a8) Add Woodpecker-CI check pipeline
-- [d4e605c0](https://git.meli-email.org/meli/meli/commit/d4e605c098ba13b8bc2d9f14d07ea45da38e9a2f) Add tagref source code annotations
-- [cf9a04a5](https://git.meli-email.org/meli/meli/commit/cf9a04a5910c9d82e1acb10a2f4d40c2af0335ed) Add metadata to Jobs, and add JobManager tab
-- [bb7e119a](https://git.meli-email.org/meli/meli/commit/bb7e119ade131e8fe1bcac39b616741af817808c) Add gitea CI workflows
-- [1c79786e](https://git.meli-email.org/meli/meli/commit/1c79786ea210e53ee7d566455d83d74fe4699d28) Add scripts/make_html_manual_page.py
-- [65e82d88](https://git.meli-email.org/meli/meli/commit/65e82d8896500e8ef586656e3bde4bc102b84aba) Add meli/README.md symbolic link
-
-### Fixed
-
-- [ce2068d3](https://git.meli-email.org/meli/meli/commit/ce2068d36bb5d8ad0bb8f886bc19cb4aab75c4e8) Fix background watch using JSON paths incorrectly
-- [e9aaa7b0](https://git.meli-email.org/meli/meli/commit/e9aaa7b067903040acd7f3d7c685de94b3b98450) Use *const c_char instead of *const i8 for portability
-- [aa3524dd](https://git.meli-email.org/meli/meli/commit/aa3524dd305f2cf293eaaf7120b812478255f79c) Fix tag not being removed in set_flags()
-- [daa900ec](https://git.meli-email.org/meli/meli/commit/daa900ec9a566460833c020feba10933c0248162) Fix embed terminal in macos
-- [7fca5f01](https://git.meli-email.org/meli/meli/commit/7fca5f01ef53069958403dd794ee0e5c310f4e45) Fix jmap build with isahc 1.7.2
-- [ed3dbc85](https://git.meli-email.org/meli/meli/commit/ed3dbc85861ab61fee56077c7ba94306b0a96dc4) Fix crashes when listing is empty
-- [824f614a](https://git.meli-email.org/meli/meli/commit/824f614a69e55a25d67832593cb8aadb9671e306) Fix HtmlView not being redrawn when parent is dirty
-- [97ff3e78](https://git.meli-email.org/meli/meli/commit/97ff3e787fbfb5ff50e3ba787f067829509f7cd2) Only add toml files to the themes
-- [9cb66ef8](https://git.meli-email.org/meli/meli/commit/9cb66ef818f6598eb779f931e201a8d38e86a484) Fix all clippy warnings in `meli` crate
-- [0c0bee44](https://git.meli-email.org/meli/meli/commit/0c0bee4482d4fbfa675b97ca30405fdc77655936) Add missing .PHONY targets, fix missing tab indentation
-- [a73885ac](https://git.meli-email.org/meli/meli/commit/a73885acb14cd94d4a6a54ebd5b39a001d7e21e1) Improve embed terminal
-- [da9c80cc](https://git.meli-email.org/meli/meli/commit/da9c80ccfd7aa87842c2c3c089ba2b784a583ab6) Enhance SubjectPrefix with strip_prefixes_from_list() method
-- [aa99b0d7](https://git.meli-email.org/meli/meli/commit/aa99b0d787463be4267913b801117bd4d2ea5003) Implement configurable subject prefix stripping when replying
-- [cbe593cf](https://git.meli-email.org/meli/meli/commit/cbe593cf31308dcf549d7880eea2d82e5024dd73) Add configurable header preample suffix and prefix for editing
-- [2de69d17](https://git.meli-email.org/meli/meli/commit/2de69d17f14e79ce2a35564d278b5e895d16a48f) Fix erroneous placement of newlnes for wrap_header_preamble suffix
-- [94bd84b4](https://git.meli-email.org/meli/meli/commit/94bd84b45d53b0e0fae52198fbdc05179b87cccc) Fix clippy lints for `meli` crate
-- [b138d9bc](https://git.meli-email.org/meli/meli/commit/b138d9bc6166b763febf035b50109d810e3c18c9) Fix some clippy lints
-- [c6bdda03](https://git.meli-email.org/meli/meli/commit/c6bdda03cf451ab52a3d414cad1344bb32c82879) Fix notmuch error shown on any missing backend
-- [16646976](https://git.meli-email.org/meli/meli/commit/16646976d75284665c1fa0d7b7e3e3cde3531d66) Fix reply subject prefixes stripping original prefix
-- [88a1f0d4](https://git.meli-email.org/meli/meli/commit/88a1f0d4bc17b60f8f23ea71f33a81aee78f8769) Fix FETCH response parsing bug
-- [59b95f83](https://git.meli-email.org/meli/meli/commit/59b95f83d2b388b30a3a855f68bf5952355597d7) Fix docs
-- [282af86e](https://git.meli-email.org/meli/meli/commit/282af86e83807772f042b115af24ffe2e0575b9e) Fix NAME sections manual pages for correct whatis(1) parsing
-- [bd22f986](https://git.meli-email.org/meli/meli/commit/bd22f986f0c06f6dae535733d484aa89f610ed46) Fix clippy lints
-- [5ba7b2cd](https://git.meli-email.org/meli/meli/commit/5ba7b2cd7bb07abe8faafe5e45db6145b3f90bc9) Fix clippy lints for meli binary
-- [7924aa8b](https://git.meli-email.org/meli/meli/commit/7924aa8bfe8f0fbcd557bb8bb3a9d3ebeab2220a) Fix compilation
-- [b9030a68](https://git.meli-email.org/meli/meli/commit/b9030a684c0ad64951a388e49d5825c12b483fb4) Fix selection not appearing immediately and invalid motions
-- [4f45b109](https://git.meli-email.org/meli/meli/commit/4f45b109745ebc29febc452b9bcb0cd88f131ffc) Fix tag updates not showing up right away
-- [abc56eae](https://git.meli-email.org/meli/meli/commit/abc56eae431153d2e48f8b1eb3e0d2a140b600d8) Fix SEEN flag update hiding mail view momentarily
-- [40c6647d](https://git.meli-email.org/meli/meli/commit/40c6647db83c5137b79c9bec233972a8a78aeb76) Fix multipart/related with main text/html part not displayed correctly
-- [11140b4a](https://git.meli-email.org/meli/meli/commit/11140b4a76419a6f8c83db38823e83aeac8fbb98) Fix test output
-- [3a10953f](https://git.meli-email.org/meli/meli/commit/3a10953f05ea4944a8a20c2c5d647d5862dca907) Update fix-prefix-for-debian.patch
-- [939dc15e](https://git.meli-email.org/meli/meli/commit/939dc15e289e06a0fad72e44f9e91133892a4ec0) Fix melib tests
-- [39d9c2af](https://git.meli-email.org/meli/meli/commit/39d9c2af3b7daf39c6aa7eab5f2d95f1b9c3a562) Fix test smtp server logic
-- [34bb532e](https://git.meli-email.org/meli/meli/commit/34bb532e8d91c5f35bdc058821da63ac543ecfa6) Mention w3m dependency
-- [b1a71887](https://git.meli-email.org/meli/meli/commit/b1a71887710153f0f98b25b2f224fbe37f7a6889) Clippy fixes
-- [1f8ac228](https://git.meli-email.org/meli/meli/commit/1f8ac2287b960e0ed5c44dadbf68b924f035d321) Fix ftplugin location and add example mail.vim file
-- [1eea8bab](https://git.meli-email.org/meli/meli/commit/1eea8bab77cc20fb911f13aa16322a217b36b06b) Fix `test_imap_fetch_response`.
-- [daf42fd4](https://git.meli-email.org/meli/meli/commit/daf42fd456bad5ddf65ac515c2fb277896d1fea3) Fix build error with quote 1.0.28
-- [6388bea9](https://git.meli-email.org/meli/meli/commit/6388bea9a063f776398ffc503fdb0789ce9af9f1) Fix &[u8] index in HeaderMap
-- [c5ecacea](https://git.meli-email.org/meli/meli/commit/c5ecaceae1ab50a1c337f5cab9e97c0b061cb2d5) Fix some search criteria in Query type
-- [27a4dcb9](https://git.meli-email.org/meli/meli/commit/27a4dcb916e0bed723490df9d82bfd7c83f10a83) Fix some rustdoc lints
-- [fdc0861a](https://git.meli-email.org/meli/meli/commit/fdc0861ac0ac725e6e5031d120bd4682752c0267) Fix expanded_hash argument off by one error
-- [0c0a678c](https://git.meli-email.org/meli/meli/commit/0c0a678cffec73940065923bb3837deb85075f9f) Fix overlay widgets not being reaped after Unrealize event
-- [65179d48](https://git.meli-email.org/meli/meli/commit/65179d4816a39b0c92e9c6a981b491c60313634f) Fix cursor/widget focus scrolling logic
-- [e64923ee](https://git.meli-email.org/meli/meli/commit/e64923eeaaf1fdf0ee485cceff0c57b2d43f165a) Fix debug_assert condition
-- [5f29faa6](https://git.meli-email.org/meli/meli/commit/5f29faa640ebe7b14e76e56227a482207b8d952e) Clippy lint fixes
-- [0b258a1f](https://git.meli-email.org/meli/meli/commit/0b258a1f058fa08b143a8e573883a4abe89dc7e1) Clippy lint fixes
-- [ba7f5dce](https://git.meli-email.org/meli/meli/commit/ba7f5dce1c37c04768aa060b35f3803e6db3840e) Fix display of threaded conversations tree structure
-- [1dc1d868](https://git.meli-email.org/meli/meli/commit/1dc1d86848eb6d187120bcaa00296f2b4e2025ca) Fix infinite loop bug
-- [e8e49e74](https://git.meli-email.org/meli/meli/commit/e8e49e741b0f888d44da69f52aa3fff2e03e7ced) Fix wrong per message offset
-- [e3dfeaad](https://git.meli-email.org/meli/meli/commit/e3dfeaad7e4f838af5fb2e6e398d3e1aa37fe511) Fix compilation error when building without `gpgme` feature
-- [7998e1e7](https://git.meli-email.org/meli/meli/commit/7998e1e77ef057bab28434edefb79d7be6a4de33) Add missing LC libc constants for openbsd target_os
-- [b5657201](https://git.meli-email.org/meli/meli/commit/b5657201db4828c6e61c52e7ce338ac1a6e6f9fc) Fix doctest compilation errors
-- [c2ed3e28](https://git.meli-email.org/meli/meli/commit/c2ed3e283f6729ac7e112d00ae54dd99a2ada5e6) Fix Source::* view showing only envelope body
-- [d93ee413](https://git.meli-email.org/meli/meli/commit/d93ee413a766f35a4ef88d9fc3ace9cf37d28dd1) Add timestamp_to_string_utc
-- [6086a378](https://git.meli-email.org/meli/meli/commit/6086a3789d4d01818322dab1f1a9eb4c1f6a2b25) Fix libgpgme segfault error and re-enable gpg
-- [ab418c1d](https://git.meli-email.org/meli/meli/commit/ab418c1d39d02840bc5c61996c1a5416e2f35464) Refresh documentation, fix encryption/signing
-- [0219dc87](https://git.meli-email.org/meli/meli/commit/0219dc870798a16fd4d9f546d14c115f9e2c6bd8) Respect max_objects_in_get when fetching email
-- [6280bc75](https://git.meli-email.org/meli/meli/commit/6280bc75e550332a73c1a51dd46475cd54cc0a34) Fix blob download URL formatting
-- [2df73547](https://git.meli-email.org/meli/meli/commit/2df73547515fd3464e1fc2b88aa67462f583a8ec) Fix overflow substracts
-- [8e698cab](https://git.meli-email.org/meli/meli/commit/8e698cabcfe58ddd566133ba2c33249c23180a74) Fix unreachable-pub and disjoint-capture lint errors
-- [40d4ecef](https://git.meli-email.org/meli/meli/commit/40d4ecefa013caaa13af493233c693fb495360ca) Accept invalid (non-ascii) address comment text
-- [4e654d2d](https://git.meli-email.org/meli/meli/commit/4e654d2d02044be7340b63f1250d37b2ca57b221) Limit LIST ACTIVE command length to 512 octets
-- [84081f4e](https://git.meli-email.org/meli/meli/commit/84081f4ed7570dd8bcc23d90b9c4cbff55620636) Minor style fix
-- [97d36868](https://git.meli-email.org/meli/meli/commit/97d3686815c011bb8f1d4e448f12b2294693730d) Use Happy Eyeballs algorithm Ꙭ
-- [96f0b3e6](https://git.meli-email.org/meli/meli/commit/96f0b3e6b484c9cbb7eaddcaad2b59811b733545) Fix shortcut section order
-- [64982b4c](https://git.meli-email.org/meli/meli/commit/64982b4cab0b0c2d396cb5dcf7add6f268fd4551) Fix page{up,down} event bubbling up
-- [8551e1ba](https://git.meli-email.org/meli/meli/commit/8551e1ba0b4fa6d9587bbb249f11e9b80d24e4d3) Fix new 1.72 default clippy lints
-
-### Changed
-
-- [8563bccd](https://git.meli-email.org/meli/meli/commit/8563bccd1b6d48dc06dd521f77228c3cbecf7613) Don't cache CellBuffer, only row info
-- [0f6f3e30](https://git.meli-email.org/meli/meli/commit/0f6f3e30c67f209e0b5e03d2dd2e1e48180d9855) Add IMAP config in config parse test
-- [ce269c64](https://git.meli-email.org/meli/meli/commit/ce269c64e16db344f0e65461e56dbced2f1a4d64) Don't fail on `server_password_command`
-- [9dc4d405](https://git.meli-email.org/meli/meli/commit/9dc4d4055cb2f854e835748315677bf4a2db2012) Add focus_{left,right} shortcuts to switch focus
-- [4b96bd59](https://git.meli-email.org/meli/meli/commit/4b96bd591f18bf7c8a3c922d469b81072d1782a2) Add ColorCache constructor to deduplicate code
-- [c06c3f58](https://git.meli-email.org/meli/meli/commit/c06c3f589315f017a412f31d80559a5a734d7b89) Draw gap between list and mail view
-- [c9d26bb4](https://git.meli-email.org/meli/meli/commit/c9d26bb4158e2f423c795f82bcb2c91a0f0c46ec) Add configurable custom hooks with shell commands
-- [02e86d1f](https://git.meli-email.org/meli/meli/commit/02e86d1fade9faefc14b890e3cec8ed2255bb839) Check for subject overflow on draw
-- [8cab9d9d](https://git.meli-email.org/meli/meli/commit/8cab9d9da8710257f2b62832bfac802c2a35b368) Add option to hide consecutive identical From values inside a thread
-- [363f4930](https://git.meli-email.org/meli/meli/commit/363f4930994d1d2e88220878b3848f176b8c5f97) Add {previous,next}_entry shortcuts to quickly open other mail entries
-- [342df091](https://git.meli-email.org/meli/meli/commit/342df091a076bce1f8477dabbad193312d8cdd67) Don't set all thread to seen when opening a thread entry
-- [74e15316](https://git.meli-email.org/meli/meli/commit/74e15316dbbf67254023e619924e522f80e77cb9) Open message/rfc822 attachments in subview instead of new tab
-- [369c1dbd](https://git.meli-email.org/meli/meli/commit/369c1dbdac9842746270a3d3c5bf7ed2205cb644) Show `open` command in status bar
-- [519257b0](https://git.meli-email.org/meli/meli/commit/519257b08f7029fe71efd2f61ab3a29a4b43b862) Add relative_menu_indices setting for menubar
-- [8abc9358](https://git.meli-email.org/meli/meli/commit/8abc9358a70465b12a11168be1718ab06479d6e2) Add newline after Version: 1 header
-- [561ba9c8](https://git.meli-email.org/meli/meli/commit/561ba9c87b57e1012ad89bde08506a2beacb7fff) Add relative_list_indices setting for thread listing
-- [52874f9a](https://git.meli-email.org/meli/meli/commit/52874f9a97a4799fcff2e14c43cafe9692f21cb6) Cancel previous jobs on MailView drop/update
-- [9037f084](https://git.meli-email.org/meli/meli/commit/9037f08495894c15a7817594ba91e0d5561c6e69) Replace hardcoded Key::{Home,End} values with shortcut values
-- [31aa9ad2](https://git.meli-email.org/meli/meli/commit/31aa9ad29e33f285314d0d320a02f00071f61282) Autogen mbox filename when exporting mail to directories
-
-### Refactoring
-
-- [330a2b20](https://git.meli-email.org/meli/meli/commit/330a2b20ed492f6b6ea86c196d43d67430487faa) Flush stdout in Ask() after printing
-- [340d6451](https://git.meli-email.org/meli/meli/commit/340d6451a330861af09fd02231c17ba4168d9654) Add config setting for sidebar ratio
-- [d0de0485](https://git.meli-email.org/meli/meli/commit/d0de04854ec4770b54e4d8303a9b8ab9eb5d68b0) Add {in,de}crease_sidebar shortcuts
-- [f5dc25ae](https://git.meli-email.org/meli/meli/commit/f5dc25ae0d5b8d6fb15a534fa49557385d6894d0) Check that all conf flags are recognized in validation
-- [d3e62e3d](https://git.meli-email.org/meli/meli/commit/d3e62e3d74bdc55872bbdf92c01d18aa00b0affd) Use conf shortcuts for scroll {up, down}
-- [23c23556](https://git.meli-email.org/meli/meli/commit/23c2355662d589c091dd3c86c8d91c7988eb941c) Fill and align shortcut table columns
-- [5823178c](https://git.meli-email.org/meli/meli/commit/5823178cc26f66ba902a901522f0506b4348b22e) Add test that looks in source code for invalid theme key references
-- [9205f3b8](https://git.meli-email.org/meli/meli/commit/9205f3b8afe28ef3a68959d590ed967946a5d622) Handle a per account mail order parameter
-- [d921b3c3](https://git.meli-email.org/meli/meli/commit/d921b3c3209ff7fe865b5a3b90e20098b3ff211f) Use mail sorting parameters from config
-- [f4e0970d](https://git.meli-email.org/meli/meli/commit/f4e0970d46e3ec73d684e2ddcc5011f61e87314d) Add ability to kill embed process
-- [bde87af3](https://git.meli-email.org/meli/meli/commit/bde87af3877d4a0b071e331c93a07e0acf51bf7a) Refactor filter() method in Listing trait
-- [a42a6ca8](https://git.meli-email.org/meli/meli/commit/a42a6ca868e4590a8b93560737173e80993ecaec) Show notifications in terminal if no alternative
-- [eb5949dc](https://git.meli-email.org/meli/meli/commit/eb5949dc9bbcf05f86c58b3c93d1066204313e2a) Switch summary<->details identifiers
-- [8c7b001a](https://git.meli-email.org/meli/meli/commit/8c7b001aa5d4cb6bbaf438f3f47cd91cc2fd6833) Add `thread_subject_pack` command to pack different inner thread subjects in entry title
-- [388d4e35](https://git.meli-email.org/meli/meli/commit/388d4e35d65f8f770526c4c5f44767c55eda23f8) Add in-progress messages while connecting in IMAP
-- [787c64c2](https://git.meli-email.org/meli/meli/commit/787c64c2da8af5cc0dafcb92c1d3bea6b54f3659) Remove expect()s from create_config_file()
-- [b87d54ea](https://git.meli-email.org/meli/meli/commit/b87d54ea3f3f077b6330e798263be6a3d33b3b9c) Impl Into<BTreeSet<EnvelopeHash>> for EnvelopeHashBatch
-- [e450ad0f](https://git.meli-email.org/meli/meli/commit/e450ad0f9cbc2d215a8f03d2d39260abe19fb5af) Remove unused struct
-- [c54a31f7](https://git.meli-email.org/meli/meli/commit/c54a31f7cca728eec87f7cd670a4baec37dc919a) Break line for error messages
-- [7935e49a](https://git.meli-email.org/meli/meli/commit/7935e49a00190cc7f2057abe353739c8dad4f74d) Check properly if mailbox request is an error
-- [117d7fbe](https://git.meli-email.org/meli/meli/commit/117d7fbe046fe23c400a925ccba7317d8a1d3f08) Make private fields public
-- [ffb12c6d](https://git.meli-email.org/meli/meli/commit/ffb12c6d1ae9a774de22a25d38bc6714a435c7ad) Make all public struct fields public
-- [46a038dc](https://git.meli-email.org/meli/meli/commit/46a038dc68093b28b69c3af38de4dd09431efae2) Remove interactive messages when #[cfg(test)]
-- [803d3414](https://git.meli-email.org/meli/meli/commit/803d3414fd73743ff5bfc0fefe5e3d76d88e58cb) Implement some rfc5804 commands
-- [b776409d](https://git.meli-email.org/meli/meli/commit/b776409d6c9caec3732bada9e25637c2676af3b8) Add thread, env hash index fields
-- [cc439b23](https://git.meli-email.org/meli/meli/commit/cc439b239ae27ae84fbcf50fbd82ec591c147c94) Add RowsState struct
-- [db227dea](https://git.meli-email.org/meli/meli/commit/db227dea34caa747e136500356fddf95a91002e6) Add error messages if `mandoc`,`man` binaries are missing
-- [ee9d458b](https://git.meli-email.org/meli/meli/commit/ee9d458b05ffa0214a4526daf1423916830526bc) Implement mailbox {un,}sub actions
-- [7af89359](https://git.meli-email.org/meli/meli/commit/7af893597f5a3f3261bfff47dae0723bf1b17e53) Replace use of Self::DESCRIPTION with Shortcuts struct consts
-- [eaecc5ea](https://git.meli-email.org/meli/meli/commit/eaecc5ea12f4a5ebe309d5654509c0771bbdc2f1) Remove hardcoded major .so version for non linux/macos target_os
-- [f63ce388](https://git.meli-email.org/meli/meli/commit/f63ce388f7774ea015fdaa2362202c33f3ddacd4) Move ManageMailboxes to Tab Actions
-- [3c847ad2](https://git.meli-email.org/meli/meli/commit/3c847ad26afcc4a4cdcfbdbf70f35be57d0da1ab) Add beginning of sieve parser
-- [5443b7e8](https://git.meli-email.org/meli/meli/commit/5443b7e8f300a0084abde7354360ecbe909178bb) Remove literal_map() parse combinator
-- [12cb717b](https://git.meli-email.org/meli/meli/commit/12cb717bda186b0ebdda18e2215e30b1426fb08a) Add server_password_command to jmap
-- [428f752b](https://git.meli-email.org/meli/meli/commit/428f752b20cdb1c8ab01e7f3119001cfafca8ef1) Remove obsolete crate::components::mail::get_display_name()
-- [91557c2c](https://git.meli-email.org/meli/meli/commit/91557c2c4366b481e80943e94f661c8b47150571) Prevent list blank when refreshing account
-- [d332e457](https://git.meli-email.org/meli/meli/commit/d332e4578d69c4371418fb2bb3c0d75e1960e01f) Add proper Display impl for HeaderName
-- [f537c249](https://git.meli-email.org/meli/meli/commit/f537c24909d13a53a95b43e265e4cb4c013334ac) Move text field to its own module
-- [d33f9d54](https://git.meli-email.org/meli/meli/commit/d33f9d54c708699386a3f32e4056ccab6c68528b) Remove unreachable!() in Key::serialize
-- [330887c4](https://git.meli-email.org/meli/meli/commit/330887c4f5bad5357508b9fa6f723e45ab307d2a) Introduce imap-codec.
-- [4da53669](https://git.meli-email.org/meli/meli/commit/4da5366959145e166c40297abfdf1876e5addc50) Remove bincode dep, use serde_json for sqlite3 values
-- [155fb41b](https://git.meli-email.org/meli/meli/commit/155fb41b93708ef8793250f9dea611bc317a86d5) Remove unused Component::set_id method
-- [575509f1](https://git.meli-email.org/meli/meli/commit/575509f1edc756ad218bb76cf74460d83009c851) Move mail view to listing parent component
-- [6858ee1f](https://git.meli-email.org/meli/meli/commit/6858ee1fab3bcddbda7335f49c30f36153e8d4b7) Move subcommand handling to its own module
-- [b0e867eb](https://git.meli-email.org/meli/meli/commit/b0e867eb68dc3dba96de79f7481989187fa12df4) Move src to meli/src
-- [48a10f72](https://git.meli-email.org/meli/meli/commit/48a10f724171bfae702b7b40438189adbbe75079) Remove unused BackendOp::fetch_flags() method
-- [073d43b9](https://git.meli-email.org/meli/meli/commit/073d43b9b869fc9d46c5195c31ad6e7806cf486c) Move data files to data subdir
-- [1e084c1d](https://git.meli-email.org/meli/meli/commit/1e084c1d854ed7efb2254f9e8d52ac13d8badffa) Move backends out of the backends module
-- [a5446975](https://git.meli-email.org/meli/meli/commit/a5446975c2423654dea9551474a880e94ebdc006) Move braille and screen to their own module files
-- [005bf388](https://git.meli-email.org/meli/meli/commit/005bf3881ec59d53e4f16473fb3b1857487dae23) Move components/utilities -> utilities
-- [64ab65dd](https://git.meli-email.org/meli/meli/commit/64ab65ddffe3341bca775acb2289ee00e771fdb0) Move components/contacts -> contacts
-- [7c9a4b4b](https://git.meli-email.org/meli/meli/commit/7c9a4b4b7c366c967a3378098d210124712fd293) Move components/mail -> mail
-- [df638cce](https://git.meli-email.org/meli/meli/commit/df638cceec6016760037b650a77143a07cd1e738) Remove stale failing doc code example
-- [da8e8104](https://git.meli-email.org/meli/meli/commit/da8e81044833975cadb08db836795a389c142e9c) Remove leftover debug prints
-- [a1e70061](https://git.meli-email.org/meli/meli/commit/a1e7006186474f55cf4a14f53dbd32bdf8ca5993) Move Sort{Order,Field} to utils mod
-- [66c21ab1](https://git.meli-email.org/meli/meli/commit/66c21ab1734bfbf4e604da505f6b6109008fd7c2) Move StandardHeader to its own module
-- [946309c6](https://git.meli-email.org/meli/meli/commit/946309c6f3bbc59b53dc2b05732b40f3d445fd9f) Do some small parser refactoring
-- [b95f7783](https://git.meli-email.org/meli/meli/commit/b95f778335bebd480f69fe66fabec4f8a6e2b587) Move JmapSession to its own module
-
-### Documentation
-
-- [a866b294](https://git.meli-email.org/meli/meli/commit/a866b29499b44032545df4941b6cfec4ee2db8bb) Update valid shortcut entries from src/conf/shortcuts.rs
-- [f76f4ea3](https://git.meli-email.org/meli/meli/commit/f76f4ea3f7416a4a641d5891f19927aa354a3247) Add meli.7, a general tutorial document
-- [5fa4b626](https://git.meli-email.org/meli/meli/commit/5fa4b6260c60409579fe964970719f9ab60482cc) Add more screenshots
-- [7c711542](https://git.meli-email.org/meli/meli/commit/7c7115427dd5f6320a4305df3dc88a8567829720) Complete guide document
-- [30cc5d3d](https://git.meli-email.org/meli/meli/commit/30cc5d3d0220452630780c3238f393b9e1f2b93a) Add edit-config in manpages
-- [24103f33](https://git.meli-email.org/meli/meli/commit/24103f3310ca533791bdd07643fdb23a10c6031d) Add external-tools.md document
-- [b6c93e49](https://git.meli-email.org/meli/meli/commit/b6c93e49f2af3001b206a288edea02c58e14aa5b) Add use_tls option in IMAP connection settings
-- [34a54d3c](https://git.meli-email.org/meli/meli/commit/34a54d3c05efc3b56154179111c3e39e0f3fd8b1) Add some `TODO([#222](https://git.meli-email.org/meli/meli/issues/222))`s.
-
-### Packaging
-
-- [671ce9f6](https://git.meli-email.org/meli/meli/commit/671ce9f694a8e941826472caad8051998540bb1f) Add missing build dependencies
-
-### Miscellaneous Tasks
-
-- [25805229](https://git.meli-email.org/meli/meli/commit/2580522931fb29442598ac8932a13eaeb577bace) Log vcard parsing failures
-- [5f003a31](https://git.meli-email.org/meli/meli/commit/5f003a31be95a3877d1006f8a22e424a1183163d) Parse vCards with just LF instead of CRLF line endings
-- [d8e9a005](https://git.meli-email.org/meli/meli/commit/d8e9a00563c023abb0ff75aaa4ba3fa92626c5ce) Add quoted REFERENCES field in parsing of responses
-- [81d12656](https://git.meli-email.org/meli/meli/commit/81d1265601c299dee6405f3f9b4e81f89d3cfe29) Escape IMAP passwords properly
-- [0d8bedd2](https://git.meli-email.org/meli/meli/commit/0d8bedd2d5d3eb8eee831e75d1e14d45beefb847) Make is_online() await for connection
-- [d4b690d5](https://git.meli-email.org/meli/meli/commit/d4b690d5d3a7f6a6b57afd7a6177db0db20a9c94) Send password as byte literal on LOGIN
-- [2eb22a29](https://git.meli-email.org/meli/meli/commit/2eb22a290abb3f37bc77c3bc2771edfb60a1c314) Stop hardcoding certain component colors
-- [2c23ca34](https://git.meli-email.org/meli/meli/commit/2c23ca34cdee769a0f78a0b0ef934e5f20dd9567) Update most Cargo dependencies
-- [721891c2](https://git.meli-email.org/meli/meli/commit/721891c2955e9f5e223949bde2dd43604cec8390) Update nom dependency
-- [4fdc90b3](https://git.meli-email.org/meli/meli/commit/4fdc90b31ea56c046dfe5bf9bee0a118f9c03db1) Use `open` instead of `xdg-open` in macos
-- [9558b2ae](https://git.meli-email.org/meli/meli/commit/9558b2ae921aa35076f58d68b5898334a2797685) Parse Cp1253 as windows1253 encoding
-- [6a843d49](https://git.meli-email.org/meli/meli/commit/6a843d49830f8c70f510c4232ea63eb204d35319) Export list_mail_in_maildir_fs() function
-- [d6355a30](https://git.meli-email.org/meli/meli/commit/d6355a3043ec0b4b2a3e1c3fbb0ed66d2e87e7f4) Impl Debug for ParsingError
-- [dc5afa13](https://git.meli-email.org/meli/meli/commit/dc5afa13dbea4da042c35e12291c5b5a2846c3ff) Use osascript/applescript for notifications on macos
-- [e6d6e1f5](https://git.meli-email.org/meli/meli/commit/e6d6e1f588db9793e822cdbb1ce2edb2959170c6) Don't unwrap if pseudoterminal creation fails
-- [ca84906d](https://git.meli-email.org/meli/meli/commit/ca84906d7ddb1351643998efaa56086e3ba9cf8e) Escape all quotes in applescript on macos
-- [4a79b202](https://git.meli-email.org/meli/meli/commit/4a79b2021d2fb3edd046197b44b702bdb468fc5e) Update dependency versions
-- [e29041f7](https://git.meli-email.org/meli/meli/commit/e29041f73354c59ef95916edd75e6ca7876e3c3a) Rename src/bin.rs to src/main.rs
-- [7650805c](https://git.meli-email.org/meli/meli/commit/7650805c60cec2fe09cd2a59cb665731f5cca140) Bring stripped binary size down to 7MiB
-- [ca488968](https://git.meli-email.org/meli/meli/commit/ca48896865778df2c79bc1d13f03b5f56136304c) Add strip option to profile.release
-- [10497952](https://git.meli-email.org/meli/meli/commit/10497952f718b49f3a247741a64361f855b2d4f7) Wrap stdout in BufWriter
-- [29042aba](https://git.meli-email.org/meli/meli/commit/29042aba593210f3be73010908d5092951b3b1a1) Add mbox date format parse
-- [480000eb](https://git.meli-email.org/meli/meli/commit/480000ebbb67a80181fd27762ca649acf13df0f3) Show error if account directory does not contain ".notmuch" subdirectory
-- [a484b397](https://git.meli-email.org/meli/meli/commit/a484b397c68fd126c17073ac9c9f02432c413341) Show informative error messages if libloading fails
-- [4a20fc42](https://git.meli-email.org/meli/meli/commit/4a20fc42e1f5cad325d5aa439d1baab210aceed8) Update CHANGELOG.md
-- [a72c96a2](https://git.meli-email.org/meli/meli/commit/a72c96a26afe9e54a0fcadb8c43448f1fdc09ce9) Add 8BITMIME support to smtp client
-- [3c0f5d82](https://git.meli-email.org/meli/meli/commit/3c0f5d8274d8039b1a2c928f99194835bca7b83a) Add BINARYMIME support to smtp client
-- [36883692](https://git.meli-email.org/meli/meli/commit/36883692782ed2355a0ec12ccf9f82aa2edcc8c1) Add smtp test
-- [9cbbf71e](https://git.meli-email.org/meli/meli/commit/9cbbf71e0f8f9115e9e043982f20045cfc550eb7) Add DecodeOptions struct for decoding
-- [0df46a63](https://git.meli-email.org/meli/meli/commit/0df46a63ec6e30983480f0eb50c8da3f74b4f0b3) Show error if sqlite3 search backend is set but doesn't exist
-- [a7a50d30](https://git.meli-email.org/meli/meli/commit/a7a50d3078cb7466ab341ddfc30a80c7b1f8dfdb) Box<_> some large fields in biggest types
-- [d8d43a16](https://git.meli-email.org/meli/meli/commit/d8d43a16fef045a2116ff126e7b6e27817b526fc) Add html_open config setting
-- [0ed10711](https://git.meli-email.org/meli/meli/commit/0ed10711ef542cc13eaaef809fa557468b3d6696) Add new_mail_script option
-- [c3fdafde](https://git.meli-email.org/meli/meli/commit/c3fdafde3b69c0abc78a62926e0c32fc3dd602d6) Documentation touchups
-- [347be543](https://git.meli-email.org/meli/meli/commit/347be54305c60350b055a1da3a1abfa4d33d3f22) Add NetworkErrorKind enum
-- [0c08cb73](https://git.meli-email.org/meli/meli/commit/0c08cb737ceaa5c738712905c7d57f956d449ed0) Mark mailboxes as subscribed on personal accounts
-- [129573e0](https://git.meli-email.org/meli/meli/commit/129573e0fd9b42ebf14c2de176e65b92bf8479bd) Rename root_path to root_mailbox
-- [7e09b180](https://git.meli-email.org/meli/meli/commit/7e09b1807ffa9bae54da35b02c83b5aaee455819) Replace _Ref deref unwraps with expect()
-- [55ed9624](https://git.meli-email.org/meli/meli/commit/55ed962425ba25d2317946705ff6861a77eb770f) Use server_url instead of server_hostname + server_port in config
-- [0ef4dde9](https://git.meli-email.org/meli/meli/commit/0ef4dde9392452f7cf7f18294f747fc6e0babb8d) Wrap serde_json deserialize errors in human readable errors
-- [dd0baa82](https://git.meli-email.org/meli/meli/commit/dd0baa82e9789da23c8f9b06925776c7f80e2568) Spawn user-given command strings with sh -c ".."
-- [3697b7d9](https://git.meli-email.org/meli/meli/commit/3697b7d960cc9dbe602fa84f861cea854b600b73) Don't use LC_ category in place of LC_ masks in libc calls
-- [6d20abdd](https://git.meli-email.org/meli/meli/commit/6d20abdde7b4cec6ec1af7c097f01042ea05cfbb) Add #[allow(deref_nullptr)] in bindgen tests
-- [17b42b1a](https://git.meli-email.org/meli/meli/commit/17b42b1a6c721fb2e369c2a300867c8db2beb959) Add json deserialization tests
-- [64346dd3](https://git.meli-email.org/meli/meli/commit/64346dd3fe0ef40025ec6fdb01d18eb38f7e7f65) Add map_res, quoted_slice, is_a, alt, take, take_literal
-- [56fc43bc](https://git.meli-email.org/meli/meli/commit/56fc43bcf869a867455b44d007b9d3d17422bc8d) Add As{Ref,Mut} impls for RwRef{,Mut}
-- [63179841](https://git.meli-email.org/meli/meli/commit/631798413659a320dcd9574e0bca7b7d75cc8d6c) Add --bin flag to meli cargo build target
-- [ded9adde](https://git.meli-email.org/meli/meli/commit/ded9adde614ac3d38045fa97a0f5144b80855fe7) More descriptive "Unimplemented" messages
-- [2224a710](https://git.meli-email.org/meli/meli/commit/2224a7100f9bc6c44bc66117a88556003e74186e) Reset imap cache on init error
-- [252d2bdf](https://git.meli-email.org/meli/meli/commit/252d2bdf2f12c8954f8b299000bbde6219d25335) Replace hardcoded /bin/false with 'false'
-- [2427b097](https://git.meli-email.org/meli/meli/commit/2427b097c5c40f3212a105cb40f913c9860ae2a8) Make tag_default background lighter on light theme
-- [7382e301](https://git.meli-email.org/meli/meli/commit/7382e30160a934ce97dd73c1be44640d5b4a4c75) Convert EnvelopeHash from typedef to wrapper struct
-- [259aeb00](https://git.meli-email.org/meli/meli/commit/259aeb00877557ee85b5cc555d50e605b85b3109) Convert {Account,Mailbox}Hash from typedef to wrapper struct
-- [5634f955](https://git.meli-email.org/meli/meli/commit/5634f9555315deb2d39ed8fce577a35f4d535ac1) Rename MeliError struct to Error
-- [7606317f](https://git.meli-email.org/meli/meli/commit/7606317f24d076bdc7db873c2b15811728ed946a) Add support for virtual mailbox hierarchy
-- [2878bbb8](https://git.meli-email.org/meli/meli/commit/2878bbb8c887275d26264bf7201a632161c4048a) Add parser for mutt alias file
-- [de2f46fe](https://git.meli-email.org/meli/meli/commit/de2f46fe611726a445c1e06cbc35343e716aa335) Rustfmt changes
-- [f9ac9b60](https://git.meli-email.org/meli/meli/commit/f9ac9b607a2bd01e42c81cfab3c933df28ff1676) Temporarily disable libgpgme functions because of a bug
-- [256a3e25](https://git.meli-email.org/meli/meli/commit/256a3e252e2e4db9af9a04c7df1a52eeaf2bbfc9) Update minimum supported rust version
-- [fbc1007f](https://git.meli-email.org/meli/meli/commit/fbc1007ff4f41bac888a1b53c156feec4f795403) Deserialize `null` to empty vec for messageId
-- [d7ec97f0](https://git.meli-email.org/meli/meli/commit/d7ec97f03bc0e815e160a142f871dc764d416af1) Small rustfmt change
-- [2447a2cb](https://git.meli-email.org/meli/meli/commit/2447a2cbfeaa8d6f7ec11a2a8a6f3be1ff2fea58) Avoid relying on hardcoded hash values
-- [d679a744](https://git.meli-email.org/meli/meli/commit/d679a74450b35724301c81da1644bcedb1c54045) Implement Bearer token authentication
-- [47e6d5d9](https://git.meli-email.org/meli/meli/commit/47e6d5d935a2b5124efbe847dac885b859200469) Add edit-config CLI subcommand that opens config files on EDITOR
-- [3a02b6fb](https://git.meli-email.org/meli/meli/commit/3a02b6fb8024e6bb046fc167e7527aad1b192202) Mention how to override w3m with html_filter
-- [85d4316a](https://git.meli-email.org/meli/meli/commit/85d4316a6a8703ac3e4923cf99ce8c4bb22bb4ae) Replace old logging module with the `log` create
-- [1f1ea307](https://git.meli-email.org/meli/meli/commit/1f1ea307698a5a7f62f5ab2ea1594aef4d8f48a8) On draw() set dirty on return
-- [77020e0c](https://git.meli-email.org/meli/meli/commit/77020e0c19873b8053321132ff5b58181c567fcd) Update CHANGELOG.md
-- [682ea554](https://git.meli-email.org/meli/meli/commit/682ea5547e380deeb215503b39c8aa66c65b3cac) Add `.idea` (CLion) to `.gitignore`.
-- [f63f6445](https://git.meli-email.org/meli/meli/commit/f63f6445addeccee1a6b830f1c101a043612ea4e) Improve error message when `m4` executable is missing.
-- [cc27639f](https://git.meli-email.org/meli/meli/commit/cc27639fca0dcb3a5ff9fceef8666dbbf047adaa) Use Envelope attachments when editing and don't add already existing headers
-- [30866f75](https://git.meli-email.org/meli/meli/commit/30866f752b21802b64ce7d2e02c9962c1091c9d8) Bypass rustfmt bug.
-- [235fceaf](https://git.meli-email.org/meli/meli/commit/235fceaf2168af50c3804cecfbf69e64ff42598c) Add standard heeder constants in email::headers
-- [aebff3d3](https://git.meli-email.org/meli/meli/commit/aebff3d3d9864b8854aba5e7f43a61d515e8057f) Implement mailto RFC properly
-- [954329d8](https://git.meli-email.org/meli/meli/commit/954329d848a5b3e73fca50ed1db9859118bed6dd) Set file extensions to temp files, use `open` in macos
-- [58889bca](https://git.meli-email.org/meli/meli/commit/58889bcadd44d6aec2eddd17cf5ecb1e07531cbe) Add show_extra_headers option
-- [23d95973](https://git.meli-email.org/meli/meli/commit/23d95973d4f574fe431441df97ceaef0e3e4762f) Add search.rs module
-- [6bf1756d](https://git.meli-email.org/meli/meli/commit/6bf1756de844386ba312d15109ae29951896147b) Implement more search criteria in Query type
-- [299c8e0f](https://git.meli-email.org/meli/meli/commit/299c8e0f993c4ac88005a5c9e708d9e214b20ac1) Restructure pub use melib::* imports
-- [f8623d4b](https://git.meli-email.org/meli/meli/commit/f8623d4b2c386f51f1d11a23900503d8165ac9f3) Implement more ResponseCode cases
-- [b92a80a2](https://git.meli-email.org/meli/meli/commit/b92a80a23afb96fbd63031704e4656cc8a00526c) Resync even if UIDVALIDITY is missing from cache
-- [bf615e7d](https://git.meli-email.org/meli/meli/commit/bf615e7d933b474942d421eafc1015aeb28f8516) Check for case when envelope has its own message id in References and In-Reply-To
-- [e0257c9d](https://git.meli-email.org/meli/meli/commit/e0257c9d8d6f234f71852a0080d443b063d5e6d7) Run cargo-sort
-- [d7e6b40b](https://git.meli-email.org/meli/meli/commit/d7e6b40b7e1f501fdaaba54880e9c7a4b0e01288) Auto re-index sqlite3 database if it's missing
-- [cd85d833](https://git.meli-email.org/meli/meli/commit/cd85d83324a009ea4b86ac22af395145a9e999ab) Replace timestamp with Date value in message/rfc822 Display
-- [579372b4](https://git.meli-email.org/meli/meli/commit/579372b4a75e39c9e84010de16d7d46294bed04a) Improve readability of `Envelope`.
-- [6c6d9f4b](https://git.meli-email.org/meli/meli/commit/6c6d9f4b4e0d16b5a73ae8e2a2fb2a6f124df7e6) Improve ordering of `flag_impl!`s.
-- [8f14a237](https://git.meli-email.org/meli/meli/commit/8f14a2373e16b9b4af22f9388fae84235dd08123) Put imap-codec logic under the imap_backend feature
-- [fd0faade](https://git.meli-email.org/meli/meli/commit/fd0faade066a18466e683361211bba569956bf63) Add connection instance id string for debugging in logs
-- [5c9b3fb0](https://git.meli-email.org/meli/meli/commit/5c9b3fb0448fa3689ff33faba3dde03c49347f61) Impl Component for Box<dyn Component>
-- [45bac6eb](https://git.meli-email.org/meli/meli/commit/45bac6eb16a5a093193d5beb4d80040ce161304a) Tidy up use of debug!
-- [5699baec](https://git.meli-email.org/meli/meli/commit/5699baecfba9cb15aac04a6b400cfb6bc881e2c5) Add utils::{futures, random}
-- [b05d9299](https://git.meli-email.org/meli/meli/commit/b05d92997546e438b202d336fc581c2514c63b9f) Impl exponential backoff when retrying connection
-- [f5cfbd32](https://git.meli-email.org/meli/meli/commit/f5cfbd32e6ebbe83ad7e84d048f1fbf2e51ca605) On set_flags, update {un,}seen sets in all mailboxes
-- [f0d88005](https://git.meli-email.org/meli/meli/commit/f0d88005fbabcd552593ba0fe785e89a3560ac1c) Change message/rfc822 Display repr
-- [f98e36ce](https://git.meli-email.org/meli/meli/commit/f98e36cee514f643e0fe256857cf31e2e0f24080) Replace old-style /*! module doc comments with //!
-- [1bcc0bbe](https://git.meli-email.org/meli/meli/commit/1bcc0bbece2f479950e8811261befedc0199dab9) Add mbox parsing test
-- [619fbef1](https://git.meli-email.org/meli/meli/commit/619fbef129e249489e64a26e1d0dfbd02db2516a) Recursively calculate update_show_subject()
-- [957abf4e](https://git.meli-email.org/meli/meli/commit/957abf4e7238ec74b2194a21533b69dd1a58c0a8) Update cargo dependencies
-- [9d51b6bd](https://git.meli-email.org/meli/meli/commit/9d51b6bd525784bc108959519c8dd21d30a8b020) Update `imap-codec`.
-- [7c33f899](https://git.meli-email.org/meli/meli/commit/7c33f8999b6a5efd911680f2b83a3ff3a682a715) Use published imap-codec 0.10.0.
-- [3803d788](https://git.meli-email.org/meli/meli/commit/3803d788abc5157b9cc6368da7e54aced9604aec) If auth is false checks if config has password entry
-- [866166eb](https://git.meli-email.org/meli/meli/commit/866166eb8e8b994c8c87aad92a3303f9f6449b2d) Don't print parsing error for empty bytes
-- [5b5869a2](https://git.meli-email.org/meli/meli/commit/5b5869a2ec3fce2fc69aa5c83fbda7a767f2a402) Re-enable print to stderr ifdef MELI_DEBUG_STDERR
-- [13fe64a0](https://git.meli-email.org/meli/meli/commit/13fe64a027895780efdb6bfee246d562741a4be1) Cache pgp signature verification results
-- [5ceddf41](https://git.meli-email.org/meli/meli/commit/5ceddf412e3b215b712e55aea8e18887d2d39f1a) Update CHANGELOG.md
-- [4e55fbc9](https://git.meli-email.org/meli/meli/commit/4e55fbc90d8b105788c7c5998cb26b2829ac87a2) Add SEEN flag to all envs, since NNTP has no flags
-- [e9cd800f](https://git.meli-email.org/meli/meli/commit/e9cd800f49e2d0e155d434ff8e91462e20b9d4f5) Add support for storing read status locally
-- [53cba4be](https://git.meli-email.org/meli/meli/commit/53cba4beee4f774b548881c1a3f207ca391d3df3) Update README.md relative file paths
-- [c4c245ee](https://git.meli-email.org/meli/meli/commit/c4c245ee19137f64d836401f7c1de17c9eb42b6e) Respect danger_accept_invalid_certs setting
-- [29b43e2c](https://git.meli-email.org/meli/meli/commit/29b43e2c88edcfdecffd076fbb773c8547425f12) Replace mktime with timegm
-- [4874e30f](https://git.meli-email.org/meli/meli/commit/4874e30f3ce9b186ac7cd427cba4a8542bd5048e) Add smtp-trace feature
-- [51e9fbe8](https://git.meli-email.org/meli/meli/commit/51e9fbe8f2c380f3c9ee6a9ee65e638c169b43ef) Add account_name identifier to sqlite3 index database name
-- [129f1091](https://git.meli-email.org/meli/meli/commit/129f10911b01641940801586bfa5286307e4342f) Rename `imap_backend` feature to `imap`
-- [fe027fa3](https://git.meli-email.org/meli/meli/commit/fe027fa300a9882730a558fffe6000527ef08ff8) Rename `maildir_backend` feature to `maildir`
-- [fe7dcc50](https://git.meli-email.org/meli/meli/commit/fe7dcc508ee51f492df2de3884147531fada6f4e) Rename `notmuch_backend` feature to `notmuch`
-- [e9f09a15](https://git.meli-email.org/meli/meli/commit/e9f09a153ca0a1a023efe924b314ea977ccc3c25) Rename `mbox_backend` feature to `mbox`
-- [7db930ca](https://git.meli-email.org/meli/meli/commit/7db930cabd295e888f4f106d5e7ea411521340ff) Rename `jmap_backend` feature to `jmap`
-- [89c90f22](https://git.meli-email.org/meli/meli/commit/89c90f224a68ec524f7dc7033955ce7b8196f493) Add `nntp` feature
-- [b65934fa](https://git.meli-email.org/meli/meli/commit/b65934facc7aeeb8ab30603e16cef2b747f9a0e5) Add nntp-trace feature
-- [8ecdb6df](https://git.meli-email.org/meli/meli/commit/8ecdb6df3189cae4b6fa21a177bde756cc4407cf) Add imap-trace feature
-- [9216e7bc](https://git.meli-email.org/meli/meli/commit/9216e7bc657738ae9861583a837c1326398197e4) Add opt id string for tracing
-- [ae25ffba](https://git.meli-email.org/meli/meli/commit/ae25ffba430572efe73fde05eaf8111453f814cf) Don't do plain EHLO before starting Tls connection
-- [8cb2a515](https://git.meli-email.org/meli/meli/commit/8cb2a515e1ba31efe914db67504993bc081ed7f3) Use localhost in lieu of 127.0.0.1 for CI
-- [0ee1b6e0](https://git.meli-email.org/meli/meli/commit/0ee1b6e01830c01871e93e27d735a39792202325) Start background watch job in init
-- [448e0635](https://git.meli-email.org/meli/meli/commit/448e0635e00b533a4d9dc15ba65982097649b397) Log error when command length exceeds 512 octets
-- [bf543855](https://git.meli-email.org/meli/meli/commit/bf543855dc143b25344b79303f017380c9773793) Add PartialEq<str> for MessageID
-- [7c7f6e19](https://git.meli-email.org/meli/meli/commit/7c7f6e1923e8b3127cf7cbd4b18f1db3ed9c6583) Don't increase Thread length for duplicates
-- [5c2b0471](https://git.meli-email.org/meli/meli/commit/5c2b04719b953373c6a657f22db295d08b94685e) Normalize std::fmt::* imports
-- [0f60009e](https://git.meli-email.org/meli/meli/commit/0f60009ea909adfb8f4e85d942decb8bc60f7539) Add RUSTFLAGS with -D warnings
-- [6578a566](https://git.meli-email.org/meli/meli/commit/6578a5666889434ed6ca2f276e365633956fe3d3) Update cargo install directions
-- [4f6081b6](https://git.meli-email.org/meli/meli/commit/4f6081b6633aed1eeafd99c24aa2dc64397043ca) Update to `imap-codec 1.0.0-beta`.
-- [dc2b0044](https://git.meli-email.org/meli/meli/commit/dc2b00442b04c21455a6fda59b4729d0cbd04eff) Run rustfmt and cargo-sort
-- [b3858de2](https://git.meli-email.org/meli/meli/commit/b3858de2f4e12723ee922174c79cc36062bed54e) Impl From<io::ErrorKind> for ErrorKind
-- [f93adb68](https://git.meli-email.org/meli/meli/commit/f93adb683a562f25e40ffa03f80d04d5ad8ca34f) Replace change_color uses with change_theme
-- [f193bdf6](https://git.meli-email.org/meli/meli/commit/f193bdf685e06652ab5b2da2a9a01fa56620cda6) Add column headers and sorting
-- [095d24f9](https://git.meli-email.org/meli/meli/commit/095d24f91447a2ecab6d6bc78e1705ea4394e9bd) Add PULL_REQUEST_TEMPLATE.md
-- [ab57e942](https://git.meli-email.org/meli/meli/commit/ab57e9420db29efd42773e970f33751b7b3f6f26) Add delete_contact shortcut
-- [3963103d](https://git.meli-email.org/meli/meli/commit/3963103d55db28f789fe39f0dd80cd0d57792b5d) Prevent duplicate contact creation
-- [f162239f](https://git.meli-email.org/meli/meli/commit/f162239fcc87d9c4f8aba8c33a9812a5e691c8d9) Change `on:` conditions for test.yaml
-- [974b3a53](https://git.meli-email.org/meli/meli/commit/974b3a53058181e3df992a2105abcbf1c392fc19) Update bitflags, rusqlite dependencies
-- [4d22b669](https://git.meli-email.org/meli/meli/commit/4d22b669bf330f8f3168fc2f704ad63c21c5e821) Update dependencies
-- [ffba203a](https://git.meli-email.org/meli/meli/commit/ffba203a3b7070cc9e71d9444556e108ff0e18ea) Add support for Home and End key navigation
-- [3433f7c4](https://git.meli-email.org/meli/meli/commit/3433f7c41e0d0cbb48af821280537da41b9e53d0) Update PULL_REQUEST_TEMPLATE.md
-- [f7a4741b](https://git.meli-email.org/meli/meli/commit/f7a4741bf1622ae60042fb6ab0a906fe50fb1e06) Add jmap-trace feature
-- [c875dda4](https://git.meli-email.org/meli/meli/commit/c875dda4960e5688b17176ba82ad1e5da38b883b) Add last_method_response field to Connection
-- [37a787e6](https://git.meli-email.org/meli/meli/commit/37a787e6bb5abd34fae2888944537dec1ee3842f) Use IndexMap instead of HashMap
-- [6ebdc7f9](https://git.meli-email.org/meli/meli/commit/6ebdc7f9aec5531c2b562a4e0cfd320ead6a4c01) Add Id<_>::empty() contructor
-- [4f9b9773](https://git.meli-email.org/meli/meli/commit/4f9b97736a4af8b8b4ba0017ad1175a1c2352db6) Rename EmailImport to EmailImportObject
-- [11432ba2](https://git.meli-email.org/meli/meli/commit/11432ba2c381b07bb540f7f92664b3c351e3cf62) Make `null` fields into Option<_>s
-- [d9467d5f](https://git.meli-email.org/meli/meli/commit/d9467d5fcd9543611ec8a034eb7e25d12a3dcc45) Save all core capabilities to session store
-- [31982931](https://git.meli-email.org/meli/meli/commit/31982931f5f472717b4c3d900f16c0588682f48e) Use Argument<OBJ> (value or resultreference) where appropriate
-- [29fd8522](https://git.meli-email.org/meli/meli/commit/29fd8522e6bc2b0b6196cb97c8868dc34c2ba2f0) Implement Backend::create_mailbox()
-- [5d8f07c8](https://git.meli-email.org/meli/meli/commit/5d8f07c8058261c7c251b3fb010ad866110e91df) Rename some objects better
-- [38bc1369](https://git.meli-email.org/meli/meli/commit/38bc1369cc136c482f48d1ed3172b7f510ff7762) Add an Identity type.
-- [59513b26](https://git.meli-email.org/meli/meli/commit/59513b267097cac8fe757c6198f26e0179014604) Implement Backend::submit(), server-side submission
-- [5459a84f](https://git.meli-email.org/meli/meli/commit/5459a84f3d2b4c91a89252fba63f4ef12d965b9b) Update to imap-codec 1.0.0 (w/o `-beta`)
-- [290cfb86](https://git.meli-email.org/meli/meli/commit/290cfb86c0c942690c48a0d3298e9d2de3ec4d94) Add a highlighted_selected theme key
-- [46636d87](https://git.meli-email.org/meli/meli/commit/46636d8748f2779f38a10c6bf38c4e07acf16f8a) Bump version to 0.8.0
-
-### Continuous Integration
-
-- [1d0405ed](https://git.meli-email.org/meli/meli/commit/1d0405ed5b5cd76f4fe79e73fb30f4d4dce1d441) Add env vars
-- [6e27edcb](https://git.meli-email.org/meli/meli/commit/6e27edcb775ce831b784d2040672f2d2af2c020f) Use cargo-nextest
-- [67d2da0f](https://git.meli-email.org/meli/meli/commit/67d2da0f88b0e7b9b74c5d05c6c17a45057b094a) Disable smtp::test::test_smtp in test.yaml
-
-## [alpha-0.7.2] - 2021-10-15
-
-### Added
-
-- Add forward mail option
-- Add url_launcher config setting
-- Add add_addresses_to_contacts command
-- Add show_date_in_my_timezone pager config flag
-- docs: add pager filter documentation
-- mail/view: respect per-folder/account pager filter override
-- pager: add filter command, esc to clear filter
-- Show compile time features in with command argument
-
-### Fixed
-
-- melib/email/address: quote display_name if it contains ","
-- melib/smtp: fix Cc and Bcc ignored when sending mail
-- melib/email/address: quote display_name if it contains "."
-
-## [alpha-0.7.1] - 2021-09-08
-
-### Added
-
-- Change all Down/Up shortcuts to j/k
-- add 'GB18030' charset
-- melib/nntp: implement refresh
-- melib/nntp: update total/new counters on new articles
-- melib/nntp: implement NNTP posting
-- configs: throw error on extra unused conf flags in some imap/nntp
-- configs: throw error on missing `composing` section with explanation
-
-### Fixed
-
-- Fix compilation for netbsd-9.2
-- conf: fixed some boolean flag values requiring to be string e.g. "true"
-
-## [alpha-0.7.0] - 2021-09-03
-
-### Added
-
-Notable changes:
-
-- add import command to import email from files into accounts
-- add add-attachment-file-picker command and `file_picker_command` setting to
-  use external commands to choose files when composing new mail
-- ask confirm for delete
-- add export-mbox command
-- add export-mail command
-- add TLS support with nntp
-- add JMAP watch with polling
-- add reload-config command
-- add import-mail command
-- imap: implement gmail XOAUTH2 authentication method
-- imap: implement OAUTH2 authentication
-- compose: treat inline message/rfc822 as attachments
-- add gpg support via libgpgme
-
-### Fixed
-
-- Loading notmuch library on macos
-- Limit dbus dependency to target_os = "linux"
-- IMAP, notmuch, mbox backends: various performance fixes
-
-## [alpha-0.6.2] - 2020-09-24
-
-### Added
-- Add customizable mailbox tree in sidebar
-- Make `dbus` dependency opt-out (feature is `dbus-notifications`)
-- Implemented JMAP async, search, tagging, syncing
-- Preserve account order from configuration file
-- Implemented IMAP `CONDSTORE` support for IMAP cache
-- Add `timeout` setting for IMAP
-- Implement TCP keepalive for IMAP
-- Rewrote email address parsers.
-- Implement `copy_messages` for maildir
-- Implement selection with motions
-
-### Fixed
-- Fixed various problems with IMAP cache
-- Fixed various problems with IMAP message counts
-- Fixed various problems with IMAP connection hanging
-- Fixed IMAP not reconnecting on dropped IDLE connections
-- Fixed various problems with notmuch backend
-
-## [alpha-0.6.1] - 2020-08-02
-
-### Added
-
-- added experimental NNTP backend
-- added server extension support and use in account status tab
-
-### Fixed
-
-- imap: fixed IDLE connection getting stuck when using DEFLATE
-
-## [alpha-0.6.0] - 2020-07-29
-
-### Added
-
-- Add `select` command to select threads that match search query
-- Add support for mass copying/deleting/flagging/moving of messages
-- IMAP: add support for COMPRESS=DEFLATE and others
-  Extension use can be configured with individual flags such as `use_deflate`
-- Rename EXECUTE mode to COMMAND
-- add async IMAP backend
-- add in-app SMTP support
-- ui: Show decoded source by default when viewing an Envelope's source
-- ui: Add search in pagers
-- Add managesieve REPL binary for managesieve script management
-- imap: `add server_password_command`
-- configuration: Add per-folder and per-account configuration overrides.
-  e.g. `accounts."imap.domain.tld".mailboxes."INBOX".index_style = "plain"`
-
-  The selection is done for a specific field as follows:
-
-  ```text
-  if per-folder override is defined, return per-folder override
-    else if per-account override is defined, return per-account override
-      else return global setting field value.
-  ```
-- themes: Add Italics, Blink, Dim and Hidden text attributes
-- ui: recognize readline shortcuts in Execute mode
-- ui: hopefully smarter auto-completion in Execute mode
-- demo NNTP python plugin
-- ui: add `auto_choose_multipart_alternative`: Choose `text/html` alternative if `text/plain` is empty in `multipart/alternative` attachments.
-- ui: custom date format strings
-- ui: manual refresh for mailbox view
-- ui: create mailbox command
-- fs autocomplete
-- ui: add support for [`NO_COLOR`](https://no-color.org/)
-- enhanced, portable Makefile
-- added Debian packaging
-- added `default_header_values`: default header values used when creating a new draft
-- ui: switch between sidebar and mailbox view with {left,right} keys for more intuitive navigation
-- ui: add optional filter query for each mailbox view to view only the matching subset of messages (for example, you can hide all seen envelopes with `filter = "not flags:seen"`
-
-### Changed
-
-- Replace any use of 'folder' with 'mailbox' in user configuration
-- Load libnotmuch dynamically
-- Launch all user shell commands with `sh -c "..."`
-
-### Fixed
-
-- notmuch: add support for multiple accounts on same notmuch db
-
-## [alpha-0.5.1] - 2020-02-09
-
-### Added
-
-- Added in-terminal floating notifications with history
-- Added mailbox creation/deletion commands in IMAP accounts
-- Added cli-docs compile time feature: Optionally build manpages to text with mandoc and print them from the command line.
-- Added new theme keys
-
-[unreleased]: #
-[alpha-0.5.1]: https://github.com/meli/meli/releases/tag/alpha-0.5.1
-[alpha-0.6.0]: https://github.com/meli/meli/releases/tag/alpha-0.6.0
-[alpha-0.6.1]: https://github.com/meli/meli/releases/tag/alpha-0.6.1
-[alpha-0.6.2]: https://github.com/meli/meli/releases/tag/alpha-0.6.2
-[alpha-0.7.0]: https://github.com/meli/meli/releases/tag/alpha-0.7.0
-[alpha-0.7.1]: https://github.com/meli/meli/releases/tag/alpha-0.7.1
-[alpha-0.7.2]: https://github.com/meli/meli/releases/tag/alpha-0.7.2
-[v0.8.0]: https://git.meli-email.org/meli/meli/releases/tag/v0.8.0
-[v0.8.1]: https://git.meli-email.org/meli/meli/releases/tag/v0.8.1
-[v0.8.2]: https://git.meli-email.org/meli/meli/releases/tag/v0.8.2
-[v0.8.3]: https://git.meli-email.org/meli/meli/releases/tag/v0.8.3
-[v0.8.4]: https://git.meli-email.org/meli/meli/releases/tag/v0.8.4

Cargo.toml

@@ -1,14 +1,32 @@
-[workspace]
-resolver = "2"
+[package]
+name = "meli"
+version = "0.3.2"
+authors = ["Manos Pitsidianakis <el13635@mail.ntua.gr>"]
+edition = "2018"
 
-members = [
-    "meli",
-    "melib",
-]
+[[bin]]
+name = "meli"
+path = "src/bin.rs"
+
+[dependencies]
+xdg = "2.1.0"
+crossbeam = "0.7.2"
+signal-hook = "0.1.10"
+nix = "*"
+melib = { path = "melib", version = "*" }
+ui = { path = "ui", version = "*" }
 
 [profile.release]
-lto = "fat"
-codegen-units = 1
-opt-level = "s"
+lto = true
 debug = false
-strip = true
+
+[workspace]
+members = ["melib", "ui", "debug_printer", "testing", "text_processing"]
+
+[features]
+default = []
+notmuch = ["melib/notmuch_backend", "ui/notmuch"]
+
+# Print tracing logs as meli runs in stderr
+# enable for debug tracing logs: build with --features=debug-tracing
+debug-tracing = ["melib/debug-tracing", "ui/debug-tracing"]

Cross.toml

@@ -1,21 +0,0 @@
-[target.aarch64-unknown-linux-gnu]
-# Build with -static features.
-pre-build = [
-  "export DEBIAN_FRONTEND=noninteractive ",
-  "dpkg --add-architecture $CROSS_DEB_ARCH",
-  "apt-get update -y",
-  """
-  apt-get install --assume-yes \
-  pkg-config \
-  libdbus-1-dev \
-  libdbus-1-dev:$CROSS_DEB_ARCH \
-  librust-libdbus-sys-dev \
-  librust-libdbus-sys-dev:$CROSS_DEB_ARCH \
-  librust-openssl-sys-dev \
-  librust-openssl-sys-dev:$CROSS_DEB_ARCH \
-  libsqlite3-dev:$CROSS_DEB_ARCH \
-  libssl-dev \
-  libssl-dev:$CROSS_DEB_ARCH \
-  sqlite3:$CROSS_DEB_ARCH
-  """,
-]

DEVELOPMENT.md

@@ -1,67 +0,0 @@
-# Development
-
-Code style follows the `rustfmt.toml` file.
-
-## Trace logs
-
-Enable trace logs to `stderr` with:
-
-```sh
-export MELI_DEBUG_STDERR=yes
-```
-
-This means you will have to to redirect `stderr` to a file like `meli 2> trace.log`.
-
-Tracing is opt-in by build features:
-
-```sh
-cargo build --features=debug-tracing,imap-trace,smtp-trace
-```
-
-## use `.git-blame-ignore-revs` file _optional_
-
-Use this file to ignore formatting commits from `git-blame`.
-It needs to be set up per project because `git-blame` will fail if it's missing.
-
-```sh
-git config blame.ignoreRevsFile .git-blame-ignore-revs
-```
-
-## Formatting with `rustfmt`
-
-```sh
-make fmt
-```
-
-## Linting with `clippy`
-
-```sh
-make lint
-```
-
-## Testing
-
-```sh
-make test
-```
-
-How to run specific tests:
-
-```sh
-cargo test -p {melib, meli} (-- --nocapture) (--test test_name)
-```
-
-## Profiling
-
-```sh
-perf record -g target/debug/meli
-perf script | stackcollapse-perf | rust-unmangle | flamegraph > perf.svg
-```
-<!--  -->
-<!-- ## Running fuzz targets -->
-<!--  -->
-<!-- Note: `cargo-fuzz` requires the nightly toolchain. -->
-<!--  -->
-<!-- ```sh -->
-<!-- cargo +nightly fuzz run envelope_parse -- -dict=fuzz/envelope_tokens.dict -->
-<!-- ``` -->

Makefile

@@ -1,248 +1,30 @@
-# meli - Makefile
-#
-# Copyright 2017-2020 Manos Pitsidianakis
-#
-# This file is part of meli.
-#
-# meli is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-#
-# meli is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with meli. If not, see <http://www.gnu.org/licenses/>.
 .POSIX:
 .SUFFIXES:
-CARGO_TARGET_DIR ?= target
-CARGO_BIN ?= cargo
-TAGREF_BIN ?= tagref
-CARGO_ARGS ?=
-RUSTFLAGS ?= -D warnings -W unreachable-pub -W rust-2021-compatibility
-CARGO_SORT_BIN = cargo-sort
-CARGO_HACK_BIN = cargo-hack
-PRINTF = /usr/bin/printf
+meli:
+	cargo build $(FEATURES)--release
 
-# Options
-PREFIX ?= /usr/local
-EXPANDED_PREFIX := `cd ${PREFIX} && pwd -P`
-BINDIR ?= ${EXPANDED_PREFIX}/bin
-MANDIR ?= ${EXPANDED_PREFIX}/share/man
-
-# Installation parameters
-DOCS_SUBDIR ?= meli/docs/
-MANPAGES ?= meli.1 meli.conf.5 meli-themes.5 meli.7
-FEATURES ?= --features "${MELI_FEATURES}"
-
-MANPATHS != ACCUM="";for m in `manpath 2> /dev/null | tr ':' ' '`; do if [ -d "$${m}" ]; then REAL_PATH=`cd $${m} && pwd` ACCUM="$${ACCUM}:$${REAL_PATH}";fi;done;echo $${ACCUM}'\c' | sed 's/^://'
-VERSION = `grep -m1 version meli/Cargo.toml | head -n1 | cut -d'"' -f 2 | head -n1`
-MIN_RUSTC = `grep -m1 rust-version meli/Cargo.toml | head -n1 | cut -d'"' -f 2 | head -n1`
-GIT_COMMIT = `git show-ref -s --abbrev HEAD`
-DATE = `date -I`
-
-# Output parameters
-BOLD ?= `[ -z $${TERM} ] && echo "" || tput bold`
-UNDERLINE ?= `[ -z $${TERM} ] && echo "" || tput smul`
-ANSI_RESET ?= `[ -z $${TERM} ] && echo "" || tput sgr0`
-CARGO_COLOR ?= `[ -z $${NO_COLOR+x} ] && echo "" || echo "--color=never "`
-RED ?= `[ -z $${NO_COLOR+x} ] && ([ -z $${TERM} ] && echo "" || tput setaf 1) || echo ""`
-GREEN ?= `[ -z $${NO_COLOR+x} ] && ([ -z $${TERM} ] && echo "" || tput setaf 2) || echo ""`
-YELLOW ?= `[ -z $${NO_COLOR+x} ] && ([ -z $${TERM} ] && echo "" || tput setaf 3) || echo ""`
-
-.PHONY: meli
-meli: check-deps
-	@${CARGO_BIN} build ${CARGO_ARGS} ${CARGO_COLOR}--target-dir="${CARGO_TARGET_DIR}" ${FEATURES} --release --bin meli
-
-.PHONY: help
-help:
-	@echo "For a quick start, build and install locally:\n\n${BOLD}${GREEN}make PREFIX=~/.local install${ANSI_RESET}\n"
-	@echo "Available subcommands:"
-	@echo " - ${BOLD}meli${ANSI_RESET} (builds meli with optimizations in \$$CARGO_TARGET_DIR)"
-	@echo " - ${BOLD}install${ANSI_RESET} (installs binary in \$$BINDIR and documentation to \$$MANDIR)"
-	@echo " - ${BOLD}uninstall${ANSI_RESET}"
-	@echo "\nSecondary subcommands:"
-	@echo " - ${BOLD}clean${ANSI_RESET} (cleans build artifacts)"
-	@echo " - ${BOLD}check-deps${ANSI_RESET} (checks dependencies)"
-	@echo " - ${BOLD}install-bin${ANSI_RESET} (installs binary to \$$BINDIR)"
-	@echo " - ${BOLD}install-doc${ANSI_RESET} (installs manpages to \$$MANDIR)"
-	@echo " - ${BOLD}help${ANSI_RESET} (prints this information)"
-
-	@echo " - ${BOLD}dist${ANSI_RESET} (creates release tarball named meli-"${VERSION}".tar.gz in this directory)"
-	@echo " - ${BOLD}deb-dist${ANSI_RESET} (builds debian package in the parent directory)"
-	@echo " - ${BOLD}distclean${ANSI_RESET} (cleans distribution build artifacts)"
-	@echo " - ${BOLD}build-rustdoc${ANSI_RESET} (builds rustdoc documentation for all packages in \$$CARGO_TARGET_DIR)"
-	@echo "\nENVIRONMENT variables of interest:"
-	@echo "* PREFIX = ${UNDERLINE}${EXPANDED_PREFIX}${ANSI_RESET}"
-	@echo "* MELI_FEATURES = ${UNDERLINE}\n"
-	@[ -z $${MELI_FEATURES+x} ] && echo "unset\c" || echo ${MELI_FEATURES}'\c'
-	@echo ${ANSI_RESET}
-	@echo "* BINDIR = ${UNDERLINE}${BINDIR}${ANSI_RESET}"
-	@echo "* MANDIR = ${UNDERLINE}${MANDIR}${ANSI_RESET}"
-	@echo "* MANPATH = ${UNDERLINE}\c"
-	@[ $${MANPATH+x} ] && echo $${MANPATH}'\c' || echo "unset\c"
-	@echo ${ANSI_RESET}
-	@echo "* (cleaned) output of manpath(1) = ${UNDERLINE}${MANPATHS}${ANSI_RESET}"
-	@echo "* NO_MAN ${UNDERLINE}\c"
-	@[ $${NO_MAN+x} ] && echo "set\c" || echo "unset\c"
-	@echo ${ANSI_RESET}
-	@echo "* NO_COLOR ${UNDERLINE}\c"
-	@[ $${NO_COLOR+x} ] && echo "set\c" || echo "unset\c"
-	@echo ${ANSI_RESET}
-	@echo "* CARGO_BIN = ${UNDERLINE}${CARGO_BIN}${ANSI_RESET}"
-	@echo "* CARGO_ARGS = ${UNDERLINE}${CARGO_ARGS}${ANSI_RESET}"
-	@echo "* MIN_RUSTC = ${UNDERLINE}${MIN_RUSTC}${ANSI_RESET}"
-	@echo "* VERSION = ${UNDERLINE}${VERSION}${ANSI_RESET}"
-	@echo "* GIT_COMMIT = ${UNDERLINE}${GIT_COMMIT}${ANSI_RESET}"
-	@#@echo "* CARGO_COLOR = ${CARGO_COLOR}"
-
-.PHONY: check
-check: check-tagrefs
-	@RUSTFLAGS='${RUSTFLAGS}' ${CARGO_BIN} check ${CARGO_ARGS} ${CARGO_COLOR}--target-dir="${CARGO_TARGET_DIR}" ${FEATURES} --all --tests --examples --benches --bins
-
-.PHONY: fmt
-fmt:
-	@$(CARGO_BIN) +nightly fmt --all || $(CARGO_BIN) fmt --all
-	@OUT=$$($(CARGO_SORT_BIN) -w 2>&1) || $(PRINTF) "WARN: %s cargo-sort failed or binary not found in PATH.\n" "$$OUT"
-
-.PHONY: lint
-lint:
-	@RUSTFLAGS='${RUSTFLAGS}' $(CARGO_BIN) clippy --no-deps --all-features --all --tests --examples --benches --bins
-
-.PHONY: test
-test: test-docs
-	@RUSTFLAGS='${RUSTFLAGS}' ${CARGO_BIN} test ${CARGO_ARGS} ${CARGO_COLOR}--target-dir="${CARGO_TARGET_DIR}" --all --tests --examples --benches --bins
-
-.PHONY: test-docs
-test-docs:
-	@RUSTFLAGS='${RUSTFLAGS}' ${CARGO_BIN} test ${CARGO_ARGS} ${CARGO_COLOR}--target-dir="${CARGO_TARGET_DIR}" --all --doc
-
-.PHONY: test-feature-permutations
-test-feature-permutations:
-	$(CARGO_HACK_BIN) hack --feature-powerset
-
-.PHONY: check-deps
-check-deps:
-	@(if ! echo ${MIN_RUSTC}\\n`${CARGO_BIN} --version | grep ^cargo | cut -d ' ' -f 2` | sort -CV; then echo "rust version >= ${RED}${MIN_RUSTC}${ANSI_RESET} required, found: `which ${CARGO_BIN}` `${CARGO_BIN} --version | cut -d ' ' -f 2`" \
-		"\nYour options:\n - Set CARGO_BIN to a supported version\n - Install a supported version from your distribution's package manager\n - Install a supported version from ${UNDERLINE}https://rustup.rs/${ANSI_RESET}" ; exit 1; fi)
+PREFIX=/usr/local
 
+ifdef MELI_FEATURES
+  FEATURES ?= --features="$(MELI_FEATURES)" 
+else
+  FEATURES ?=
+endif
 
 .PHONY: clean
-clean:
-	-rm -rf ./${CARGO_TARGET_DIR}/
+clean: rm -ri ./target/
 
-.PHONY: distclean
-distclean:
-	@rm -f meli-${VERSION}.tar.gz
-	@rm -rf .pc # rm debian stuff
 
 .PHONY: uninstall
-uninstall:
-	rm -f $(DESTDIR)${BINDIR}/meli
-	for MANPAGE in ${MANPAGES}; do \
-			SECTION=`echo $${MANPAGE} | rev | cut -d "." -f 1`; \
-			MANPAGEPATH="${DESTDIR}${MANDIR}/man$${SECTION}/$${MANPAGE}.gz"; \
-			rm -f "$${MANAGEPATH}"
-	; done
-
-.PHONY: install-doc
-install-doc:
-	@(if [ -z $${NO_MAN+x} ]; then \
-		echo " - ${BOLD}Installing manpages to ${ANSI_RESET}${DESTDIR}${MANDIR}:" ; \
-		for MANPAGE in ${MANPAGES}; do \
-			SECTION=`echo $${MANPAGE} | rev | cut -d "." -f 1`; \
-			mkdir -p $(DESTDIR)${MANDIR}/man$${SECTION} ; \
-			MANPAGEPATH=${DESTDIR}${MANDIR}/man$${SECTION}/$${MANPAGE}.gz; \
-			echo "  * installing $${MANPAGE} → ${GREEN}$${MANPAGEPATH}${ANSI_RESET}"; \
-			gzip -n < ${DOCS_SUBDIR}$${MANPAGE} > $${MANPAGEPATH} \
-		; done ; \
-	(case ":${MANPATHS}:" in \
-	*:${DESTDIR}${MANDIR}:*) echo "\c";; \
-	*) echo "\n${RED}${BOLD}WARNING${ANSI_RESET}: ${UNDERLINE}Path ${DESTDIR}${MANDIR} is not contained in your MANPATH variable or the output of \`manpath\` command.${ANSI_RESET} \`man\` might fail finding the installed manpages. Consider adding it if necessary.\nMANPATH variable / output of \`manpath\`: ${MANPATHS}" ;; \
-	esac) ; \
-	else echo "NO_MAN is defined, so no documentation is going to be installed." ; fi)
-
-.PHONY: install-bin
-install-bin: meli
-	@mkdir -p $(DESTDIR)${BINDIR}
-	@echo " - ${BOLD}Installing binary to ${ANSI_RESET}${GREEN}${DESTDIR}${BINDIR}/meli${ANSI_RESET}"
-	@case ":${PATH}:" in \
-	*:${DESTDIR}${BINDIR}:*) echo "\n";; \
-	*) echo "\n${RED}${BOLD}WARNING${ANSI_RESET}: ${UNDERLINE}Path ${DESTDIR}${BINDIR} is not contained in your PATH variable.${ANSI_RESET} Consider adding it if necessary.\nPATH variable: ${PATH}";; \
-	esac
-	@mkdir -p $(DESTDIR)${BINDIR}
-	@rm -f  $(DESTDIR)${BINDIR}/meli
-	@cp ./${CARGO_TARGET_DIR}/release/meli $(DESTDIR)${BINDIR}/meli
-	@chmod 755 $(DESTDIR)${BINDIR}/meli
-
+uninstall: rm -f $(DESTDIR)$(PREFIX)/bin/meli
+	rm $(DESTDIR)$(PREFIX)/share/man/man1/meli.1.gz
+	rm $(DESTDIR)$(PREFIX)/share/man/man5/meli.conf.5.gz
 
 .PHONY: install
-.NOTPARALLEL: yes
-install: meli install-bin install-doc
-	@(if [ -z $${NO_MAN+x} ]; then \
-	$(PRINTF) "\n You're ready to go. You might want to read the \"STARTING WITH meli\" section in the manpage (\`man meli\`)" ;\
-	$(PRINTF) "\n or the tutorial in meli(7) (\`man 7 meli\`).\n" ;\
-	fi)
-	@$(PRINTF) " - Report bugs in the mailing list or git issue tracker ${UNDERLINE}https://git.meli-email.org${ANSI_RESET}\n"
-	@$(PRINTF) " - If you have a specific feature or workflow you want to use, you can post in the mailing list or git issue tracker.\n"
-
-.PHONY: dist
-dist:
-	@git archive --format=tar.gz --prefix=meli-${VERSION}/ HEAD >meli-${VERSION}.tar.gz
-	@echo meli-${VERSION}.tar.gz
-
-.PHONY: deb-dist
-deb-dist:
-	@author=$(grep -m1 authors meli/Cargo.toml | head -n1 | cut -d'"' -f 2 | head -n1)
-	@dpkg-buildpackage -b -rfakeroot -us -uc --build-by="${author}" --release-by="${author}"
-	@echo ${BOLD}${GREEN}Generated${ANSI_RESET}  ../meli_${VERSION}-1_`dpkg --print-architecture`.deb
-
-.PHONY: build-rustdoc
-build-rustdoc:
-	@RUSTDOCFLAGS="--crate-version ${VERSION}_${GIT_COMMIT}_${DATE}" ${CARGO_BIN} doc ${CARGO_ARGS} ${CARGO_COLOR}--target-dir="${CARGO_TARGET_DIR}" --all-features --no-deps --workspace --document-private-items --open
-
-.PHONY: check-tagrefs
-check-tagrefs:
-	@(if ! command -v "$(TAGREF_BIN)" > /dev/null;\
-		then \
-				$(PRINTF) "Warning: tagref binary not in PATH.\n" 1>&2;\
-				exit;\
-		else \
-				$(TAGREF_BIN);\
-		fi)
-
-.PHONY: test-makefile
-test-makefile:
-	@$(PRINTF) "Checking that current version is detected. "
-	@([ ! -z "${VERSION}" ] && $(PRINTF) "${GREEN}OK${ANSI_RESET}\n") || $(PRINTF) "${RED}ERROR${ANSI_RESET}\nVERSION env var is empty, check its definition.\n" 1>&2
-	@$(PRINTF) "Checking that 'date -I' works on this platform. "
-	@export DATEVAL=$$(printf "%s" ${DATE} | wc -c | tr -d "[:blank:]" 2>&1); ([ "$${DATEVAL}" = "10" ] && $(PRINTF) "${GREEN}OK${ANSI_RESET}\n") || $(PRINTF) "${RED}ERROR${ANSI_RESET}\n'date -I' does not produce a YYYY-MM-DD output on this platform.\n" 1>&2
-	@$(PRINTF) "Checking that the git commit SHA can be detected. "
-	@([ ! -z "$(GIT_COMMIT)" ] && $(PRINTF) "${GREEN}OK${ANSI_RESET}\n") || $(PRINTF) "${YELLOW}WARN${ANSI_RESET}\nGIT_COMMIT env var is empty.\n" 1>&2
-
-# Checking if mdoc changes produce new lint warnings from mandoc(1) compared to HEAD version:
-#
-# example invocation: `mandoc_lint meli.1`
-#
-# with diff(1)
-# ============
-#function mandoc_lint () {
-#diff <(mandoc -T lint <(git show HEAD:./meli/docs/$1) 2> /dev/null | cut -d':' -f 3-) <(mandoc -T lint ./meli/docs/$1 2> /dev/null | cut -d':' -f 3-)
-#}
-#
-# with sdiff(1) (side by side)
-# ============================
-#
-#function mandoc_lint () {
-#sdiff <(mandoc -T lint <(git show HEAD:./meli/docs/$1) 2> /dev/null | cut -d':' -f 3-) <(mandoc -T lint ./meli/docs/$1 2> /dev/null | cut -d':' -f 3-)
-#}
-#
-# with delta(1)
-# =============
-#
-#function mandoc_lint () {
-#delta --side-by-side <(mandoc -T lint <(git show HEAD:./meli/docs/$1) 2> /dev/null | cut -d':' -f 3-) <(mandoc -T lint ./meli/docs/$1 2> /dev/null | cut -d':' -f 3-)
-#}
+install: meli
+	mkdir -p $(DESTDIR)$(PREFIX)/bin
+	mkdir -p $(DESTDIR)$(PREFIX)/share/man/man1
+	mkdir -p $(DESTDIR)$(PREFIX)/share/man/man5
+	cp -f target/release/meli $(DESTDIR)$(PREFIX)/bin
+	gzip < meli.1 > $(DESTDIR)$(PREFIX)/share/man/man1/meli.1.gz
+	gzip < meli.conf.5 > $(DESTDIR)$(PREFIX)/share/man/man5/meli.conf.5.gz

README

@@ -0,0 +1,104 @@
+    __
+ __/  \__
+/  \__/  \__                       .
+\__/  \__/  \    , _ , _     ___   │   '
+/  \__   \__/    │' `│  `┒ .'   `  │   │
+\__/  \__/  \    │   │   │ |────'  │   │
+   \__/  \__/    │       / `.___, /\__ /
+      \__/
+                                    ,-.
+                                    \_/
+        terminal mail user agent   {|||)<
+                                    / \
+                                    `-'
+DOCUMENTATION
+=============
+
+After installing meli, see meli(1) and meli.conf(5) for documentation.
+
+BUILDING
+========
+
+meli requires rust 1.34 and rust's package manager, Cargo. Information on how
+to get it on your system can be found here:
+
+https://doc.rust-lang.org/cargo/getting-started/installation.html
+
+With Cargo available, the project can be built with
+
+# make
+
+The resulting binary will then be found under target/release/meli
+
+Run:
+
+# make install
+
+to install the binary and man pages. This requires root, so I suggest you override the default paths and install it in your $HOME:
+
+# make PREFIX=$HOME/.local install
+
+See meli(1) and meli.conf(5) for documentation.
+
+You can build and run meli with one command:
+
+# cargo run --release
+
+While the project is in early development, meli will only be developed for the
+linux kernel and respected linux distributions. Support for more UNIX-like OSes
+is on the roadmap.
+
+BUILDING IN DEBIAN
+==================
+
+Building with Debian's packaged cargo might require the installation of these
+two packages: librust-openssl-sys-dev and librust-libdbus-sys-dev
+
+BUILDING WITH NOTMUCH
+=====================
+
+To use the optional notmuch backend feature, you must have libnotmuch installed in your system. In Debian-like systems, install the "libnotmuch" package.
+
+To build with notmuch support, prepend the environment variable "MELI_FEATURES='notmuch'" to your make invocation:
+
+# MELI_FEATURES="notmuch" make
+
+or if building directly with cargo, use the flag '--features="notmuch"'.
+
+DEVELOPMENT
+===========
+
+Development builds can be built and/or run with
+
+# cargo build
+# cargo run
+
+There is a debug/tracing log feature that can be enabled by using the flag
+`--feature debug-tracing` after uncommenting the features in `Cargo.toml`. The logs
+are printed in stderr, thus you can run meli with a redirection (i.e `2> log`)
+
+Code style follows the default rustfmt profile.
+
+CONFIG
+======
+
+meli by default looks for a configuration file in this location:
+# $XDG_CONFIG_HOME/meli/config
+
+You can run meli with arbitrary configuration files by setting the MELI_CONFIG
+environment variable to their locations, ie:
+
+# MELI_CONFIG=./test_config cargo run
+
+TESTING
+=======
+
+How to run specific tests:
+
+# cargo test -p {melib, ui, meli} (-- --nocapture) (--test test_name)
+
+PROFILING
+=========
+
+# perf record -g target/debug/bin
+# perf script | stackcollapse-perf | rust-unmangle | flamegraph > perf.svg

README.md

@@ -1,153 +0,0 @@
-# meli  ![Established, created in 2017](https://img.shields.io/badge/Est.-2017-blue) ![Minimum Supported Rust Version](https://img.shields.io/badge/MSRV-1.68.2-blue) [![GitHub license](https://img.shields.io/github/license/meli/meli)](https://github.com/meli/meli/blob/master/COPYING) [![Crates.io](https://img.shields.io/crates/v/meli)](https://crates.io/crates/meli) [![IRC channel](https://img.shields.io/badge/irc.oftc.net-%23meli-blue)](ircs://irc.oftc.net:6697/%23meli)
-
-**BSD/Linux/macos terminal email client with support for multiple accounts and Maildir / mbox / notmuch / IMAP / JMAP / NNTP (Usenet).**
-
-Try an [old online interactive web demo](https://meli-email.org/wasm2.html "online interactive web demo") powered by WebAssembly!
-
-* `#meli` on OFTC IRC | [mailing lists](https://lists.meli-email.org/)
-* Repository:
-  - Main <https://git.meli-email.org/meli/meli> Report bugs and/or feature requests in [meli's issue tracker](https://git.meli-email.org/meli/meli/issues "meli gitea issue tracker")
-  - Official mirror <https://codeberg.org/meli/meli>
-  - Official mirror <https://github.com/meli/meli>
-
-**Table of contents**:
-
-- [Install](#install)
-- [Build](#build)
-- [Quick start](#quick-start)
-- [Supported E-mail backends](#supported-e-mail-backends)
-- [E-mail submission backends](#e-mail-submission-backends)
-- [Non-exhaustive list of features](#non-exhaustive-list-of-features)
-- [HTML Rendering](#html-rendering)
-- [Documentation](#documentation)
-
-## Install
-
-- [pkgsrc](https://pkgsrc.se/mail/meli)
-- [openbsd ports](https://openports.pl/path/mail/meli)
-- `cargo install meli` or `cargo install --git https://git.meli-email.org/meli/meli.git meli`
-- [Pre-built debian package, static binaries](https://github.com/meli/meli/releases/ "github releases for meli")
-- [Nix](https://search.nixos.org/packages?show=meli&query=meli&from=0&size=30&sort=relevance&channel=unstable#disabled "nixos package search results for 'meli'")
-
-## Build
-
-Run `cargo build --release --bin meli` or `make`.
-
-For detailed building instructions, see [`BUILD.md`](./BUILD.md)
-
-## Quick start
-
-<table>
-<tr><td>
-
-```sh
-# Create configuration file in ${XDG_CONFIG_HOME}/meli/config.toml:
-$ meli create-config
-# Edit configuration in ${EDITOR} or ${VISUAL}:
-$ meli edit-config
-# Optionally, install manual pages if installed via cargo:
-$ meli install-man
-# Ready to go.
-$ meli
-```
-
-</td><td>
-
-See a comprehensive tour of `meli` in the manual page [`meli(7)`](./meli/docs/meli.7).
-
-See also the [Quickstart tutorial](https://meli-email.org/documentation.html#quick-start) online.
-
-After installing `meli`, see `meli(1)`, `meli.conf(5)`, `meli(7)` and `meli-themes(5)` for documentation.
-Sample configuration and theme files can be found in the `meli/docs/samples/` subdirectory.
-Manual pages are also [hosted online](https://meli-email.org/documentation.html "meli documentation").
-`meli` by default looks for a configuration file in this location: `${XDG_CONFIG_HOME}/meli/config.toml`.
-
-You can run meli with arbitrary configuration files by setting the `${MELI_CONFIG}` environment variable to their locations, i.e.:
-
-```sh
-MELI_CONFIG=./test_config cargo run
-```
-
-</td></tr>
-</table>
-
-See [`meli(7)`](./meli/docs/meli.7) for an extensive tutorial and [`meli.conf(5)`](./meli/docs/meli.conf.5) for all configuration values.
-
-| | | |
-:---:|:---:|:---:
-![Main view screenshot](./meli/docs/screenshots/main.webp "mail meli view screenshot")  |  ![Compact main view screenshot](./meli/docs/screenshots/compact.webp "compact main view screenshot") | ![Compose with embed terminal editor screenshot](./meli/docs/screenshots/compose.webp "composing view screenshot")
-Main view             |  Compact main view | Compose with embed terminal editor
-
-### Supported E-mail backends
-
-| Protocol     | Support         |
-|:------------:|:----------------|
-| IMAP         | full            |
-| Maildir      | full            |
-| notmuch      | full[^0]        |
-| mbox         | read-only       |
-| JMAP         | functional      |
-| NNTP / Usenet| functional      |
-
-[^0]: there's no support for searching through all email directly, you'd have to
-      create a mailbox with a notmuch query that returns everything and search
-      inside that mailbox.
-
-### E-mail submission backends
-
-- SMTP
-- Pipe to shell script
-- Server-side submission when supported
-
-### Non-exhaustive list of features
-
-- TLS
-- email threading support
-- multithreaded, async operation
-- optionally run your editor of choice inside meli, with an embedded
-  xterm-compatible terminal emulator
-- plain text configuration in TOML
-- ability to open emails in UI tabs and switch to them
-- optional sqlite3 index search
-- override almost any setting per mailbox, per account
-- contact list (+read-only vCard and mutt alias file support)
-- forced UTF-8 (other encodings are read-only)
-- configurable shortcuts
-- theming
-- `NO_COLOR` support
-- ascii-only drawing characters option
-- view text/html attachments through an html filter command (w3m by default)
-- pipe attachments/mail to stuff
-- use external attachment file picker instead of typing in an attachment's full path
-- GPG signing, encryption, signing + encryption
-- GPG signature verification
-
-## HTML Rendering
-
-HTML rendering is achieved using [w3m](https://github.com/tats/w3m) by default.
-You can use the `pager.html_filter` setting to override this (for more details you can consult [`meli.conf(5)`](./meli/docs/meli.conf.5)).
-
-
-## Documentation
-
-See a comprehensive tour of `meli` in the manual page [`meli(7)`](./meli/docs/meli.7).
-
-See also the [Quickstart tutorial](https://meli-email.org/documentation.html#quick-start) online.
-
-After installing `meli`, see `meli(1)`, `meli.conf(5)`, `meli(7)` and `meli-themes(5)` for documentation.
-Sample configuration and theme files can be found in the `meli/docs/samples/` subdirectory.
-Manual pages are also [hosted online](https://meli-email.org/documentation.html "meli documentation").
-
-`meli` by default looks for a configuration file in this location: `${XDG_CONFIG_HOME}/meli/config.toml`
-
-You can run meli with arbitrary configuration files by setting the `${MELI_CONFIG}` environment variable to their locations, or use the `[-c, --config]` argument:
-
-```sh
-MELI_CONFIG=./test_config meli
-```
-
-or
-
-```sh
-meli -c ./test_config
-```

cliff.toml

@@ -1,123 +0,0 @@
-# configuration for https://github.com/orhun/git-cliff
-
-[changelog]
-# changelog header
-header = """
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-"""
-# template for the changelog body
-# https://keats.github.io/tera/docs/#introduction
-# note that the - before / after the % controls whether whitespace is rendered between each line.
-# Getting this right so that the markdown renders with the correct number of lines between headings
-# code fences and list items is pretty finicky. Note also that the 4 backticks in the commit macro
-# is intentional as this escapes any backticks in the commit body.
-body = """
-
-{% if not version %}
-## [Unreleased]
-{% else %}
-## [{{ version }}](https://git.meli-email.org/meli/meli/releases/tag/{{ version }}) - {{ timestamp | date(format="%Y-%m-%d") }}
-{% endif %}
-{% macro commit(commit) -%}
-- [{{ commit.id | truncate(length=8, end="") }}]({{ "https://git.meli-email.org/meli/meli/commit/" ~ commit.id }}) {% if commit.scope %}*({{commit.scope | lower }})* {% endif %}{{ commit.message | split(pat="\n")| first | upper_first }}{% endmacro -%}
-{% for group, commits in commits | group_by(attribute="group") %}
-
-### {{ group | striptags | trim | upper_first }}
-{% for commit in commits | filter(attribute="scope") | sort(attribute="scope") %}
-{{ self::commit(commit=commit) }}
-{%- endfor -%}
-{% for commit in commits %}
-{%- if not commit.scope %}
-{{ self::commit(commit=commit) }}
-{%- endif -%}
-{%- endfor -%}
-{%- endfor %}
-"""
-
-# remove the leading and trailing whitespace from the template
-trim = true
-# changelog footer
-footer = """
-
-
-<!-- generated by git-cliff <https://git-cliff.org> -->
-"""
-
-[git]
-# parse the commits based on https://www.conventionalcommits.org
-conventional_commits = true
-# filter out the commits that are not conventional
-filter_unconventional = false
-# process each line of a commit as an individual commit
-split_commits = false
-# regex for preprocessing the commit messages
-commit_preprocessors = [
-  { pattern = '\((\w+\s)?#([0-9]+)\)', replace = "([#${2}](https://git.meli-email.org/meli/meli/issues/${2}))" },
-]
-# regex for parsing and grouping commits
-commit_parsers = [
-  { message = "^feat", group = "<!-- 00 -->Added" },
-  { message = "^[aA]dd", group = "<!-- 00 -->Added" },
-  { message = "[fF]ix", group = "<!-- 01 -->Bug Fixes" },
-  { message = "[rR]efactor", group = "<!-- 02 -->Refactoring" },
-  { message = "[mM]ove", group = "<!-- 02 -->Refactoring" },
-  { message = "[rR]emove", group = "<!-- 02 -->Refactoring" },
-  { message = "^refactor", group = "<!-- 02 -->Refactoring" },
-  { message = "^[^.]*.rs:", group = "<!-- 02 -->Refactoring" },
-  { message = "^meli", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^melib", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^imap", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^jmap", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^notmuch", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^mbox", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^smtp", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^mbox", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^doc", group = "<!-- 03 -->Documentation" },
-  { message = "[mM]anual", group = "<!-- 03 -->Documentation" },
-  { message = "[mM]anpage", group = "<!-- 03 -->Documentation" },
-  { message = "[rR]eadme", group = "<!-- 03 -->Documentation" },
-  { message = "^perf", group = "<!-- 04 -->Performance" },
-  { message = "^style", group = "<!-- 05 -->Styling" },
-  { message = "^test", group = "<!-- 06 -->Testing" },
-  { message = "^debian", group = "<!-- 06 -->Packaging" },
-  { message = "^mail/view", group = "<!-- 02 -->Changes" },
-  { message = "^view", group = "<!-- 02 -->Changes" },
-  { message = "^utilities", group = "<!-- 02 -->Changes" },
-  { message = "^mail", group = "<!-- 02 -->Changes" },
-  { message = "^listing", group = "<!-- 02 -->Changes" },
-  { message = "^terminal", group = "<!-- 02 -->Changes" },
-  { message = "^types", group = "<!-- 02 -->Changes" },
-  { message = "^conf", group = "<!-- 02 -->Changes" },
-  { message = "^chore\\(release\\): prepare for", skip = true },
-  { message = "^chore\\(pr\\)", skip = true },
-  { message = "^chore\\(pull\\)", skip = true },
-  { message = "^chore\\(deps\\)", skip = true },
-  { message = "^chore\\(changelog\\)", skip = true },
-  { message = "^[cC]hore", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { message = "^scripts", group = "<!-- 07 -->Miscellaneous Tasks" },
-  { body = ".*security", group = "<!-- 08 -->Security" },
-  { message = "^build", group = "<!-- 09 -->Build" },
-  { message = "^ci", group = "<!-- 10 -->Continuous Integration" },
-  { message = "^revert", group = "<!-- 11 -->Reverted Commits" },
-  { message = ".*", group = "<!-- 07 -->Miscellaneous Tasks" },
-]
-# protect breaking changes from being skipped due to matching a skipping commit_parser
-protect_breaking_commits = false
-# filter out the commits that are not matched by commit parsers
-filter_commits = false
-# glob pattern for matching git tags
-tag_pattern = "v[0-9]+|alpha-[0-9]+"
-# regex for ignoring tags
-ignore_tags = "v[^-]+-rc[.]?[0-9]+"
-# regex for skipping tags
-#skip_tags = "alpha"
-# sort the tags topologically
-topo_order = false
-# sort the commits inside sections by oldest/newest order
-sort_commits = "oldest"

codemeta.json

@@ -1,62 +0,0 @@
-{
-    "@context": ["https://doi.org/10.5063/schema/codemeta-2.0", "http://schema.org/"],
-    "@type": "SoftwareSourceCode",
-    "applicationCategory": "E-mail client",
-    "author": [
-        {
-            "@id": "https://pitsidianak.is/",
-            "@type": "Person",
-            "name": "epilys",
-            "email": "manos@pitsidianak.is",
-            "familyName": "Pitsidianakis",
-            "givenName": "Manos",
-            "url": "https://pitsidianak.is/"
-        }
-    ],
-    "codeRepository": "https://git.meli-email.org/meli/meli.git",
-    "dateCreated": "2016-04-25",
-    "dateModified": "2023-12-11",
-    "datePublished": "2017-07-23",
-    "description": "BSD/Linux/macos terminal email client with support for multiple accounts and Maildir / mbox / notmuch / IMAP / JMAP / NNTP (Usenet).",
-    "downloadUrl": "https://git.meli-email.org/meli/meli/archive/v0.8.5-rc.3.tar.gz",
-    "identifier": "https://meli-email.org/",
-    "isPartOf": "https://meli-email.org/",
-    "keywords": [
-        "e-mail",
-        "email",
-        "mail",
-        "terminal user interface",
-        "client",
-        "mua",
-        "mail user agent",
-        "smtp",
-        "imap",
-        "jmap",
-        "mbox",
-        "maildir",
-        "nntp"
-    ],
-    "license": [
-        "https://spdx.org/licenses/EUPL-1.2",
-        "https://spdx.org/licenses/GPL-3.0-or-later"
-    ],
-    "name": "meli",
-    "operatingSystem": [
-        "Linux",
-        "macOS",
-        "OpenBSD",
-        "NetBSD"
-    ],
-    "programmingLanguage": "Rust",
-    "relatedLink": [
-        "https://codeberg.org/meli/meli",
-        "https://github.com/meli/meli",
-        "https://lists.meli-email.org/"
-    ],
-    "version": "0.8.5-rc3",
-    "contIntegration": "https://git.meli-email.org/meli/meli/actions",
-    "developmentStatus": "active",
-    "issueTracker": "https://git.meli-email.org/meli/meli/issues",
-    "readme": "https://git.meli-email.org/meli/meli/raw/commit/dedee908d1e0b42773bade8e0604e94b14810e2d/README.md",
-    "buildInstructions": "https://git.meli-email.org/meli/meli/raw/commit/dedee908d1e0b42773bade8e0604e94b14810e2d/BUILD.md"
-}

contrib/oauth2.py

@@ -1,348 +0,0 @@
-#!/usr/bin/env python3
-#
-# Copyright 2012 Google Inc.
-# Copyright 2020 Manos Pitsidianakis
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-     # http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-"""Performs client tasks for testing IMAP OAuth2 authentication.
-
-To use this script, you'll need to have registered with Google as an OAuth
-application and obtained an OAuth client ID and client secret.
-See https://developers.google.com/identity/protocols/OAuth2 for instructions on
-registering and for documentation of the APIs invoked by this code.
-
-This script has 3 modes of operation.
-
-1. The first mode is used to generate and authorize an OAuth2 token, the
-first step in logging in via OAuth2.
-
-  oauth2 --user=xxx@gmail.com \
-    --client_id=1038[...].apps.googleusercontent.com \
-    --client_secret=VWFn8LIKAMC-MsjBMhJeOplZ \
-    --generate_oauth2_token
-
-The script will converse with Google and generate an oauth request
-token, then present you with a URL you should visit in your browser to
-authorize the token. Once you get the verification code from the Google
-website, enter it into the script to get your OAuth access token. The output
-from this command will contain the access token, a refresh token, and some
-metadata about the tokens. The access token can be used until it expires, and
-the refresh token lasts indefinitely, so you should record these values for
-reuse.
-
-2. The script will generate new access tokens using a refresh token.
-
-  oauth2 --user=xxx@gmail.com \
-    --client_id=1038[...].apps.googleusercontent.com \
-    --client_secret=VWFn8LIKAMC-MsjBMhJeOplZ \
-    --refresh_token=1/Yzm6MRy4q1xi7Dx2DuWXNgT6s37OrP_DW_IoyTum4YA
-
-3. The script will generate an OAuth2 string that can be fed
-directly to IMAP or SMTP. This is triggered with the --generate_oauth2_string
-option.
-
-  oauth2 --generate_oauth2_string --user=xxx@gmail.com \
-    --access_token=ya29.AGy[...]ezLg
-
-The output of this mode will be a base64-encoded string. To use it, connect to a
-IMAPFE and pass it as the second argument to the AUTHENTICATE command.
-
-  a AUTHENTICATE XOAUTH2 a9sha9sfs[...]9dfja929dk==
-"""
-
-import base64
-import imaplib
-import json
-from optparse import OptionParser
-import smtplib
-import sys
-import urllib.request, urllib.parse, urllib.error
-
-
-def SetupOptionParser():
-  # Usage message is the module's docstring.
-  parser = OptionParser(usage=__doc__)
-  parser.add_option('--generate_oauth2_token',
-                    action='store_true',
-                    dest='generate_oauth2_token',
-                    help='generates an OAuth2 token for testing')
-  parser.add_option('--generate_oauth2_string',
-                    action='store_true',
-                    dest='generate_oauth2_string',
-                    help='generates an initial client response string for '
-                         'OAuth2')
-  parser.add_option('--client_id',
-                    default=None,
-                    help='Client ID of the application that is authenticating. '
-                         'See OAuth2 documentation for details.')
-  parser.add_option('--client_secret',
-                    default=None,
-                    help='Client secret of the application that is '
-                         'authenticating. See OAuth2 documentation for '
-                         'details.')
-  parser.add_option('--access_token',
-                    default=None,
-                    help='OAuth2 access token')
-  parser.add_option('--refresh_token',
-                    default=None,
-                    help='OAuth2 refresh token')
-  parser.add_option('--scope',
-                    default='https://mail.google.com/',
-                    help='scope for the access token. Multiple scopes can be '
-                         'listed separated by spaces with the whole argument '
-                         'quoted.')
-  parser.add_option('--test_imap_authentication',
-                    action='store_true',
-                    dest='test_imap_authentication',
-                    help='attempts to authenticate to IMAP')
-  parser.add_option('--test_smtp_authentication',
-                    action='store_true',
-                    dest='test_smtp_authentication',
-                    help='attempts to authenticate to SMTP')
-  parser.add_option('--user',
-                    default=None,
-                    help='email address of user whose account is being '
-                         'accessed')
-  parser.add_option('--quiet',
-                    action='store_true',
-                    default=False,
-                    dest='quiet',
-                    help='Omit verbose descriptions and only print '
-                         'machine-readable outputs.')
-  return parser
-
-
-# The URL root for accessing Google Accounts.
-GOOGLE_ACCOUNTS_BASE_URL = 'https://accounts.google.com'
-
-
-# Hardcoded dummy redirect URI for non-web apps.
-REDIRECT_URI = 'urn:ietf:wg:oauth:2.0:oob'
-
-
-def AccountsUrl(command):
-  """Generates the Google Accounts URL.
-
-  Args:
-    command: The command to execute.
-
-  Returns:
-    A URL for the given command.
-  """
-  return '%s/%s' % (GOOGLE_ACCOUNTS_BASE_URL, command)
-
-
-def UrlEscape(text):
-  # See OAUTH 5.1 for a definition of which characters need to be escaped.
-  return urllib.parse.quote(text, safe='~-._')
-
-
-def UrlUnescape(text):
-  # See OAUTH 5.1 for a definition of which characters need to be escaped.
-  return urllib.parse.unquote(text)
-
-
-def FormatUrlParams(params):
-  """Formats parameters into a URL query string.
-
-  Args:
-    params: A key-value map.
-
-  Returns:
-    A URL query string version of the given parameters.
-  """
-  param_fragments = []
-  for param in sorted(iter(params.items()), key=lambda x: x[0]):
-    param_fragments.append('%s=%s' % (param[0], UrlEscape(param[1])))
-  return '&'.join(param_fragments)
-
-
-def GeneratePermissionUrl(client_id, scope='https://mail.google.com/'):
-  """Generates the URL for authorizing access.
-
-  This uses the "OAuth2 for Installed Applications" flow described at
-  https://developers.google.com/accounts/docs/OAuth2InstalledApp
-
-  Args:
-    client_id: Client ID obtained by registering your app.
-    scope: scope for access token, e.g. 'https://mail.google.com'
-  Returns:
-    A URL that the user should visit in their browser.
-  """
-  params = {}
-  params['client_id'] = client_id
-  params['redirect_uri'] = REDIRECT_URI
-  params['scope'] = scope
-  params['response_type'] = 'code'
-  return '%s?%s' % (AccountsUrl('o/oauth2/auth'),
-                    FormatUrlParams(params))
-
-
-def AuthorizeTokens(client_id, client_secret, authorization_code):
-  """Obtains OAuth access token and refresh token.
-
-  This uses the application portion of the "OAuth2 for Installed Applications"
-  flow at https://developers.google.com/accounts/docs/OAuth2InstalledApp#handlingtheresponse
-
-  Args:
-    client_id: Client ID obtained by registering your app.
-    client_secret: Client secret obtained by registering your app.
-    authorization_code: code generated by Google Accounts after user grants
-        permission.
-  Returns:
-    The decoded response from the Google Accounts server, as a dict. Expected
-    fields include 'access_token', 'expires_in', and 'refresh_token'.
-  """
-  params = {}
-  params['client_id'] = client_id
-  params['client_secret'] = client_secret
-  params['code'] = authorization_code
-  params['redirect_uri'] = REDIRECT_URI
-  params['grant_type'] = 'authorization_code'
-  request_url = AccountsUrl('o/oauth2/token')
-
-  response = urllib.request.urlopen(request_url, urllib.parse.urlencode(params).encode()).read()
-  return json.loads(response)
-
-
-def RefreshToken(client_id, client_secret, refresh_token):
-  """Obtains a new token given a refresh token.
-
-  See https://developers.google.com/accounts/docs/OAuth2InstalledApp#refresh
-
-  Args:
-    client_id: Client ID obtained by registering your app.
-    client_secret: Client secret obtained by registering your app.
-    refresh_token: A previously-obtained refresh token.
-  Returns:
-    The decoded response from the Google Accounts server, as a dict. Expected
-    fields include 'access_token', 'expires_in', and 'refresh_token'.
-  """
-  params = {}
-  params['client_id'] = client_id
-  params['client_secret'] = client_secret
-  params['refresh_token'] = refresh_token
-  params['grant_type'] = 'refresh_token'
-  request_url = AccountsUrl('o/oauth2/token')
-
-  response = urllib.request.urlopen(request_url, urllib.parse.urlencode(params).encode()).read()
-  return json.loads(response)
-
-
-def GenerateOAuth2String(username, access_token, base64_encode=True):
-  """Generates an IMAP OAuth2 authentication string.
-
-  See https://developers.google.com/google-apps/gmail/oauth2_overview
-
-  Args:
-    username: the username (email address) of the account to authenticate
-    access_token: An OAuth2 access token.
-    base64_encode: Whether to base64-encode the output.
-
-  Returns:
-    The SASL argument for the OAuth2 mechanism.
-  """
-  auth_string = 'user=%s\1auth=Bearer %s\1\1' % (username, access_token)
-  if base64_encode:
-    auth_string = base64.b64encode(bytes(auth_string, 'utf-8'))
-  return auth_string
-
-
-def TestImapAuthentication(user, auth_string):
-  """Authenticates to IMAP with the given auth_string.
-
-  Prints a debug trace of the attempted IMAP connection.
-
-  Args:
-    user: The Gmail username (full email address)
-    auth_string: A valid OAuth2 string, as returned by GenerateOAuth2String.
-        Must not be base64-encoded, since imaplib does its own base64-encoding.
-  """
-  print()
-  imap_conn = imaplib.IMAP4_SSL('imap.gmail.com')
-  imap_conn.debug = 4
-  imap_conn.authenticate('XOAUTH2', lambda x: auth_string)
-  imap_conn.select('INBOX')
-
-
-def TestSmtpAuthentication(user, auth_string):
-  """Authenticates to SMTP with the given auth_string.
-
-  Args:
-    user: The Gmail username (full email address)
-    auth_string: A valid OAuth2 string, not base64-encoded, as returned by
-        GenerateOAuth2String.
-  """
-  print()
-  smtp_conn = smtplib.SMTP('smtp.gmail.com', 587)
-  smtp_conn.set_debuglevel(True)
-  smtp_conn.ehlo('test')
-  smtp_conn.starttls()
-  smtp_conn.docmd('AUTH', 'XOAUTH2 ' + base64.b64encode(auth_string))
-
-
-def RequireOptions(options, *args):
-  missing = [arg for arg in args if getattr(options, arg) is None]
-  if missing:
-    print('Missing options: %s' % ' '.join(missing), file=sys.stderr)
-    sys.exit(-1)
-
-
-def main(argv):
-  options_parser = SetupOptionParser()
-  (options, args) = options_parser.parse_args()
-  if options.refresh_token:
-    RequireOptions(options, 'client_id', 'client_secret')
-    response = RefreshToken(options.client_id, options.client_secret,
-                            options.refresh_token)
-    if options.quiet:
-      print(response['access_token'])
-    else:
-      print('Access Token: %s' % response['access_token'])
-      print('Access Token Expiration Seconds: %s' % response['expires_in'])
-  elif options.generate_oauth2_string:
-    RequireOptions(options, 'user', 'access_token')
-    oauth2_string = GenerateOAuth2String(options.user, options.access_token)
-    if options.quiet:
-      print(oauth2_string.decode('utf-8'))
-    else:
-      print('OAuth2 argument:\n' + oauth2_string.decode('utf-8'))
-  elif options.generate_oauth2_token:
-    RequireOptions(options, 'client_id', 'client_secret')
-    print('To authorize token, visit this url and follow the directions:')
-    print('  %s' % GeneratePermissionUrl(options.client_id, options.scope))
-    authorization_code = input('Enter verification code: ')
-    response = AuthorizeTokens(options.client_id, options.client_secret,
-                                authorization_code)
-    print('Refresh Token: %s' % response['refresh_token'])
-    print('Access Token: %s' % response['access_token'])
-    print('Access Token Expiration Seconds: %s' % response['expires_in'])
-  elif options.test_imap_authentication:
-    RequireOptions(options, 'user', 'access_token')
-    TestImapAuthentication(options.user,
-        GenerateOAuth2String(options.user, options.access_token,
-                             base64_encode=False))
-  elif options.test_smtp_authentication:
-    RequireOptions(options, 'user', 'access_token')
-    TestSmtpAuthentication(options.user,
-        GenerateOAuth2String(options.user, options.access_token,
-                             base64_encode=False))
-  else:
-    options_parser.print_help()
-    print('Nothing to do, exiting.')
-    return
-
-
-if __name__ == '__main__':
-  main(sys.argv)

debian/changelog

@@ -1,104 +0,0 @@
-meli (0.8.5-rc.3-1) bookworm; urgency=low
-
-  * Update to 0.8.5-rc.3
-
- -- Manos Pitsidianakis <manos@pitsidianak.is>  Sun, 10 Dec 2023 15:22:18 +0000
-
-meli (0.8.5-rc.2-1) bookworm; urgency=low
-
-  * Update to 0.8.5-rc.2
-
- -- Manos Pitsidianakis <manos@pitsidianak.is>  Mon, 4 Dec 2023 19:34:00 +0200
-
-meli (0.8.4-1) bookworm; urgency=low
-
-  * Update to 0.8.4
-
- -- Manos Pitsidianakis <manos@pitsidianak.is>  Mon, 27 Nov 2023 19:34:00 +0200
-
-meli (0.7.2-1) bullseye; urgency=low
-    Added
-
-  - Add forward mail option
-  - Add url_launcher config setting
-  - Add add_addresses_to_contacts command
-  - Add show_date_in_my_timezone pager config flag
-  - docs: add pager filter documentation
-  - mail/view: respect per-folder/account pager filter override
-  - pager: add filter command, esc to clear filter
-  - Show compile time features in with command argument
-
-    Fixed
-
-  - melib/email/address: quote display_name if it contains ","
-  - melib/smtp: fix Cc and Bcc ignored when sending mail
-  - melib/email/address: quote display_name if it contains "."
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Fri, 15 Oct 2021 12:34:00 +0200
-meli (0.7.1-1) bullseye; urgency=low
-
-  Added
-  - Change all Down/Up shortcuts to j/k
-  - add 'GB18030' charset
-  - melib/nntp: implement refresh
-  - melib/nntp: update total/new counters on new articles
-  - melib/nntp: implement NNTP posting
-  - configs: throw error on extra unused conf flags in some imap/nntp
-  - configs: throw error on missing `composing` section with explanation
-
-  Fixed
-  - Fix compilation for netbsd-9.2
-  - conf: fixed some boolean flag values requiring to be string e.g. "true"
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Wed, 08 Sep 2021 18:14:00 +0200
-meli (0.7.0-1) buster; urgency=low
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Fri, 03 Sep 2021 18:14:00 +0200
-meli (0.6.2-1) buster; urgency=low
-
-  Added
-  - Add customizable mailbox tree in sidebar
-  - Make `dbus` dependency opt-out (feature is `dbus-notifications`)
-  - Implemented JMAP async, search, tagging, syncing
-  - Preserve account order from configuration file
-  - Implemented IMAP `CONDSTORE` support for IMAP cache
-  - Add `timeout` setting for IMAP
-  - Implement TCP keepalive for IMAP
-  - Rewrote email address parsers.
-  - Implement `copy_messages` for maildir
-  - Implement selection with motions
-
-  Fixed
-  - Fixed various problems with IMAP cache
-  - Fixed various problems with IMAP message counts
-  - Fixed various problems with IMAP connection hanging
-  - Fixed IMAP not reconnecting on dropped IDLE connections
-  - Fixed various problems with notmuch backend
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Thu, 24 Sep 2020 18:14:00 +0200
-meli (0.6.1-1) buster; urgency=low
-
-  * added experimental NNTP backend
-  * added server extension support and use in account status tab
-  * imap: fixed IDLE connection getting stuck when using DEFLATE
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Sun, 02 Aug 2020 01:09:05 +0200
-meli (0.6.0-1) buster; urgency=low
-
-  * Update to 0.6.0
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Wed, 29 Jul 2020 22:24:08 +0200
-meli (0.5.1-1) buster; urgency=low
-
-  * Update to 0.5.1
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Wed, 29 Jan 2020 22:24:08 +0200
-meli (0.5.0-1) buster; urgency=low
-
-  * Update to 0.5.0
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Wed, 29 Jan 2020 22:24:08 +0200
-meli (0.4.1-1) buster; urgency=low
-
-  * Initial release.
-
- -- Manos Pitsidianakis <epilys@nessuent.xyz>  Wed, 29 Jan 2020 22:24:08 +0200

debian/control

@@ -1,20 +0,0 @@
-Source: meli
-Section: mail
-Priority: optional
-Maintainer: Manos Pitsidianakis <manos@pitsidianak.is>
-Build-Depends: debhelper-compat (=13), mandoc (>=1.14.4-1), quilt, libsqlite3-dev
-Standards-Version: 4.1.4
-Rules-Requires-Root: no
-Vcs-Git: https://git.meli-email.org/meli/meli.git
-Vcs-Browser: https://git.meli-email.org/meli/meli
-Homepage: https://meli-email.org
-
-Package: meli
-Architecture: any
-Depends: ${misc:Depends}, ${shlibs:Depends}
-Recommends: xdg-utils (>=1.1.3-1), w3m, mailcap
-Suggests: libnotmuch5, notmuch, rss2email, xterm, neovim, msmtp
-Provides: mail-reader, imap-client
-Description: terminal mail client.
- meli supports mbox, maildir, IMAP, JMAP, notmuch and NNTP (Usernet) with
- TLS/SSL, SASL, GPG features.

debian/copyright

@@ -1,685 +0,0 @@
-Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Upstream-Name: meli
-Source: https://git.meli-email.org/meli/meli
-#
-# Please double check copyright with the licensecheck(1) command.
-
-Files:     *
-Copyright: 2017-2023 Manos Pitsidianakis
-License:   GPL-3.0+
-#----------------------------------------------------------------------------
-# License file: COPYING
-                     GNU GENERAL PUBLIC LICENSE
-                        Version 3, 29 June 2007
- .
-  Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
-  Everyone is permitted to copy and distribute verbatim copies
-  of this license document, but changing it is not allowed.
- .
-                             Preamble
- .
-   The GNU General Public License is a free, copyleft license for
- software and other kinds of works.
- .
-   The licenses for most software and other practical works are designed
- to take away your freedom to share and change the works.  By contrast,
- the GNU General Public License is intended to guarantee your freedom to
- share and change all versions of a program--to make sure it remains free
- software for all its users.  We, the Free Software Foundation, use the
- GNU General Public License for most of our software; it applies also to
- any other work released this way by its authors.  You can apply it to
- your programs, too.
- .
-   When we speak of free software, we are referring to freedom, not
- price.  Our General Public Licenses are designed to make sure that you
- have the freedom to distribute copies of free software (and charge for
- them if you wish), that you receive source code or can get it if you
- want it, that you can change the software or use pieces of it in new
- free programs, and that you know you can do these things.
- .
-   To protect your rights, we need to prevent others from denying you
- these rights or asking you to surrender the rights.  Therefore, you have
- certain responsibilities if you distribute copies of the software, or if
- you modify it: responsibilities to respect the freedom of others.
- .
-   For example, if you distribute copies of such a program, whether
- gratis or for a fee, you must pass on to the recipients the same
- freedoms that you received.  You must make sure that they, too, receive
- or can get the source code.  And you must show them these terms so they
- know their rights.
- .
-   Developers that use the GNU GPL protect your rights with two steps:
- (1) assert copyright on the software, and (2) offer you this License
- giving you legal permission to copy, distribute and/or modify it.
- .
-   For the developers' and authors' protection, the GPL clearly explains
- that there is no warranty for this free software.  For both users' and
- authors' sake, the GPL requires that modified versions be marked as
- changed, so that their problems will not be attributed erroneously to
- authors of previous versions.
- .
-   Some devices are designed to deny users access to install or run
- modified versions of the software inside them, although the manufacturer
- can do so.  This is fundamentally incompatible with the aim of
- protecting users' freedom to change the software.  The systematic
- pattern of such abuse occurs in the area of products for individuals to
- use, which is precisely where it is most unacceptable.  Therefore, we
- have designed this version of the GPL to prohibit the practice for those
- products.  If such problems arise substantially in other domains, we
- stand ready to extend this provision to those domains in future versions
- of the GPL, as needed to protect the freedom of users.
- .
-   Finally, every program is threatened constantly by software patents.
- States should not allow patents to restrict development and use of
- software on general-purpose computers, but in those that do, we wish to
- avoid the special danger that patents applied to a free program could
- make it effectively proprietary.  To prevent this, the GPL assures that
- patents cannot be used to render the program non-free.
- .
-   The precise terms and conditions for copying, distribution and
- modification follow.
- .
-                        TERMS AND CONDITIONS
- .
-   0. Definitions.
- .
-   "This License" refers to version 3 of the GNU General Public License.
- .
-   "Copyright" also means copyright-like laws that apply to other kinds of
- works, such as semiconductor masks.
- .
-   "The Program" refers to any copyrightable work licensed under this
- License.  Each licensee is addressed as "you".  "Licensees" and
- "recipients" may be individuals or organizations.
- .
-   To "modify" a work means to copy from or adapt all or part of the work
- in a fashion requiring copyright permission, other than the making of an
- exact copy.  The resulting work is called a "modified version" of the
- earlier work or a work "based on" the earlier work.
- .
-   A "covered work" means either the unmodified Program or a work based
- on the Program.
- .
-   To "propagate" a work means to do anything with it that, without
- permission, would make you directly or secondarily liable for
- infringement under applicable copyright law, except executing it on a
- computer or modifying a private copy.  Propagation includes copying,
- distribution (with or without modification), making available to the
- public, and in some countries other activities as well.
- .
-   To "convey" a work means any kind of propagation that enables other
- parties to make or receive copies.  Mere interaction with a user through
- a computer network, with no transfer of a copy, is not conveying.
- .
-   An interactive user interface displays "Appropriate Legal Notices"
- to the extent that it includes a convenient and prominently visible
- feature that (1) displays an appropriate copyright notice, and (2)
- tells the user that there is no warranty for the work (except to the
- extent that warranties are provided), that licensees may convey the
- work under this License, and how to view a copy of this License.  If
- the interface presents a list of user commands or options, such as a
- menu, a prominent item in the list meets this criterion.
- .
-   1. Source Code.
- .
-   The "source code" for a work means the preferred form of the work
- for making modifications to it.  "Object code" means any non-source
- form of a work.
- .
-   A "Standard Interface" means an interface that either is an official
- standard defined by a recognized standards body, or, in the case of
- interfaces specified for a particular programming language, one that
- is widely used among developers working in that language.
- .
-   The "System Libraries" of an executable work include anything, other
- than the work as a whole, that (a) is included in the normal form of
- packaging a Major Component, but which is not part of that Major
- Component, and (b) serves only to enable use of the work with that
- Major Component, or to implement a Standard Interface for which an
- implementation is available to the public in source code form.  A
- "Major Component", in this context, means a major essential component
- (kernel, window system, and so on) of the specific operating system
- (if any) on which the executable work runs, or a compiler used to
- produce the work, or an object code interpreter used to run it.
- .
-   The "Corresponding Source" for a work in object code form means all
- the source code needed to generate, install, and (for an executable
- work) run the object code and to modify the work, including scripts to
- control those activities.  However, it does not include the work's
- System Libraries, or general-purpose tools or generally available free
- programs which are used unmodified in performing those activities but
- which are not part of the work.  For example, Corresponding Source
- includes interface definition files associated with source files for
- the work, and the source code for shared libraries and dynamically
- linked subprograms that the work is specifically designed to require,
- such as by intimate data communication or control flow between those
- subprograms and other parts of the work.
- .
-   The Corresponding Source need not include anything that users
- can regenerate automatically from other parts of the Corresponding
- Source.
- .
-   The Corresponding Source for a work in source code form is that
- same work.
- .
-   2. Basic Permissions.
- .
-   All rights granted under this License are granted for the term of
- copyright on the Program, and are irrevocable provided the stated
- conditions are met.  This License explicitly affirms your unlimited
- permission to run the unmodified Program.  The output from running a
- covered work is covered by this License only if the output, given its
- content, constitutes a covered work.  This License acknowledges your
- rights of fair use or other equivalent, as provided by copyright law.
- .
-   You may make, run and propagate covered works that you do not
- convey, without conditions so long as your license otherwise remains
- in force.  You may convey covered works to others for the sole purpose
- of having them make modifications exclusively for you, or provide you
- with facilities for running those works, provided that you comply with
- the terms of this License in conveying all material for which you do
- not control copyright.  Those thus making or running the covered works
- for you must do so exclusively on your behalf, under your direction
- and control, on terms that prohibit them from making any copies of
- your copyrighted material outside their relationship with you.
- .
-   Conveying under any other circumstances is permitted solely under
- the conditions stated below.  Sublicensing is not allowed; section 10
- makes it unnecessary.
- .
-   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
- .
-   No covered work shall be deemed part of an effective technological
- measure under any applicable law fulfilling obligations under article
- 11 of the WIPO copyright treaty adopted on 20 December 1996, or
- similar laws prohibiting or restricting circumvention of such
- measures.
- .
-   When you convey a covered work, you waive any legal power to forbid
- circumvention of technological measures to the extent such circumvention
- is effected by exercising rights under this License with respect to
- the covered work, and you disclaim any intention to limit operation or
- modification of the work as a means of enforcing, against the work's
- users, your or third parties' legal rights to forbid circumvention of
- technological measures.
- .
-   4. Conveying Verbatim Copies.
- .
-   You may convey verbatim copies of the Program's source code as you
- receive it, in any medium, provided that you conspicuously and
- appropriately publish on each copy an appropriate copyright notice;
- keep intact all notices stating that this License and any
- non-permissive terms added in accord with section 7 apply to the code;
- keep intact all notices of the absence of any warranty; and give all
- recipients a copy of this License along with the Program.
- .
-   You may charge any price or no price for each copy that you convey,
- and you may offer support or warranty protection for a fee.
- .
-   5. Conveying Modified Source Versions.
- .
-   You may convey a work based on the Program, or the modifications to
- produce it from the Program, in the form of source code under the
- terms of section 4, provided that you also meet all of these conditions:
- .
-     a) The work must carry prominent notices stating that you modified
-     it, and giving a relevant date.
- .
-     b) The work must carry prominent notices stating that it is
-     released under this License and any conditions added under section
-     7.  This requirement modifies the requirement in section 4 to
-     "keep intact all notices".
- .
-     c) You must license the entire work, as a whole, under this
-     License to anyone who comes into possession of a copy.  This
-     License will therefore apply, along with any applicable section 7
-     additional terms, to the whole of the work, and all its parts,
-     regardless of how they are packaged.  This License gives no
-     permission to license the work in any other way, but it does not
-     invalidate such permission if you have separately received it.
- .
-     d) If the work has interactive user interfaces, each must display
-     Appropriate Legal Notices; however, if the Program has interactive
-     interfaces that do not display Appropriate Legal Notices, your
-     work need not make them do so.
- .
-   A compilation of a covered work with other separate and independent
- works, which are not by their nature extensions of the covered work,
- and which are not combined with it such as to form a larger program,
- in or on a volume of a storage or distribution medium, is called an
- "aggregate" if the compilation and its resulting copyright are not
- used to limit the access or legal rights of the compilation's users
- beyond what the individual works permit.  Inclusion of a covered work
- in an aggregate does not cause this License to apply to the other
- parts of the aggregate.
- .
-   6. Conveying Non-Source Forms.
- .
-   You may convey a covered work in object code form under the terms
- of sections 4 and 5, provided that you also convey the
- machine-readable Corresponding Source under the terms of this License,
- in one of these ways:
- .
-     a) Convey the object code in, or embodied in, a physical product
-     (including a physical distribution medium), accompanied by the
-     Corresponding Source fixed on a durable physical medium
-     customarily used for software interchange.
- .
-     b) Convey the object code in, or embodied in, a physical product
-     (including a physical distribution medium), accompanied by a
-     written offer, valid for at least three years and valid for as
-     long as you offer spare parts or customer support for that product
-     model, to give anyone who possesses the object code either (1) a
-     copy of the Corresponding Source for all the software in the
-     product that is covered by this License, on a durable physical
-     medium customarily used for software interchange, for a price no
-     more than your reasonable cost of physically performing this
-     conveying of source, or (2) access to copy the
-     Corresponding Source from a network server at no charge.
- .
-     c) Convey individual copies of the object code with a copy of the
-     written offer to provide the Corresponding Source.  This
-     alternative is allowed only occasionally and noncommercially, and
-     only if you received the object code with such an offer, in accord
-     with subsection 6b.
- .
-     d) Convey the object code by offering access from a designated
-     place (gratis or for a charge), and offer equivalent access to the
-     Corresponding Source in the same way through the same place at no
-     further charge.  You need not require recipients to copy the
-     Corresponding Source along with the object code.  If the place to
-     copy the object code is a network server, the Corresponding Source
-     may be on a different server (operated by you or a third party)
-     that supports equivalent copying facilities, provided you maintain
-     clear directions next to the object code saying where to find the
-     Corresponding Source.  Regardless of what server hosts the
-     Corresponding Source, you remain obligated to ensure that it is
-     available for as long as needed to satisfy these requirements.
- .
-     e) Convey the object code using peer-to-peer transmission, provided
-     you inform other peers where the object code and Corresponding
-     Source of the work are being offered to the general public at no
-     charge under subsection 6d.
- .
-   A separable portion of the object code, whose source code is excluded
- from the Corresponding Source as a System Library, need not be
- included in conveying the object code work.
- .
-   A "User Product" is either (1) a "consumer product", which means any
- tangible personal property which is normally used for personal, family,
- or household purposes, or (2) anything designed or sold for incorporation
- into a dwelling.  In determining whether a product is a consumer product,
- doubtful cases shall be resolved in favor of coverage.  For a particular
- product received by a particular user, "normally used" refers to a
- typical or common use of that class of product, regardless of the status
- of the particular user or of the way in which the particular user
- actually uses, or expects or is expected to use, the product.  A product
- is a consumer product regardless of whether the product has substantial
- commercial, industrial or non-consumer uses, unless such uses represent
- the only significant mode of use of the product.
- .
-   "Installation Information" for a User Product means any methods,
- procedures, authorization keys, or other information required to install
- and execute modified versions of a covered work in that User Product from
- a modified version of its Corresponding Source.  The information must
- suffice to ensure that the continued functioning of the modified object
- code is in no case prevented or interfered with solely because
- modification has been made.
- .
-   If you convey an object code work under this section in, or with, or
- specifically for use in, a User Product, and the conveying occurs as
- part of a transaction in which the right of possession and use of the
- User Product is transferred to the recipient in perpetuity or for a
- fixed term (regardless of how the transaction is characterized), the
- Corresponding Source conveyed under this section must be accompanied
- by the Installation Information.  But this requirement does not apply
- if neither you nor any third party retains the ability to install
- modified object code on the User Product (for example, the work has
- been installed in ROM).
- .
-   The requirement to provide Installation Information does not include a
- requirement to continue to provide support service, warranty, or updates
- for a work that has been modified or installed by the recipient, or for
- the User Product in which it has been modified or installed.  Access to a
- network may be denied when the modification itself materially and
- adversely affects the operation of the network or violates the rules and
- protocols for communication across the network.
- .
-   Corresponding Source conveyed, and Installation Information provided,
- in accord with this section must be in a format that is publicly
- documented (and with an implementation available to the public in
- source code form), and must require no special password or key for
- unpacking, reading or copying.
- .
-   7. Additional Terms.
- .
-   "Additional permissions" are terms that supplement the terms of this
- License by making exceptions from one or more of its conditions.
- Additional permissions that are applicable to the entire Program shall
- be treated as though they were included in this License, to the extent
- that they are valid under applicable law.  If additional permissions
- apply only to part of the Program, that part may be used separately
- under those permissions, but the entire Program remains governed by
- this License without regard to the additional permissions.
- .
-   When you convey a copy of a covered work, you may at your option
- remove any additional permissions from that copy, or from any part of
- it.  (Additional permissions may be written to require their own
- removal in certain cases when you modify the work.)  You may place
- additional permissions on material, added by you to a covered work,
- for which you have or can give appropriate copyright permission.
- .
-   Notwithstanding any other provision of this License, for material you
- add to a covered work, you may (if authorized by the copyright holders of
- that material) supplement the terms of this License with terms:
- .
-     a) Disclaiming warranty or limiting liability differently from the
-     terms of sections 15 and 16 of this License; or
- .
-     b) Requiring preservation of specified reasonable legal notices or
-     author attributions in that material or in the Appropriate Legal
-     Notices displayed by works containing it; or
- .
-     c) Prohibiting misrepresentation of the origin of that material, or
-     requiring that modified versions of such material be marked in
-     reasonable ways as different from the original version; or
- .
-     d) Limiting the use for publicity purposes of names of licensors or
-     authors of the material; or
- .
-     e) Declining to grant rights under trademark law for use of some
-     trade names, trademarks, or service marks; or
- .
-     f) Requiring indemnification of licensors and authors of that
-     material by anyone who conveys the material (or modified versions of
-     it) with contractual assumptions of liability to the recipient, for
-     any liability that these contractual assumptions directly impose on
-     those licensors and authors.
- .
-   All other non-permissive additional terms are considered "further
- restrictions" within the meaning of section 10.  If the Program as you
- received it, or any part of it, contains a notice stating that it is
- governed by this License along with a term that is a further
- restriction, you may remove that term.  If a license document contains
- a further restriction but permits relicensing or conveying under this
- License, you may add to a covered work material governed by the terms
- of that license document, provided that the further restriction does
- not survive such relicensing or conveying.
- .
-   If you add terms to a covered work in accord with this section, you
- must place, in the relevant source files, a statement of the
- additional terms that apply to those files, or a notice indicating
- where to find the applicable terms.
- .
-   Additional terms, permissive or non-permissive, may be stated in the
- form of a separately written license, or stated as exceptions;
- the above requirements apply either way.
- .
-   8. Termination.
- .
-   You may not propagate or modify a covered work except as expressly
- provided under this License.  Any attempt otherwise to propagate or
- modify it is void, and will automatically terminate your rights under
- this License (including any patent licenses granted under the third
- paragraph of section 11).
- .
-   However, if you cease all violation of this License, then your
- license from a particular copyright holder is reinstated (a)
- provisionally, unless and until the copyright holder explicitly and
- finally terminates your license, and (b) permanently, if the copyright
- holder fails to notify you of the violation by some reasonable means
- prior to 60 days after the cessation.
- .
-   Moreover, your license from a particular copyright holder is
- reinstated permanently if the copyright holder notifies you of the
- violation by some reasonable means, this is the first time you have
- received notice of violation of this License (for any work) from that
- copyright holder, and you cure the violation prior to 30 days after
- your receipt of the notice.
- .
-   Termination of your rights under this section does not terminate the
- licenses of parties who have received copies or rights from you under
- this License.  If your rights have been terminated and not permanently
- reinstated, you do not qualify to receive new licenses for the same
- material under section 10.
- .
-   9. Acceptance Not Required for Having Copies.
- .
-   You are not required to accept this License in order to receive or
- run a copy of the Program.  Ancillary propagation of a covered work
- occurring solely as a consequence of using peer-to-peer transmission
- to receive a copy likewise does not require acceptance.  However,
- nothing other than this License grants you permission to propagate or
- modify any covered work.  These actions infringe copyright if you do
- not accept this License.  Therefore, by modifying or propagating a
- covered work, you indicate your acceptance of this License to do so.
- .
-   10. Automatic Licensing of Downstream Recipients.
- .
-   Each time you convey a covered work, the recipient automatically
- receives a license from the original licensors, to run, modify and
- propagate that work, subject to this License.  You are not responsible
- for enforcing compliance by third parties with this License.
- .
-   An "entity transaction" is a transaction transferring control of an
- organization, or substantially all assets of one, or subdividing an
- organization, or merging organizations.  If propagation of a covered
- work results from an entity transaction, each party to that
- transaction who receives a copy of the work also receives whatever
- licenses to the work the party's predecessor in interest had or could
- give under the previous paragraph, plus a right to possession of the
- Corresponding Source of the work from the predecessor in interest, if
- the predecessor has it or can get it with reasonable efforts.
- .
-   You may not impose any further restrictions on the exercise of the
- rights granted or affirmed under this License.  For example, you may
- not impose a license fee, royalty, or other charge for exercise of
- rights granted under this License, and you may not initiate litigation
- (including a cross-claim or counterclaim in a lawsuit) alleging that
- any patent claim is infringed by making, using, selling, offering for
- sale, or importing the Program or any portion of it.
- .
-   11. Patents.
- .
-   A "contributor" is a copyright holder who authorizes use under this
- License of the Program or a work on which the Program is based.  The
- work thus licensed is called the contributor's "contributor version".
- .
-   A contributor's "essential patent claims" are all patent claims
- owned or controlled by the contributor, whether already acquired or
- hereafter acquired, that would be infringed by some manner, permitted
- by this License, of making, using, or selling its contributor version,
- but do not include claims that would be infringed only as a
- consequence of further modification of the contributor version.  For
- purposes of this definition, "control" includes the right to grant
- patent sublicenses in a manner consistent with the requirements of
- this License.
- .
-   Each contributor grants you a non-exclusive, worldwide, royalty-free
- patent license under the contributor's essential patent claims, to
- make, use, sell, offer for sale, import and otherwise run, modify and
- propagate the contents of its contributor version.
- .
-   In the following three paragraphs, a "patent license" is any express
- agreement or commitment, however denominated, not to enforce a patent
- (such as an express permission to practice a patent or covenant not to
- sue for patent infringement).  To "grant" such a patent license to a
- party means to make such an agreement or commitment not to enforce a
- patent against the party.
- .
-   If you convey a covered work, knowingly relying on a patent license,
- and the Corresponding Source of the work is not available for anyone
- to copy, free of charge and under the terms of this License, through a
- publicly available network server or other readily accessible means,
- then you must either (1) cause the Corresponding Source to be so
- available, or (2) arrange to deprive yourself of the benefit of the
- patent license for this particular work, or (3) arrange, in a manner
- consistent with the requirements of this License, to extend the patent
- license to downstream recipients.  "Knowingly relying" means you have
- actual knowledge that, but for the patent license, your conveying the
- covered work in a country, or your recipient's use of the covered work
- in a country, would infringe one or more identifiable patents in that
- country that you have reason to believe are valid.
- .
-   If, pursuant to or in connection with a single transaction or
- arrangement, you convey, or propagate by procuring conveyance of, a
- covered work, and grant a patent license to some of the parties
- receiving the covered work authorizing them to use, propagate, modify
- or convey a specific copy of the covered work, then the patent license
- you grant is automatically extended to all recipients of the covered
- work and works based on it.
- .
-   A patent license is "discriminatory" if it does not include within
- the scope of its coverage, prohibits the exercise of, or is
- conditioned on the non-exercise of one or more of the rights that are
- specifically granted under this License.  You may not convey a covered
- work if you are a party to an arrangement with a third party that is
- in the business of distributing software, under which you make payment
- to the third party based on the extent of your activity of conveying
- the work, and under which the third party grants, to any of the
- parties who would receive the covered work from you, a discriminatory
- patent license (a) in connection with copies of the covered work
- conveyed by you (or copies made from those copies), or (b) primarily
- for and in connection with specific products or compilations that
- contain the covered work, unless you entered into that arrangement,
- or that patent license was granted, prior to 28 March 2007.
- .
-   Nothing in this License shall be construed as excluding or limiting
- any implied license or other defenses to infringement that may
- otherwise be available to you under applicable patent law.
- .
-   12. No Surrender of Others' Freedom.
- .
-   If conditions are imposed on you (whether by court order, agreement or
- otherwise) that contradict the conditions of this License, they do not
- excuse you from the conditions of this License.  If you cannot convey a
- covered work so as to satisfy simultaneously your obligations under this
- License and any other pertinent obligations, then as a consequence you may
- not convey it at all.  For example, if you agree to terms that obligate you
- to collect a royalty for further conveying from those to whom you convey
- the Program, the only way you could satisfy both those terms and this
- License would be to refrain entirely from conveying the Program.
- .
-   13. Use with the GNU Affero General Public License.
- .
-   Notwithstanding any other provision of this License, you have
- permission to link or combine any covered work with a work licensed
- under version 3 of the GNU Affero General Public License into a single
- combined work, and to convey the resulting work.  The terms of this
- License will continue to apply to the part which is the covered work,
- but the special requirements of the GNU Affero General Public License,
- section 13, concerning interaction through a network will apply to the
- combination as such.
- .
-   14. Revised Versions of this License.
- .
-   The Free Software Foundation may publish revised and/or new versions of
- the GNU General Public License from time to time.  Such new versions will
- be similar in spirit to the present version, but may differ in detail to
- address new problems or concerns.
- .
-   Each version is given a distinguishing version number.  If the
- Program specifies that a certain numbered version of the GNU General
- Public License "or any later version" applies to it, you have the
- option of following the terms and conditions either of that numbered
- version or of any later version published by the Free Software
- Foundation.  If the Program does not specify a version number of the
- GNU General Public License, you may choose any version ever published
- by the Free Software Foundation.
- .
-   If the Program specifies that a proxy can decide which future
- versions of the GNU General Public License can be used, that proxy's
- public statement of acceptance of a version permanently authorizes you
- to choose that version for the Program.
- .
-   Later license versions may give you additional or different
- permissions.  However, no additional obligations are imposed on any
- author or copyright holder as a result of your choosing to follow a
- later version.
- .
-   15. Disclaimer of Warranty.
- .
-   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
- APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
- HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
- OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
- THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
- IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
- ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
- .
-   16. Limitation of Liability.
- .
-   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
- WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
- THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
- GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
- USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
- DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
- PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
- EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
- SUCH DAMAGES.
- .
-   17. Interpretation of Sections 15 and 16.
- .
-   If the disclaimer of warranty and limitation of liability provided
- above cannot be given local legal effect according to their terms,
- reviewing courts shall apply local law that most closely approximates
- an absolute waiver of all civil liability in connection with the
- Program, unless a warranty or assumption of liability accompanies a
- copy of the Program in return for a fee.
- .
-                      END OF TERMS AND CONDITIONS
- .
-             How to Apply These Terms to Your New Programs
- .
-   If you develop a new program, and you want it to be of the greatest
- possible use to the public, the best way to achieve this is to make it
- free software which everyone can redistribute and change under these terms.
- .
-   To do so, attach the following notices to the program.  It is safest
- to attach them to the start of each source file to most effectively
- state the exclusion of warranty; and each file should have at least
- the "copyright" line and a pointer to where the full notice is found.
- .
-     <one line to give the program's name and a brief idea of what it does.>
-     Copyright (C) <year>  <name of author>
- .
-     This program is free software: you can redistribute it and/or modify
-     it under the terms of the GNU General Public License as published by
-     the Free Software Foundation, either version 3 of the License, or
-     (at your option) any later version.
- .
-     This program is distributed in the hope that it will be useful,
-     but WITHOUT ANY WARRANTY; without even the implied warranty of
-     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-     GNU General Public License for more details.
- .
-     You should have received a copy of the GNU General Public License
-     along with this program.  If not, see <http://www.gnu.org/licenses/>.
- .
- Also add information on how to contact you by electronic and paper mail.
- .
-   If the program does terminal interaction, make it output a short
- notice like this when it starts in an interactive mode:
- .
-     <program>  Copyright (C) <year>  <name of author>
-     This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
-     This is free software, and you are welcome to redistribute it
-     under certain conditions; type `show c' for details.
- .
- The hypothetical commands `show w' and `show c' should show the appropriate
- parts of the General Public License.  Of course, your program's commands
- might be different; for a GUI interface, you would use an "about box".
- .
-   You should also get your employer (if you work as a programmer) or school,
- if any, to sign a "copyright disclaimer" for the program, if necessary.
- For more information on this, and how to apply and follow the GNU GPL, see
- <http://www.gnu.org/licenses/>.
- .
-   The GNU General Public License does not permit incorporating your program
- into proprietary programs.  If your program is a subroutine library, you
- may consider it more useful to permit linking proprietary applications with
- the library.  If this is what you want to do, use the GNU Lesser General
- Public License instead of this License.  But first, please read
- <http://www.gnu.org/philosophy/why-not-lgpl.html>.

debian/extra/meli.desktop

@@ -1,8 +0,0 @@
-[Desktop Entry]
-Name=meli
-Exec=meli
-Categories=Office;Network;Email;
-Comment=Terminal mail client
-NoDisplay=false
-Terminal=true
-Type=Application

debian/meli.bug-presubj

@@ -1,7 +0,0 @@
-WARNING: This package is not distributed by debian, it was generated from the source repository of meli.
-
-Please do not report bugs to debian, but to the appropriate issue tracker for meli:
-
-- https://git.meli-email.org/meli/meli/issues
-- Send e-mail to the mailing list, "meli general" <meli-general@meli-email.org>
-  https://lists.meli-email.org/list/meli-general/

debian/meli.bug-script

@@ -1,9 +0,0 @@
-#!/bin/sh
-
-echo "Including output of \`meli -v\` and \`meli compiled-with\`..."
-
-LC_ALL=C meli -v >&3
-
-echo "\nEnabled compile-time features"
-echo "-----------------------------"
-LC_ALL=C meli compiled-with >&3 || true

debian/meli.doc-base

@@ -1,5 +0,0 @@
-Document: meli
-Title: meli E-mail Client Manual
-Author: Various
-Abstract: Manual for meli the terminal e-mail client.
-Section: Network/Communication

debian/meli.docs

@@ -1,4 +0,0 @@
-meli/docs/meli.1
-meli/docs/meli.7
-meli/docs/meli.conf.5
-meli/docs/meli-themes.5

debian/meli.examples

@@ -1,2 +0,0 @@
-meli/docs/samples/sample-config.toml
-meli/docs/samples/themes

debian/patches/fix-prefix-for-debian.patch

@@ -1,16 +0,0 @@
-Description: Fix PREFIX env var in Makefile for use in Debian
-Author: Manos Pitsidianakis <epilys@nessuent.xyz>
-Last-Update: 2023-03-06
-Index: meli/Makefile
-===================================================================
---- meli.orig/Makefile
-+++ meli/Makefile
-@@ -20,7 +20,7 @@
- .SUFFIXES:
- 
- # Options
--PREFIX ?= /usr/local
-+PREFIX ?= /usr
- EXPANDED_PREFIX := `cd ${PREFIX} && pwd -P`
- BINDIR ?= ${EXPANDED_PREFIX}/bin
- MANDIR ?= ${EXPANDED_PREFIX}/share/man

debian/patches/series

@@ -1,2 +0,0 @@
-fix-prefix-for-debian.patch
-usr_bin_editor.patch

debian/patches/usr_bin_editor.patch

@@ -1,23 +0,0 @@
-From: Manos Pitsidianakis <manos@pitsidianak.is>
-Date: Thu, 27 Feb 2014 16:06:15 +0100
-Subject: usr_bin_editor
-
-If EDITOR or VISUAL is not set, fall back to /usr/bin/editor,
-which is set by update-alternatives.
----
- meli/src/subcommands.rs | 1 +---
- 1 file changed, 1 insertion(+), 3 deletions(-)
-
---- a/meli/src/subcommands.rs
-+++ b/meli/src/subcommands.rs
-@@ -52,9 +52,7 @@
- pub fn edit_config() -> Result<()> {
-     let editor = std::env::var("EDITOR")
-         .or_else(|_| std::env::var("VISUAL"))
--        .map_err(|err| {
--            format!("Could not find any value in environment variables EDITOR and VISUAL. {err}")
--        })?;
-+        .unwrap_or_else(|_| "/usr/bin/editor".into());
-     let config_path = crate::conf::get_config_file()?;
- 
-     let mut cmd = Command::new(editor);

debian/rules

@@ -1,23 +0,0 @@
-#!/usr/bin/make -f
-# You must remove unused comment lines for the released package.
-export RUSTUP_HOME=${HOME}/.rustup
-export DH_VERBOSE = 1
-#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
-#export DEB_CFLAGS_MAINT_APPEND  = -Wall -pedantic
-#export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
-#export MELI_FEATURES = cli-docs sqlite3
-
-%:
-	dh $@  --with quilt
-
-override_dh_auto_configure:
-	true
-
-override_dh_auto_test:
-	true
-
-#override_dh_auto_install:
-#	dh_auto_install -- prefix=/usr
-
-#override_dh_install:
-#	dh_install --list-missing -X.pyc -X.pyo

debian/source/format

@@ -1 +0,0 @@
-3.0 (quilt)

debian/source/local-options

@@ -1,2 +0,0 @@
-#abort-on-upstream-changes
-unapply-patches

debug_printer/Cargo.toml

@@ -0,0 +1,17 @@
+[package]
+name = "debug_printer"
+version = "0.0.1"  #:version
+authors = ["Manos Pitsidianakis <el13635@mail.ntua.gr>"]
+workspace = ".."
+edition = "2018"
+
+[lib]
+name = "debugprinter"
+crate-type = ["dylib"]
+path = "src/lib.rs"
+
+
+[dependencies]
+libc = {version = "0.2.55", features = ["extra_traits",] }
+melib = { path = "../melib", version = "*" }
+ui = { path = "../ui", version = "*" }

debug_printer/src/lib.rs

@@ -0,0 +1,44 @@
+extern crate libc;
+extern crate melib;
+
+use melib::Envelope;
+use std::ffi::CString;
+use std::os::raw::c_char;
+
+#[no_mangle]
+pub extern "C" fn print_envelope(ptr: *const Envelope) -> *const c_char {
+    unsafe {
+        assert!(!ptr.is_null(), "Null pointer in print_envelope");
+        //println!("got addr {}", p as u64);
+        //unsafe { CString::new("blah".to_string()).unwrap().as_ptr() }
+        let s = CString::new(format!("{:?}", *ptr)).unwrap();
+        drop(ptr);
+        let p = s.as_ptr();
+        std::mem::forget(s);
+        p
+    }
+}
+
+#[no_mangle]
+pub extern "C" fn get_empty_envelope() -> *mut Envelope {
+    let mut ret = Envelope::default();
+    let ptr = std::ptr::NonNull::new(&mut ret as *mut Envelope)
+        .expect("Envelope::default() has a NULL pointer?");
+
+    let ptr = ptr.as_ptr();
+    std::mem::forget(ret);
+    ptr
+}
+
+#[no_mangle]
+pub extern "C" fn destroy_cstring(ptr: *mut c_char) {
+    unsafe {
+        let slice = CString::from_raw(ptr);
+        drop(slice);
+    }
+}
+
+#[no_mangle]
+pub extern "C" fn envelope_size() -> libc::size_t {
+    std::mem::size_of::<Envelope>()
+}

fuzz/.gitignore

@@ -1,4 +0,0 @@
-
-target
-corpus
-artifacts

fuzz/Cargo.toml

@@ -1,21 +0,0 @@
-[package]
-name = "melib-fuzz"
-version = "0.0.0"
-authors = ["Automatically generated"]
-publish = false
-edition = "2018"
-
-[package.metadata]
-cargo-fuzz = true
-
-[[bin]]
-name = "envelope_parse"
-path = "fuzz_targets/envelope_parse.rs"
-
-[dependencies]
-libfuzzer-sys = "0.3"
-melib = { path = "../melib" }
-
-# Prevent this from interfering with workspaces
-[workspace]
-members = ["."]

fuzz/envelope_tokens.dict

@@ -1,25 +0,0 @@
-","
-";"
-"<"
-">"
-"@"
-":"
-# tab character
-"\x09"
-# new line character
-"\x0A"
-"  "
-"Subject: "
-"Subject"
-"To"
-"To: "
-"Date"
-"Date: "
-"Message-Id"
-"Message-Id: "
-"From"
-"From: "
-"Cc"
-"Cc: "
-"Bcc"
-"Bcc: "

fuzz/fuzz_targets/envelope_parse.rs

@@ -1,11 +0,0 @@
-#![no_main]
-use libfuzzer_sys::fuzz_target;
-
-extern crate melib;
-
-use melib::Envelope;
-
-fuzz_target!(|data: &[u8]| {
-    // fuzzed code goes here
-    let _envelope = Envelope::from_bytes(data, None);
-});

meli.1

@@ -0,0 +1,460 @@
+.\" meli - meli.1
+.\"
+.\" Copyright 2017-2019 Manos Pitsidianakis
+.\"
+.\" This file is part of meli.
+.\"
+.\" meli is free software: you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" meli is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
+.\"
+.Dd July 29, 2019
+.Dt MELI 1
+.Os
+.Sh NAME
+.Nm meli
+.Nd Meli Mail User Agent. meli is the Greek word for honey
+.Sh SYNOPSIS
+.Nm
+.Op Fl -help | h
+.Op Fl -version | v
+.Op Fl -create-config Op Ar path
+.Op Fl -test-config Op Ar path
+.Op Fl -config Ar path
+.Sh DESCRIPTION
+Experimental terminal mail client
+.Bl -tag -width flag -offset indent
+.It Fl -help, h
+Show help message and exit.
+.It Fl -version, v
+Show version and exit.
+.It Fl -create-config Op Ar path
+Create configuration file in
+.Pa path
+if given, or at
+.Pa $XDG_CONFIG_HOME/meli/config
+.It Fl -test-config Op Ar path
+Test a configuration file for syntax issues or missing options.
+.It Fl -config Ar path
+Start meli with given configuration file.
+.El
+.Sh STARTING WITH meli
+When launched for the first time,
+.Nm
+will search for its configuration directory,
+.Pa $XDG_CONFIG_HOME/meli/ Ns
+\&. If it doesn't exist, you will be asked if you want to create one along with a sample configuration. The sample configuration
+.Pa $XDG_CONFIG_HOME/meli/config
+includes comments with the basic settings required for setting up accounts allowing you to copy and edit right away. See
+.Xr meli.conf 5
+for the available configuration options.
+.Pp
+At any time, you may press
+.Cm \&?
+to show a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
+.Pp
+The main visual navigation tool is the left-side sidebar. The menu's visibility may be toggled with 
+.Cm ` 
+(shortcuts.listing: 
+.Ic toggle_menu_visibility Ns
+).
+.Pp
+The view into each folder has 4 modes: plain, threaded, conversations and compact. Plain views each mail indvidually, threaded shows their thread relationship visually, and conversations includes one entry per thread of emails (compact is one row per thread).
+.Pp
+If you're using a light color palette in your terminal, you may set
+.Em theme = "light"
+in the
+.Em terminal
+section of your configuration.
+.Bd -literal
+         ^^      .-=-=-=-.  ^^
+     ^^        (`-=-=-=-=-`)         ^^
+             (`-=-=-=-=-=-=-`)  ^^         ^^
+       ^^   (`-=-=-=-=-=-=-=-`)   ^^
+           ( `-=-=-=-(@)-=-=-` )      ^^
+           (`-=-=-=-=-=-=-=-=-`)  ^^
+           (`-=-=-=-=-=-=-=-=-`)          ^^
+           (`-=-=-=-=-=-=-=-=-`)
+    ^^     (`-=-=-=-=-=-=-=-=-`)  ^^
+       ^^   (`-=-=-=-=-=-=-=-`)          ^^
+             (`-=-=-=-=-=-=-`)  ^^
+      ^^       (`-=-=-=-=-`)
+                `-=-=-=-=-`          ^^
+.Ed
+.Sh VIEWING MAIL
+Open attachments by typing their index in the attachments list and then
+.Cm a Ns
+\&.
+.Ns
+.Nm
+will attempt to open text inside its pager and other content via
+.Cm xdg-open Ns
+\&. Press
+.Cm m
+instead to use the mailcap entry for the MIME type of the attachment, if any. See
+.Sx FILES
+for the location of the mailcap files and
+.Xr mailcap 5
+for their syntax.
+.Sh SEARCH
+Each e-mail storage backend has its default search method.
+.Em IMAP
+uses the SEARCH command,
+.Em notmuch
+uses libnotmuch and
+.Em Maildir/mbox
+have to do a slow linear search. Thus it is advised to use a cache on
+.Em Maildir/mbox
+accounts.
+.Nm Ns
+, if built with sqlite3, includes the ability to perform full text search on the following fields: From, To, Cc, Bcc, In-Reply-To, References, Subject and Date. The message body (in plain text human readable form) and the flags can also be queried. To enable sqlite3 indexing for an account set
+.Em cache_type
+to
+.Em sqlite3
+in the configuration file and to create the sqlite3 index issue command
+.Cm index Ar ACCOUNT_NAME Ns \&.
+
+To search in the message body type your keywords without any special formatting.
+To search in specific fields, prepend your search keyword with "field:" like so:
+.Pp
+.D1 subject:helloooo or subject:\&"call for help\&" or \&"You remind me today of a small, Mexican chihuahua.\&"
+.Pp
+.D1 not ((from:unrealistic and (to:complex or not "query")) or flags:seen,draft)
+.Pp
+.D1 alladdresses:mailing@list.tld and cc:me@domain.tld
+.Pp
+Boolean operators are
+.Em or Ns
+,
+.Em and
+and
+.Em not
+.Po
+alias:
+.Em \&!
+.Pc
+String keywords with spaces must be quoted. Quotes should always be escaped.
+.sp
+.Sy Important Notice about IMAP
+.sp
+To prevent downloading all your messages from your IMAP server, don't set
+.Em cache_type
+to
+.Em sqlite3 Ns
+\&.
+.Nm
+will relay your queries to the IMAP server. Expect a delay between query and response. Sqlite3 on the contrary at reasonable mailbox sizes should have a non noticable delay.
+.Sh COMPOSING
+To send mail, press
+.Cm m
+while viewing the appropriate account to open a new composing tab. To reply to a mail, press
+.Cm R Ns
+\&. You may edit some of the header fields from within the view, by selecting with the arrow keys and pressing
+.Cm enter
+to enter
+.Ar INSERT
+mode. At any time you may press
+.Cm e
+to launch your editor (see
+.Xr meli.conf 5 COMPOSING Ns
+, setting
+.Ic editor_cmd
+for how to select which editor to launch). Attachments may be handled with the
+.Em add-attachment Ns
+,
+.Em remove-attachment
+commands (see below). Finally, pressing
+.Cm s
+will send your message by piping it into a binary of your choosing (see
+.Xr meli.conf 5 COMPOSING Ns
+, setting
+.Ic mailer_cmd Ns
+). To save your draft without sending it, issue command
+.Cm close
+and select 'save as draft'.
+.Pp
+With no Draft or Sent folder,
+.Nm
+tries first saving mail in your INBOX and then at any other folder. On complete failure to save your draft or sent message it will be saved in your
+.Em tmp
+directory instead and you will be notified of its location.
+.Pp
+To open a draft for editing later, select your draft in the mail listing and press
+.Cm e Ns
+\&.
+
+Your editor can be used in
+.Nm Ns
+\&'s embed terminal emulator by setting
+.Ic embed
+to
+.Em true
+in your composing settings. When launched, your editor captures all input until it exits or stops. To stop your editor and return to
+.Nm
+issue Ctrl-z and to resume editing press the
+.Ic edit_mail
+command again (default
+.Em e Ns
+).
+.Sh CONTACTS
+.Nm
+supports two kinds of contact backends:
+
+.Bl -enum -compact -offset indent
+.It
+an internal format that gets saved under
+.Pa $XDG_DATA_HOME/meli/account_name/addressbook Ns
+\&.
+.It
+vCard files (v3, v4) through the
+.Ic vcard_folder
+option in the account section. The path defined as
+.Ic vcard_folder
+can hold multiple vCards per file. They are loaded read only.
+.El
+
+See
+.Xr meli.conf 5 ACCOUNTS
+for the complete account configuration values.
+.Sh EXECUTE mode
+Commands are issued in EXECUTE mode, by default started with Space and exited with Escape key.
+.Pp
+the following commands are valid in the mail listing context:
+.Bl -tag -width 36n
+.It Cm set Ar plain | threaded | compact | conversations
+set the way mailboxes are displayed
+.El
+.TS
+allbox tab(:);
+lb l.
+conversations:shows one entry per thread
+compact:shows one row per thread
+threaded:shows threads as a tree structure
+plain:shows one row per mail, regardless of threading
+.TE
+.Bl -tag -width 36n
+.It Cm sort Ar subject | date \  Ar asc | desc
+sort mail listing
+.It Cm subsort Ar subject | date \  Ar asc | desc
+sorts only the first level of replies.
+.It Cm go Ar n
+where
+.Ar n
+is a mailbox prefixed with the
+.Ar n
+number in the side menu for the current account
+.It Cm toggle_thread_snooze
+don't issue notifications for thread under cursor in thread listing
+.It Cm filter Ar STRING
+filter mailbox with
+.Ar STRING
+key. Escape exits filter results
+.It Cm set read, set unread
+.It Cm create-folder Ar ACCOUNT Ar FOLDER_PATH
+create folder with given path. be careful with backends and separator sensitivity (eg IMAP)
+.It Cm subscribe-folder Ar ACCOUNT Ar FOLDER_PATH
+subscribe to folder with given path
+.It Cm unsubscribe-folder Ar ACCOUNT Ar FOLDER_PATH
+unsubscribe to folder with given path
+.It Cm rename-folder Ar ACCOUNT Ar FOLDER_PATH_SRC Ar FOLDER_PATH_DEST
+rename folder
+.It Cm delete-folder Ar ACCOUNT Ar FOLDER_PATH
+delete folder
+.El
+.Pp
+envelope view commands:
+.Bl -tag -width 36n
+.It Cm pipe Ar EXECUTABLE Ar ARGS
+pipe pager contents to binary
+.It Cm list-post
+post in list of viewed envelope
+.It Cm list-unsubscribe
+unsubscribe automatically from list of viewed envelope
+.It Cm list-archive
+open list archive with
+.Cm xdg-open
+.El
+.Pp
+composing mail commands:
+.Bl -tag -width 36n
+.It Cm add-attachment Ar PATH
+in composer, add
+.Ar PATH
+as an attachment
+.It Cm remove-attachment Ar INDEX
+remove attachment with given index
+.It Cm toggle sign
+toggle between signing and not signing this message. If the gpg invocation fails then the mail won't be sent.
+.El
+.Pp
+generic commands:
+.Bl -tag -width 36n
+.It Cm open-in-tab
+opens envelope view in new tab
+.It Cm close
+closes closeable tabs
+.It Cm setenv Ar KEY=VALUE
+set environment variable
+.Ar KEY
+to
+.Ar VALUE
+.It Cm printenv Ar KEY
+print environment variable
+.Ar KEY
+.El
+.Sh SHORTCUTS
+Non-complete list of shortcuts and their default values.
+.Bl -tag -width 36n
+.It Ic open_thread
+\&'\\n'
+.It Ic exit_thread
+\&'i'
+.It Ic create_contact
+\&'c'
+.It Ic edit_contact
+\&'e'
+.It Ic prev_page
+PageUp,
+.It Ic next_page
+PageDown
+.It Ic prev_folder
+\&'K'
+.It Ic next_folder
+\&'J'
+.It Ic prev_account
+\&'l'
+.It Ic next_account
+\&'h'
+.It Ic new_mail
+\&'m'
+.It Ic scroll_up
+\&'k'
+.It Ic scroll_down
+\&'j'
+.It Ic page_up
+PageUp
+.It Ic page_down
+PageDown
+.It Ic toggle-menu-visibility
+\&'`'
+.It Ic select
+\&'v'
+.It Ic `
+toggles hiding of sidebar in mail listings
+.It Ic \&?
+opens up a shortcut window that shows available actions in the current component you are using (eg mail listing, contact list, mail composing)
+.It Ic m
+starts a new mail composer
+.It Ic R
+replies to the viewed mail.
+.It Ic u
+displays numbers next to urls in the body text of an email and
+.Ar n Ns Ic g
+opens the
+.Ar n Ns
+th
+url with xdg-open
+.It Ar n Ns Ic a
+opens the
+.Ar n Ns
+th
+attachment.
+.It Ar n Ns Ic m
+opens the
+.Ar n Ns
+th
+attachment according to its mailcap entry.
+.It Ic v
+(un)selects mail entries in mail listings
+.El
+.Sh EXIT STATUS
+.Nm
+exits with 0 on a successful run. Other exit statuses are:
+.Bl -tag -width 2n
+.It 1
+catchall for general errors
+.El
+.Sh ENVIRONMENT
+.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
+.It Ev EDITOR
+Specifies the editor to use
+.It Ev MELI_CONFIG
+Override the configuration file
+.El
+.Sh FILES
+.Nm
+uses the following parts of the XDG standard:
+.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
+.It Ev XDG_CONFIG_HOME
+defaults to
+.Pa ~/.config/
+.It Ev XDG_CACHE_HOME
+defaults to
+.Pa ~/.cache/
+.El
+.Pp
+and appropriates the following locations:
+.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
+.It Pa $XDG_CONFIG_HOME/meli/
+User configuration directory.
+.It Pa $XDG_CONFIG_HOME/meli/config
+User configuration file. See
+.Xr meli.conf 5
+for its syntax and values.
+.It Pa $XDG_CONFIG_HOME/meli/hooks/*
+Reserved for event hooks.
+.It Pa $XDG_CONFIG_HOME/meli/plugins/*
+Reserved for plugin files.
+.It Pa $XDG_CACHE_HOME/meli/*
+Internal cached data used by meli.
+.It Pa $XDG_DATA_HOME/meli/*
+Internal data used by meli.
+.It Pa $XDG_DATA_HOME/meli/meli.log
+Operation log.
+.It Pa /tmp/meli/*
+Temporary files generated by
+.Nm Ns
+\&.
+.El
+.Pp
+Mailcap entries are searched for in the following files, in this order:
+.Pp
+.Bl -enum -compact -offset indent
+.It
+.Pa $XDG_CONFIG_HOME/meli/mailcap
+.It
+.Pa $XDG_CONFIG_HOME/.mailcap
+.It
+.Pa $HOME/.mailcap
+.It
+.Pa /etc/mailcap
+.It
+.Pa /usr/etc/mailcap
+.It
+.Pa /usr/local/etc/mailcap
+.El
+.Sh SEE ALSO
+.Xr meli.conf 5 ,
+.Xr xdg-open 1 ,
+.Xr mailcap 5
+.Sh CONFORMING TO
+XDG Standard
+.Aq https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html Ns
+, maildir
+.Aq https://cr.yp.to/proto/maildir.html Ns
+, IMAPv4rev1 RFC3501.
+.Sh AUTHORS
+Copyright 2017-2019
+.An Manos Pitsidianakis Aq epilys@nessuent.xyz
+Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)
+.Pp
+.Aq https://meli.delivery

meli.conf.5

@@ -0,0 +1,590 @@
+.\" meli - meli.1
+.\"
+.\" Copyright 2017-2019 Manos Pitsidianakis
+.\"
+.\" This file is part of meli.
+.\"
+.\" meli is free software: you can redistribute it and/or modify
+.\" it under the terms of the GNU General Public License as published by
+.\" the Free Software Foundation, either version 3 of the License, or
+.\" (at your option) any later version.
+.\"
+.\" meli is distributed in the hope that it will be useful,
+.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
+.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+.\" GNU General Public License for more details.
+.\"
+.\" You should have received a copy of the GNU General Public License
+.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
+.\"
+.Dd September 16, 2019
+.Dt MELI.CONF 5
+.Os
+.Sh NAME
+.Nm meli.conf
+.Nd configuration file for the Meli Mail User Agent
+.Sh SYNOPSIS
+.Pa $XDG_CONFIG_HOME/meli/config
+.Sh DESCRIPTION
+Configuration for meli is written in TOML. Few things to consider before writing TOML (quoting the spec):
+.Pp
+.Bl -bullet -compact
+.It
+TOML is case sensitive.
+.It
+A TOML file must be a valid UTF-8 encoded Unicode document.
+.It
+Whitespace means tab (0x09) or space (0x20).
+.It
+Newline means LF (0x0A) or CRLF (0x0D 0x0A).
+.El
+.Pp
+Refer to TOML documentation for valid TOML syntax.
+
+Thought not part of TOML syntax,
+.Nm
+can have nested configuration files by using the following include directive, which though starting with
+.Em \&#
+is not a comment:
+.Bd -literal
+#include "/path/to/file"
+.Ed
+
+The accepted regular expression is
+.Li ^\es*include\es*\&\\&\e"(\e\e.|[^\e"])+\e"\es*$
+.Sh SECTIONS
+The top level sections of the config are accounts, shortcuts, notifications, pager, composing, pgp, terminal.
+.Pp
+.Sy example configuration
+.Bd -literal
+# Setting up a Maildir account
+[accounts.account-name]
+root_folder = "/path/to/root/folder"
+format = "Maildir"
+index_style = "Compact"
+identity="email@address.tld"
+subscribed_folders = ["folder", "folder/Sent"] # or [ "*", ] for all folders
+display_name = "Name"
+
+# Set folder-specific settings
+  [accounts.account-name.folders]
+  "INBOX" = { rename="Inbox" } #inline table
+  "drafts" = { rename="Drafts" } #inline table
+  [accounts.account-name.folders."foobar-devel"] # or a regular table
+    ignore = true # don't show notifications for this folder
+
+# Setting up an mbox account
+[accounts.mbox]
+root_folder = "/var/mail/username"
+format = "mbox"
+index_style = "Compact"
+identity="username@hostname.local"
+
+[pager]
+filter = "/usr/bin/pygmentize"
+html_filter = "w3m -I utf-8 -T text/html"
+
+[notifications]
+script = "notify-send"
+
+[composing]
+# required for sending e-mail
+mailer_cmd = 'msmtp --read-recipients --read-envelope-from'
+editor_cmd = 'vim +/^$'
+
+[shortcuts]
+[shortcuts.composing]
+edit_mail = 'e'
+
+[shortcuts.listing]
+new_mail = 'm'
+set_seen = 'n'
+
+[terminal]
+theme = "light"
+.Ed
+.Pp
+available options are listed below.
+.Sy default values are shown in parentheses.
+.Sh ACCOUNTS
+.Bl -tag -width 36n
+.It Ic root_folder Ar String
+the backend-specific path of the root_folder, usually INBOX.
+.It Ic format Ar String Op maildir mbox imap notmuch
+the format of the mail backend.
+.It Ic subscribed_folders Ar [String,]
+an array of folder paths to display in the UI. Paths are relative to the root folder (eg "INBOX/Sent", not "Sent").
+The glob wildcard
+.Em \&*
+can be used to match every folder name and path.
+.It Ic identity Ar String
+your e-mail address that is inserted in the From: headers of outgoing mail
+.It Ic index_style Ar String
+set the way mailboxes are displayed
+.El
+.TS
+allbox tab(:);
+lb l.
+conversations:shows one entry per thread
+compact:shows one row per thread
+threaded:shows threads as a tree structure
+plain:shows one row per mail, regardless of threading
+.TE
+.Bl -tag -width 36n
+.It Ic display_name Ar String
+(optional) a name which can be combined with your address:
+"Name <email@address.tld>"
+.It Ic read_only Ar boolean
+attempt to not make any changes to this account.
+.Pq Em false
+.It Ic cache_type Ar String
+(optional) choose which cache backend to use. Available options are 'none' and 'sqlite3'
+.Pq Em "sqlite3"
+.It Ic vcard_folder Ar String
+(optional) Folder that contains .vcf files. They are parsed and imported read-only.
+.It Ic folders Ar folder_config
+(optional) configuration for each folder. Its format is described below in
+.Sx FOLDERS Ns
+\&.
+.El
+.Sh notmuch only
+.Ic root_folder
+points to the directory which contains the
+.Pa .notmuch/
+subdirectory. notmuch folders are virtual, since they are defined by user-given notmuch queries. Thus you have to explicitly state the folders you want in the
+.Ic folders
+field and set the
+.Ar query
+property to each of them. Example:
+.Bd -literal
+[accounts.notmuch]
+format = "notmuch"
+\&...
+  [accounts.notmuch.folders]
+  "INBOX" = {  query="tag:inbox", subscribe = true }
+  "Drafts" = {  query="tag:draft", subscribe = true }
+  "Sent" = {  query="from:username@server.tld from:username2@server.tld", subscribe = true }
+.Ed
+.Sh IMAP only
+IMAP specific options are:
+.Bl -tag -width 36n
+.It Ic server_hostname Ar String
+example:
+.Qq mail.example.tld
+.It Ic server_username Ar String
+.It Ic server_password Ar String
+.It Ic server_port Ar number
+(optional)
+.\" default value
+.Pq Em 143
+.It Ic use_starttls Ar boolean
+(optional) if port is 993 and use_starttls is unspecified, it becomes false by default.
+.\" default value
+.Pq Em true
+.It Ic danger_accept_invalid_certs Ar boolean
+(optional) do not validate TLS certificates.
+.\" default value
+.Pq Em false
+.El
+.Sh FOLDERS
+.Bl -tag -width 36n
+.It Ic rename Ar String
+(optional) show a different name for this folder in the UI
+.It Ic autoload Ar boolean
+(optional) load this folder on startup (not functional yet)
+.It Ic subscribe Ar boolean
+(optional) watch this folder for updates
+.\" default value
+.Pq Em true
+.It Ic ignore Ar boolean
+(optional) silently insert updates for this folder, if any
+.\" default value
+.Pq Em false
+.It Ic usage Ar boolean
+(optional) special usage of this folder. valid values are:
+.Bl -bullet -compact
+.It
+.Ar Normal
+.It
+.Ar Inbox
+.It
+.Ar Archive
+.It
+.Ar Drafts
+.It
+.Ar Flagged
+.It
+.Ar Junk
+.It
+.Ar Sent
+.It
+.Ar Trash
+.El
+otherwise usage is inferred from the folder title.
+.It Ic conf_override Ar boolean
+(optional) override global settings for this folder. available sections to override are
+.Em pager, notifications, shortcuts, composing
+and the account options
+.Em identity and index_style Ns
+\&. example:
+.Bd -literal
+[accounts."imap.domain.tld".folders."INBOX"]
+  index_style = "plain"
+  [accounts."imap.domain.tld".folders."INBOX".pager]
+    filter = ""
+.Ed
+.El
+.Sh COMPOSING
+.Bl -tag -width 36n
+.It Ic mailer_cmd Ar String
+command to pipe new mail to, exit code must be 0 for success.
+.It Ic editor_cmd Ar String
+command to launch editor. Can have arguments. Draft filename is given as the last argument. If it's missing, the environment variable $EDITOR is looked up.
+.It Ic embed Ar boolean
+(optional) embed editor within meli
+.\" default value
+.Pq Em false
+.It Ic format_flowed Ar boolean
+(optional) set format=flowed [RFC3676] in text/plain attachments.
+.\" default value
+.Pq Em true
+.El
+.Sh SHORTCUTS
+Shortcuts can take the following values:
+.Qq Em Backspace
+.Qq Em Left
+.Qq Em Right
+.Qq Em Up
+.Qq Em Down
+.Qq Em Home
+.Qq Em End
+.Qq Em PageUp
+.Qq Em PageDown
+.Qq Em Delete
+.Qq Em Insert
+.Qq Em Enter
+.Qq Em Tab
+.Qq Em Esc
+.Qq Em F1..F12
+.Qq Em M-char
+.Qq Em C-char
+and
+.Qq Em char Ns
+, where char is a single character string.
+
+The headings before each list indicate the map key of the shortcut list. For example for the first list titled
+.Em general
+the configuration is typed as follows:
+.Bd -literal
+[shortcuts.general]
+next_tab = 'T'
+.Ed
+
+and for
+.Em compact-listing Ns
+:
+.Bd -literal
+[shortcuts.compact-listing]
+open_thread = "Enter"
+exit_thread = 'i'
+.Bd
+
+.Sy Em general
+.Bl -tag -width 36n
+.It Ic next_tab
+Go to next tab.
+.\" default value
+.Pq Em T
+.It Ic go_to_tab
+Go to the 
+.Em n Ns
+th tab
+.Pq Em cannot be redefined
+.El
+
+.Sy Em listing
+.Bl -tag -width 36n
+.It Ic prev_page
+Go to previous page.
+.\" default value
+.Pq Em PageUp
+.It Ic next_page
+Go to next page.
+.\" default value
+.Pq Em PageDown
+.It Ic prev_folder
+Go to previous folder.
+.\" default value
+.Pq Em K
+.It Ic next_folder
+Go to next folder.
+.\" default value
+.Pq Em J
+.It Ic prev_account
+Go to previous account.
+.\" default value
+.Pq Em l
+.It Ic next_account
+Go to next account.
+.\" default value
+.Pq Em h
+.It Ic new_mail
+Start new mail draft in new tab
+.\" default value
+.Pq Em m
+.It Ic search
+Search within list of e-mails.
+.\" default value
+.Pq Em /
+.It Ic toggle_menu_visibility
+Toggle visibility of side menu in mail list.
+.\" default value
+.Pq Em `
+.El
+
+.Sy Em compact-listing
+.Bl -tag -width 36n
+.It Ic exit_thread
+Exit thread view
+.\" default value
+.Pq Em i
+.It Ic open_thread
+Open thread.
+.\" default value
+.Pq Em Enter
+.It Ic select_entry
+Select thread entry.
+.\" default value
+.Pq Em v
+.El
+
+.Sy Em pager
+.Bl -tag -width 36n
+.It Ic scroll_up
+Scroll up pager.
+.\" default value
+.Pq Em k
+.It Ic scroll_down
+Scroll down pager.
+.\" default value
+.Pq Em j
+.It Ic page_up
+Go to previous pager page
+.\" default value
+.Pq Em PageUp
+.It Ic page_down
+Go to next pager pag
+.\" default value
+.Pq Em PageDown
+.El
+
+.Sy Em contact-list
+.Bl -tag -width 36n
+.It Ic create_contact
+Create new contact.
+.\" default value
+.Pq Em c
+.It Ic edit_contact
+Edit contact under cursor
+.\" default value
+.Pq Em e
+.It Ic mail_contact
+Mail contact under cursor
+.\" default value
+.Pq Em m
+.It Ic toggle_menu_visibility
+Toggle visibility of side menu in mail list.
+.\" default value
+.Pq Em `
+.El
+
+
+.Sy Em composing
+.Bl -tag -width 36n
+.It Ic send_mail
+Deliver draft to mailer
+.\" default value
+.Pq Em s
+.It Ic edit_mail
+Edit mail.
+.\" default value
+.Pq Em e
+.El
+
+.Sy Em envelope-view
+
+To "select" an attachment, type its index (you will see the typed result in the command buffer on your bottom right of the status line) and then issue the corresponding command.
+.Bl -tag -width 36n
+.It Ic add_addresses_to_contacts Ns
+Select addresses from envelope to add to contacts.
+.\" default value
+.Pq Em c
+.It Ic view_raw_source
+View raw envelope source in a pager.
+.\" default value
+.Pq Em M-r
+.It Ic reply
+Reply to envelope.
+.\" default value
+.Pq Em R
+.It Ic edit
+Open envelope in composer.
+.\" default value
+.Pq Em e
+.It Ic return_to_normal_view
+Return to envelope if viewing raw source or attachment.
+.\" default value
+.Pq Em r
+.It Ic open_attachment
+Opens selected attachment with 
+.Cm xdg-open
+.\" default value
+.Pq Em a
+.It Ic open_mailcap
+Opens selected attachment according to its mailcap entry. See 
+.Xr meli.1 FILES
+for the mailcap file locations.
+.\" default value
+.Pq Em m
+.It Ic go_to_url
+Go to url of given index
+.\" default value
+.Pq Em g
+.It Ic toggle_url_mode
+Toggles url open mode. When active, it prepends an index next to each url that you can select by typing and open by issuing 
+.Ic go_to_url
+.\" default value
+.Pq Em u
+.It Ic toggle_expand_headers
+Expand extra headers (References and others)
+.\" default value
+.Pq Em h
+.El
+
+.Sy Em thread-view
+.Bl -tag -width 36n
+.It Ic reverse_thread_order
+Reverse thread order.
+.\" default value
+.Pq Em r
+.It Ic toggle_mailview
+Toggle mail view visibility.
+.\" default value
+.Pq Em p
+.It Ic toggle_threadview
+Toggle thread view visibility.
+.\" default value
+.Pq Em t
+.It Ic collapse_subtree
+Collapse thread branches.
+.\" default value
+.Pq Em h
+.It Ic prev_page
+Go to previous page.
+.\" default value
+.Pq Em PageUp
+.It Ic next_page
+Go to next page.
+.\" default value
+.Pq Em PageDown
+.El
+
+.Bl -tag -width 36n
+.Sh NOTIFICATIONS
+.Bl -tag -width 36n
+.It Ic enable Ar boolean
+enable freedesktop-spec notifications. this is usually what you want
+.\" default value
+.Pq Em true
+.It Ic script Ar String
+(optional) script to pass notifications to, with title as 1st arg and body as 2nd
+.\" default value
+.Pq Em none
+.It Ic xbiff_file_path Ar String
+(optional) file that gets its size updated when new mail arrives
+.Pq Em none
+.\" default value
+.It Ic play_sound Ar boolean
+(optional) play theme sound in notifications if possible
+.Pq Em false
+.\" default value
+.It Ic sound_file Ar String
+(optional) play sound file in notifications if possible
+.\" default value
+.Pq Em none
+.El
+.Sh PAGER
+.Bl -tag -width 36n
+.It Ic pager_context Ar num
+(optional) number of context lines when going to next page. (Unimplemented)
+.\" default value
+.Pq Em 0
+.It Ic headers_sticky Ar boolean
+(optional) always show headers when scrolling.
+.\" default value
+.Pq Em true
+.It Ic html_filter Ar String
+(optional) pipe html attachments through this filter before display
+.\" default value
+.Pq Em none
+.It Ic filter Ar String
+(optional) a command to pipe mail output through for viewing in pager.
+.\" default value
+.Pq Em none
+.It Ic format_flowed Ar bool
+(optional) respect format=flowed
+.\" default value
+.Pq Em true
+.It Ic split_long_lines Ar bool
+(optional) Split long lines that would overflow on the x axis.
+.\" default value
+.Pq Em true
+.It Ic minimum_width Ar num
+(optional) Minimum text width in columns.
+.\" default value
+.Pq Em 80
+.El
+.Sh PGP
+.Bl -tag -width 36n
+.It Ic auto_verify_signatures Ar boolean
+auto verify signed e-mail according to RFC3156
+.\" default value
+.Pq Em true
+.It Ic auto_sign Ar boolean
+(optional) always sign sent messages
+.\" default value
+.Pq Em false
+.It Ic key Ar String
+(optional) key to be used when signing/encrypting (not functional yet)
+.\" default value
+.Pq Em none
+.It Ic gpg_binary Ar String
+(optional) gpg binary name or file location to use
+.\" default value
+.Pq Em "gpg2"
+.El
+.Sh TERMINAL
+.Bl -tag -width 36n
+.It Ic theme Ar String
+(optional) select between these themes: light / dark
+.\" default value
+.Pq Em dark
+.It Ic ascii_drawing Ar boolean
+(optional) if true, box drawing will be done with ascii characters.
+.\" default value
+.Pq Em false
+.It Ic window_title Ar String
+(optional) set window title in xterm compatible terminals (empty string means no window title is set)
+.\" default value
+.Pq Em "meli"
+.El
+.Sh SEE ALSO
+.Xr meli 1
+.Sh CONFORMING TO
+TOML Standard v.0.5.0 https://github.com/toml-lang/toml/blob/master/versions/en/toml-v0.5.0.md
+.Sh AUTHORS
+Copyright 2017-2019
+.An Manos Pitsidianakis Aq epilys@nessuent.xyz
+Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)
+.Pp
+.Aq https://meli.delivery

meli/Cargo.toml

@@ -1,91 +0,0 @@
-[package]
-name = "meli"
-version = "0.8.5-rc.3"
-authors = ["Manos Pitsidianakis <manos@pitsidianak.is>"]
-edition = "2021"
-rust-version = "1.68.2"
-license = "GPL-3.0-or-later"
-readme = "README.md"
-description = "terminal e-mail client"
-homepage = "https://meli-email.org"
-repository = "https://git.meli-email.org/meli/meli.git"
-keywords = ["mail", "mua", "maildir", "terminal", "imap"]
-categories = ["command-line-utilities", "email"]
-default-run = "meli"
-
-[[bin]]
-name = "meli"
-path = "src/main.rs"
-
-[lib]
-name = "meli"
-path = "src/lib.rs"
-
-[dependencies]
-async-task = "^4.2.0"
-bitflags = { version = "2.4", features = ["serde"] }
-crossbeam = { version = "^0.8" }
-flate2 = { version = "1", optional = true }
-futures = "0.3.5"
-indexmap = { version = "^1.6", features = ["serde-1"] }
-libc = { version = "0.2.125", default-features = false, features = ["extra_traits"] }
-libz-sys = { version = "1.1", features = ["static"], optional = true }
-linkify = { version = "^0.10", default-features = false }
-melib = { path = "../melib", version = "0.8.5-rc.3", features = [] }
-nix = { version = "0.27", default-features = false, features = ["signal", "poll", "term", "ioctl", "process"] }
-serde = "1.0.71"
-serde_derive = "1.0.71"
-serde_json = "1.0"
-signal-hook = { version = "^0.3", default-features = false, features = ["iterator"] }
-signal-hook-registry = { version = "1.2.0", default-features = false }
-smallvec = { version = "^1.5.0", features = ["serde"] }
-structopt = { version = "0.3.14", default-features = false }
-svg_crate = { version = "^0.13", optional = true, package = "svg" }
-termion = { version = "1.5.1", default-features = false }
-toml = { version = "0.8", default-features = false, features = ["display","preserve_order","parse"] }
-xdg = "2.1.0"
-
-[dependencies.pcre2]
-# An [env] entry in .cargo/config.toml should force a static build instead of
-# looking for a system library.
-version = "0.2.3"
-optional = true
-
-[features]
-default = ["sqlite3", "notmuch", "smtp", "dbus-notifications", "gpgme", "cli-docs", "jmap", "static"]
-notmuch = ["melib/notmuch"]
-jmap = ["melib/jmap"]
-sqlite3 = ["melib/sqlite3"]
-smtp = ["melib/smtp"]
-smtp-trace = ["smtp", "melib/smtp-trace"]
-regexp = ["dep:pcre2"]
-dbus-notifications = ["dep:notify-rust"]
-cli-docs = ["dep:flate2"]
-svgscreenshot = ["dep:svg_crate"]
-gpgme = ["melib/gpgme"]
-# Static / vendoring features.
-tls-static = ["melib/tls-static"]
-http-static = ["melib/http-static"]
-sqlite3-static = ["melib/sqlite3-static"]
-dbus-static = ["dep:notify-rust", "notify-rust?/d_vendored"]
-libz-static = ["dep:libz-sys", "libz-sys?/static"]
-static = ["tls-static", "http-static", "sqlite3-static", "dbus-static", "libz-static"]
-
-# Print tracing logs as meli runs in stderr
-# enable for debug tracing logs: build with --features=debug-tracing and export MELI_DEBUG_STDERR
-debug-tracing = ["melib/debug-tracing"]
-
-[build-dependencies]
-flate2 = { version = "1", optional = true }
-proc-macro2 = "1.0.37"
-quote = "^1.0"
-regex = "1"
-syn = { version = "1", features = [] }
-
-[dev-dependencies]
-flate2 = { version = "1" }
-regex = "1"
-tempfile = "3.3"
-
-[target.'cfg(target_os="linux")'.dependencies]
-notify-rust = { version = "^4", default-features = false, features = ["dbus"], optional = true }

meli/README.md

@@ -1 +0,0 @@
-../README.md

meli/build.rs

@@ -1,85 +0,0 @@
-/*
- * meli - build.rs
- *
- * Copyright 2020  Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-extern crate proc_macro;
-extern crate quote;
-extern crate syn;
-include!("config_macros.rs");
-
-fn main() {
-    println!("cargo:rerun-if-changed=src/conf/.rebuild.overrides.rs");
-    override_derive(&[
-        ("src/conf/pager.rs", "PagerSettings"),
-        ("src/conf/listing.rs", "ListingSettings"),
-        ("src/conf/notifications.rs", "NotificationsSettings"),
-        ("src/conf/shortcuts.rs", "Shortcuts"),
-        ("src/conf/composing.rs", "ComposingSettings"),
-        ("src/conf/tags.rs", "TagsSettings"),
-        ("src/conf/pgp.rs", "PGPSettings"),
-    ]);
-    #[cfg(feature = "cli-docs")]
-    {
-        use flate2::{Compression, GzBuilder};
-        const MANDOC_OPTS: &[&str] = &["-T", "utf8", "-I", "os=Generated by mandoc(1)"];
-        use std::{env, io::prelude::*, path::Path};
-
-        let out_dir = env::var("OUT_DIR").unwrap();
-        let mut out_dir_path = Path::new(&out_dir).to_path_buf();
-
-        let mut cl = |filepath: &str, output: &str, source: bool| {
-            out_dir_path.push(output);
-            let output = if source {
-                std::fs::read_to_string(filepath).unwrap().into_bytes()
-            } else {
-                let output = Command::new("mandoc")
-                    .args(MANDOC_OPTS)
-                    .arg(filepath)
-                    .output()
-                    .or_else(|_| Command::new("man").arg("-l").arg(filepath).output())
-                    .expect(
-                        "could not execute `mandoc` or `man`. If the binaries are not available \
-                         in the PATH, disable `cli-docs` feature to be able to continue \
-                         compilation.",
-                    );
-                output.stdout
-            };
-
-            let file = File::create(&out_dir_path).unwrap_or_else(|err| {
-                panic!("Could not create file {}: {}", out_dir_path.display(), err)
-            });
-            let mut gz = GzBuilder::new()
-                .comment(output.len().to_string().into_bytes())
-                .write(file, Compression::default());
-            gz.write_all(&output).unwrap();
-            gz.finish().unwrap();
-            out_dir_path.pop();
-        };
-
-        cl("docs/meli.1", "meli.txt.gz", false);
-        cl("docs/meli.conf.5", "meli.conf.txt.gz", false);
-        cl("docs/meli-themes.5", "meli-themes.txt.gz", false);
-        cl("docs/meli.7", "meli.7.txt.gz", false);
-        cl("docs/meli.1", "meli.mdoc.gz", true);
-        cl("docs/meli.conf.5", "meli.conf.mdoc.gz", true);
-        cl("docs/meli-themes.5", "meli-themes.mdoc.gz", true);
-        cl("docs/meli.7", "meli.7.mdoc.gz", true);
-    }
-}

meli/config_macros.rs

@@ -1,245 +0,0 @@
-/*
- * meli -
- *
- * Copyright  Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use std::{
-    fs::File,
-    io::prelude::*,
-    process::{Command, Stdio},
-};
-
-use quote::{format_ident, quote};
-use regex::Regex;
-
-// Write ConfigStructOverride to overrides.rs
-pub(crate) fn override_derive(filenames: &[(&str, &str)]) {
-    let mut output_file =
-        File::create("src/conf/overrides.rs").expect("Unable to open output file");
-    let mut output_string = r##"// @generated
-/*
- * meli - conf/overrides.rs
- *
- * Copyright 2020 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#![allow(clippy::derivable_impls)]
-
-//! This module is automatically generated by `config_macros.rs`.
-
-use super::*;
-use melib::HeaderName;
-
-"##
-    .to_string();
-
-    let cfg_attr_default_attr_regex = Regex::new(r"\s*default\s*[,]").unwrap();
-    let cfg_attr_default_val_attr_regex = Regex::new(r#"\s*default\s*=\s*"[^"]*"\s*,\s*"#).unwrap();
-    let cfg_attr_feature_regex = Regex::new(r"[(](?:not[(]\s*)?feature").unwrap();
-
-    'file_loop: for (filename, ident) in filenames {
-        println!("cargo:rerun-if-changed={}", filename);
-        let mut file = File::open(filename)
-            .unwrap_or_else(|err| panic!("Unable to open file `{}` {}", filename, err));
-
-        let mut src = String::new();
-        file.read_to_string(&mut src).expect("Unable to read file");
-
-        let syntax = syn::parse_file(&src).expect("Unable to parse file");
-        if syntax.items.iter().any(|item| {
-            if let syn::Item::Struct(s) = item {
-                if s.ident.to_string().ends_with("Override") {
-                    println!("ident {} exists, skipping {}", ident, filename);
-                    return true;
-                }
-            }
-            false
-        }) {
-            continue 'file_loop;
-        }
-
-        for item in syntax.items.iter() {
-            if let syn::Item::Struct(s) = item {
-                if s.ident != ident {
-                    continue;
-                }
-                if s.ident.to_string().ends_with("Override") {
-                    unreachable!();
-                }
-                let override_ident: syn::Ident = format_ident!("{}Override", s.ident);
-                let mut field_tokentrees = vec![];
-                let mut attrs_tokens = vec![];
-                for attr in &s.attrs {
-                    if let Ok(syn::Meta::List(ml)) = attr.parse_meta() {
-                        if ml.path.get_ident().is_some() && ml.path.get_ident().unwrap() == "cfg" {
-                            attrs_tokens.push(attr);
-                        }
-                    }
-                }
-                let mut field_idents = vec![];
-                for f in &s.fields {
-                    let ident = &f.ident;
-                    let ty = &f.ty;
-                    let attrs = f
-                        .attrs
-                        .iter()
-                        .filter_map(|f| {
-                            let mut new_attr = f.clone();
-                            if let proc_macro2::TokenTree::Group(g) =
-                                f.tokens.clone().into_iter().next().unwrap()
-                            {
-                                let mut attr_inner_value = f.tokens.to_string();
-                                if cfg_attr_feature_regex.is_match(&attr_inner_value) {
-                                    attr_inner_value = cfg_attr_default_val_attr_regex
-                                        .replace_all(&attr_inner_value, "")
-                                        .to_string();
-                                    if attr_inner_value.contains("default") {
-                                        attr_inner_value = cfg_attr_default_attr_regex
-                                            .replace_all(&attr_inner_value, "")
-                                            .to_string();
-                                    }
-                                    let new_toks: proc_macro2::TokenStream =
-                                        attr_inner_value.parse().unwrap();
-                                    new_attr.tokens = quote! { #new_toks };
-                                }
-                                if !attr_inner_value.starts_with("( default")
-                                    && !attr_inner_value.starts_with("( default =")
-                                    && !attr_inner_value.starts_with("(default")
-                                    && !attr_inner_value.starts_with("(default =")
-                                {
-                                    return Some(new_attr);
-                                }
-                                if attr_inner_value.starts_with("( default =")
-                                    || attr_inner_value.starts_with("(default =")
-                                {
-                                    let rest = g.stream().into_iter().skip(4);
-                                    new_attr.tokens = quote! { ( #(#rest)*) };
-                                    match new_attr.tokens.to_string().as_str() {
-                                        "( )" | "()" => {
-                                            return None;
-                                        }
-                                        _ => {}
-                                    }
-                                } else if attr_inner_value.starts_with("( default")
-                                    || attr_inner_value.starts_with("(default")
-                                {
-                                    let rest = g.stream().into_iter().skip(2);
-                                    new_attr.tokens = quote! { ( #(#rest)*) };
-                                    match new_attr.tokens.to_string().as_str() {
-                                        "( )" | "()" => {
-                                            return None;
-                                        }
-                                        _ => {}
-                                    }
-                                }
-                            }
-
-                            Some(new_attr)
-                        })
-                        .collect::<Vec<_>>();
-                    let t = quote! {
-                        #(#attrs)*
-                        #[serde(default)]
-                        pub #ident : Option<#ty>
-                    };
-                    if !field_idents.contains(&ident) {
-                        field_idents.push(ident);
-                    }
-                    field_tokentrees.push(t);
-                }
-                //let fields = &s.fields;
-
-                let literal_struct = quote! {
-                    #(#attrs_tokens)*
-                    #[derive(Debug, Serialize, Deserialize, Clone)]
-                    #[serde(deny_unknown_fields)]
-                    pub struct #override_ident {
-                        #(#field_tokentrees),*
-                    }
-
-
-                    #(#attrs_tokens)*
-                    impl Default for #override_ident {
-                        fn default() -> Self {
-                            Self {
-                                #(#field_idents: None),*
-                            }
-                        }
-                    }
-                };
-                output_string.push_str(&literal_struct.to_string());
-                output_string.push_str("\n\n");
-            }
-        }
-    }
-
-    let rustfmt_closure = move |output_file: &mut File, output_string: &str| {
-        let mut rustfmt = Command::new("rustfmt")
-            .stdin(Stdio::piped())
-            .stdout(Stdio::piped())
-            .stderr(Stdio::piped())
-            .spawn()
-            .map_err(|err| format!("failed to execute rustfmt {}", err))?;
-
-        {
-            // limited borrow of stdin
-            let stdin = rustfmt
-                .stdin
-                .as_mut()
-                .ok_or("failed to get rustfmt stdin")?;
-            stdin
-                .write_all(output_string.as_bytes())
-                .map_err(|err| format!("failed to write to rustfmt stdin {}", err))?;
-        }
-
-        let output = rustfmt
-            .wait_with_output()
-            .map_err(|err| format!("failed to wait on rustfmt child {}", err))?;
-        if !output.stderr.is_empty() {
-            return Err(format!(
-                "rustfmt invocation replied with: `{}`",
-                String::from_utf8_lossy(&output.stderr)
-            ));
-        }
-
-        output_file
-            .write_all(&output.stdout)
-            .expect("failed to write to src/conf/overrides.rs");
-        Ok(())
-    };
-    if let Err(err) = rustfmt_closure(&mut output_file, &output_string) {
-        println!("Tried rustfmt on overrides module, got error: {}", err);
-        output_file.write_all(output_string.as_bytes()).unwrap();
-    }
-}

meli/docs/external-tools.md

@@ -1,122 +0,0 @@
-# Using other apps with `meli`
-
-## Sending mail with a command line tool
-
-`composing.send_mail` can use either settings for an SMTP server or a shell 
-command to which it pipes new mail to.
-
-### `msmtp` and `send_mail`
-
-[`msmtp`][msmtp] is a command line SMTP client that can be configured to work 
-with many SMTP servers. It supports queuing and other small useful features. 
-See [the documentation](https://marlam.de/msmtp/msmtp.html).
-
-```toml
-[composing]
-send_mail = 'msmtp --logfile=/home/user/.mail/msmtp.log --read-recipients 
---read-envelope-from'
-```
-[msmtp]: https://marlam.de/msmtp/
-
-## Editor
-
-Any editor you specify in `composing.editor_cmd` will be invoked with the 
-e-mail draft file path appended as an argument to it. For example, if your 
-setting is `editor_cmd = 'nano'`, `meli` will execute `nano /tmp/meli/...`.
-
-### Configuration
-
-#### `vim` / `neovim` command
-
-The following command setting in your `meli` configuration file makes editing 
-start at the first empty line, that is, after the e-mail headers. This allows 
-you to start writing the e-mail body right away after opening the editor from 
-`meli`.
-
-```toml
-[composing]
-editor_cmd = '~/.local/bin/vim +/^$'
-```
-
-In `vim`, the `+` argument positions the cursor at the first file argument. `/` 
-specifies a pattern position instead of a line number. `^` specifies the start 
-of a line, and `$` the end of the line. The pattern altogether matches an empty 
-line, which will be after the e-mail headers.
-
-### Composing with `format=flowed`
-
-`format=flowed` is a proposed IETF standard[^formatflowed] that lets you 
-preserve the structure of paragraphs by disambiguating a *hard* and a *soft* 
-line break. A line break that is preceded by a space character is *soft* and 
-does not terminate the paragraph, while a line break without a space is a 
-*hard* one and creates a new paragraph. This allows text to be re-flowed in 
-e-mail clients at different display widths and font sizes without messing up 
-the author's formatting.
-
-#### `vim` / `neovim` and `format=flowed`
-
-Create a `mail.vim` file type plugin in:
-
-- `$HOME/.vim/after/ftplugin/mail.vim` for vim
-- `$HOME/.config/nvim/after/ftplugin/mail.vim` for neovim
-
-```vim
-setlocal nomodeline
-setlocal textwidth=72
-setlocal formatoptions=aqtw2r
-setlocal nojoinspaces
-setlocal nosmartindent
-setlocal comments+=nb:>
-match ErrorMsg '\s\+$'
-```
-
-Also, don't forget that you can easily quote stuff with `MailQuote`.
-From `:help ft-mail-plugin`:
-
-> Local mappings:
-> `<LocalLeader>q`   or   `\\MailQuote`
->   Quotes the text selected in Visual mode, or from the cursor position
->   to the end of the file in Normal mode.
->   This means "> " is inserted in each line.
-
-See the accompanying [`mail.vim`](./mail.vim) for comments for each setting.
-
-## `xbiff`
-
-[`xbiff(1)`][xbiff] manual page says:[^xbiffmanpage]
-
-> The `xbiff` program displays a little image of a mailbox. When there is no
-> mail, the flag on the mailbox is down. When mail arrives, the flag goes up
-> and the mailbox beeps.
-
-This tool is very outdated, but some users might still have use for it. 
-Therefore `meli` provides support (also, it's easy to support this feature).
-
-Specify a file path in `notifications.xbiff_file_path` and `meli` will write to 
-it when new mail arrives. This file can the be used as input to `xbiff`.
-
-```toml
-[notifications]
-xbiff_file_path = "/tmp/xbiff"
-```
-
-[xbiff]: https://en.wikipedia.org/wiki/Xbiff
-[^xbiffmanpage]: https://www.x.org/releases/X11R7.0/doc/html/xbiff.1.html
-
-## Viewing HTML e-mail
-
-By default `meli` tries to render HTML e-mail with `w3m`. You can override this 
-by setting the `pager.html_filter` setting. The default setting corresponds to:
-
-```toml
-[pager]
-html_filter = "w3m -I utf-8 -T text/html"
-```
-
-The HTML of the e-mail is piped into `html_filter`'s standard input.
-
-## Externally refreshing e-mail accounts
-
-If your account's syncing is handled by an external tool, you can use the 
-refresh shortcuts within `meli` to call this tool with 
-`accounts.refresh_command`.

meli/docs/historical-manpages/maildir.5.en.gz

@@ -1,354 +0,0 @@
-'\" t
-.\"<!-- Copyright 1998 - 2007 Double Precision, Inc.  See COPYING for -->
-.\"<!-- distribution information. -->
-.\"     Title: maildir
-.\"    Author: Sam Varshavchik
-.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 07/24/2017
-.\"    Manual: Double Precision, Inc.
-.\"    Source: Courier Mail Server
-.\"  Language: English
-.\"
-.TH "MAILDIR" "5" "07/24/2017" "Courier Mail Server" "Double Precision, Inc\&."
-.\" -----------------------------------------------------------------
-.\" * Define some portability stuff
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" http://bugs.debian.org/507673
-.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.ie \n(.g .ds Aq \(aq
-.el       .ds Aq '
-.\" -----------------------------------------------------------------
-.\" * set default formatting
-.\" -----------------------------------------------------------------
-.\" disable hyphenation
-.nh
-.\" disable justification (adjust text to left margin only)
-.ad l
-.\" -----------------------------------------------------------------
-.\" * MAIN CONTENT STARTS HERE *
-.\" -----------------------------------------------------------------
-.SH "NAME"
-maildir \- E\-mail directory
-.SH "SYNOPSIS"
-.sp
-$HOME/Maildir
-.SH "DESCRIPTION"
-.PP
-A
-\(lqMaildir\(rq
-is a structured directory that holds E\-mail messages\&. Maildirs were first implemented by the
-Qmail
-mail server\&. Qmail\*(Aqs maildirs were a simple data structure, nothing more than a single collection of E\-mail messages\&. The
-Courier
-mail server builds upon
-Qmail\*(Aqs maildirs to provide extended functionality, such as folders and quotas\&. This document describes the
-Courier
-mail server\*(Aqs extended maildirs, without explicitly identifying The
-Courier
-mail server\-specific extensions\&. See
-\fBmaildir\fR(5)
-in Qmail\*(Aqs documentation for the original definition of maildirs\&.
-.PP
-Traditionally, E\-mail folders were saved as plain text files, called
-\(lqmboxes\(rq\&. Mboxes have known limitations\&. Only one application can use an mbox at the same time\&. Locking is required in order to allow simultaneous concurrent access by different applications\&. Locking is often problematic, and not very reliable in network\-based filesystem requirements\&. Some network\-based filesystems don\*(Aqt offer any reliable locking mechanism at all\&. Furthermore, even bulletproof locking won\*(Aqt prevent occasional mbox corruption\&. A process can be killed or terminated in the middle of updating an mbox\&. This will likely result in corruption, and a loss of most messages in the mbox\&.
-.PP
-Maildirs allow multiple concurrent access by different applications\&. Maildirs do not require locking\&. Multiple applications can update a maildir at the same time, without stepping on each other\*(Aqs feet\&.
-.SS "Maildir contents"
-.PP
-A
-\(lqmaildir\(rq
-is a directory that\*(Aqs created by
-\m[blue]\fB\fBmaildirmake\fR(1)\fR\m[]\&\s-2\u[1]\d\s+2\&. Naturally, maildirs should not have any group or world permissions, unless you want other people to read your mail\&. A maildir contains three subdirectories:
-tmp,
-new, and
-cur\&. These three subdirectories comprise the primary folder, where new mail is delivered by the system\&.
-.PP
-Folders are additional subdirectories in the maildir whose names begin with a period: such as
-\&.Drafts
-or
-\&.Sent\&. Each folder itself contains the same three subdirectories,
-tmp,
-new, and
-cur, and an additional zero\-length file named
-maildirfolder, whose purpose is to inform any mail delivery agent that it\*(Aqs really delivering to a folder, and that the mail delivery agent should look in the parent directory for any maildir\-related information\&.
-.PP
-Folders are not physically nested\&. A folder subdirectory, such as
-\&.Sent
-does not itself contain any subfolders\&. The main maildir contains a single, flat list of subfolders\&. These folders are logically nested, and periods serve to separate folder hierarchies\&. For example,
-\&.Sent\&.2002
-is considered to be a subfolder called
-\(lq2002\(rq
-which is a subfolder of
-\(lqSent\(rq\&.
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBFolder name encoding\fR
-.RS 4
-.PP
-Folder names can contain any Unicode character, except for control characters\&. US\-ASCII characters, U+0x0020 \- U+0x007F, except for the period, forward\-slash, and ampersand characters (U+0x002E, U+0x002F, and U+0x0026) represent themselves\&. The ampersand is represent by the two character sequence
-\(lq&\-\(rq\&. The period, forward slash, and non US\-ASCII Unicode characters are represented using the UTF\-7 character set, and encoded with a modified form of base64\-encoding\&.
-.PP
-The
-\(lq&\(rq
-character starts the modified base64\-encoded sequence; the sequence is terminated by the
-\(lq\-\(rq
-character\&. The sequence of 16\-bit Unicode characters is written in big\-endian order, and encoded using the base64\-encoding method described in section 5\&.2 of
-\m[blue]\fBRFC 1521\fR\m[]\&\s-2\u[2]\d\s+2, with the following modifications:
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The
-\(lq=\(rq
-padding character is omitted\&. When decoding, an incomplete 16\-bit character is discarded\&.
-.RE
-.sp
-.RS 4
-.ie n \{\
-\h'-04'\(bu\h'+03'\c
-.\}
-.el \{\
-.sp -1
-.IP \(bu 2.3
-.\}
-The comma character,
-\(lq,\(rq
-is used in place of the
-\(lq/\(rq
-character in the base64 alphabet\&.
-.RE
-.PP
-For example, the word
-\(lqResume\(rq
-with both "e"s being the e\-acute character, U+0x00e9, is encoded as
-\(lqR&AOk\-sum&AOk\-\(rq
-(so a folder of that name would be a maildir subdirectory called
-\(lq\&.R&AOk\-sum&AOk\-\(rq)\&.
-.RE
-.sp
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.br
-.ps +1
-\fBOther maildir contents\fR
-.RS 4
-.PP
-Software that uses maildirs may also create additional files besides the
-tmp,
-new, and
-cur
-subdirectories \-\- in the main maildir or a subfolder \-\- for its own purposes\&.
-.RE
-.SS "Messages"
-.PP
-E\-mail messages are stored in separate, individual files, one E\-mail message per file\&. The
-tmp
-subdirectory temporarily stores E\-mail messages that are in the process of being delivered to this maildir\&.
-tmp
-may also store other kinds of temporary files, as long as they are created in the same way that message files are created in
-tmp\&. The
-new
-subdirectory stores messages that have been delivered to this maildir, but have not yet been seen by any mail application\&. The
-cur
-subdirectory stores messages that have already been seen by mail applications\&.
-.SS "Adding new mail to maildirs"
-.PP
-The following process delivers a new message to the maildir:
-.PP
-A new unique filename is created using one of two possible forms:
-\(lqtime\&.MusecPpid\&.host\(rq, or
-\(lqtime\&.MusecPpid_unique\&.host\(rq\&.
-\(lqtime\(rq
-and
-\(lqusec\(rq
-is the current system time, obtained from
-\fBgettimeofday\fR(2)\&.
-\(lqpid\(rq
-is the process number of the process that is delivering this message to the maildir\&.
-\(lqhost\(rq
-is the name of the machine where the mail is being delivered\&. In the event that the same process creates multiple messages, a suffix unique to each message is appended to the process id; preferrably an underscore, followed by an increasing counter\&. This applies whether messages created by a process are all added to the same, or different, maildirs\&. This protocol allows multiple processes running on multiple machines on the same network to simultaneously create new messages without stomping on each other\&.
-.PP
-The filename created in the previous step is checked for existence by executing the
-\fBstat\fR(2)
-system call\&. If
-\fBstat\fR(2)
-results in ANYTHING OTHER than the system error
-ENOENT, the process must sleep for two seconds, then go back and create another unique filename\&. This is an extra step to insure that each new message has a completely unique filename\&.
-.PP
-Other applications that wish to use
-tmp
-for temporary storage should observe the same protocol (but see READING MAIL FROM MAILDIRS below, because old files in
-tmp
-will be eventually deleted)\&.
-.PP
-If the
-\fBstat\fR(2)
-system call returned
-ENOENT, the process may proceed to create the file in the
-tmp
-subdirectory, and save the entire message in the new file\&. The message saved MUST NOT have the
-\(lqFrom_\(rq
-header that is used to mboxes\&. The message also MUST NOT have any
-\(lqFrom_\(rq
-lines in the contents of the message prefixed by the
-\(lq>\(rq
-character\&.
-.PP
-When saving the message, the number of bytes returned by the
-\fBwrite\fR(2)
-system call must be checked, in order to make sure that the complete message has been written out\&.
-.PP
-After the message is saved, the file descriptor is
-\fBfstat\fR(2)\-ed\&. The file\*(Aqs device number, inode number, and the its byte size, are saved\&. The file is closed and is then immediately moved/renamed into the
-new
-subdirectory\&. The name of the file in
-new
-should be
-\(lqtime\&.MusecPpidVdevIino\&.host,S=\fIcnt\fR\(rq, or
-\(lqtime\&.MusecPpidVdevIino_unique\&.host,S=\fIcnt\fR\(rq\&.
-\(lqdev\(rq
-is the message\*(Aqs device number,
-\(lqino\(rq
-is the message\*(Aqs inode number (from the previous
-\fBfstat\fR(2)
-call); and
-\(lqcnt\(rq
-is the message\*(Aqs size, in bytes\&.
-.PP
-The
-\(lq,S=\fIcnt\fR\(rq
-part optimizes the
-\m[blue]\fBCourier\fR\m[]\&\s-2\u[3]\d\s+2
-mail server\*(Aqs maildir quota enhancement; it allows the size of all the mail stored in the maildir to be added up without issuing the
-\fBstat\fR(2)
-system call for each individual message (this can be quite a performance drain with certain network filesystems)\&.
-.SS "READING MAIL FROM MAILDIRS"
-.PP
-Applications that read mail from maildirs should do it in the following order:
-.PP
-When opening a maildir or a maildir folder, read the
-tmp
-subdirectory and delete any files in there that are at least 36 hours old\&.
-.PP
-Look for new messages in the
-new
-subdirectory\&. Rename
-\fInew/filename\fR, as
-\fIcur/filename:2,info\fR\&. Here,
-\fIinfo\fR
-represents the state of the message, and it consists of zero or more boolean flags chosen from the following:
-\(lqD\(rq
-\- this is a \*(Aqdraft\*(Aq message,
-\(lqR\(rq
-\- this message has been replied to,
-\(lqS\(rq
-\- this message has been viewed (seen),
-\(lqT\(rq
-\- this message has been marked to be deleted (trashed), but is not yet removed (messages are removed from maildirs simply by deleting their file),
-\(lqF\(rq
-\- this message has been marked by the user, for some purpose\&. These flags must be stored in alphabetical order\&. New messages contain only the
-:2,
-suffix, with no flags, indicating that the messages were not seen, replied, marked, or deleted\&.
-.PP
-Maildirs may have maximum size quotas defined, but these quotas are purely voluntary\&. If you need to implement mandatory quotas, you should use any quota facilities provided by the underlying filesystem that is used to store the maildirs\&. The maildir quota enhancement is designed to be used in certain situations where filesystem\-based quotas cannot be used for some reason\&. The implementation is designed to avoid the use of any locking\&. As such, at certain times the calculated quota may be imprecise, and certain anomalous situations may result in the maildir actually going over the stated quota\&. One such situation would be when applications create messages without updating the quota estimate for the maildir\&. Eventually it will be precisely recalculated, but wherever possible new messages should be created in compliance with the voluntary quota protocol\&.
-.PP
-The voluntary quota protocol involves some additional procedures that must be followed when creating or deleting messages within a given maildir or its subfolders\&. The
-\m[blue]\fB\fBdeliverquota\fR(8)\fR\m[]\&\s-2\u[4]\d\s+2
-command is a tiny application that delivers a single message to a maildir using the voluntary quota protocol, and hopefully it can be used as a measure of last resort\&. Alternatively, applications can use the
-libmaildir\&.a
-library to handle all the low\-level dirty details for them\&. The voluntary quota enhancement is described in the
-\m[blue]\fB\fBmaildirquota\fR(7)\fR\m[]\&\s-2\u[5]\d\s+2
-man page\&.
-.SS "Maildir Quotas"
-.PP
-This is a voluntary mechanism for enforcing "loose" quotas on the maximum sizes of maildirs\&. This mechanism is enforced in software, and not by the operating system\&. Therefore it is only effective as long as the maildirs themselves are not directly accessible by their users, since this mechanism is trivially disabled\&.
-.PP
-If possible, operating system\-enforced quotas are preferrable\&. Where operating system quota enforcement is not available, or not possible, this voluntary quota enforcement mechanism might be an acceptable compromise\&. Since it\*(Aqs enforced in software, all software that modifies or accesses the maildirs is required to voluntary obey and enforce a quota\&. The voluntary quota implementation is flexible enough to allow non quota\-aware applications to also access the maildirs, without any drastic consequences\&. There will be some non\-drastic consequences, though\&. Of course, non quota\-aware applications will not enforce any defined quotas\&. Furthermore, this voluntary maildir quota mechanism works by estimating the current size of the maildir, with periodic exact recalculation\&. Obviously non quota\-aware maildir applications will not update the maildir size estimation, so the estimate will be thrown off for some period of time, until the next recalculation\&.
-.PP
-This voluntary quota mechanism is designed to be a reasonable compromise between effectiveness, and performance\&. The entire purpose of using maildir\-based mail storage is to avoid any kind of locking, and to permit parallel access to mail by multiple applications\&. In order to compute the exact size of a maildir, the maildir must be locked somehow to prevent any modifications while its contents are added up\&. Obviously something like that defeats the original purpose of using maildirs, therefore the voluntary quota mechanism does not use locking, and that\*(Aqs why the current recorded maildir size is always considered to be an estimate\&. Regular size recalculations will compensate for any occasional race conditions that result in the estimate to be thrown off\&.
-.PP
-A quota for an existing maildir is installed by running maildirmake with the
-\-q
-option, and naming an existing maildir\&. The
-\-q
-option takes a parameter,
-\fIquota\fR, which is a comma\-separated list of quota specifications\&. A quota specification consists of a number followed by either \*(AqS\*(Aq, indicating the maximum message size in bytes, or \*(AqC\*(Aq, maximum number of messages\&. For example:
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fBmaildirmake \-q 5000000S,1000C \&./Maildir\fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This sets the quota to 5,000,000 bytes or 1000 messages, whichever comes first\&.
-.sp
-.if n \{\
-.RS 4
-.\}
-.nf
-\fBmaildirmake \-q 1000000S \&./Maildir\fR
-.fi
-.if n \{\
-.RE
-.\}
-.PP
-This sets the quota to 1,000,000 bytes, without limiting the number of messages\&.
-.PP
-A quota of an existing maildir can be changed by rerunning the
-\fBmaildirmake\fR
-command with a new
-\-q
-option\&. To delete a quota entirely, delete the
-\fIMaildir\fR/maildirsize
-file\&.
-.SH "SEE ALSO"
-.PP
-\m[blue]\fB\fBmaildirmake\fR(1)\fR\m[]\&\s-2\u[1]\d\s+2\&.
-.SH "AUTHOR"
-.PP
-\fBSam Varshavchik\fR
-.RS 4
-Author
-.RE
-.SH "NOTES"
-.IP " 1." 4
-\fBmaildirmake\fR(1)
-.RS 4
-\%http://www.courier-mta.org/maildirmake.html
-.RE
-.IP " 2." 4
-RFC 1521
-.RS 4
-\%http://www.rfc-editor.org/rfc/rfc1521.txt
-.RE
-.IP " 3." 4
-Courier
-.RS 4
-\%http://www.courier-mta.org
-.RE
-.IP " 4." 4
-\fBdeliverquota\fR(8)
-.RS 4
-\%http://www.courier-mta.org/deliverquota.html
-.RE
-.IP " 5." 4
-\fBmaildirquota\fR(7)
-.RS 4
-\%http://www.courier-mta.org/maildirquota.html
-.RE

meli/docs/historical-manpages/mbox.5.en.gz

@@ -1,187 +0,0 @@
-'\" t
-.\" -*-nroff-*-
-.\"
-.\"     Copyright (C) 2000 Thomas Roessler <roessler@does-not-exist.org>
-.\"
-.\"	This document is in the public domain and may be distributed and
-.\"	changed arbitrarily.
-.\"
-.TH mbox 5 "February 19th, 2002" Unix "User Manuals"
-.\"
-.SH NAME
-mbox \- Format for mail message storage.
-.\"
-.SH DESCRIPTION
-This document describes the format traditionally used by Unix hosts
-to store mail messages locally.
-.B mbox
-files typically reside in the system's mail spool, under various
-names in users' Mail directories, and under the name
-.B mbox
-in users' home directories.
-.PP
-An
-.B mbox
-is a text file containing an arbitrary number of e-mail messages.
-Each message consists of a postmark, followed by an e-mail message
-formatted according to \fBRFC822\fP, \fBRFC2822\fP. The file format
-is line-oriented. Lines are separated by line feed characters (ASCII 10).
-.PP
-A postmark line consists of the four characters "From", followed by
-a space character, followed by the message's envelope sender
-address, followed by whitespace, and followed by a time stamp. This
-line is often called From_ line.
-.PP
-The sender address is expected to be
-.B addr-spec
-as defined in \fBRFC2822\fP 3.4.1. The date is expected to be
-.B date-time
-as output by
-.BR asctime (3).
-For compatibility reasons with legacy software, two-digit years
-greater than or equal to 70 should be interpreted as the years
-1970+, while two-digit years less than 70 should be interpreted as
-the years 2000-2069. Software reading files in this format should
-also be prepared to accept non-numeric timezone information such as
-"CET DST" for Central European Time, daylight saving time.
-.PP
-Example:
-.IP "" 1
->From example@example.com Fri Jun 23 02:56:55 2000
-.PP
-In order to avoid misinterpretation of lines in message bodies
-which begin with the four characters "From", followed by a space
-character, the mail delivery agent must quote any occurrence
-of "From " at the start of a body line.
-.sp
-There are two different quoting schemes, the first (\fBMBOXO\fP) only
-quotes plain "From " lines in the body by prepending a '>' to the
-line; the second (\fBMBOXRD\fP) also quotes already quoted "From "
-lines by prepending a '>' (i.e. ">From ", ">>From ", ...). The later
-has the advantage that lines like
-.IP "" 1
->From the command line you can use the '\-p' option
-.PP
-aren't dequoted wrongly as a \fBMBOXRD\fP-MDA would turn the line
-into
-.IP "" 1
->>From the command line you can use the '\-p' option
-.PP
-before storing it. Besides \fBMBOXO\fP and \fBMBOXRD\fP there is also
-\fBMBOXCL\fP which is \fBMBOXO\fP with a "Content-Length:"\-field with the
-number of bytes in the message body; some MUAs (like
-.BR mutt (1))
-do automatically transform \fBMBOXO\fP mailboxes into \fBMBOXCL\fP ones when
-ever they write them back as \fBMBOXCL\fP can be read by any \fBMBOXO\fP-MUA
-without any problems.
-.PP
-If the modification-time (usually determined via
-.BR stat (2))
-of a nonempty
-.B mbox
-file is greater than the access-time the file has new mail. Many MUAs
-place a Status: header in each message to indicate which messages have
-already been read.
-.\"
-.SH LOCKING
-Since
-.B mbox
-files are frequently accessed by multiple programs in parallel,
-.B mbox
-files should generally not be accessed without locking.
-.PP
-Three different locking mechanisms (and combinations thereof) are in
-general use:
-.IP "\(bu"
-.BR fcntl (2)
-locking is mostly used on recent, POSIX-compliant systems. Use of
-this locking method is, in particular, advisable if
-.B mbox
-files are accessed through the Network File System (NFS), since it
-seems the only way to reliably invalidate NFS clients' caches.
-.IP "\(bu"
-.BR flock (2)
-locking is mostly used on BSD-based systems.
-.IP "\(bu"
-Dotlocking is used on all kinds of systems. In order to lock an
-.B mbox
-file named \fIfolder\fR, an application first creates a temporary file
-with a unique name in the directory in which the
-\fIfolder\fR resides. The application then tries to use the
-.BR link (2)
-system call to create a hard link named \fIfolder.lock\fR
-to the temporary file. The success of the
-.BR link (2)
-system call should be additionally verified using
-.BR stat (2)
-calls. If the link has succeeded, the mail folder is considered
-dotlocked. The temporary file can then safely be unlinked.
-.IP ""
-In order to release the lock, an application just unlinks the
-\fIfolder.lock\fR file.
-.PP
-If multiple methods are combined, implementors should make sure to
-use the non-blocking variants of the
-.BR fcntl (2)
-and
-.BR flock (2)
-system calls in order to avoid deadlocks.
-.PP
-If multiple methods are combined, an
-.B mbox
-file must not be considered to have been successfully locked before
-all individual locks were obtained. When one of the individual
-locking methods fails, an application should release all locks it
-acquired successfully, and restart the entire locking procedure from
-the beginning, after a suitable delay.
-.PP
-The locking mechanism used on a particular system is a matter of
-local policy, and should be consistently used by all applications
-installed on the system which access
-.B mbox
-files. Failure to do so may result in loss of e-mail data, and in
-corrupted
-.B mbox
-files.
-.\"
-.SH FILES
-.IR /var/spool/mail/$LOGNAME
-.RS
-\fB$LOGNAME\fP's incoming mail folder.
-.RE
-.PP
-.IR $HOME/mbox
-.RS
-user's archived mail messages, in his \fB$HOME\fP directory.
-.RE
-.PP
-.IR $HOME/Mail/
-.RS
-A directory in user's \fB$HOME\fP directory which is commonly used to hold
-.B mbox
-format folders.
-.RE
-.PP
-.\"
-.SH "SEE ALSO"
-.BR mutt (1),
-.BR fcntl (2),
-.BR flock (2),
-.BR link (2),
-.BR stat (2),
-.BR asctime (3),
-.BR maildir (5),
-.BR mmdf (5),
-.BR RFC822 ,
-.BR RFC976 ,
-.BR RFC2822
-.\"
-.SH AUTHOR
-Thomas Roessler <roessler@does-not-exist.org>, Urs Janssen <urs@tin.org>
-.\"
-.SH HISTORY
-The
-.B mbox
-format occurred in Version 6 AT&T Unix.
-.br
-A variant of this format was documented in \fBRFC976\fP.

meli/docs/historical-manpages/mbox.5qmail.en.gz

@@ -1,235 +0,0 @@
-.TH mbox 5
-.SH "NAME"
-mbox \- file containing mail messages
-.SH "INTRODUCTION"
-The most common format for storage of mail messages is
-.I mbox
-format.
-An
-.I mbox
-is a single file containing zero or more mail messages.
-.SH "MESSAGE FORMAT"
-A message encoded in
-.I mbox
-format begins with a
-.B From_
-line, continues with a series of
-.B \fRnon-\fBFrom_
-lines,
-and ends with a blank line.
-A
-.B From_
-line means any line that begins with the characters
-F, r, o, m, space:
-
-.EX
-     From god@heaven.af.mil Sat Jan  3 01:05:34 1996
-.br
-     Return-Path: <god@heaven.af.mil>
-.br
-     Delivered-To: djb@silverton.berkeley.edu
-.br
-     Date: 3 Jan 1996 01:05:34 -0000
-.br
-     From: God <god@heaven.af.mil>
-.br
-     To: djb@silverton.berkeley.edu (D. J. Bernstein)
-.br
-
-.br
-     How's that mail system project coming along?
-.br
-
-.EE
-
-The final line is a completely blank line (no spaces or tabs).
-Notice that blank lines may also appear elsewhere in the message.
-
-The
-.B From_
-line always looks like
-.B From
-.I envsender
-.I date
-.IR moreinfo .
-.I envsender
-is one word, without spaces or tabs;
-it is usually the envelope sender of the message.
-.I date
-is the delivery date of the message.
-It always contains exactly 24 characters in
-.B asctime
-format.
-.I moreinfo
-is optional; it may contain arbitrary information.
-
-Between the
-.B From_
-line and the blank line is a message in RFC 822 format,
-as described in
-.BR qmail-header(5) ,
-subject to
-.B >From quoting
-as described below.
-.SH "HOW A MESSAGE IS DELIVERED"
-Here is how a program appends a message to an
-.I mbox
-file.
-
-It first creates a
-.B From_
-line given the message's envelope sender and the current date.
-If the envelope sender is empty (i.e., if this is a bounce message),
-the program uses
-.B MAILER-DAEMON
-instead.
-If the envelope sender contains spaces, tabs, or newlines,
-the program replaces them with hyphens.
-
-The program then copies the message, applying
-.B >From quoting
-to each line.
-.B >From quoting
-ensures that the resulting lines are not
-.B From_
-lines:
-the program prepends a
-.B >
-to any
-.B From_
-line,
-.B >From_
-line,
-.B >>From_
-line,
-.B >>>From_
-line,
-etc.
-
-Finally the program appends a blank line to the message.
-If the last line of the message was a partial line,
-it writes two newlines;
-otherwise it writes one.
-.SH "HOW A MESSAGE IS READ"
-A reader scans through an
-.I mbox
-file looking for
-.B From_
-lines.
-Any
-.B From_
-line marks the beginning of a message.
-The reader should not attempt to take advantage of the fact that every
-.B From_
-line (past the beginning of the file)
-is preceded by a blank line.
-
-Once the reader finds a message,
-it extracts a (possibly corrupted) envelope sender
-and delivery date out of the
-.B From_
-line.
-It then reads until the next
-.B From_
-line or end of file, whichever comes first.
-It strips off the final blank line
-and
-deletes the
-quoting of
-.B >From_
-lines and
-.B >>From_
-lines and so on.
-The result is an RFC 822 message.
-.SH "COMMON MBOX VARIANTS"
-There are many variants of
-.I mbox
-format.
-The variant described above is
-.I mboxrd
-format, popularized by Rahul Dhesi in June 1995.
-
-The original
-.I mboxo
-format quotes only
-.B From_
-lines, not
-.B >From_
-lines.
-As a result it is impossible to tell whether
-
-.EX
-     From: djb@silverton.berkeley.edu (D. J. Bernstein)
-.br
-     To: god@heaven.af.mil
-.br
-
-.br
-     >From now through August I'll be doing beta testing.
-.br
-     Thanks for your interest.
-.EE
-
-was quoted in the original message.
-An
-.I mboxrd
-reader will always strip off the quoting.
-
-.I mboxcl
-format is like
-.I mboxo
-format, but includes a Content-Length field with the 
-number of bytes in the message.
-.I mboxcl2
-format is like
-.I mboxcl
-but has no
-.B >From
-quoting.
-These formats are used by SVR4 mailers.
-.I mboxcl2
-cannot be read safely by
-.I mboxrd
-readers.
-.SH "UNSPECIFIED DETAILS"
-There are many locking mechanisms for
-.I mbox
-files.
-.B qmail-local
-always uses
-.B flock
-on systems that have it, otherwise
-.BR lockf .
-
-The delivery date in a
-.B From_
-line does not specify a time zone.
-.B qmail-local
-always creates the delivery date in GMT
-so that 
-.I mbox
-files can be safely transported from one time zone to another.
-
-If the mtime on a nonempty 
-.I mbox
-file is greater than the atime,
-the file has new mail.
-If the mtime is smaller than the atime,
-the new mail has been read.
-If the atime equals the mtime,
-there is no way to tell whether the file has new mail,
-since
-.B qmail-local
-takes much less than a second to run.
-One solution is for a mail reader to artificially set the
-atime to the mtime plus 1.
-Then the file has new mail if and only if the atime is
-less than or equal to the mtime.
-
-Some mail readers place
-.B Status
-fields in each message to indicate which messages have been read.
-.SH "SEE ALSO"
-maildir(5),
-qmail-header(5),
-qmail-local(8)

meli/docs/historical-manpages/qmail-maildir.5.gz

@@ -1,239 +0,0 @@
-.TH maildir 5
-.SH "NAME"
-maildir \- directory for incoming mail messages
-.SH "INTRODUCTION"
-.I maildir
-is a structure for
-directories of incoming mail messages.
-It solves the reliability problems that plague
-.I mbox
-files and
-.I mh
-folders.
-.SH "RELIABILITY ISSUES"
-A machine may crash while it is delivering a message.
-For both
-.I mbox
-files and
-.I mh
-folders this means that the message will be silently truncated.
-Even worse: for
-.I mbox
-format, if the message is truncated in the middle of a line,
-it will be silently joined to the next message.
-The mail transport agent will try again later to deliver the message,
-but it is unacceptable that a corrupted message should show up at all.
-In
-.IR maildir ,
-every message is guaranteed complete upon delivery.
-
-A machine may have two programs simultaneously delivering mail
-to the same user.
-The
-.I mbox
-and
-.I mh
-formats require the programs to update a single central file.
-If the programs do not use some locking mechanism,
-the central file will be corrupted.
-There are several
-.I mbox
-and
-.I mh
-locking mechanisms,
-none of which work portably and reliably.
-In contrast, in
-.IR maildir ,
-no locks are ever necessary.
-Different delivery processes never touch the same file.
-
-A user may try to delete messages from his mailbox at the same
-moment that the machine delivers a new message.
-For
-.I mbox
-and
-.I mh
-formats, the user's mail-reading program must know
-what locking mechanism the mail-delivery programs use.
-In contrast, in
-.IR maildir ,
-any delivered message
-can be safely updated or deleted by a mail-reading program.
-
-Many sites use Sun's 
-.B Network F\fPa\fBil\fPur\fBe System
-(NFS),
-presumably because the operating system vendor does not offer
-anything else.
-NFS exacerbates all of the above problems.
-Some NFS implementations don't provide
-.B any
-reliable locking mechanism.
-With 
-.I mbox
-and
-.I mh
-formats,
-if two machines deliver mail to the same user,
-or if a user reads mail anywhere except the delivery machine,
-the user's mail is at risk.
-.I maildir
-works without trouble over NFS.
-.SH "THE MAILDIR STRUCTURE"
-A directory in
-.I maildir
-format has three subdirectories,
-all on the same filesystem:
-.BR tmp ,
-.BR new ,
-and
-.BR cur .
-
-Each file in
-.B new
-is a newly delivered mail message.
-The modification time of the file is the delivery date of the message.
-The message is delivered
-.I without
-an extra UUCP-style
-.B From_
-line,
-.I without
-any
-.B >From
-quoting,
-and
-.I without
-an extra blank line at the end.
-The message is normally in RFC 822 format,
-starting with a
-.B Return-Path
-line and a
-.B Delivered-To
-line,
-but it could contain arbitrary binary data.
-It might not even end with a newline.
-
-Files in
-.B cur
-are just like files in
-.BR new .
-The big difference is that files in
-.B cur
-are no longer new mail:
-they have been seen by the user's mail-reading program.
-.SH "HOW A MESSAGE IS DELIVERED"
-The
-.B tmp
-directory is used to ensure reliable delivery,
-as discussed here.
-
-A program delivers a mail message in six steps.
-First, it
-.B chdir()\fPs
-to the
-.I maildir
-directory.
-Second, it 
-.B stat()s
-the name
-.BR tmp/\fItime.pid.host ,
-where
-.I time
-is the number of seconds since the beginning of 1970 GMT,
-.I pid
-is the program's process ID,
-and
-.I host
-is the host name.
-Third, if
-.B stat()
-returned anything other than ENOENT,
-the program sleeps for two seconds, updates
-.IR time ,
-and tries the
-.B stat()
-again, a limited number of times.
-Fourth, the program
-creates
-.BR tmp/\fItime.pid.host .
-Fifth, the program
-.I NFS-writes
-the message to the file.
-Sixth, the program
-.BR link() s
-the file to
-.BR new/\fItime.pid.host .
-At that instant the message has been successfully delivered.
-
-The delivery program is required to start a 24-hour timer before
-creating
-.BR tmp/\fItime.pid.host ,
-and to abort the delivery
-if the timer expires.
-Upon error, timeout, or normal completion,
-the delivery program may attempt to
-.B unlink()
-.BR tmp/\fItime.pid.host .
-
-.I NFS-writing
-means
-(1) as usual, checking the number of bytes returned from each
-.B write()
-call;
-(2) calling
-.B fsync()
-and checking its return value;
-(3) calling
-.B close()
-and checking its return value.
-(Standard NFS implementations handle
-.B fsync()
-incorrectly
-but make up for it by abusing
-.BR close() .)
-.SH "HOW A MESSAGE IS READ"
-A mail reader operates as follows.
-
-It looks through the
-.B new
-directory for new messages.
-Say there is a new message,
-.BR new/\fIunique .
-The reader may freely display the contents of
-.BR new/\fIunique ,
-delete
-.BR new/\fIunique ,
-or rename
-.B new/\fIunique
-as
-.BR cur/\fIunique:info .
-See
-.B http://pobox.com/~djb/proto/maildir.html
-for the meaning of
-.IR info .
-
-The reader is also expected to look through the
-.B tmp
-directory and to clean up any old files found there.
-A file in
-.B tmp
-may be safely removed if it
-has not been accessed in 36 hours.
-
-It is a good idea for readers to skip all filenames in
-.B new
-and
-.B cur
-starting with a dot.
-Other than this, readers should not attempt to parse filenames.
-.SH "ENVIRONMENT VARIABLES"
-Mail readers supporting
-.I maildir
-use the
-.B MAILDIR
-environment variable
-as the name of the user's primary mail directory.
-.SH "SEE ALSO"
-mbox(5),
-qmail-local(8)

meli/docs/mail.vim

@@ -1,87 +0,0 @@
-" Place this plugin in
-"
-" `$HOME/.vim/after/ftplugin/mail.vim` for vim
-" `$HOME/.config/nvim/after/ftplugin/mail.vim` for neovim
-
-" Don't use modelines in e-mail messages
-setlocal nomodeline
-setlocal textwidth=72
-
-"                                                         *fo-a*
-" a Automatic formatting of paragraphs.
-"   Every time text is inserted or deleted the paragraph will be reformatted.
-"                                                         *fo-w*
-" w Trailing white space indicates a paragraph continues in the next line.
-"   A line that ends in a non-white character ends a paragraph.
-"                                                         *fo-q*
-" q Allow formatting of comments with "gq".
-"                                                         *fo-t*
-" t Auto-wrap text using textwidth
-"                                                         *fo-r*
-" r Automatically insert the current comment leader after hitting <Enter> in
-" Insert mode.
-"                                                         *fo-c*
-" c Auto-wrap comments using textwidth, inserting the current comment leader
-" automatically.
-"                                                         *fo-2*
-" 2 When formatting text, use the indent of the second line of a paragraph for
-"   the rest of the paragraph, instead of the indent of the first line.
-"   This supports paragraphs in which the first line has a different indent than 
-"   the rest.
-"   Note that 'autoindent' must be set too.
-" Example:
-"         first line of a paragraph
-"     second line of the same paragraph
-"     third line.
-" This also works inside comments, ignoring the comment leader.
-setlocal formatoptions=aqtw2r
-
-" Disable adding two spaces after '.', '?' and '!' with a join command.
-setlocal nojoinspaces
-
-" Disable smartident (meant for source code)
-setlocal nosmartindent
-
-"       *'comments'* *'com'* *E524* *E525*
-" A comma-separated list of strings that can start a comment line.
-"   See |format-comments|.
-"   See |option-backslash| about using backslashes to insert a space.
-"
-"
-"  The 'comments' option is a comma-separated list of parts.
-"  Each part defines a type of comment string.
-"  A part consists of: {flags}:{string}
-"
-"  {string} is the literal text that must appear.
-"
-"  {flags}:
-"  n  Nested comment.
-"  Nesting with mixed parts is allowed.
-"  If 'comments' is "n:),n:>" a line starting with "> ) >" is a comment.
-"
-"  b Blank (<Space>, <Tab> or <EOL>) required after {string}.
-setlocal comments+=nb:>
-
-" Highlight trailing whitespace as errors.
-match ErrorMsg '\s\+$'
-
-" MAIL            *mail.vim* *ft-mail.vim*
-" By default mail.vim synchronises syntax to 100 lines before the first
-" displayed line.
-" If you have a slow machine, and generally deal with emails with short 
-" headers, you can change this to a smaller value:
-
-let mail_minlines = 30
-
-
-"          *no_mail_maps* *g:no_mail_maps*
-" Disable defining mappings for a specific filetype by setting a variable,
-" which contains the name of the filetype.
-" For the "mail" filetype this would be:
-let no_mail_maps = 1
-
-" Local mappings:
-" <LocalLeader>q   or   \\MailQuote
-"   Quotes the text selected in Visual mode, or from the cursor position
-"   to the end of the file in Normal mode.
-"   This means "> " is inserted in each line.

meli/docs/meli-themes.5

@@ -1,666 +0,0 @@
-.\" meli - meli-themes.5
-.\"
-.\" Copyright 2017-2020 Manos Pitsidianakis
-.\"
-.\" This file is part of meli.
-.\"
-.\" meli is free software: you can redistribute it and/or modify
-.\" it under the terms of the GNU General Public License as published by
-.\" the Free Software Foundation, either version 3 of the License, or
-.\" (at your option) any later version.
-.\"
-.\" meli is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-.\" GNU General Public License for more details.
-.\"
-.\" You should have received a copy of the GNU General Public License
-.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
-.\"
-.\".Dd November 11, 2022
-.Dd March 10, 2024
-.Dt MELI-THEMES 5
-.Os
-.Sh NAME
-.Nm meli-themes
-.Nd themes for the
-.Xr meli 1
-terminal e-mail client
-.Sh SYNOPSIS
-.Nm meli
-comes with two themes,
-.Ic dark
-(default) and
-.Ic light .
-.Pp
-Custom themes are defined as lists of key-values in the configuration files:
-.Bl -item -compact -offset 2
-.It
-.Pa $XDG_CONFIG_HOME/meli/config.toml
-.It
-.Pa $XDG_CONFIG_HOME/meli/themes/*.toml
-.El
-.Pp
-The application theme is defined in the configuration as follows:
-.Bd -literal
-[terminal]
-theme = "dark"
-.Ed
-.Sh DESCRIPTION
-Themes for
-.Nm meli
-are described in the configuration language TOML, as they are key-value tables defined in the TERMINAL section of the configuration file.
-Each key defines the semantic location of the theme attribute within the application.
-For example,
-.Ic mail.listing.compact.*
-keys are settings for the
-.Ic compact
-mail listing style.
-A setting contains three fields: fg for foreground color, bg for background color, and attrs for text attribute.
-.Pp
-.Dl \&"widget.key.label\&" = { fg = \&"Default\&", bg = \&"Default\&", attrs = \&"Default\&" }
-.Pp
-Each field contains a value, which may be either a color/attribute, a link (key name) or a valid alias.
-An alias is a string starting with the \&"\&$\&" character and must be declared in advance in the
-.Ic color_aliases
-or
-.Ic attr_aliases
-fields of a theme.
-An alias' value can be any valid value, including links and other aliases, as long as they are valid.
-In the case of a link the setting's real value depends on the value of the referred key.
-This allows for defaults within a group of associated values.
-Cyclic references in a theme results in an error:
-.Pp
-.Dl spooky theme contains a cycle: fg:  mail.listing.compact.even -> mail.listing.compact.highlighted -> mail.listing.compact.odd -> mail.listing.compact.even
-.Pp
-Two themes are included by default,
-.Ql light
-and
-.Ql dark Ns
-\&.
-.Sh EXAMPLES
-Specific settings from already defined themes can be overwritten:
-.Bd -literal
-[terminal]
-theme = "dark"
-.sp
-[terminal.themes.dark]
-"mail.sidebar_highlighted_account" = { bg = "#ff4529" }
-"mail.listing.attachment_flag" = { fg = "#ff4529" }
-"mail.view.headers" = { fg = "30" }
-"mail.view.body" = {fg = "HotPink3", bg = "LightSalmon1"}
-# Linked value keys can be whatever key:
-"mail.listing.compact.even_unseen" = { bg = "mail.sidebar_highlighted_account" }
-# Linked color value keys can optionally refer to another field:
-"mail.listing.compact.odd_unseen" = { bg = "mail.sidebar_highlighted_account.fg" }
-.sp
-# define new theme. Undefined settings will inherit from the default "dark" theme.
-[terminal.themes."hunter2"]
-color_aliases= { "Jebediah" = "#b4da55" }
-"mail.listing.tag_default" = { fg = "$Jebediah" }
-"mail.view.headers" = { fg = "White", bg = "Black" }
-.Ed
-.Sh CUSTOM THEMES
-Custom themes can be included in your configuration files or be saved independently in your
-.Pa $XDG_CONFIG_HOME/meli/themes/
-directory as TOML files.
-To start creating a theme right away, you can begin by editing the default theme keys and values:
-.Pp
-.Dl meli print-default-theme > ~/.config/meli/themes/new_theme.toml
-.Pp
-.Pa new_theme.toml
-will now include all keys and values of the "dark" theme.
-.Pp
-.Dl meli print-loaded-themes
-.Pp
-will print all loaded themes with the links resolved.
-.Sh VALID ATTRIBUTE VALUES
-Case-sensitive.
-.Bl -dash -compact
-.It
-"Default"
-.It
-"Bold"
-.It
-"Dim"
-.It
-"Italics"
-.It
-"Underline"
-.It
-"Blink"
-.It
-"Reverse"
-.It
-"Hidden"
-.It
-Any combo of the above separated by a bitwise XOR "\&|" eg "Dim | Italics"
-.El
-.Sh VALID COLOR VALUES
-Color values are of type String with the following valid contents:
-.Bl -dash -compact
-.It
-"Default" is the terminal default. (Case-sensitive)
-.It
-Hex triplet e.g. #FFFFFF for RGB colors.
-Three character shorthand is also valid, e.g. #09c → #0099cc (Case-insensitive)
-.It
-0-255 byte for 256 colors.
-.It
-.Xr xterm 1
-name but with some modifications (for a full table see COLOR NAMES addendum) (Case-sensitive)
-.El
-.Sh NO COLOR
-To completely disable
-.Tn ANSI
-colors, there are two options:
-.Bl -dash -compact
-.It
-Set the
-.Ic use_color
-option (section
-.Ic terminal Ns
-) to false, which is true by default.
-.It
-The
-.Ev NO_COLOR
-environmental variable, when present (regardless of its value), prevents the addition of
-.Tn ANSI
-color.
-When the configuration value
-.Ic use_color
-is explicitly set to true by the user,
-.Ev NO_COLOR
-is ignored.
-.El
-.Pp
-In this mode, cursor locations (i.e., currently selected entries/items) will use the
-.Ql reverse video
-.Tn ANSI
-attribute to invert the terminal's default foreground/background colors.
-.Sh VALID KEYS
-.Bl -dash -compact
-.It
-theme_default
-.It
-error_message
-.It
-highlight
-.It
-status.bar
-.It
-status.command_bar
-.It
-status.history
-.It
-status.history.hints
-.It
-status.notification
-.It
-tab.focused
-.It
-tab.unfocused
-.It
-tab.bar
-.It
-widgets.list.header
-.It
-widgets.form.label
-.It
-widgets.form.field
-.It
-widgets.form.highlighted
-.It
-widgets.options.highlighted
-.It
-mail.sidebar
-.It
-mail.sidebar_divider
-.It
-mail.sidebar_unread_count
-.It
-mail.sidebar_index
-.It
-mail.sidebar_highlighted
-.It
-mail.sidebar_highlighted_unread_count
-.It
-mail.sidebar_highlighted_index
-.It
-mail.sidebar_highlighted_account
-.It
-mail.sidebar_highlighted_account_unread_count
-.It
-mail.sidebar_highlighted_account_index
-.It
-mail.listing.compact.even
-.It
-mail.listing.compact.odd
-.It
-mail.listing.compact.even_unseen
-.It
-mail.listing.compact.odd_unseen
-.It
-mail.listing.compact.even_selected
-.It
-mail.listing.compact.odd_selected
-.It
-mail.listing.compact.even_highlighted
-.It
-mail.listing.compact.odd_highlighted
-.It
-mail.listing.compact.even_highlighted_selected
-.It
-mail.listing.compact.odd_highlighted_selected
-.It
-mail.listing.plain.even
-.It
-mail.listing.plain.odd
-.It
-mail.listing.plain.even_unseen
-.It
-mail.listing.plain.odd_unseen
-.It
-mail.listing.plain.even_selected
-.It
-mail.listing.plain.odd_selected
-.It
-mail.listing.plain.even_highlighted
-.It
-mail.listing.plain.odd_highlighted
-.It
-mail.listing.plain.even_highlighted_selected
-.It
-mail.listing.plain.odd_highlighted_selected
-.It
-mail.listing.conversations
-.It
-mail.listing.conversations.subject
-.It
-mail.listing.conversations.from
-.It
-mail.listing.conversations.date
-.It
-mail.listing.conversations.unseen
-.It
-mail.listing.conversations.highlighted
-.It
-mail.listing.conversations.selected
-.It
-mail.listing.conversations.highlighted_selected
-.It
-mail.view.headers
-.It
-mail.view.headers_names
-.It
-mail.view.headers_area
-.It
-mail.view.body
-.It
-mail.view.thread.indentation.a
-.It
-mail.view.thread.indentation.b
-.It
-mail.view.thread.indentation.c
-.It
-mail.view.thread.indentation.d
-.It
-mail.view.thread.indentation.e
-.It
-mail.view.thread.indentation.f
-.It
-mail.listing.attachment_flag
-.It
-mail.listing.thread_snooze_flag
-.It
-mail.listing.tag_default
-.It
-pager.highlight_search
-.It
-pager.highlight_search_current
-.El
-.Sh COLOR NAMES
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-Aqua:14:_:Black:0
-Aquamarine1:122:_:Maroon:1
-Aquamarine2:86:_:Green:2
-Aquamarine3:79:_:Olive:3
-Black:0:_:Navy:4
-Blue:12:_:Purple1:5
-Blue1:21:_:Teal:6
-Blue2:19:_:Silver:7
-Blue3:20:_:Grey:8
-BlueViolet:57:_:Red:9
-CadetBlue:72:_:Lime:10
-CadetBlue1:73:_:Yellow:11
-Chartreuse1:118:_:Blue:12
-Chartreuse2:112:_:Fuchsia:13
-Chartreuse3:82:_:Aqua:14
-Chartreuse4:70:_:White:15
-Chartreuse5:76:_:Grey0:16
-Chartreuse6:64:_:NavyBlue:17
-CornflowerBlue:69:_:DarkBlue:18
-Cornsilk1:230:_:Blue2:19
-Cyan1:51:_:Blue3:20
-Cyan2:50:_:Blue1:21
-Cyan3:43:_:DarkGreen:22
-DarkBlue:18:_:DeepSkyBlue5:23
-DarkCyan:36:_:DeepSkyBlue6:24
-DarkGoldenrod:136:_:DeepSkyBlue7:25
-DarkGreen:22:_:DodgerBlue3:26
-DarkKhaki:143:_:DodgerBlue2:27
-DarkMagenta:90:_:Green4:28
-DarkMagenta1:91:_:SpringGreen6:29
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-DarkOliveGreen1:192:_:Turquoise4:30
-DarkOliveGreen2:155:_:DeepSkyBlue3:31
-DarkOliveGreen3:191:_:DeepSkyBlue4:32
-DarkOliveGreen4:107:_:DodgerBlue1:33
-DarkOliveGreen5:113:_:Green2:34
-DarkOliveGreen6:149:_:SpringGreen4:35
-DarkOrange:208:_:DarkCyan:36
-DarkOrange2:130:_:LightSeaGreen:37
-DarkOrange3:166:_:DeepSkyBlue2:38
-DarkRed:52:_:DeepSkyBlue1:39
-DarkRed2:88:_:Green3:40
-DarkSeaGreen:108:_:SpringGreen5:41
-DarkSeaGreen1:158:_:SpringGreen2:42
-DarkSeaGreen2:193:_:Cyan3:43
-DarkSeaGreen3:151:_:DarkTurquoise:44
-DarkSeaGreen4:157:_:Turquoise2:45
-DarkSeaGreen5:115:_:Green1:46
-DarkSeaGreen6:150:_:SpringGreen3:47
-DarkSeaGreen7:65:_:SpringGreen1:48
-DarkSeaGreen8:71:_:MediumSpringGreen:49
-DarkSlateGray1:123:_:Cyan2:50
-DarkSlateGray2:87:_:Cyan1:51
-DarkSlateGray3:116:_:DarkRed:52
-DarkTurquoise:44:_:DeepPink8:53
-DarkViolet:128:_:Purple4:54
-DarkViolet1:92:_:Purple5:55
-DeepPink1:199:_:Purple3:56
-DeepPink2:197:_:BlueViolet:57
-DeepPink3:198:_:Orange3:58
-DeepPink4:125:_:Grey37:59
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-DeepPink6:162:_:MediumPurple6:60
-DeepPink7:89:_:SlateBlue2:61
-DeepPink8:53:_:SlateBlue3:62
-DeepPink9:161:_:RoyalBlue1:63
-DeepSkyBlue1:39:_:Chartreuse6:64
-DeepSkyBlue2:38:_:DarkSeaGreen7:65
-DeepSkyBlue3:31:_:PaleTurquoise4:66
-DeepSkyBlue4:32:_:SteelBlue:67
-DeepSkyBlue5:23:_:SteelBlue3:68
-DeepSkyBlue6:24:_:CornflowerBlue:69
-DeepSkyBlue7:25:_:Chartreuse4:70
-DodgerBlue1:33:_:DarkSeaGreen8:71
-DodgerBlue2:27:_:CadetBlue:72
-DodgerBlue3:26:_:CadetBlue1:73
-Fuchsia:13:_:SkyBlue3:74
-Gold1:220:_:SteelBlue1:75
-Gold2:142:_:Chartreuse5:76
-Gold3:178:_:PaleGreen4:77
-Green:2:_:SeaGreen4:78
-Green1:46:_:Aquamarine3:79
-Green2:34:_:MediumTurquoise:80
-Green3:40:_:SteelBlue2:81
-Green4:28:_:Chartreuse3:82
-GreenYellow:154:_:SeaGreen3:83
-Grey:8:_:SeaGreen1:84
-Grey0:16:_:SeaGreen2:85
-Grey100:231:_:Aquamarine2:86
-Grey11:234:_:DarkSlateGray2:87
-Grey15:235:_:DarkRed2:88
-Grey19:236:_:DeepPink7:89
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-Grey23:237:_:DarkMagenta:90
-Grey27:238:_:DarkMagenta1:91
-Grey3:232:_:DarkViolet1:92
-Grey30:239:_:Purple2:93
-Grey35:240:_:Orange4:94
-Grey37:59:_:LightPink3:95
-Grey39:241:_:Plum4:96
-Grey42:242:_:MediumPurple4:97
-Grey46:243:_:MediumPurple5:98
-Grey50:244:_:SlateBlue1:99
-Grey53:102:_:Yellow4:100
-Grey54:245:_:Wheat4:101
-Grey58:246:_:Grey53:102
-Grey62:247:_:LightSlateGrey:103
-Grey63:139:_:MediumPurple:104
-Grey66:248:_:LightSlateBlue:105
-Grey69:145:_:Yellow5:106
-Grey7:233:_:DarkOliveGreen4:107
-Grey70:249:_:DarkSeaGreen:108
-Grey74:250:_:LightSkyBlue2:109
-Grey78:251:_:LightSkyBlue3:110
-Grey82:252:_:SkyBlue2:111
-Grey84:188:_:Chartreuse2:112
-Grey85:253:_:DarkOliveGreen5:113
-Grey89:254:_:PaleGreen3:114
-Grey93:255:_:DarkSeaGreen5:115
-Honeydew2:194:_:DarkSlateGray3:116
-HotPink:205:_:SkyBlue1:117
-HotPink1:206:_:Chartreuse1:118
-HotPink2:169:_:LightGreen:119
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-HotPink3:132:_:LightGreen1:120
-HotPink4:168:_:PaleGreen1:121
-IndianRed:131:_:Aquamarine1:122
-IndianRed1:167:_:DarkSlateGray1:123
-IndianRed2:204:_:Red2:124
-IndianRed3:203:_:DeepPink4:125
-Khaki1:228:_:MediumVioletRed:126
-Khaki3:185:_:Magenta4:127
-LightCoral:210:_:DarkViolet:128
-LightCyan2:195:_:Purple:129
-LightCyan3:152:_:DarkOrange2:130
-LightGoldenrod1:227:_:IndianRed:131
-LightGoldenrod2:222:_:HotPink3:132
-LightGoldenrod3:179:_:MediumOrchid3:133
-LightGoldenrod4:221:_:MediumOrchid:134
-LightGoldenrod5:186:_:MediumPurple2:135
-LightGreen:119:_:DarkGoldenrod:136
-LightGreen1:120:_:LightSalmon2:137
-LightPink1:217:_:RosyBrown:138
-LightPink2:174:_:Grey63:139
-LightPink3:95:_:MediumPurple3:140
-LightSalmon1:216:_:MediumPurple1:141
-LightSalmon2:137:_:Gold2:142
-LightSalmon3:173:_:DarkKhaki:143
-LightSeaGreen:37:_:NavajoWhite3:144
-LightSkyBlue1:153:_:Grey69:145
-LightSkyBlue2:109:_:LightSteelBlue3:146
-LightSkyBlue3:110:_:LightSteelBlue:147
-LightSlateBlue:105:_:Yellow6:148
-LightSlateGrey:103:_:DarkOliveGreen6:149
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-LightSteelBlue:147:_:DarkSeaGreen6:150
-LightSteelBlue1:189:_:DarkSeaGreen3:151
-LightSteelBlue3:146:_:LightCyan3:152
-LightYellow3:187:_:LightSkyBlue1:153
-Lime:10:_:GreenYellow:154
-Magenta1:201:_:DarkOliveGreen2:155
-Magenta2:165:_:PaleGreen2:156
-Magenta3:200:_:DarkSeaGreen4:157
-Magenta4:127:_:DarkSeaGreen1:158
-Magenta5:163:_:PaleTurquoise1:159
-Magenta6:164:_:Red3:160
-Maroon:1:_:DeepPink9:161
-MediumOrchid:134:_:DeepPink6:162
-MediumOrchid1:171:_:Magenta5:163
-MediumOrchid2:207:_:Magenta6:164
-MediumOrchid3:133:_:Magenta2:165
-MediumPurple:104:_:DarkOrange3:166
-MediumPurple1:141:_:IndianRed1:167
-MediumPurple2:135:_:HotPink4:168
-MediumPurple3:140:_:HotPink2:169
-MediumPurple4:97:_:Orchid:170
-MediumPurple5:98:_:MediumOrchid1:171
-MediumPurple6:60:_:Orange2:172
-MediumSpringGreen:49:_:LightSalmon3:173
-MediumTurquoise:80:_:LightPink2:174
-MediumVioletRed:126:_:Pink3:175
-MistyRose1:224:_:Plum3:176
-MistyRose3:181:_:Violet:177
-NavajoWhite1:223:_:Gold3:178
-NavajoWhite3:144:_:LightGoldenrod3:179
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-Navy:4:_:Tan:180
-NavyBlue:17:_:MistyRose3:181
-Olive:3:_:Thistle3:182
-Orange1:214:_:Plum2:183
-Orange2:172:_:Yellow3:184
-Orange3:58:_:Khaki3:185
-Orange4:94:_:LightGoldenrod5:186
-OrangeRed1:202:_:LightYellow3:187
-Orchid:170:_:Grey84:188
-Orchid1:213:_:LightSteelBlue1:189
-Orchid2:212:_:Yellow2:190
-PaleGreen1:121:_:DarkOliveGreen3:191
-PaleGreen2:156:_:DarkOliveGreen1:192
-PaleGreen3:114:_:DarkSeaGreen2:193
-PaleGreen4:77:_:Honeydew2:194
-PaleTurquoise1:159:_:LightCyan2:195
-PaleTurquoise4:66:_:Red1:196
-PaleVioletRed1:211:_:DeepPink2:197
-Pink1:218:_:DeepPink3:198
-Pink3:175:_:DeepPink1:199
-Plum1:219:_:Magenta3:200
-Plum2:183:_:Magenta1:201
-Plum3:176:_:OrangeRed1:202
-Plum4:96:_:IndianRed3:203
-Purple:129:_:IndianRed2:204
-Purple1:5:_:HotPink:205
-Purple2:93:_:HotPink1:206
-Purple3:56:_:MediumOrchid2:207
-Purple4:54:_:DarkOrange:208
-Purple5:55:_:Salmon1:209
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-Red:9:_:LightCoral:210
-Red1:196:_:PaleVioletRed1:211
-Red2:124:_:Orchid2:212
-Red3:160:_:Orchid1:213
-RosyBrown:138:_:Orange1:214
-RoyalBlue1:63:_:SandyBrown:215
-Salmon1:209:_:LightSalmon1:216
-SandyBrown:215:_:LightPink1:217
-SeaGreen1:84:_:Pink1:218
-SeaGreen2:85:_:Plum1:219
-SeaGreen3:83:_:Gold1:220
-SeaGreen4:78:_:LightGoldenrod4:221
-Silver:7:_:LightGoldenrod2:222
-SkyBlue1:117:_:NavajoWhite1:223
-SkyBlue2:111:_:MistyRose1:224
-SkyBlue3:74:_:Thistle1:225
-SlateBlue1:99:_:Yellow1:226
-SlateBlue2:61:_:LightGoldenrod1:227
-SlateBlue3:62:_:Khaki1:228
-SpringGreen1:48:_:Wheat1:229
-SpringGreen2:42:_:Cornsilk1:230
-SpringGreen3:47:_:Grey100:231
-SpringGreen4:35:_:Grey3:232
-SpringGreen5:41:_:Grey7:233
-SpringGreen6:29:_:Grey11:234
-SteelBlue:67:_:Grey15:235
-SteelBlue1:75:_:Grey19:236
-SteelBlue2:81:_:Grey23:237
-SteelBlue3:68:_:Grey27:238
-Tan:180:_:Grey30:239
-.TE
-.TS
-allbox tab(:);
-lb|lb|l|lb|lb
-l  l|l|l  l.
-name \(da:byte:_:name:byte \(da
-Teal:6:_:Grey35:240
-Thistle1:225:_:Grey39:241
-Thistle3:182:_:Grey42:242
-Turquoise2:45:_:Grey46:243
-Turquoise4:30:_:Grey50:244
-Violet:177:_:Grey54:245
-Wheat1:229:_:Grey58:246
-Wheat4:101:_:Grey62:247
-White:15:_:Grey66:248
-Yellow:11:_:Grey70:249
-Yellow1:226:_:Grey74:250
-Yellow2:190:_:Grey78:251
-Yellow3:184:_:Grey82:252
-Yellow4:100:_:Grey85:253
-Yellow5:106:_:Grey89:254
-Yellow6:148:_:Grey93:255
-.TE
-.Sh SEE ALSO
-.Xr meli 1 ,
-.Xr meli.conf 5
-.Sh STANDARDS
-.Bl -item -compact
-.It
-.Lk https://toml.io/en/v0.5.0 "TOML Standard v.0.5.0"
-.It
-.Lk https://no\-color.org/ "NO_COLOR: disabling ANSI color output by default"
-.El
-.Sh AUTHORS
-Copyright 2017\(en2024
-.An Manos Pitsidianakis Aq Mt manos@pitsidianak.is
-.Pp
-Released under the GPL, version 3 or greater.
-This software carries no warranty of any kind.
-.Po
-See
-.Pa COPYING
-for full copyright and warranty notices.
-.Pc
-.Ss Links
-.Bl -item -compact
-.It
-.Lk https://meli\-email.org "Website"
-.It
-.Lk https://git.meli\-email.org/meli/meli "Main\ git\ repository\ and\ issue\ tracker"
-.It
-.Lk https://codeberg.org/meli/meli "Official\ read-only\ git\ mirror\ on\ codeberg.org"
-.It
-.Lk https://github.com/meli/meli "Official\ read-only\ git\ mirror\ on\ github.com"
-.It
-.Lk https://crates.io/crates/meli "meli\ crate\ on\ crates.io"
-.El

meli/docs/meli.1

@@ -1,939 +0,0 @@
-.\" meli - meli.1
-.\"
-.\" Copyright 2017-2019 Manos Pitsidianakis
-.\"
-.\" This file is part of meli.
-.\"
-.\" meli is free software: you can redistribute it and/or modify
-.\" it under the terms of the GNU General Public License as published by
-.\" the Free Software Foundation, either version 3 of the License, or
-.\" (at your option) any later version.
-.\"
-.\" meli is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-.\" GNU General Public License for more details.
-.\"
-.\" You should have received a copy of the GNU General Public License
-.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
-.\"
-.de HorizontalRule
-.\"\l'\n(.l\(ru1.25'
-.sp
-..
-.de Shortcut
-.Sm
-.Aq \\$1
-\ 
-.Po
-.Em shortcuts.\\$2\&. Ns
-.Em \\$3
-.Pc
-.Sm
-..
-.de ShortcutPeriod
-.Aq \\$1
-.Po
-.Em shortcuts.\\$2\&. Ns
-.Em \\$3
-.Pc Ns
-..
-.de Command
-.Bd -ragged
-.Cm \\$*
-.Ed
-.sp
-..
-.\".Dd November 11, 2022
-.Dd March 10, 2024
-.Dt MELI 1
-.Os
-.Sh NAME
-.Nm meli
-.Nd terminal e\-mail client
-.Em μέλι
-is the Greek word for honey
-.Sh SYNOPSIS
-.Nm
-.Op Fl -help | h
-.Op Fl -version | v
-.Op Fl -config Ar path
-.Bl -tag -width flag -offset indent
-.It Fl -help | h
-Show help message and exit.
-.It Fl -version | v
-Show version and exit.
-.It Fl -config Ar path
-Start meli with given configuration file.
-.It Cm create-config Op Ar path
-Create configuration file in
-.Pa path
-if given, or at
-.Pa $XDG_CONFIG_HOME/meli/config.toml
-.It Cm test-config Op Ar path
-Test a configuration file for syntax issues or missing options.
-.It Cm man Op Ar page
-Print documentation page and exit (Piping to a pager is recommended).
-.It Cm install-man Op Ar path
-Install manual pages to the first location provided by
-.Ev MANPATH
-or
-.Xr manpath 1 ,
-unless you specify the directory as an argument.
-.It Cm compiled-with
-Print compile time feature flags of this binary.
-.It Cm edit-config
-Edit configuration files with
-.Ev EDITOR
-or
-.Ev VISUAL Ns
-\&.
-.It Cm help
-Prints help information or the help of the given subcommand(s).
-.It Cm print-app-directories
-Print all directories that
-.Ns Nm
-creates and uses.
-.It Cm print-config-path
-Print location of configuration file that will be loaded on normal app startup.
-.It Cm print-default-theme
-Print default theme keys and values in TOML syntax, to be used as a blueprint.
-.It Cm print-loaded-themes
-Print all loaded themes in TOML syntax.
-.It Cm print-log-path
-Print log file location.
-.It Cm view
-View mail from input file.
-.El
-.Sh DESCRIPTION
-.Nm
-is a terminal mail client aiming for extensive and user-friendly configurability.
-.Bd -literal
-     ^^      .-=-=-=-.  ^^
- ^^        (`-=-=-=-=-`)         ^^
-         (`-=-=-=-=-=-=-`)  ^^         ^^
-   ^^   (`-=-=-=-=-=-=-=-`)   ^^
-       ( `-=-=-=-(@)-=-=-` )      ^^
-       (`-=-=-=-=-=-=-=-=-`)  ^^
-       (`-=-=-=-=-=-=-=-=-`)          ^^
-       (`-=-=-=-=-=-=-=-=-`)
-^^     (`-=-=-=-=-=-=-=-=-`)  ^^
-   ^^   (`-=-=-=-=-=-=-=-`)          ^^
-         (`-=-=-=-=-=-=-`)  ^^
-  ^^       (`-=-=-=-=-`)
-            `-=-=-=-=-`          ^^
-.Ed
-.Sh STARTING WITH meli
-When launched for the first time,
-.Nm
-will search for its configuration directory,
-.Pa $XDG_CONFIG_HOME/meli/ Ns
-\&.
-If it doesn't exist, you will be asked if you want to create one and presented with a sample configuration file
-.Pq Pa $XDG_CONFIG_HOME/meli/config.toml
-that includes the basic settings required for setting up accounts allowing you to copy and edit right away.
-See
-.Xr meli.conf 5
-for the available configuration options.
-.Pp
-At any time, you may press
-.Shortcut \&? general toggle_help
-for a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
-.Pp
-The main visual navigation tool, the left-side sidebar may be toggled with
-.ShortcutPeriod \(ga listing toggle_menu_visibility
-\&.
-.Pp
-Each mailbox may be viewed in 4 modes:
-.Bl -dash -compact
-.It
-.Tg index-style-plain
-.Em Plain
-views each mail individually,
-.It
-.Tg index-style-threaded
-.Em Threaded
-shows their thread relationship visually,
-.It
-.Tg index-style-conversations
-.Em Conversations
-collapses each thread of e\-mails into a single entry,
-.It
-.Tg index-style-compact
-.Em Compact
-shows one row per thread.
-.El
-.Pp
-If you're using a light color palette in your terminal, you should set
-.Em theme = "light"
-in the
-.Em terminal
-section of your configuration.
-See
-.Xr meli-themes 5
-for complete documentation on user themes.
-.Pp
-See
-.Xr meli 7
-for a more detailed tutorial on using
-.Nm Ns
-\&.
-.Sh SHORTCUTS
-See
-.Xr meli.conf 5 SHORTCUTS
-for shortcuts and their default values.
-.Sh VIEWING MAIL
-Open attachments by typing their index in the attachments list and then
-.ShortcutPeriod a envelope_view open_attachment
-\&.
-.Nm
-will attempt to open text inside its pager, and other content via
-.Cm xdg-open Ns
-\&.
-Press
-.Shortcut m envelope_view open_mailcap
-instead to use the mailcap entry for the MIME type of the attachment, if any.
-See
-.Sx FILES
-for the location of the mailcap files and
-.Xr mailcap 5
-for their syntax.
-You can save individual attachments with the
-.Command save-attachment Ar INDEX Ar path-to-file
-command.
-.Ar INDEX
-is the attachment's index in the listing.
-If the path provided is a directory, the attachment is saved with its filename set to the filename in the attachment, if any.
-If the 0th index is provided, the entire message is saved.
-If the path provided is a directory, the message is saved as an eml file with its filename set to the messages message-id.
-.Sh SEARCH
-Each e\-mail storage backend has a default search method assigned.
-.Em IMAP
-uses the SEARCH command,
-.Em notmuch
-uses libnotmuch and
-.Em Maildir/mbox
-performs a slow linear search.
-It is advised to use a search backend on
-.Em Maildir/mbox
-accounts.
-.Nm Ns
-, if built with sqlite3, includes the ability to perform full text search on the following fields:
-.Em From ,
-.Em To ,
-.Em Cc ,
-.Em Bcc ,
-.Em In-Reply-To ,
-.Em References ,
-.Em Subject
-and
-.Em Date .
-The message body (in plain text human readable form) and the flags can also be queried.
-To enable sqlite3 indexing for an account set
-.Em search_backend
-to
-.Em sqlite3
-in the configuration file and to create the sqlite3 index issue command:
-.Command index Ar ACCOUNT_NAME Ns
-To search in the message body type your keywords without any special formatting.
-To search in specific fields, prepend your search keyword with "field:" like so:
-.Pp
-.D1 subject:helloooo or subject:\&"call for help\&" or \&"You remind me today of a small, Mexican chihuahua.\&"
-.Pp
-.D1 not ((from:unrealistic and (to:complex or not "query")) or flags:seen,draft)
-.Pp
-.D1 alladdresses:mailing@example.com and cc:me@example.com
-.Pp
-Boolean operators are
-.Em or Ns
-,
-.Em and
-and
-.Em not
-.Po
-alias:
-.Em \&!
-.Pc
-String keywords with spaces must be quoted.
-Quotes should always be escaped.
-.Ss Important Notice about IMAP/JMAP
-.HorizontalRule
-To prevent downloading all your messages from your IMAP/JMAP server, don't set
-.Em search_backend
-to
-.Em sqlite3 Ns
-\&.
-.Nm
-will relay your queries to the IMAP server.
-Expect a delay between query and response.
-Sqlite3 on the contrary at reasonable mailbox sizes should have a non noticeable delay.
-.Ss QUERY ABNF SYNTAX
-.HorizontalRule
-.Bl -dash -compact
-.It
-.Li query = \&"(\&" query \&")\&" | from | to | cc | bcc | alladdresses | subject | flags | has_attachments | query \&"or\&" query | query \&"and\&" query | not query
-.It
-.Li not = \&"not\&" | \&"!\&"
-.It
-.Li quoted = ALPHA / SP *(ALPHA / DIGIT / SP)
-.It
-.Li term = ALPHA *(ALPHA / DIGIT) | DQUOTE quoted DQUOTE
-.It
-.Li tagname = term
-.It
-.Li flagval = \&"passed\&" | \&"replied\&" | \&"seen\&" | \&"read\&" | \&"junk\&" | \&"trash\&" | \&"trashed\&" | \&"draft\&" | \&"flagged\&" | tagname
-.It
-.Li flagterm = flagval | flagval \&",\&" flagterm
-.It
-.Li from = \&"from:\&" term
-.It
-.Li to = \&"to:\&" term
-.It
-.Li cc = \&"cc:\&" term
-.It
-.Li bcc = \&"bcc:\&" term
-.It
-.Li alladdresses = \&"alladdresses:\&" term
-.It
-.Li subject = \&"subject:\&" term
-.It
-.Li flags = \&"flags:\&" flag | \&"tags:\&" flag | \&"is:\&" flag
-.El
-.Sh FLAGS
-.Nm
-supports the basic maildir flags: passed, replied, seen, trashed, draft and flagged.
-Flags can be searched with the
-.Ns Ql flags:
-prefix in a search query, and can be modified by
-.Command flag set FLAG
-and
-.Command flag unset FLAG
-.Sh TAGS
-.Nm
-supports tagging in notmuch and IMAP/JMAP backends.
-Tags can be searched with the
-.Ns Ql tags:
-or
-.Ns Ql flags:
-prefix in a search query, and can be modified by
-.Command tag add TAG
-and
-.Command tag remove TAG
-(see
-.Xr meli.conf 5 TAGS Ns
-, settings
-.Ic colors
-and
-.Ic ignore_tags
-for how to set tag colors and tag visibility)
-.Sh COMPOSING
-.Ss Opening the message Composer tab
-To create a new mail message, press
-.Shortcut m listing new_mail
-while viewing a mailbox.
-To reply to a mail, press
-.ShortcutPeriod R envelope_view reply
-\&.
-Both these actions open the mail composer view in a new tab.
-.Ss Editing text
-.HorizontalRule
-.Bl -dash -compact
-.It
-Edit the header fields by selecting with the arrow keys and pressing
-.Shortcut Enter general focus_in_text_field
-to enter
-.Em INSERT
-mode and
-.Cm Esc
-key to exit.
-.It
-At any time you may press
-.Shortcut e composing edit Ns
-to launch your editor (see
-.Xr meli.conf 5 COMPOSING Ns
-, setting
-.Ic editor_command
-for how to select which editor to launch).
-.It
-Your editor can be used in
-.Nm Ns
-\&'s embed terminal emulator by setting
-.Ic embed
-to
-.Em true
-in your composing settings
-.Po
-You can return to
-.Nm
-at any time by pressing
-.Aq Ctrl-Z
-.Pc
-.It
-When launched, your editor captures all input until it exits or stops.
-.It
-To stop your editor and return to
-.Nm
-press
-.Aq Ctrl-z
-and to resume editing press the
-.Ic edit
-command again.
-.El
-.Ss Attachments
-.HorizontalRule
-Attachments may be handled with the
-.Cm add-attachment Ns
-,
-.Cm remove-attachment
-commands (see below).
-.Ss Sending
-.HorizontalRule
-Finally, pressing
-.Shortcut s composing send_mail
-will send your message according to your settings
-.Po
-see
-.Xr meli.conf 5 COMPOSING Ns
-, setting name
-.Ic send_mail
-.Pc Ns
-\&.
-With no Draft or Sent mailbox,
-.Nm
-tries first saving mail in your INBOX and then at any other mailbox.
-On complete failure to save your draft or sent message it will be saved in your
-.Em tmp
-directory instead and you will be notified of its location.
-.Ss Drafts
-.HorizontalRule
-To save your draft without sending it, issue
-.Em COMMAND
-.Cm close
-and select 'save as draft'.
-.sp
-To open a draft for further editing, select your draft in the mail listing and press
-.Ic edit Ns
-\&.
-.Sh CONTACTS
-.Nm
-supports three kinds of contact backends:
-.Bl -enum -compact
-.It
-an internal format that gets saved under
-.Pa $XDG_DATA_HOME/meli/account_name/addressbook Ns
-\&.
-.It
-vCard files (v3, v4) through the
-.Ic vcard_folder
-option in the account section.
-The path defined as
-.Ic vcard_folder
-can hold multiple vCards per file.
-They are loaded read only.
-.It
-a
-.Xr mutt 1
-compatible alias file in the option
-.Ic mutt_alias_file
-.El
-.sp
-See
-.Xr meli.conf 5 ACCOUNTS
-for the complete account contact configuration values.
-.Sh MODES
-.Bl -tag -compact -width 8n
-.It NORMAL
-is the default mode
-.It COMMAND
-commands are issued in
-.Em COMMAND
-mode, by default started with
-.Shortcut \&: general enter_command_mode
-and exited with
-.Aq Esc
-key.
-.It EMBED
-is the mode of the embed terminal emulator
-.It INSERT
-captures all input as text input, and is exited with
-.Cm Esc
-key.
-.El
-.Sh COMMAND
-.Ss Mail listing commands
-.HorizontalRule
-.Bl -tag -width 36n
-.It Cm set Ar plain | threaded | compact | conversations
-set the way mailboxes are displayed
-.El
-.TS
-allbox tab(:);
-lb l.
-conversations:shows one entry per thread
-compact:shows one row per thread
-threaded:shows threads as a tree structure
-plain:shows one row per mail, regardless of threading
-.TE
-.Bl -tag -width 36n
-.It Cm sort Ar subject | date \  Ar asc | desc
-sort mail listing
-.It Cm subsort Ar subject | date \  Ar asc | desc
-sorts only the first level of replies.
-.It Cm go Ar n
-where
-.Ar n
-is a mailbox prefixed with the
-.Ar n
-number in the side menu for the current account
-.It Cm toggle thread_snooze
-don't issue notifications for thread under cursor in thread listing
-.It Cm search Ar STRING
-search mailbox with
-.Ar STRING
-query.
-Escape exits search results.
-.It Cm select Ar STRING
-select threads matching
-.Ar STRING
-query.
-.It Cm clear-selection
-Clear current selection.
-.It Cm set seen, set unseen
-Set seen status of message.
-.It Cm import Ar FILEPATH Ar MAILBOX_PATH
-Import mail from file into given mailbox.
-.It Cm copyto, moveto Ar MAILBOX_PATH
-Copy or move to other mailbox.
-.It Cm copyto, moveto Ar ACCOUNT Ar MAILBOX_PATH
-Copy or move to another account's mailbox.
-.It Cm delete
-Delete selected threads.
-.It Cm export-mbox Ar FILEPATH
-Export selected threads to mboxcl2 file.
-.It Cm create\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
-create mailbox with given path.
-Be careful with backends and separator sensitivity (eg IMAP)
-.It Cm subscribe\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
-subscribe to mailbox with given path
-.It Cm unsubscribe\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
-unsubscribe to mailbox with given path
-.It Cm rename\-mailbox Ar ACCOUNT Ar MAILBOX_PATH_SRC Ar MAILBOX_PATH_DEST
-rename mailbox
-.It Cm delete\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
-deletes mailbox in the mail backend.
-This action is irreversible.
-.El
-.Ss Mail view commands
-.HorizontalRule
-.Bl -tag -width 36n
-.It Cm pipe Ar EXECUTABLE Ar ARGS
-pipe pager contents to binary
-.It Cm filter Ar EXECUTABLE Ar ARGS
-filter and display pager contents through command
-.It Cm list-post
-post in list of viewed envelope
-.It Cm list-unsubscribe
-unsubscribe automatically from list of viewed envelope
-.It Cm list-archive
-open list archive with
-.Cm xdg-open
-.El
-.Ss Composing mail commands
-.HorizontalRule
-.Bl -tag -width 36n
-.It Cm mailto Ar MAILTO_ADDRESS
-Opens a composer tab with initial values parsed from the
-.Li mailto:
-address.
-.It Cm add-attachment Ar PATH
-in composer, add
-.Ar PATH
-as an attachment
-.It Cm add-attachment < Ar CMD Ar ARGS
-in composer, pipe
-.Ar CMD Ar ARGS
-output into an attachment
-.It Cm add-attachment-file-picker
-Launch command defined in the configuration value
-.Ic file_picker_command
-in
-.Xr meli.conf 5 TERMINAL
-.It Cm add-attachment-file-picker < Ar CMD Ar ARGS
-Launch command
-.Ar CMD Ar ARGS Ns
-\&.
-The command should print file paths in stderr, separated by NULL bytes.
-.It Cm remove-attachment Ar INDEX
-remove attachment with given index
-.It Cm toggle sign
-toggle between signing and not signing this message.
-If the gpg invocation fails then the mail won't be sent.
-See
-.Xr meli.conf 5 PGP
-for PGP configuration.
-.It Cm save-draft
-saves a copy of the draft in the Draft folder
-.El
-.Ss Generic commands
-.HorizontalRule
-.Bl -tag -width 36n
-.It Cm open-in-tab
-opens envelope view in new tab
-.It Cm close
-closes closeable tabs
-.It Cm setenv Ar KEY=VALUE
-set environment variable
-.Ar KEY
-to
-.Ar VALUE
-.It Cm printenv Ar KEY
-print environment variable
-.Ar KEY
-.It Cm quit
-Quits
-.Nm Ns
-\&.
-.It Cm reload-config
-Reloads configuration but only if account configuration is unchanged.
-Useful if you want to reload some settings without restarting
-.Nm Ns
-\&.
-.El
-.Sh EXIT STATUS
-.Nm
-exits with 0 on a successful run.
-Other exit statuses are:
-.Bl -tag -width 5n
-.It 1
-catchall for general errors
-.It 101
-process panic
-.El
-.Sh ENVIRONMENT
-.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
-.It Ev EDITOR
-Specifies the editor to use
-.It Ev MELI_CONFIG
-Override the configuration file
-.It Ev NO_COLOR
-When defined (regardless of its value), prevents the addition of
-.Tn ANSI
-color.
-The configuration value
-.Ic use_color
-overrides this.
-.El
-.Sh FILES
-.Nm
-uses the following parts of the XDG standard:
-.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
-.It Ev XDG_CONFIG_HOME
-defaults to
-.Pa ~/.config/
-.It Ev XDG_CACHE_HOME
-defaults to
-.Pa ~/.cache/
-.El
-.Pp
-and appropriates the following locations:
-.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
-.It Pa $XDG_CONFIG_HOME/meli/
-User configuration directory
-.It Pa $XDG_CONFIG_HOME/meli/config.toml
-User configuration file, see
-.Xr meli.conf 5
-for its syntax and values.
-.It Pa $XDG_CONFIG_HOME/meli/hooks/*
-Reserved for event hooks.
-.It Pa $XDG_CONFIG_HOME/meli/plugins/*
-Reserved for plugin files.
-.It Pa $XDG_CACHE_HOME/meli/*
-Internal cached data used by meli.
-.It Pa $XDG_DATA_HOME/meli/*
-Internal data used by meli.
-.It Pa $XDG_DATA_HOME/meli/meli.log
-Operation log.
-.It Pa /tmp/meli/*
-Temporary files generated by
-.Nm Ns
-\&.
-.El
-.Pp
-Mailcap entries are searched for in the following files, in this order:
-.Pp
-.Bl -enum -compact -offset indent
-.It
-.Pa $XDG_CONFIG_HOME/meli/mailcap
-.It
-.Pa $XDG_CONFIG_HOME/.mailcap
-.It
-.Pa $HOME/.mailcap
-.It
-.Pa /etc/mailcap
-.It
-.Pa /usr/etc/mailcap
-.It
-.Pa /usr/local/etc/mailcap
-.El
-.Sh STANDARDS
-.Bl -dash -compact
-.It
-.Rs
-.%B XDG Base Directory Specification
-.%O Version 0.8
-.%A Waldo Bastian
-.%A Allison Karlitskaya
-.%A Lennart Poettering
-.%A Johannes Löthberg
-.%U https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
-.%D May 08, 2021
-.Re
-.It
-.Rs
-.%B maildir
-.%A Daniel J. Bernstein
-.%U https://cr.yp.to/proto/maildir.html
-.%D 1995
-.Re
-.It
-.Rs
-.%B RFC1524 A User Agent Configuration Mechanism For Multimedia Mail Format Information
-.%O mailcap file
-.%I Legacy
-.%D September 01, 1993
-.%A Dr. Nathaniel S. Borenstein
-.%U https://datatracker.ietf.org/doc/rfc1524/
-.Re
-.It
-.Rs
-.%B RFC2047 MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text
-.%I IETF
-.%D November 01, 1996
-.%A Keith Moore
-.%U https://datatracker.ietf.org/doc/rfc2047/
-.Re
-.It
-.Rs
-.%B RFC2183 Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field
-.%I Legacy
-.%D August 01, 1997
-.%A Rens Troost
-.%A Steve Dorner
-.%A Keith Moore
-.%U https://datatracker.ietf.org/doc/rfc2183/
-.Re
-.It
-.Rs
-.%B RFC2369 The Use of URLs as Meta-Syntax for Core Mail List Commands and their Transport through Message Header Fields
-.%I Legacy
-.%D July 01, 1998
-.%A Joshua D. Baer
-.%A Grant Neufeld
-.%U https://datatracker.ietf.org/doc/rfc2369/
-.Re
-.It
-.Rs
-.%B RFC2426 vCard MIME Directory Profile
-.%O vCard Version 3
-.%I IETF
-.%D September 01, 1998
-.%A Frank Dawson
-.%A Tim Howes
-.%U https://datatracker.ietf.org/doc/rfc2426/
-.Re
-.It
-.Rs
-.%B RFC3156 MIME Security with OpenPGP
-.%I IETF
-.%D August 01, 2001
-.%A Thomas Roessler
-.%A Michael Elkins
-.%A Raph Levien
-.%A Dave Del Torto
-.%U https://datatracker.ietf.org/doc/rfc3156/
-.Re
-.It
-.Rs
-.%B RFC3461 Simple Mail Transfer Protocol (SMTP) Service Extension for Delivery Status Notifications (DSNs)
-.%I IETF
-.%D January 23, 2003
-.%A Keith Moore
-.%U https://datatracker.ietf.org/doc/rfc3461/
-.Re
-.It
-.Rs
-.%B RFC3501 INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1
-.%I IETF
-.%D March 18, 2003
-.%A Mark Crispin
-.%U https://datatracker.ietf.org/doc/rfc3501/
-.Re
-.It
-.Rs
-.%B RFC3676 The Text/Plain Format and DelSp Parameters
-.%I IETF
-.%D February 19, 2004
-.%A Randall Gellens
-.%U https://datatracker.ietf.org/doc/rfc3676/
-.Re
-.It
-.Rs
-.%B RFC3691 Internet Message Access Protocol (IMAP) UNSELECT command
-.%I IETF
-.%D February 20, 2004
-.%A Alexey Melnikov
-.%U https://datatracker.ietf.org/doc/rfc3691/
-.Re
-.It
-.Rs
-.%B RFC3977 Network News Transfer Protocol (NNTP)
-.%I IETF
-.%D October 26, 2006
-.%A Clive Feather
-.%U https://datatracker.ietf.org/doc/rfc3977/
-.Re
-.It
-.Rs
-.%B RFC4549 Synchronization Operations for Disconnected IMAP4 Clients
-.%I IETF
-.%D June 16, 2006
-.%A Alexey Melnikov
-.%U https://datatracker.ietf.org/doc/rfc4549/
-.Re
-.It
-.Rs
-.%B RFC4616 The PLAIN Simple Authentication and Security Layer (SASL) Mechanism
-.%I IETF
-.%D August 31, 2006
-.%A Kurt Zeilenga
-.%U https://datatracker.ietf.org/doc/rfc4616/
-.Re
-.It
-.Rs
-.%B RFC4954 SMTP Service Extension for Authentication
-.%I IETF
-.%D July 23, 2007
-.%A Rob Siemborski
-.%A Alexey Melnikov
-.%U https://datatracker.ietf.org/doc/rfc4954/
-.Re
-.It
-.Rs
-.%B RFC5321 Simple Mail Transfer Protocol
-.%I IETF
-.%D October 01, 2008
-.%A Dr. John C. Klensin
-.%U https://datatracker.ietf.org/doc/rfc5321/
-.Re
-.It
-.Rs
-.%B RFC5322 Internet Message Format
-.%I IETF
-.%D October 01, 2008
-.%A Pete Resnick
-.%U https://datatracker.ietf.org/doc/rfc5322/
-.Re
-.It
-.Rs
-.%B RFC6048 Network News Transfer Protocol (NNTP) Additions to LIST Command
-.%I IETF
-.%D November 22, 2010
-.%A Julien ÉLIE
-.%U https://datatracker.ietf.org/doc/rfc6048/
-.Re
-.It
-.Rs
-.%B RFC6152 SMTP Service Extension for 8-bit MIME Transport
-.%I IETF
-.%D March 07, 2011
-.%A Dave Crocker
-.%A Dr. John C. Klensin
-.%A Dr. Marshall T. Rose
-.%A Ned Freed
-.%U https://datatracker.ietf.org/doc/rfc6152/
-.Re
-.It
-.Rs
-.%B RFC6350 vCard Format Specification
-.%O vCard Version 4
-.%I IETF
-.%D August 31, 2011
-.%A Simon Perreault
-.%U https://datatracker.ietf.org/doc/rfc6350/
-.Re
-.It
-.Rs
-.%B RFC6532 Internationalized Email Headers
-.%I IETF
-.%D February 17, 2012
-.%A Abel Yang
-.%A Shawn Steele
-.%A Ned Freed
-.%U https://datatracker.ietf.org/doc/rfc6532/
-.Re
-.It
-.Rs
-.%B RFC6868 Parameter Value Encoding in iCalendar and vCard
-.%I IETF
-.%D February 14, 2013
-.%A Cyrus Daboo
-.%U https://datatracker.ietf.org/doc/rfc6868/
-.Re
-.It
-.Rs
-.%B RFC7162 IMAP Extensions: Quick Flag Changes Resynchronization (CONDSTORE) and Quick Mailbox Resynchronization (QRESYNC)
-.%I IETF
-.%D May 23, 2014
-.%A Alexey Melnikov
-.%A Dave Cridland
-.%U https://datatracker.ietf.org/doc/rfc7162/
-.Re
-.It
-.Rs
-.%B RFC8620 The JSON Meta Application Protocol (JMAP)
-.%I IETF
-.%D July 18, 2019
-.%A Neil Jenkins
-.%A Chris Newman
-.%U https://datatracker.ietf.org/doc/rfc8620/
-.Re
-.It
-.Rs
-.%B RFC8621 The JSON Meta Application Protocol (JMAP) for Mail
-.%I IETF
-.%D August 08, 2019
-.%A Neil Jenkins
-.%A Chris Newman
-.%U https://datatracker.ietf.org/doc/rfc8621/
-.Re
-.El
-.Sh SEE ALSO
-.Xr meli.conf 5 ,
-.Xr meli-themes 5 ,
-.Xr meli 7 ,
-.Xr xdg-open 1 ,
-.Xr mailcap 5
-.Sh AUTHORS
-Copyright 2017\(en2024
-.An Manos Pitsidianakis Aq Mt manos@pitsidianak.is
-.Pp
-Released under the GPL, version 3 or greater.
-This software carries no warranty of any kind.
-.Po
-See
-.Pa COPYING
-for full copyright and warranty notices.
-.Pc
-.Ss Links
-.Bl -item -compact
-.It
-.Lk https://meli\-email.org "Website"
-.It
-.Lk https://git.meli\-email.org/meli/meli "Main\ git\ repository\ and\ issue\ tracker"
-.It
-.Lk https://codeberg.org/meli/meli "Official\ read-only\ git\ mirror\ on\ codeberg.org"
-.It
-.Lk https://github.com/meli/meli "Official\ read-only\ git\ mirror\ on\ github.com"
-.It
-.Lk https://crates.io/crates/meli "meli\ crate\ on\ crates.io"
-.El

meli/docs/meli.7

@@ -1,764 +0,0 @@
-.\" meli - meli.7
-.\"
-.\" Copyright 2017-2022 Manos Pitsidianakis
-.\"
-.\" This file is part of meli.
-.\"
-.\" meli is free software: you can redistribute it and/or modify
-.\" it under the terms of the GNU General Public License as published by
-.\" the Free Software Foundation, either version 3 of the License, or
-.\" (at your option) any later version.
-.\"
-.\" meli is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-.\" GNU General Public License for more details.
-.\"
-.\" You should have received a copy of the GNU General Public License
-.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
-.\"
-.\".de Hr
-.\".Bd -literal -offset center
-.\"╌╍─────────────────────────────────────────────────────────╍╌
-.\".Ed
-.\"..
-.de Shortcut
-.Sm
-.Aq \\$1
-\ 
-.Po
-.Em shortcuts.\\$2\&. Ns
-.Em \\$3
-.Pc
-.Sm
-..
-.de ShortcutPeriod
-.Aq \\$1
-.Po
-.Em shortcuts.\\$2\&. Ns
-.Em \\$3
-.Pc Ns
-..
-.de Command
-.Bd -ragged -offset 1n
-.Cm \\$*
-.Ed
-..
-.\".Dd November 11, 2022
-.Dd March 10, 2024
-.Dt MELI 7
-.Os
-.Sh NAME
-.Nm meli
-.Nd Tutorial for the meli terminal e\-mail client
-.Sh SYNOPSIS
-.Nm
-.Op ...
-.Sh DESCRIPTION
-.Nm
-is a terminal mail client aiming for extensive and user\-friendly configurability.
-.Bd -literal -offset center
-     ^^      .-=-=-=-.  ^^
- ^^        (`-=-=-=-=-`)         ^^
-         (`-=-=-=-=-=-=-`)  ^^         ^^
-   ^^   (`-=-=-=-=-=-=-=-`)   ^^
-       ( `-=-=-=-(@)-=-=-` )      ^^
-       (`-=-=-=-=-=-=-=-=-`)  ^^
-       (`-=-=-=-=-=-=-=-=-`)          ^^
-       (`-=-=-=-=-=-=-=-=-`)
-^^     (`-=-=-=-=-=-=-=-=-`)  ^^
-   ^^   (`-=-=-=-=-=-=-=-`)          ^^
-         (`-=-=-=-=-=-=-`)  ^^
-  ^^       (`-=-=-=-=-`)
-            `-=-=-=-=-`          ^^
-.Ed
-.Sh INTRODUCTION
-To quit
-.Nm
-press
-.Shortcut q general quit
-at any time.
-When launched for the first time,
-.Nm
-will search for its configuration directory,
-.Pa $XDG_CONFIG_HOME/meli/ Ns
-\&.
-If it doesn't exist, you will be asked if you want to create one and presented with a sample configuration file
-.Pq Pa $XDG_CONFIG_HOME/meli/config.toml
-that includes the basic settings required for setting up accounts allowing you to copy and edit right away.
-See
-.Xr meli.conf 5
-for the available configuration options.
-.Pp
-At any time, you may press
-.Shortcut \&? general toggle_help
-for a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
-.Pp
-Each time a shortcut is mentioned in this document, you will find a parenthesis next to it with the name of the shortcut setting along with its section in the configuration settings so that you can modify it if you wish.
-.Pp
-For example, to set the
-.Em toggle_help
-shortcut mentioned in the previous paragraph, add the following to your configuration:
-.Bd -literal -offset center
-[shortcuts]
-general.toggle_help = 'F1'
-.Ed
-.sp
-Or alternatively:
-.Bd -literal -offset center
-[shortcuts.general]
-toggle_help = 'F1'
-.Ed
-.Pp
-To go to the next tab on the right, press
-.ShortcutPeriod T general next_tab
-\&.
-.Sh INTERACTING WITH Nm
-You will be interacting with
-.Nm
-in four primary ways:
-.Bl -column
-.It 1.
-keyboard shortcuts in
-.Sy NORMAL
-mode.
-.It 2.
-commands with arguments in
-.Sy COMMAND
-mode.
-.It 3.
-regular text input in text input widgets in
-.Sy INSERT
-mode.
-.It 4.
-any kind of input that gets passed directly into an embedded terminal in
-.Sy EMBED
-mode.
-.El
-.Sh MODES
-.Nm
-is a modal application, just like
-.Xr vi 1 Ns
-\&.
-This means that pressing the same keys in different modes would yield different results.
-This allows you to separate how the input is interpreted without the need to focus your input with a mouse.
-.Bl -tag -width 8n
-.It NORMAL
-This is the default mode of
-.Nm Ns
-\&.
-All keyboard shortcuts work in this mode.
-.It COMMAND
-Commands are issued in
-.Sy COMMAND
-mode, by default started with
-.Shortcut \&: general enter_command_mode
-and exited with
-.Aq Esc
-key.
-.It EMBED
-This is the mode of the embed terminal emulator.
-To exit an embedded application, issue
-.Aq Ctrl\-C
-to kill it or
-.Aq Ctrl\-Z
-to stop the program and follow the instructions on
-.Nm
-to exit.
-.It INSERT
-This mode is entered when pressing
-.Aq Enter
-on a cursor selected text input field, and it captures all input as text input.
-It is exited with the
-.Aq Esc
-key.
-.El
-.Sh ACTIVE SHORTCUTS POPUP
-By pressing
-.Shortcut \&? general toggle_help
-at any time, the shortcuts popup display status gets toggled.
-You can find all valid shortcuts for the current UI state you are in.
-.Bd -literal -offset center
-┌─shortcuts──Press ? to close────────────────────────────────┐
-│                                                           ▀│
-│  use COMMAND "search" to find shortcuts                   █│
-│  Use Up, Down, Left, Right to scroll.                     █│
-│                                                           █│
-│  pager                                                    █│
-│                                                           █│
-│       PageDown  page_down                                 █│
-│         PageUp  page_up                                    │
-│              j  scroll_down                                │
-│              k  scroll_up                                  │
-│                                                            │
-│  view mail                                                 │
-│                                                            │
-│              c  add_addresses_to_contacts                  │
-│              e  edit                                       │
-│              u  toggle_url_mode                            │
-│              a  open_attachment                            │
-│              m  open_mailcap                               │
-│              R  reply                                      │
-│            C-r  reply_to_author                            │
-│            C-g  reply_to_all                               │
-│            C-f  forward                                    │
-│            M-r  view_raw_source                            │
-│              h  toggle_expand_headers                     ▄│
-└────────────────────────────────────────────────────────────┘
-.Ed
-.Bd -ragged -offset 3n
-.Em Shows\ active\ shortcuts\ in\ order\ of\ the\ widget\ hierarchy\&.
-.Ed
-.Sh MAIN VIEW
-.Bd -literal -offset center
- ┌───────────────────────┐
- ├────┼──────────────────┤
- │___ │  ___________     │
- │ _  │ _______________  │
- │ _  │__________________│
- │ _  │      ___________ │
- │    │  _____           │
- │    │                  │
- └────┴──────────────────┘
-.Ed
-.Bd -ragged -offset 3n
-.Em The\ main\ view's\ layout\&.
-.Ed
-.sp
-This is the view you will spend more time with in
-.Nm Ns
-\&.
-.Pp
-Press
-.Shortcut \(ga listing toggle_menu_visibility
-to toggle the sidebars visibility.
-.Pp
-Press
-.Shortcut Left listing focus_right
-to switch focus on the sidebar menu.
-Press
-.Shortcut Right listing focus_left
-to switch focus on the e\-mail list.
-.Pp
-On the e\-mail list, press
-.Shortcut k listing scroll_up
-to scroll up, and
-.Shortcut j listing scroll_down
-to scroll down.
-Press
-.Shortcut Enter listing open_entry
-to open an e\-mail entry and
-.Shortcut i listing exit_entry
-to exit it.
-.Bd -ragged
-.Sy The sidebar\&.
-.Ed
-.Bd -literal -offset center
-┌─────────────┉┉┉┉┉✂
-│ mail▐  contact li✂
-│personal account  ✂
-│ 0  INBOX         ✂
-│ 1   ┣━Sent       ✂
-│ 2   ┣━Lists      ✂
-│ 3   ┃ ┣━meli-dev ✂
-│ 4   ┃ ┗━meli     ✂
-│ 5   ┣━Drafts     ✂
-│ 6   ┣━Trash      ✂
-│ 7   ┗━foobar     ✂
-┇ 8  Trash         ✂
- ✂ ✂ ✂ ✂ ✂ ✂ ✂ ✂ ✂ ✂
-.Ed
-.sp
-Press
-.Shortcut k listing scroll_up
-to scroll up, and
-.Shortcut j listing scroll_down
-to scroll down.
-.Pp
-Press
-.Shortcut Enter listing open_mailbox
-to open an entry (either a mailbox or an account name).
-Entering an account name will show you a page with details about the account and its network connection, depending on the backend.
-.Pp
-While focused in the sidebar, you can
-.Dq collapse
-a mailbox tree, if it has children, and you can open it with
-.ShortcutPeriod Space listing toggle_mailbox_collapse
-\&.
-You can have mailbox trees collapsed on startup by default by setting a mailbox's
-.Ic collapsed
-setting to
-.Em true Ns
-\&.
-See
-.Xr meli.conf 5 section MAILBOXES
-for details.
-.Pp
-You can increase the sidebar's width with
-.Shortcut Ctrl\-p listing increase_sidebar
-and decrease with
-.ShortcutPeriod Ctrl\-o listing decrease_sidebar
-\&.
-.Bd -ragged
-.Sy The status bar.
-.Ed
-.Bd -literal -offset center
-┌────────────────────────────────────────────────────┈┈
-│NORMAL | Mailbox: Inbox, Messages: 25772, New: 3006
-└────────────────────────────────────────────────────┈┈
-.Ed
-.Pp
-The status bar shows which mode you are, and the status message of the current view.
-In the pictured example, it shows the status of a mailbox called
-.Dq Inbox
-with lots of e\-mails.
-.Bd -ragged
-.Sy The number modifier buffer.
-.Ed
-.Bd -literal -offset center
- ┈┈────────────┐
-            12 │
- ┈┈────────────┘
-.Ed
-.Pp
-Some commands may accept a number modifier.
-.Tg number-modifier
-For example, scroll down commands can receive a multiplier
-.Em n
-to scroll down
-.Em n
-entries.
-Another use of the number buffer is opening URLs inside the pager.
-See
-.Sx PAGER
-for an explanation of interacting with URLs in e\-mails.
-.Pp
-Pressing numbers in
-.Sy NORMAL
-mode will populate this buffer.
-To erase it, press the
-.Aq Esc
-key.
-.Sh MAIL LIST
-There are four different list styles:
-.Bl -hyphen -compact
-.It
-.Qq plain
-which shows one line per e\-mail.
-.It
-.Qq threaded
-which shows a threaded view with drawn tree structure.
-.It
-.Qq compact
-which shows one line per thread which can include multiple e\-mails.
-.It
-.Qq conversations
-which shows more than one line per thread which can include multiple e\-mails with more details about the thread.
-.El
-.Bd -ragged
-.Sy Plain view\&.
-.Ed
-.Bd -literal -offset center
-│42     Fri, 02 Sep 2022 19:51  xxxxxxxxxxxxx <  [PATCH 3/8] │
-│43     Fri, 02 Sep 2022 19:51  xxxxxxxxxxxxx <  [PATCH 2/8] │
-│44     Fri, 02 Sep 2022 19:51  xxxxxxxxxxxxx <  [PATCH 1/8] │
-|45     Fri, 02 Sep 2022 19:51  xxxxxxxxxxxxx <  [PATCH 0/8] |
-│46     Fri, 02 Sep 2022 18:18  xxxxxxxx <xxxxx  Re: [PATCH 3│
-.Ed
-.Bd -ragged
-.Sy Threaded view\&.
-.Ed
-.Bd -literal -offset center
-│12     9 hours ago            xxxxxxxxxxxxxxx    [PATCH v3 0│
-│13     9 hours ago            xxxxxxxxxxxxxxx     ├─>[PATCH │
-│14     9 hours ago            xxxxxxxxxxxxxxx     ├─>[PATCH │
-|15     9 hours ago            xxxxxxxxxxxxxxx     ├─>[PATCH |
-│16     9 hours ago            xxxxxxxxxxxxxxx     ├─>[PATCH │
-│17     9 hours ago            xxxxxxxxxxxxxxx     └─>[PATCH │
-│18     2022-08-23 01:23:51    xxxxxxxxxxxxxxx    [RFC v4 00/│
-│19     2022-08-23 01:23:52    xxxxxxxxxxxxxxx     ├─>[RFC v4│
-|20     2022-08-30 10:30:16    xxxxxxxxxxxxxxx     │ └─>     |
-│21     6 days ago             xxxxxxxxxxxxxxx     │   └─>   │
-│22     2022-08-23 01:23:53    xxxxxxxxxxxxxxx     ├─>[RFC v4│
-.Ed
-.Bd -ragged
-.Sy Compact view\&.
-.Ed
-.Bd -literal -offset center
-│18  2022-…:38  xxxxxxxxxxxxxxx  [PATCH v3 3/3] u…_l() (2)   │
-|19  2022-…:49  xxxxxxxxxxxxxxx  [PATCH v8 0/7] A…e (3)      |
-│20  2022-…:10  xxxxxxxxxxxxxxx  [PATCH v8 2/7] f…s (2)      │
-│21  2022-…:38  xxxxxxxxxxxxxxx  [PATCH v8 3/7] b…s (2)      │
-│22  2022-…:53  xxxxxxxxxxxxxxx  [PATCH v6 00/10] p…g (31)   │
-.Ed
-.Bd -ragged
-.Sy Conversations view\&.
-.Ed
-.Bd -literal -offset center
-│[PATCH v2] xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (5)  │
-|1 day ago▁▁▁▁xxxxxxxxxxxxx <xxxxxxxxxxxxx@xxxxxxxxxx>, xxxxx│
-│                                                            |
-│[PATCH v2 0/8] xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx│
-│1 day ago▁▁▁▁xxxxxxxxxxxxxxx <xxxxxxxxxx@xxxxxxxxxxxxxx>, xx│
-|                                                            │
-│[PATCH 0/2] xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (4)    |
-│2 days ago▁▁▁▁xxxxxxxxxxxxxxxx <xxxxxxxx@xxxxxxxxxxx>, xxxxx│
-│                                                            │
-│[PATCH 0/8] xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx (12)  │
-│2 days ago▁▁▁▁xxxxxxxxxxxxx <xxxxxxxx@xxxxxxxxxx>, xxxxxxxxx│
-.Ed
-.sp
-.sp
-.Sy Performing actions on entries and/or selections\&.
-.Pp
-Press
-.Shortcut v listing select_entry
-to toggle the selection of a single entry.
-.Qq select_entry
-can be prefixed by a number modifier and affixed by a scrolling motion (up or down) to select multiple entries.
-.Tg number-modifier
-Simple set operations can be performed on a selection with these shortcut modifiers:
-.sp
-.Bl -hyphen -compact
-.It
-Union modifier:
-.Shortcut Ctrl\-u listing union_modifier
-.It
-Difference modifier:
-.Shortcut Ctrl\-d listing diff_modifier
-.It
-Intersection modifier:
-.Shortcut Ctrl\-i listing intersection_modifier
-.El
-.Pp
-To set an entry as
-.Qq read
-\&, use the
-.Shortcut n listing set_seen
-shortcut.
-To set an entry as
-.Qq unread
-\&, use the command
-.Command set unseen
-.sp
-which also has its complement
-.Command set seen
-.sp
-action.
-.Pp
-For e\-mail backends that support flags you can use the following commands on entries and selections to modify them:
-.Command flag set FLAG
-.Command flag unset FLAG
-.Pp
-For e\-mail backends that support tags
-.Po
-like
-.Qq IMAP
-or
-.Qq notmuch Ns
-.Pc
-you can use the following commands on entries and selections to modify them:
-.Command tag add TAG
-.Command tag remove TAG
-.sp
-(see
-.Xr meli.conf 5 TAGS Ns
-, settings
-.Ic colors
-and
-.Ic ignore_tags
-for how to set tag colors and tag visibility)
-You can clear the selection with the
-.Aq Esc
-key.
-.Sh PAGER
-You can open an e\-mail entry by pressing
-.ShortcutPeriod Enter listing open_entry
-\&. This brings up the e\-mail view with the e\-mail content inside a pager.
-.Bd -literal -offset center
-┌────────────────────────────────────────────────────────────┐
-│Date: Sat, 21 May 2022 16:16:11 +0300                      ▀│
-│From: Narrator <narrator@example.com>                      █│
-│To: Stanley <427@example.com>                              █│
-│Subject: The e-mail ending                                 █│
-│Message-ID: <gambheerata@example.com>                      █│
-│                                                           █│
-│The story, and the choices, or what have you, and therefore█│
-│by becoming it is! So on and so forth, until inevitably, we │
-│all until the end of time. At which time, everything all at │
-│once, so now you see? Blah, blah, blah, rah, rah, rah...    │
-│We've eaten too much and it can't be just yet. No, no!      │
-│Until two-hundred and forty-five! But the logic of          │
-│elimination, working backwards, the deduction therefore     │
-│becomes impossible to manufacture. It went on for nearly    │
-│ten thousand years, until just yesterday. Here and there,   │
-│forward and back, and never a moment before lunchtime. It   │
-│can't be! It's the only thing there is! How many billions   │
-│left until so much more than forever ago! Which is why I    │
-│say:                                                        │
-│                                                            │
-│The story, and the choices, or what have you, and therefore │
-│by becoming it is! So on and so forth, until inevitably, we▄│
-└────────────────────────────────────────────────────────────┘
-.Ed
-.Bd -ragged -offset 3n
-.Em The\ pager\ displaying\ an\ e\-mail\&.
-.Ed
-.Pp
-The pager is simple to use.
-Scroll with the following:
-.Bl -hang -width 27n
-.It Go to next pager page
-.Shortcut PageDown pager page_down
-.It Go to previous pager page
-.Shortcut PageUp pager page_up
-.It Scroll down pager.
-.Shortcut j pager scroll_down
-.It Scroll up pager.
-.Shortcut k pager scroll_up
-.El
-.sp
-All scrolling shortcuts can be prefixed with a number modifier
-.Tg number-modifier
-which will act as a multiplier.
-.Pp
-The pager can enter a special
-.Em url
-mode which will prefix all detected hyperlinks and e\-mail addresses with a number inside square brackets
-.ShortcutPeriod u pager toggle_url_mode
-\&.
-Writing down a chosen number as a number modifier
-.Tg number-modifier
-and pressing
-.Shortcut g envelope_view go_to_url
-will attempt to open the link with the system's default open command
-.Po
-.Xr xdg-open 1
-in supported OSes,
-and
-.Xr open 1
-on MacOS
-.Pc Ns
-\&.
-To override with a custom launcher, see
-.Qo
-.Li pager
-.Qc
-configuration setting
-.Qo
-.Li url_launcher
-.Qc
-.Po
-see
-.Xr meli.conf 5 PAGER
-for more details
-.Pc Ns
-\&.
-.Sh MAIL VIEW
-Other things you can do when viewing e\-mail:
-.Bl -dash -compact
-.It
-Most importantly, you can exit the mail view with:
-.Shortcut i listing exit_entry
-.It
-Add addresses from the e\-mail headers to contacts:
-.Shortcut c envelope_view add_addresses_to_contacts
-.It
-Open an attachment by entering its index as a number modifier and pressing:
-.Tg number-modifier
-.Shortcut a envelope_view open_attachment
-.It
-Open an attachment by its
-.Xr mailcap 4
-entry by entering its index as a number modifier and pressing:
-.Shortcut m envelope_view open_mailcap
-.It
-Reply to envelope:
-.Shortcut R envelope_view reply
-.It
-Reply to author:
-.Shortcut Ctrl\-r envelope_view reply_to_author
-.It
-Reply to all/Reply to list/Follow up:
-.Shortcut Ctrl\-g envelope_view reply_to_all
-.It
-Forward e\-mail:
-.Shortcut Ctrl\-f envelope_view forward
-.It
-Expand extra headers: (References and others)
-.Shortcut h envelope_view toggle_expand_headerk
-.It
-View envelope source in a pager: (toggles between raw and decoded source)
-.Shortcut M\-r envelope_view view_raw_source
-.It
-Return to envelope_view if viewing raw source or attachment:
-.Shortcut r envelope_view return_to_normal_view
-.El
-.Sh COMPOSING
-To compose an e\-mail, you can either start with an empty draft by pressing
-.Shortcut m listing new_mail
-which opens a composer view in a new tab.
-To reply to a specific e\-mail, when in envelope view you can select the specific action you want to take:
-.sp
-.Bl -dash -compact
-.It
-Reply to envelope.
-.Shortcut R envelope_view reply
-.It
-Reply to author.
-.Shortcut Ctrl\-r envelope_view reply_to_author
-.It
-Reply to all.
-.Shortcut Ctrl\-g envelope_view reply_to_all
-.El
-.sp
-To launch your editor, press
-.ShortcutPeriod e composing edit
-\&.
-To send your draft, press
-.ShortcutPeriod s composing send_mail
-\&.
-To save the draft without submission, enter the command
-.Command close
-.sp
-and select
-.Qq save as draft Ns
-\&.
-You can return to the draft by going to your
-.Qq Drafts
-mailbox and selecting
-.ShortcutPeriod e envelope_view edit
-\&.
-.Bd -literal -offset center
-┌────────────────────────────────────────────────────────────┐
-│ mail▐  contact list  ▐  composing  ▍███████████████████████│
-│          COMPOSING MESSAGE                                 │
-│           Date     Mon, 05 Sep 2022 17:49:19 +0300         │
-│           From     myself <myself@example.com>░░░░         │
-│           To       friend <myfriend@example.com>░░         │
-│           Cc       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░         │
-│           Bcc      ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░         │
-│           Subject  This is my subject!░░░░░░░░░░░░         │
-│                                                            │
-│          Hello friend!░░░░░░░░░░░░░░░░░░░░░░░░░░░░         │
-│          ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░         │
-│          ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░         │
-│                                                            │
-│          ☐ don't sign                                      │
-│          ☐ don't encrypt                                   │
-│          no attachments                                    │
-│                                                            │
-│NORMAL | Mailbox: Inbox, Messages: 25772, New: 3006         │
-└────────────────────────────────────────────────────────────┘
-.Ed
-.Bd -ragged -offset 3n
-.Em The\ lightly\ highlighted\ cells\ represent\ text\ input\ fields\&.
-.Ed
-.sp
-If you enable the embed terminal option, you can launch your terminal editor of choice when you press
-.Ic edit Ns
-\&.
-.Bd -literal -offset center
-┌────────────────────────────────────────────────────────────┐
-│ mail▐  contact list  ▐  composing  ▍███████████████████████│
-│   ╓COMPOSING MESSAGE┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄╖   │
-│   ║ p/v/f/h/5/T/m/07f56b6e-ec09-49d9-b8d8-f0c5a81e7826 ║   │
-│   ║  7 Date: Mon, 05 Sep 2022 18:43:10 +0300           ║   │
-│   ║  6 From: Mister Cardholder <mrholder@example.com>  ║   │
-│   ║  5 To:                                             ║   │
-│   ║  4 Cc:                                             ║   │
-│   ║  3 Bcc:                                            ║   │
-│   ║  2 Subject:                                        ║   │
-│   ║  1 User-Agent: meli 0.7.2                          ║   │
-│   ║8 █                                                 ║   │
-│   ║~                                                   ║   │
-│   ║~                                                   ║   │
-│   ║~                                                   ║   │
-│   ║~                                                   ║   │
-│   ║ N…  <6e-ec09-49d9-b8d8-f0c5a81e7826   100% ㏑:8 ℅:1║   │
-│   ╚════════════════════════════════════════════════════╝   │
-│                                                            │
-│                                                            │
-│ ☐ don't sign                                               │
-│ ☐ don't encrypt                                            │
-│ no attachments                                             │
-│                                                            │
-│EMBED | Mailbox: Inbox, Messages: 25772, New: 3006          │
-└────────────────────────────────────────────────────────────┘
-.Ed
-.Bd -ragged -offset 3n
-.Bf -emphasis
-.Xr nvim 1 Ns
-\ running\ inside\ the\ composing\ tab\&.
-.Ef
-The\ double\ line\ border\ annotates\ the\ area\ of\ the\ embedded\ terminal,
-the\ actual\ embedding\ is\ seamless\&.
-.Ed
-.Ss composing mail commands
-.Bl -tag -width 36n
-.It Cm add\-attachment Ar PATH
-in composer, add
-.Ar PATH
-as an attachment
-.It Cm add\-attachment < Ar CMD Ar ARGS
-in composer, pipe
-.Ar CMD Ar ARGS
-output into an attachment
-.It Cm add\-attachment\-file\-picker
-Launch command defined in the configuration value
-.Ic file_picker_command
-in
-.Xr meli.conf 5 TERMINAL
-.It Cm add\-attachment\-file\-picker < Ar CMD Ar ARGS
-Launch command
-.Ar CMD Ar ARGS Ns
-\&.
-The command should print file paths in stderr, separated by NULL bytes.
-.It Cm remove\-attachment Ar INDEX
-remove attachment with given index
-.It Cm toggle sign
-toggle between signing and not signing this message.
-If the gpg invocation fails then the mail won't be sent.
-See
-.Xr meli.conf 5 PGP
-for PGP configuration.
-.It Cm save\-draft
-saves a copy of the draft in the Draft folder
-.El
-.\" [ref:TODO]: add contacts section
-.Sh THEMES
-See
-.Xr meli-themes 5
-for documentation on how to theme
-.Nm Ns
-\&.
-.Sh SEE ALSO
-.Xr meli 1 ,
-.Xr meli.conf 5 ,
-.Xr meli-themes 5 ,
-.Xr xdg-open 1 ,
-.Xr mailcap 5
-.Sh AUTHORS
-Copyright 2017\(en2024
-.An Manos Pitsidianakis Aq Mt manos@pitsidianak.is
-.Pp
-Released under the GPL, version 3 or greater.
-This software carries no warranty of any kind.
-.Po
-See
-.Pa COPYING
-for full copyright and warranty notices.
-.Pc
-.Ss Links
-.Bl -item -compact
-.It
-.Lk https://meli\-email.org "Website"
-.It
-.Lk https://git.meli\-email.org/meli/meli "Main\ git\ repository\ and\ issue\ tracker"
-.It
-.Lk https://codeberg.org/meli/meli "Official\ read-only\ git\ mirror\ on\ codeberg.org"
-.It
-.Lk https://github.com/meli/meli "Official\ read-only\ git\ mirror\ on\ github.com"
-.It
-.Lk https://crates.io/crates/meli "meli\ crate\ on\ crates.io"
-.El

meli/docs/samples/sample-config.toml

@@ -1,142 +0,0 @@
-## Look into meli.conf(5) for all valid configuration options, their
-## descriptions and default values
-##
-## The syntax for including other configuration files is enclosed in `:
-##`include("account_one")`
-##`include("./account_two")`
-##`include("/home/absolute/path/to/shortcuts/config.toml")`
-##
-##
-## Setting up a Maildir account
-#[accounts.account-name]
-#root_mailbox = "/path/to/root/mailbox"
-#format = "Maildir"
-#listing.index_style = "Conversations" # or [plain, threaded, compact]
-#identity="email@example.com"
-#display_name = "Name"
-#subscribed_mailboxes = ["INBOX", "INBOX/Sent", "INBOX/Drafts", "INBOX/Junk"]
-#
-## Set mailbox-specific settings
-#  [accounts.account-name.mailboxes]
-#  "INBOX" = { rename="Inbox" }
-#  "drafts" = { rename="Drafts" }
-#  "foobar-devel" = { ignore = true } # don't show notifications for this mailbox
-#
-## Setting up an mbox account
-#[accounts.mbox]
-#root_mailbox = "/var/mail/username"
-#format = "mbox"
-#listing.index_style = "Compact"
-#identity="username@hostname.local"
-#
-## Setting up an IMAP account
-#[accounts."imap"]
-#root_mailbox = "INBOX"
-#format = "imap"
-#server_hostname="mail.example.com"
-#server_password="pha2hiLohs2eeeish2phaii1We3ood4chakaiv0hien2ahie3m"
-#server_username="username@example.com"
-##server_port="993" # imaps
-#server_port="143" # STARTTLS
-#use_starttls=true #optional
-#listing.index_style = "Conversations"
-#identity = "username@example.com"
-#display_name = "Name Name"
-### match every mailbox:
-#subscribed_mailboxes = ["*" ]
-### match specific mailboxes:
-##subscribed_mailboxes = ["INBOX", "INBOX/Sent", "INBOX/Drafts", "INBOX/Junk"]
-#
-## Setting up an account for an already existing notmuch database
-##[accounts.notmuch]
-##root_mailbox = "/path/to/folder" # where .notmuch/ directory is located
-##format = "notmuch"
-##listing.index_style = "conversations"
-##identity="username@example.com"
-##display_name = "Name Name"
-##  # notmuch mailboxes are virtual, they are defined by their alias and the notmuch query that corresponds to their content.
-##  [accounts.notmuch.mailboxes]
-##  "INBOX" = {  query="tag:inbox", subscribe = true }
-##  "Drafts" = {  query="tag:draft", subscribe = true }
-##  "Sent" = {  query="from:username@example.com from:username2@example.com", subscribe = true }
-##
-## Setting up a Gmail account
-#[accounts."gmail"]
-#root_mailbox = '[Gmail]'
-#format = "imap"
-#server_hostname='imap.gmail.com'
-#server_password="password"
-#server_username="username@gmail.com"
-#server_port="993"
-#listing.index_style = "Conversations"
-#identity = "username@gmail.com"
-#display_name = "Name Name"
-### match every mailbox:
-#subscribed_mailboxes = ["*" ]
-#composing.send_mail = 'msmtp --read-recipients --read-envelope-from'
-### Gmail auto saves sent mail to Sent folder, so don't duplicate the effort:
-#composing.store_sent_mail = false
-#
-##[accounts."jmap account"]
-##root_mailbox = "INBOX"
-##format = "jmap"
-##server_url="http://localhost:8080"
-##server_username="user@hostname.local"
-##server_password="changeme"
-##listing.index_style = "Conversations"
-##identity = "user@hostname.local"
-##subscribed_mailboxes = ["*", ]
-##composing.send_mail = 'server_submission'
-#
-#[pager]
-#filter = "COLUMNS=72 /usr/local/bin/pygmentize -l email"
-#pager_context = 0 # default, optional
-#sticky_headers = true # default, optional
-#
-#[notifications]
-#script = "notify-send"
-#xbiff_file_path = "path" # for use with xbiff(1)
-#play_sound = true # default, optional
-#sound_file = "path" # optional
-#
-###shortcuts
-#[shortcuts.composing]
-#edit = 'e'
-#
-#[shortcuts.contact-list]
-#create_contact = 'c'
-#edit_contact = 'e'
-#
-##Mail listing defaults
-#[shortcuts.listing]
-#prev_page = "PageUp"
-#next_page = "PageDown"
-#prev_mailbox = 'K'
-#next_mailbox = 'J'
-#prev_account = 'l'
-#next_account = 'h'
-#new_mail = 'm'
-#set_seen = 'n'
-#exit_entry = 'i'
-#
-##Pager defaults
-#
-#[shortcuts.pager]
-#scroll_up = 'k'
-#scroll_down = 'j'
-#page_up = "PageUp"
-#page_down = "PageDown"
-#
-#[composing]
-##required for sending e-mail
-#send_mail = 'msmtp --read-recipients --read-envelope-from'
-##send_mail = { hostname = "smtp.example.com", port = 587, auth = { type = "auto", username = "user", password = { type = "command_eval", value = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
-#editor_command = 'vim +/^$' # optional, by default $EDITOR is used.
-#
-#
-#[pgp]
-#auto_sign = false # always sign sent messages
-#auto_verify_signatures = true # always verify signatures when reading signed e-mails
-#
-#[terminal]
-#theme = "dark" # or "light"

meli/docs/samples/themes/nord.toml

@@ -1,70 +0,0 @@
-[terminal.themes.nord]
-"theme_default" = { fg = "$nord6", bg = "$nord0", attrs = "Default" }
-"mail.listing.compact.even" = { fg = "theme_default", bg = "$nord1", attrs = "theme_default" }
-"mail.listing.compact.odd" = { fg = "theme_default", bg = "$nord2", attrs = "theme_default" }
-"mail.listing.plain.even" = { fg = "theme_default", bg = "$nord1", attrs = "theme_default" }
-"mail.listing.plain.odd" = { fg = "theme_default", bg = "$nord2", attrs = "theme_default" }
-"mail.listing.compact.even_highlighted" = { fg = "$nord0", bg = "$focused_bg", attrs = "theme_default" }
-"mail.listing.compact.odd_highlighted" = { fg = "$nord0", bg = "$focused_bg", attrs = "theme_default" }
-"mail.listing.conversations.highlighted" = { fg = "$nord0", bg = "$focused_bg", attrs = "theme_default" }
-"mail.listing.conversations.selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.subject" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.unseen" = { fg = "theme_default", bg = "$nord2", attrs = "theme_default" }
-"mail.listing.plain.even_highlighted" = { fg = "$nord0", bg = "$focused_bg", attrs = "theme_default" }
-"mail.listing.plain.odd_highlighted" = { fg = "$nord0", bg = "$focused_bg", attrs = "theme_default" }
-"mail.listing.tag_default" = { fg = "theme_default", bg = "$nord8", attrs = "theme_default" }
-"mail.sidebar_highlighted" = { fg = "$nord1", bg = "$focused_bg", attrs = "theme_default" }
-"mail.sidebar_highlighted_account" = { fg = "$nord5", bg = "$nord1", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_name" = { fg = "mail.sidebar_highlighted_account", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_index" = { fg = "mail.sidebar_highlighted_account", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_unread_count" = { fg = "mail.sidebar_highlighted_account", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_highlighted_unread_count" = { fg = "mail.sidebar_highlighted", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar" = { fg = "$nord5", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_account_name" = { fg = "$nord5", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_index" = { fg = "$nord1", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_unread_count" = { fg = "$nord1", bg = "theme_default", attrs = "theme_default" }
-"mail.view.body" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers" = { fg = "$nord9", bg = "theme_default", attrs = "theme_default" }
-"mail.view.thread.indentation.a" = { fg = "theme_default", bg = "$nord11", attrs = "theme_default" }
-"mail.view.thread.indentation.b" = { fg = "theme_default", bg = "$nord12", attrs = "theme_default" }
-"mail.view.thread.indentation.c" = { fg = "theme_default", bg = "$nord13", attrs = "theme_default" }
-"mail.view.thread.indentation.d" = { fg = "theme_default", bg = "$nord14", attrs = "theme_default" }
-"mail.view.thread.indentation.e" = { fg = "theme_default", bg = "$nord15", attrs = "theme_default" }
-"mail.view.thread.indentation.f" = { fg = "theme_default", bg = "$nord13", attrs = "theme_default" }
-"pager.highlight_search" = { fg = "$nord5", bg = "$nord7", attrs = "Bold" }
-"pager.highlight_search_current" = { fg = "$nord7", bg = "$nord10", attrs = "Bold" }
-"status.bar" = { fg = "$nord5", bg = "$nord3", attrs = "theme_default" }
-"status.notification" = { fg = "$nord5", bg = "$nord3", attrs = "theme_default" }
-"tab.bar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"tab.focused" = { fg = "$nord1", bg = "$focused_bg", attrs = "theme_default" }
-"tab.unfocused" = { fg = "$nord4", bg = "$unfocused_bg", attrs = "theme_default" }
-"widgets.form.field" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"widgets.form.highlighted" = { fg = "theme_default", bg = "$nord2", attrs = "theme_default" }
-"widgets.form.label" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"widgets.list.header" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"widgets.options.highlighted" = { fg = "theme_default", bg = "$nord2", attrs = "theme_default" }
-
-[terminal.themes.nord.color_aliases]
-nord0 = "#2e3440"
-nord1 = "#3b4252"
-nord2 = "#434c5e"
-nord3 = "#4c566a"
-# snow storm
-nord4 = "#d8dee9"
-nord5 = "#e5e9f0"
-nord6 = "#eceff4"
-# frost
-nord7 = "#8fbcbb"
-nord8 = "#88c0d0"
-nord9 = "#81a1c1"
-nord10 = "#5e81ac"
-# aurora
-nord11 = "#bf616a"
-nord12 = "#d08770"
-nord13 = "#ebcb8b"
-nord14 = "#a3be8c"
-nord15 = "#b48ead"
-# semantics
-focused_bg = "$nord8"
-unfocused_bg = "$nord3"

meli/docs/samples/themes/orca.toml

@@ -1,60 +0,0 @@
-[terminal.themes.orca]
-color_aliases = { "neon_green" = "#6ef9d4",  "darkgrey" = "#4a4a4a",  "neon_purple" = "#df2f94"  }
-"theme_default" = { fg = "White", bg = "Black", attrs = "Default" }
-"mail.listing.attachment_flag" = { fg = "$neon_green", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.even" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.even_highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.compact.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.even_unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.compact.odd" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.odd_highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.compact.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.odd_unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.conversations" = { fg = "$darkgrey", bg = "theme_default", attrs = "Default" }
-"mail.listing.conversations.date" = { fg = "$neon_purple", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.from" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.conversations.selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.subject" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.plain.even" = { fg = "theme_default", bg = "Grey19", attrs = "theme_default" }
-"mail.listing.plain.even_highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.plain.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.plain.even_unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.plain.odd" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.odd_highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.plain.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.plain.odd_unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.tag_default" = { fg = "Black", bg = "$neon_green", attrs = "theme_default" }
-"mail.listing.thread_snooze_flag" = { fg = "Red", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted" = { fg = "Grey7", bg = "White", attrs = "theme_default" }
-"mail.sidebar_highlighted_account" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_name" = { fg = "White", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_account_name" = { fg = "$darkgrey", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_unread_count" = { fg = "mail.sidebar_unread_count", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_highlighted_unread_count" = { fg = "mail.sidebar_highlighted", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_index" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_unread_count" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.view.body" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers" = { fg = "DodgerBlue1", bg = "theme_default", attrs = "theme_default" }
-"mail.view.thread.indentation.a" = { fg = "theme_default", bg = "#EC4436", attrs = "theme_default" }
-"mail.view.thread.indentation.b" = { fg = "theme_default", bg = "#D301F9", attrs = "theme_default" }
-"mail.view.thread.indentation.c" = { fg = "theme_default", bg = "#314EFB", attrs = "theme_default" }
-"mail.view.thread.indentation.d" = { fg = "theme_default", bg = "#068ACD", attrs = "theme_default" }
-"mail.view.thread.indentation.e" = { fg = "theme_default", bg = "#019589", attrs = "theme_default" }
-"mail.view.thread.indentation.f" = { fg = "theme_default", bg = "#68A033", attrs = "theme_default" }
-"pager.highlight_search" = { fg = "White", bg = "Teal", attrs = "Bold" }
-"pager.highlight_search_current" = { fg = "White", bg = "NavyBlue", attrs = "Bold" }
-"status.bar" = { fg = "White", bg = "Black", attrs = "theme_default" }
-"status.notification" = { fg = "Plum1", bg = "theme_default", attrs = "theme_default" }
-"tab.bar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"tab.focused" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"tab.unfocused" = { fg = "$darkgrey", bg = "Black", attrs = "theme_default" }
-"widgets.form.field" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"widgets.form.highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"widgets.form.label" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"widgets.list.header" = { fg = "Black", bg = "White", attrs = "Bold" }
-"widgets.options.highlighted" = { fg = "theme_default", bg = "Grey", attrs = "theme_default" }

meli/docs/samples/themes/sail.toml

@@ -1,69 +0,0 @@
-[terminal.themes.sail]
-color_aliases = { "unseen_fg" = "theme_default", "unseen_bg" = "theme_default", "sea" = "#91C7FF", "dimmed_text" = "#afbec5", "dimmed_bg" = "Grey78", "header" = "#edeff1" }
-"theme_default" = { fg = "#37474f", bg = "White", attrs = "Default" }
-"mail.listing.attachment_flag" = { fg = "Blue", bg = "theme_default", attrs = "theme_default" }
-
-"mail.listing.compact.even" = { fg = "$dimmed_text", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.even_highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }
-"mail.listing.compact.even_selected" = { fg = "$dimmed_text", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.even_unseen" = { fg = "$unseen_fg", bg = "$unseen_bg", attrs = "theme_default" }
-
-"mail.listing.compact.odd" = { fg = "$dimmed_text", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.odd_highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }
-"mail.listing.compact.odd_selected" = { fg = "$dimmed_text", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.odd_unseen" = { fg = "$unseen_fg", bg = "$unseen_bg", attrs = "theme_default" }
-
-"mail.listing.plain.even" = { fg = "mail.listing.compact.even", bg = "mail.listing.compact.even", attrs = "theme_default" }
-"mail.listing.plain.even_highlighted" = { fg = "mail.listing.compact.even_highlighted", bg = "mail.listing.compact.even_highlighted", attrs = "theme_default" }
-"mail.listing.plain.even_selected" = { fg = "mail.listing.compact.even_selected", bg = "mail.listing.compact.even_selected", attrs = "theme_default" }
-"mail.listing.plain.even_unseen" = { fg = "mail.listing.compact.even_unseen", bg = "mail.listing.compact.even_unseen", attrs = "theme_default" }
-"mail.listing.plain.odd" = { fg = "mail.listing.compact.odd", bg = "mail.listing.compact.odd", attrs = "theme_default" }
-"mail.listing.plain.odd_highlighted" = { fg = "mail.listing.compact.odd_highlighted", bg = "mail.listing.compact.odd_highlighted", attrs = "theme_default" }
-"mail.listing.plain.odd_selected" = { fg = "mail.listing.compact.odd_selected", bg = "mail.listing.compact.odd_selected", attrs = "theme_default" }
-"mail.listing.plain.odd_unseen" = { fg = "mail.listing.compact.odd_unseen", bg = "mail.listing.compact.odd_unseen", attrs = "theme_default" }
-
-"mail.listing.conversations" = { fg = "$dimmed_text", bg = "theme_default", attrs = "Default" }
-"mail.listing.conversations.date" = { fg = "mail.listing.conversations", bg = "mail.listing.conversations", attrs = "theme_default" }
-"mail.listing.conversations.from" = { fg = "mail.listing.conversations", bg = "mail.listing.conversations", attrs = "theme_default" }
-"mail.listing.conversations.subject" = { fg = "mail.listing.conversations", bg = "mail.listing.conversations", attrs = "theme_default" }
-"mail.listing.conversations.highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }
-"mail.listing.conversations.selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.unseen" = { fg = "$unseen_fg", bg = "$unseen_bg", attrs = "theme_default" }
-
-"mail.listing.tag_default" = { fg = "Black", bg = "$dimmed_text", attrs = "theme_default" }
-"mail.listing.thread_snooze_flag" = { fg = "Red", bg = "theme_default", attrs = "theme_default" }
-
-"mail.sidebar" = { fg = "$dimmed_text", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }
-"mail.sidebar_highlighted_account" = { fg = "$dimmed_text", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_name" = { fg = "theme_default", bg = "$header", attrs = "Bold" }
-"mail.sidebar_account_name" = { fg = "mail.sidebar", bg = "mail.sidebar", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_unread_count" = { fg = "mail.sidebar_unread_count", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_highlighted_unread_count" = { fg = "mail.sidebar_highlighted", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_index" = { fg = "mail.sidebar", bg = "mail.sidebar", attrs = "theme_default" }
-"mail.sidebar_unread_count" = { fg = "$dimmed_text", bg = "theme_default", attrs = "theme_default" }
-
-"mail.view.body" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers_names" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"mail.view.thread.indentation.a" = { fg = "theme_default", bg = "#EC633D", attrs = "theme_default" }
-"mail.view.thread.indentation.b" = { fg = "theme_default", bg = "#D347F9", attrs = "theme_default" }
-"mail.view.thread.indentation.c" = { fg = "theme_default", bg = "#317EFB", attrs = "theme_default" }
-"mail.view.thread.indentation.d" = { fg = "theme_default", bg = "#06B8CD", attrs = "theme_default" }
-"mail.view.thread.indentation.e" = { fg = "theme_default", bg = "#93DDB6", attrs = "theme_default" }
-"mail.view.thread.indentation.f" = { fg = "theme_default", bg = "#68A033", attrs = "theme_default" }
-
-"pager.highlight_search" = { fg = "White", bg = "Teal", attrs = "Bold" }
-"pager.highlight_search_current" = { fg = "White", bg = "NavyBlue", attrs = "Bold" }
-"status.bar" = { fg = "theme_default", bg = "$sea", attrs = "theme_default" }
-"status.notification" = { fg = "Plum1", bg = "theme_default", attrs = "theme_default" }
-"tab.bar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"tab.focused" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"tab.unfocused" = { fg = "White", bg = "$sea", attrs = "Bold" }
-"widgets.form.field" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"widgets.form.highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }
-"widgets.form.label" = { fg = "theme_default", bg = "theme_default", attrs = "Bold" }
-"widgets.list.header" = { fg = "Black", bg = "White", attrs = "Bold" }
-"widgets.options.highlighted" = { fg = "theme_default", bg = "$dimmed_bg", attrs = "theme_default" }

meli/docs/samples/themes/spooky.toml

@@ -1,42 +0,0 @@
-[terminal.themes.spooky]
-"theme_default" = { fg = "#333", bg = "#fe9b13", attrs = "Default" }
-"mail.listing.attachment_flag" = { fg = "LightSlateGrey", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.compact.even" = { fg = "theme_default", bg = "#bf200e", attrs = "theme_default" }
-"mail.listing.compact.odd" = { fg = "theme_default", bg = "#fa4113", attrs = "theme_default" }
-"mail.listing.compact.even_highlighted" = { fg = "theme_default", bg = "Yellow6", attrs = "theme_default" }
-"mail.listing.compact.odd_highlighted" = { fg = "theme_default", bg = "Yellow6", attrs = "theme_default" }
-"mail.listing.compact.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.even_unseen" = { fg = "Black", bg = "Orange3", attrs = "theme_default" }
-"mail.listing.compact.odd_unseen" = { fg = "Black", bg = "Orange3", attrs = "theme_default" }
-"mail.listing.conversations.date" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.from" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.highlighted" = { fg = "theme_default", bg = "Grey58", attrs = "theme_default" }
-"mail.listing.conversations.selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.subject" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.unseen" = { fg = "Black", bg = "Grey78", attrs = "theme_default" }
-"mail.listing.plain.even" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.odd" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.even_unseen" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.odd_unseen" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.even_highlighted" = { fg = "theme_default", bg = "Yellow6", attrs = "theme_default" }
-"mail.listing.plain.odd_highlighted" = { fg = "theme_default", bg = "Yellow6", attrs = "theme_default" }
-"mail.listing.plain.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.plain.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.thread_snooze_flag" = { fg = "Red", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted_account" = { fg = "White", bg = "Orange3", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_unread_count" = { fg = "mail.sidebar_unread_count", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted" = { fg = "Grey7", bg = "White", attrs = "theme_default" }
-"mail.sidebar_highlighted_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_highlighted_unread_count" = { fg = "mail.sidebar_highlighted", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_index" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_unread_count" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.view.body" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers" = { fg = "DodgerBlue1", bg = "theme_default", attrs = "theme_default" }
-"status.bar" = { fg = "White", bg = "#A21500", attrs = "theme_default" }
-"tab.bar" = { fg = "theme_default", bg = "#332300", attrs = "theme_default" }
-"tab.unfocused" = { fg = "theme_default", bg = "#A26F00", attrs = "theme_default" }
-"tab.focused" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }

meli/docs/samples/themes/watermelon.toml

@@ -1,46 +0,0 @@
-[terminal.themes.watermelon]
-color_aliases = { "JewelGreen" = "#157241", "PinkLace" = "#FFD5FD", "TorchRed" = "#F50431", "ChelseaCucumber" = "#6CA94A", "ScreaminGreen" = "#8FFF52", "SunsetOrange" = "#f74b41", "Melon" = "#fdbcb4", "BlueStone" = "#005F5F", "HotPink" = "#FF74D7" }
-"theme_default" = { fg = "$TorchRed", bg = "$PinkLace", attrs = "Default" }
-"widgets.list.header" = { fg = "$PinkLace", bg = "$TorchRed", attrs = "Bold" }
-"mail.listing.attachment_flag" = { fg = "LightSlateGrey", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.tag_default" = { bg = "$Melon", attrs = "Bold" }
-"mail.listing.compact.even" = { fg = "White", bg = "$ChelseaCucumber", attrs = "Bold" }
-"mail.listing.compact.odd" = { fg = "$PinkLace", bg = "$JewelGreen", attrs = "theme_default" }
-"mail.listing.compact.even_unseen" = { fg = "$JewelGreen", bg = "$ScreaminGreen", attrs = "theme_default" }
-"mail.listing.compact.odd_unseen" = { fg = "$JewelGreen", bg = "$ScreaminGreen", attrs = "theme_default" }
-"mail.listing.compact.even_highlighted" = { fg = "$JewelGreen", bg = "$SunsetOrange", attrs = "theme_default" }
-"mail.listing.compact.odd_highlighted" = { fg = "$JewelGreen", bg = "$SunsetOrange", attrs = "theme_default" }
-"mail.listing.compact.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.compact.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.date" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.from" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.highlighted" = { fg = "$JewelGreen", bg = "$SunsetOrange", attrs = "theme_default" }
-"mail.listing.conversations.selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.conversations.subject" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.conversations.unseen" = { fg = "Black", bg = "mail.listing.compact.even_unseen", attrs = "theme_default" }
-"mail.listing.plain.even" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.odd" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.listing.plain.even_unseen" = { fg = "theme_default", bg = "mail.listing.compact.even_unseen", attrs = "theme_default" }
-"mail.listing.plain.odd_unseen" = { fg = "theme_default", bg = "mail.listing.compact.odd_unseen", attrs = "theme_default" }
-"mail.listing.plain.even_highlighted" = { fg = "$JewelGreen", bg = "$SunsetOrange", attrs = "theme_default" }
-"mail.listing.plain.odd_highlighted" = { fg = "$JewelGreen", bg = "$SunsetOrange", attrs = "theme_default" }
-"mail.listing.plain.even_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.plain.odd_selected" = { fg = "theme_default", bg = "LightCoral", attrs = "theme_default" }
-"mail.listing.thread_snooze_flag" = { fg = "Red", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_highlighted_account" = { fg = "White", bg = "$TorchRed", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted_account_unread_count" = { fg = "mail.sidebar_unread_count", bg = "mail.sidebar_highlighted_account", attrs = "theme_default" }
-"mail.sidebar_highlighted" = { fg = "Grey7", bg = "White", attrs = "theme_default" }
-"mail.sidebar_highlighted_index" = { fg = "mail.sidebar_index", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_highlighted_unread_count" = { fg = "mail.sidebar_highlighted", bg = "mail.sidebar_highlighted", attrs = "theme_default" }
-"mail.sidebar_index" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.sidebar_unread_count" = { fg = "Grey46", bg = "theme_default", attrs = "theme_default" }
-"mail.view.body" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"mail.view.headers" = { fg = "DodgerBlue1", bg = "theme_default", attrs = "theme_default" }
-"status.bar" = { fg = "$PinkLace", bg = "$TorchRed", attrs = "theme_default" }
-"status.notification" = { fg = "theme_default", bg = "theme_default", attrs = "Default" }
-"tab.bar" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }
-"tab.unfocused" = { fg = "$PinkLace", bg = "$HotPink", attrs = "theme_default" }
-"tab.focused" = { fg = "theme_default", bg = "theme_default", attrs = "theme_default" }

meli/src/accounts/backend_ops.rs

@@ -1,90 +0,0 @@
-/*
- * meli - accounts module.
- *
- * Copyright 2023 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Account mail backend operations.
-
-use super::*;
-
-impl Account {
-    pub fn set_flags(
-        &mut self,
-        env_hashes: EnvelopeHashBatch,
-        mailbox_hash: MailboxHash,
-        flags: SmallVec<[FlagOp; 8]>,
-    ) -> Result<JobId> {
-        let fut = self.backend.write().unwrap().set_flags(
-            env_hashes.clone(),
-            mailbox_hash,
-            flags.clone(),
-        )?;
-        let handle = self
-            .main_loop_handler
-            .job_executor
-            .spawn_specialized("set_flags".into(), fut);
-        let job_id = handle.job_id;
-        self.insert_job(
-            job_id,
-            JobRequest::SetFlags {
-                env_hashes,
-                mailbox_hash,
-                flags,
-                handle,
-            },
-        );
-
-        Ok(job_id)
-    }
-
-    #[cfg(not(feature = "sqlite3"))]
-    pub(super) fn update_cached_env(&mut self, _: Envelope, _: Option<EnvelopeHash>) {}
-
-    #[cfg(feature = "sqlite3")]
-    pub(super) fn update_cached_env(&mut self, env: Envelope, old_hash: Option<EnvelopeHash>) {
-        if self.settings.conf.search_backend == crate::conf::SearchBackend::Sqlite3 {
-            let msg_id = env.message_id_display().to_string();
-            let name = self.name.clone();
-            let backend = self.backend.clone();
-            let fut = async move {
-                crate::sqlite3::AccountCache::remove(
-                    name.clone(),
-                    old_hash.unwrap_or_else(|| env.hash()),
-                )
-                .await?;
-
-                crate::sqlite3::AccountCache::insert(env, backend, name).await?;
-                Ok(())
-            };
-            let handle = self
-                .main_loop_handler
-                .job_executor
-                .spawn_specialized("sqlite3::remove".into(), fut);
-            self.insert_job(
-                handle.job_id,
-                JobRequest::Generic {
-                    name: format!("Update envelope {} in sqlite3 cache", msg_id).into(),
-                    handle,
-                    log_level: LogLevel::TRACE,
-                    on_finish: None,
-                },
-            );
-        }
-    }
-}

meli/src/accounts/jobs.rs

@@ -1,222 +0,0 @@
-//
-// meli - accounts module.
-//
-// Copyright 2017 Emmanouil Pitsidianakis <manos@pitsidianak.is>
-//
-// This file is part of meli.
-//
-// meli is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// meli is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with meli. If not, see <http://www.gnu.org/licenses/>.
-//
-// SPDX-License-Identifier: EUPL-1.2 OR GPL-3.0-or-later
-
-use std::{borrow::Cow, collections::HashMap, pin::Pin};
-
-use futures::stream::Stream;
-use melib::{backends::*, email::*, error::Result, LogLevel};
-use smallvec::SmallVec;
-
-use crate::{is_variant, jobs::JoinHandle};
-
-pub enum JobRequest {
-    Mailboxes {
-        handle: JoinHandle<Result<HashMap<MailboxHash, Mailbox>>>,
-    },
-    Fetch {
-        mailbox_hash: MailboxHash,
-        #[allow(clippy::type_complexity)]
-        handle: JoinHandle<(
-            Option<Result<Vec<Envelope>>>,
-            Pin<Box<dyn Stream<Item = Result<Vec<Envelope>>> + Send + 'static>>,
-        )>,
-    },
-    Generic {
-        name: Cow<'static, str>,
-        log_level: LogLevel,
-        handle: JoinHandle<Result<()>>,
-        on_finish: Option<crate::types::CallbackFn>,
-    },
-    IsOnline {
-        handle: JoinHandle<Result<()>>,
-    },
-    Refresh {
-        mailbox_hash: MailboxHash,
-        handle: JoinHandle<Result<()>>,
-    },
-    SetFlags {
-        env_hashes: EnvelopeHashBatch,
-        mailbox_hash: MailboxHash,
-        flags: SmallVec<[FlagOp; 8]>,
-        handle: JoinHandle<Result<()>>,
-    },
-    SaveMessage {
-        bytes: Vec<u8>,
-        mailbox_hash: MailboxHash,
-        handle: JoinHandle<Result<()>>,
-    },
-    SendMessage,
-    SendMessageBackground {
-        handle: JoinHandle<Result<()>>,
-    },
-    DeleteMessages {
-        env_hashes: EnvelopeHashBatch,
-        handle: JoinHandle<Result<()>>,
-    },
-    CreateMailbox {
-        path: String,
-        handle: JoinHandle<Result<(MailboxHash, HashMap<MailboxHash, Mailbox>)>>,
-    },
-    DeleteMailbox {
-        mailbox_hash: MailboxHash,
-        handle: JoinHandle<Result<HashMap<MailboxHash, Mailbox>>>,
-    },
-    //RenameMailbox,
-    SetMailboxPermissions {
-        mailbox_hash: MailboxHash,
-        handle: JoinHandle<Result<()>>,
-    },
-    SetMailboxSubscription {
-        mailbox_hash: MailboxHash,
-        new_value: bool,
-        handle: JoinHandle<Result<()>>,
-    },
-    Watch {
-        handle: JoinHandle<Result<()>>,
-    },
-}
-
-impl Drop for JobRequest {
-    fn drop(&mut self) {
-        match self {
-            Self::Generic { handle, .. } |
-            Self::IsOnline { handle, .. } |
-            Self::Refresh { handle, .. } |
-            Self::SetFlags { handle, .. } |
-            Self::SaveMessage { handle, .. } |
-            //JobRequest::RenameMailbox,
-            Self::SetMailboxPermissions { handle, .. } |
-            Self::SetMailboxSubscription { handle, .. } |
-            Self::Watch { handle, .. } |
-            Self::SendMessageBackground { handle, .. } => {
-                handle.cancel();
-            }
-            Self::DeleteMessages { handle, .. } => {
-                handle.cancel();
-            }
-            Self::CreateMailbox { handle, .. } => {
-                handle.cancel();
-            }
-            Self::DeleteMailbox { handle, .. } => {
-                handle.cancel();
-            }
-            Self::Fetch { handle, .. } => {
-                handle.cancel();
-            }
-            Self::Mailboxes { handle, .. } => {
-                handle.cancel();
-            }
-            Self::SendMessage => {}
-        }
-    }
-}
-
-impl std::fmt::Debug for JobRequest {
-    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-        match self {
-            Self::Generic { name, .. } => write!(f, "JobRequest::Generic({})", name),
-            Self::Mailboxes { .. } => write!(f, "JobRequest::Mailboxes"),
-            Self::Fetch { mailbox_hash, .. } => {
-                write!(f, "JobRequest::Fetch({})", mailbox_hash)
-            }
-            Self::IsOnline { .. } => write!(f, "JobRequest::IsOnline"),
-            Self::Refresh { .. } => write!(f, "JobRequest::Refresh"),
-            Self::SetFlags {
-                env_hashes,
-                mailbox_hash,
-                flags,
-                ..
-            } => f
-                .debug_struct(stringify!(JobRequest::SetFlags))
-                .field("env_hashes", &env_hashes)
-                .field("mailbox_hash", &mailbox_hash)
-                .field("flags", &flags)
-                .finish(),
-            Self::SaveMessage { .. } => write!(f, "JobRequest::SaveMessage"),
-            Self::DeleteMessages { .. } => write!(f, "JobRequest::DeleteMessages"),
-            Self::CreateMailbox { .. } => write!(f, "JobRequest::CreateMailbox"),
-            Self::DeleteMailbox { mailbox_hash, .. } => {
-                write!(f, "JobRequest::DeleteMailbox({})", mailbox_hash)
-            }
-            //JobRequest::RenameMailbox,
-            Self::SetMailboxPermissions { .. } => {
-                write!(f, "JobRequest::SetMailboxPermissions")
-            }
-            Self::SetMailboxSubscription { .. } => {
-                write!(f, "JobRequest::SetMailboxSubscription")
-            }
-            Self::Watch { .. } => write!(f, "JobRequest::Watch"),
-            Self::SendMessage => write!(f, "JobRequest::SendMessage"),
-            Self::SendMessageBackground { .. } => {
-                write!(f, "JobRequest::SendMessageBackground")
-            }
-        }
-    }
-}
-
-impl std::fmt::Display for JobRequest {
-    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-        match self {
-            Self::Generic { name, .. } => write!(f, "{}", name),
-            Self::Mailboxes { .. } => write!(f, "Get mailbox list"),
-            Self::Fetch { .. } => write!(f, "Mailbox fetch"),
-            Self::IsOnline { .. } => write!(f, "Online status check"),
-            Self::Refresh { .. } => write!(f, "Refresh mailbox"),
-            Self::SetFlags {
-                env_hashes, flags, ..
-            } => write!(
-                f,
-                "Set flags for {} message{}: {:?}",
-                env_hashes.len(),
-                if env_hashes.len() == 1 { "" } else { "s" },
-                flags
-            ),
-            Self::SaveMessage { .. } => write!(f, "Save message"),
-            Self::DeleteMessages { env_hashes, .. } => write!(
-                f,
-                "Delete {} message{}",
-                env_hashes.len(),
-                if env_hashes.len() == 1 { "" } else { "s" }
-            ),
-            Self::CreateMailbox { path, .. } => write!(f, "Create mailbox {}", path),
-            Self::DeleteMailbox { .. } => write!(f, "Delete mailbox"),
-            //JobRequest::RenameMailbox,
-            Self::SetMailboxPermissions { .. } => write!(f, "Set mailbox permissions"),
-            Self::SetMailboxSubscription { .. } => write!(f, "Set mailbox subscription"),
-            Self::Watch { .. } => write!(f, "Background watch"),
-            Self::SendMessageBackground { .. } | Self::SendMessage => {
-                write!(f, "Sending message")
-            }
-        }
-    }
-}
-
-impl JobRequest {
-    is_variant! { is_watch, Watch { .. } }
-    is_variant! { is_online, IsOnline { .. } }
-
-    pub fn is_fetch(&self, mailbox_hash: MailboxHash) -> bool {
-        matches!(self, Self::Fetch {
-                 mailbox_hash: h, ..
-             } if *h == mailbox_hash)
-    }
-}

meli/src/accounts/mailbox.rs

@@ -1,347 +0,0 @@
-//
-// meli - accounts module.
-//
-// Copyright 2017 Emmanouil Pitsidianakis <manos@pitsidianak.is>
-//
-// This file is part of meli.
-//
-// meli is free software: you can redistribute it and/or modify
-// it under the terms of the GNU General Public License as published by
-// the Free Software Foundation, either version 3 of the License, or
-// (at your option) any later version.
-//
-// meli is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-// GNU General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with meli. If not, see <http://www.gnu.org/licenses/>.
-//
-// SPDX-License-Identifier: EUPL-1.2 OR GPL-3.0-or-later
-
-use indexmap::IndexMap;
-use melib::{
-    backends::{Mailbox, MailboxHash},
-    error::Error,
-    log,
-};
-use smallvec::SmallVec;
-
-use crate::{conf::FileMailboxConf, is_variant};
-
-#[derive(Clone, Debug, Default)]
-pub enum MailboxStatus {
-    Available,
-    Failed(Error),
-    /// first argument is done work, and second is total work
-    Parsing(usize, usize),
-    #[default]
-    None,
-}
-
-impl MailboxStatus {
-    is_variant! { is_available, Available }
-    is_variant! { is_parsing, Parsing(_, _) }
-}
-
-#[derive(Clone, Debug)]
-pub struct MailboxEntry {
-    pub status: MailboxStatus,
-    pub name: String,
-    pub path: String,
-    pub ref_mailbox: Mailbox,
-    pub conf: FileMailboxConf,
-}
-
-impl MailboxEntry {
-    pub fn new(
-        status: MailboxStatus,
-        name: String,
-        ref_mailbox: Mailbox,
-        conf: FileMailboxConf,
-    ) -> Self {
-        let mut ret = Self {
-            status,
-            name,
-            path: ref_mailbox.path().into(),
-            ref_mailbox,
-            conf,
-        };
-        match ret.conf.mailbox_conf.extra.get("encoding") {
-            None => {}
-            Some(v) if ["utf-8", "utf8"].iter().any(|e| v.eq_ignore_ascii_case(e)) => {}
-            Some(v) if ["utf-7", "utf7"].iter().any(|e| v.eq_ignore_ascii_case(e)) => {
-                ret.name = melib::backends::utf7::decode_utf7_imap(&ret.name);
-                ret.path = melib::backends::utf7::decode_utf7_imap(&ret.path);
-            }
-            Some(other) => {
-                log::warn!(
-                    "mailbox `{}`: unrecognized mailbox name charset: {}",
-                    &ret.name,
-                    other
-                );
-            }
-        }
-        ret
-    }
-
-    pub fn status(&self) -> String {
-        match self.status {
-            MailboxStatus::Available => format!(
-                "{} [{} messages]",
-                self.name(),
-                self.ref_mailbox.count().ok().unwrap_or((0, 0)).1
-            ),
-            MailboxStatus::Failed(ref e) => e.to_string(),
-            MailboxStatus::None => "Retrieving mailbox.".to_string(),
-            MailboxStatus::Parsing(done, total) => {
-                format!("Parsing messages. [{}/{}]", done, total)
-            }
-        }
-    }
-
-    pub fn name(&self) -> &str {
-        if let Some(name) = self.conf.mailbox_conf.alias.as_ref() {
-            name
-        } else {
-            self.ref_mailbox.name()
-        }
-    }
-}
-
-#[derive(Clone, Debug, Default, Serialize)]
-pub struct MailboxNode {
-    pub hash: MailboxHash,
-    pub depth: usize,
-    pub indentation: u32,
-    pub has_sibling: bool,
-    pub children: Vec<MailboxNode>,
-}
-
-pub fn build_mailboxes_order(
-    tree: &mut Vec<MailboxNode>,
-    mailbox_entries: &IndexMap<MailboxHash, MailboxEntry>,
-    mailboxes_order: &mut Vec<MailboxHash>,
-) {
-    tree.clear();
-    mailboxes_order.clear();
-    for (h, f) in mailbox_entries.iter() {
-        if f.ref_mailbox.parent().is_none() {
-            fn rec(
-                h: MailboxHash,
-                mailbox_entries: &IndexMap<MailboxHash, MailboxEntry>,
-                depth: usize,
-            ) -> MailboxNode {
-                let mut node = MailboxNode {
-                    hash: h,
-                    children: Vec::new(),
-                    depth,
-                    indentation: 0,
-                    has_sibling: false,
-                };
-                for &c in mailbox_entries[&h].ref_mailbox.children() {
-                    if mailbox_entries.contains_key(&c) {
-                        node.children.push(rec(c, mailbox_entries, depth + 1));
-                    }
-                }
-                node
-            }
-
-            tree.push(rec(*h, mailbox_entries, 0));
-        }
-    }
-
-    macro_rules! mailbox_eq_key {
-        ($mailbox:expr) => {{
-            if let Some(sort_order) = $mailbox.conf.mailbox_conf.sort_order {
-                (0, sort_order, $mailbox.ref_mailbox.path())
-            } else {
-                (1, 0, $mailbox.ref_mailbox.path())
-            }
-        }};
-    }
-    tree.sort_unstable_by(|a, b| {
-        if mailbox_entries[&b.hash]
-            .conf
-            .mailbox_conf
-            .sort_order
-            .is_none()
-            && mailbox_entries[&b.hash]
-                .ref_mailbox
-                .path()
-                .eq_ignore_ascii_case("INBOX")
-        {
-            std::cmp::Ordering::Greater
-        } else if mailbox_entries[&a.hash]
-            .conf
-            .mailbox_conf
-            .sort_order
-            .is_none()
-            && mailbox_entries[&a.hash]
-                .ref_mailbox
-                .path()
-                .eq_ignore_ascii_case("INBOX")
-        {
-            std::cmp::Ordering::Less
-        } else {
-            mailbox_eq_key!(mailbox_entries[&a.hash])
-                .cmp(&mailbox_eq_key!(mailbox_entries[&b.hash]))
-        }
-    });
-
-    let mut stack: SmallVec<[Option<&MailboxNode>; 16]> = SmallVec::new();
-    for n in tree.iter_mut() {
-        mailboxes_order.push(n.hash);
-        n.children.sort_unstable_by(|a, b| {
-            if mailbox_entries[&b.hash]
-                .conf
-                .mailbox_conf
-                .sort_order
-                .is_none()
-                && mailbox_entries[&b.hash]
-                    .ref_mailbox
-                    .path()
-                    .eq_ignore_ascii_case("INBOX")
-            {
-                std::cmp::Ordering::Greater
-            } else if mailbox_entries[&a.hash]
-                .conf
-                .mailbox_conf
-                .sort_order
-                .is_none()
-                && mailbox_entries[&a.hash]
-                    .ref_mailbox
-                    .path()
-                    .eq_ignore_ascii_case("INBOX")
-            {
-                std::cmp::Ordering::Less
-            } else {
-                mailbox_eq_key!(mailbox_entries[&a.hash])
-                    .cmp(&mailbox_eq_key!(mailbox_entries[&b.hash]))
-            }
-        });
-        stack.extend(n.children.iter().rev().map(Some));
-        while let Some(Some(next)) = stack.pop() {
-            mailboxes_order.push(next.hash);
-            stack.extend(next.children.iter().rev().map(Some));
-        }
-    }
-    drop(stack);
-    for node in tree.iter_mut() {
-        fn rec(
-            node: &mut MailboxNode,
-            mailbox_entries: &IndexMap<MailboxHash, MailboxEntry>,
-            mut indentation: u32,
-            has_sibling: bool,
-        ) {
-            node.indentation = indentation;
-            node.has_sibling = has_sibling;
-            let mut iter = (0..node.children.len())
-                .filter(|i| {
-                    mailbox_entries[&node.children[*i].hash]
-                        .ref_mailbox
-                        .is_subscribed()
-                })
-                .collect::<SmallVec<[_; 8]>>()
-                .into_iter()
-                .peekable();
-            indentation <<= 1;
-            if has_sibling {
-                indentation |= 1;
-            }
-            while let Some(i) = iter.next() {
-                let c = &mut node.children[i];
-                rec(c, mailbox_entries, indentation, iter.peek().is_some());
-            }
-        }
-
-        rec(node, mailbox_entries, 0, false);
-    }
-}
-
-#[cfg(test)]
-mod tests {
-    use melib::{
-        backends::{Mailbox, MailboxHash},
-        error::Result,
-        MailboxPermissions, SpecialUsageMailbox,
-    };
-
-    use crate::accounts::{FileMailboxConf, MailboxEntry, MailboxStatus};
-
-    #[test]
-    fn test_mailbox_utf7() {
-        #[derive(Debug)]
-        struct TestMailbox(String);
-
-        impl melib::BackendMailbox for TestMailbox {
-            fn hash(&self) -> MailboxHash {
-                unimplemented!()
-            }
-
-            fn name(&self) -> &str {
-                &self.0
-            }
-
-            fn path(&self) -> &str {
-                &self.0
-            }
-
-            fn children(&self) -> &[MailboxHash] {
-                unimplemented!()
-            }
-
-            fn clone(&self) -> Mailbox {
-                unimplemented!()
-            }
-
-            fn special_usage(&self) -> SpecialUsageMailbox {
-                unimplemented!()
-            }
-
-            fn parent(&self) -> Option<MailboxHash> {
-                unimplemented!()
-            }
-
-            fn permissions(&self) -> MailboxPermissions {
-                unimplemented!()
-            }
-
-            fn is_subscribed(&self) -> bool {
-                unimplemented!()
-            }
-
-            fn set_is_subscribed(&mut self, _: bool) -> Result<()> {
-                unimplemented!()
-            }
-
-            fn set_special_usage(&mut self, _: SpecialUsageMailbox) -> Result<()> {
-                unimplemented!()
-            }
-
-            fn count(&self) -> Result<(usize, usize)> {
-                unimplemented!()
-            }
-        }
-        for (n, d) in [
-            ("~peter/mail/&U,BTFw-/&ZeVnLIqe-", "~peter/mail/台北/日本語"),
-            ("&BB4EQgQ,BEAEMAQyBDsENQQ9BD0ESwQ1-", "Отправленные"),
-        ] {
-            let ref_mbox = TestMailbox(n.to_string());
-            let mut conf: melib::MailboxConf = Default::default();
-            conf.extra.insert("encoding".to_string(), "utf7".into());
-
-            let entry = MailboxEntry::new(
-                MailboxStatus::None,
-                n.to_string(),
-                Box::new(ref_mbox),
-                FileMailboxConf {
-                    mailbox_conf: conf,
-                    ..Default::default()
-                },
-            );
-            assert_eq!(&entry.path, d);
-        }
-    }
-}

meli/src/args.rs

@@ -1,229 +0,0 @@
-/*
- * meli - args.rs
- *
- * Copyright 2017-2023 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Command line arguments.
-
-use super::*;
-
-#[derive(Debug, StructOpt)]
-#[structopt(name = "meli", about = "terminal mail client", version_short = "v")]
-pub struct Opt {
-    /// use specified configuration file
-    #[structopt(short, long, parse(from_os_str))]
-    pub config: Option<PathBuf>,
-
-    #[structopt(subcommand)]
-    pub subcommand: Option<SubCommand>,
-}
-
-#[derive(Debug, StructOpt)]
-pub enum SubCommand {
-    /// print default theme in full to stdout and exit.
-    PrintDefaultTheme,
-    /// print loaded themes in full to stdout and exit.
-    PrintLoadedThemes,
-    /// print all directories that meli creates/uses.
-    PrintAppDirectories,
-    /// print location of configuration file that will be loaded on normal app
-    /// startup.
-    PrintConfigPath,
-    /// edit configuration files with `$EDITOR`/`$VISUAL`.
-    EditConfig,
-    /// create a sample configuration file with available configuration options.
-    /// If PATH is not specified, meli will try to create it in
-    /// $XDG_CONFIG_HOME/meli/config.toml
-    #[structopt(display_order = 1)]
-    CreateConfig {
-        #[structopt(value_name = "NEW_CONFIG_PATH", parse(from_os_str))]
-        path: Option<PathBuf>,
-    },
-    /// test a configuration file for syntax issues or missing options.
-    #[structopt(display_order = 2)]
-    TestConfig {
-        #[structopt(value_name = "CONFIG_PATH", parse(from_os_str))]
-        path: Option<PathBuf>,
-    },
-    #[structopt(visible_alias="docs", aliases=&["docs", "manpage", "manpages"])]
-    #[structopt(display_order = 3)]
-    /// print documentation page and exit (Piping to a pager is recommended.).
-    Man(ManOpt),
-
-    #[structopt(display_order = 4)]
-    /// Install manual pages to the first location provided by $MANPATH /
-    /// manpath(1), unless you specify the directory as an argument.
-    InstallMan {
-        #[structopt(value_name = "DESTINATION_PATH", parse(from_os_str))]
-        destination_path: Option<PathBuf>,
-    },
-    #[structopt(display_order = 5)]
-    /// Print compile time feature flags of this binary
-    CompiledWith,
-    /// Print log file location.
-    PrintLogPath,
-    /// View mail from input file.
-    View {
-        #[structopt(value_name = "INPUT", parse(from_os_str))]
-        path: PathBuf,
-    },
-}
-
-#[derive(Debug, StructOpt)]
-pub struct ManOpt {
-    #[cfg(feature = "cli-docs")]
-    #[cfg_attr(feature = "cli-docs", structopt(default_value = "meli", possible_values=manpages::POSSIBLE_VALUES, value_name="PAGE", parse(try_from_str = manpages::parse_manpage)))]
-    /// Name of manual page.
-    pub page: manpages::ManPages,
-    /// If true, output text in stdout instead of spawning $PAGER.
-    #[cfg(feature = "cli-docs")]
-    #[cfg_attr(
-        feature = "cli-docs",
-        structopt(long = "no-raw", alias = "no-raw", value_name = "bool")
-    )]
-    pub no_raw: Option<Option<bool>>,
-}
-
-#[cfg(feature = "cli-docs")]
-pub mod manpages {
-    use std::{
-        env, fs,
-        path::{Path, PathBuf},
-        sync::Arc,
-    };
-
-    use melib::log;
-
-    use crate::{Error, Result};
-
-    pub const POSSIBLE_VALUES: &[&str] = &[
-        "meli",
-        "meli.1",
-        "conf",
-        "meli.conf",
-        "meli.conf.5",
-        "themes",
-        "meli-themes",
-        "meli-themes.5",
-        "guide",
-        "meli.7",
-    ];
-
-    pub fn parse_manpage(src: &str) -> Result<ManPages> {
-        match src {
-            "" | "meli" | "meli.1" | "main" => Ok(ManPages::Main),
-            "meli.7" | "guide" => Ok(ManPages::Guide),
-            "meli.conf" | "meli.conf.5" | "conf" | "config" | "configuration" => Ok(ManPages::Conf),
-            "meli-themes" | "meli-themes.5" | "themes" | "theming" | "theme" => {
-                Ok(ManPages::Themes)
-            }
-            _ => Err(Error::new(format!("Invalid documentation page: {src}",))),
-        }
-    }
-
-    #[derive(Clone, Copy, Debug)]
-    /// Choose manpage
-    pub enum ManPages {
-        /// meli(1)
-        Main = 0,
-        /// meli.conf(5)
-        Conf = 1,
-        /// meli-themes(5)
-        Themes = 2,
-        /// meli(7)
-        Guide = 3,
-    }
-
-    impl std::fmt::Display for ManPages {
-        fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
-            write!(
-                fmt,
-                "{}",
-                match self {
-                    Self::Main => "meli.1",
-                    Self::Conf => "meli.conf.5",
-                    Self::Themes => "meli-themes.5",
-                    Self::Guide => "meli.7",
-                }
-            )
-        }
-    }
-
-    impl ManPages {
-        pub fn install(destination: Option<PathBuf>) -> Result<PathBuf> {
-            fn path_valid(p: &Path, tries: &mut Vec<PathBuf>) -> bool {
-                tries.push(p.into());
-                p.exists()
-                    && p.is_dir()
-                    && fs::metadata(p)
-                        .ok()
-                        .map(|m| !m.permissions().readonly())
-                        .unwrap_or(false)
-            }
-
-            let mut tries = vec![];
-            let Some(mut path) = destination
-                .filter(|p| path_valid(p, &mut tries))
-                .or_else(|| {
-                    if let Some(paths) = env::var_os("MANPATH") {
-                        if let Some(path) =
-                            env::split_paths(&paths).find(|p| path_valid(p, &mut tries))
-                        {
-                            return Some(path);
-                        }
-                    }
-                    None
-                })
-                .or_else(|| {
-                    #[allow(deprecated)]
-                    env::home_dir()
-                        .map(|p| p.join(".local").join("share").join("man"))
-                        .filter(|p| path_valid(p, &mut tries))
-                })
-            else {
-                return Err(format!("Could not write to any of these paths: {:?}", tries).into());
-            };
-
-            for (p, dir) in [
-                (Self::Main, "man1"),
-                (Self::Conf, "man5"),
-                (Self::Themes, "man5"),
-                (Self::Guide, "man7"),
-            ] {
-                let text = crate::subcommands::man(p, true)?;
-                path.push(dir);
-                std::fs::create_dir_all(&path).map_err(|err| {
-                    Error::new(format!("Could not create {} directory.", path.display()))
-                        .set_source(Some(Arc::new(err)))
-                })?;
-                path.push(&p.to_string());
-
-                fs::write(&path, text.as_bytes()).map_err(|err| {
-                    Error::new(format!("Could not write to {}", path.display()))
-                        .set_source(Some(Arc::new(err)))
-                })?;
-                log::trace!("Installed {} to {}", p, path.display());
-                path.pop();
-                path.pop();
-            }
-
-            Ok(path)
-        }
-    }
-}

meli/src/command.rs

@@ -1,688 +0,0 @@
-/*
- * meli
- *
- * Copyright 2017-2018 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! A parser module for user commands passed through
-//! [`Command`](crate::types::UIMode::Command) mode.
-
-use std::{borrow::Cow, collections::HashSet, str::FromStr};
-
-use melib::{
-    nom::{
-        self,
-        branch::alt,
-        bytes::complete::{is_a, is_not, tag, take_until},
-        character::complete::{digit1, not_line_ending},
-        combinator::{map, map_res},
-        error::Error as NomError,
-        multi::separated_list1,
-        sequence::{pair, preceded, separated_pair},
-        IResult,
-    },
-    parser::BytesExt,
-    SortField, SortOrder,
-};
-
-pub mod actions;
-#[macro_use]
-pub mod error;
-#[macro_use]
-pub mod argcheck;
-pub mod history;
-pub mod parser;
-use actions::MailboxOperation;
-use error::CommandError;
-pub use parser::parse_command;
-
-pub use crate::actions::{
-    AccountAction::{self, *},
-    Action::{self, *},
-    ComposeAction::{self, *},
-    FlagAction,
-    ListingAction::{self, *},
-    MailingListAction::{self, *},
-    TabAction::{self, *},
-    TagAction,
-    ViewAction::{self, *},
-};
-
-/// Helper macro to convert an array of tokens into a `TokenStream`
-macro_rules! to_stream {
-    ($token: expr) => {
-        TokenStream {
-            tokens: &[$token],
-        }
-    };
-    ($($tokens:expr),*) => {
-        TokenStream {
-            tokens: &[$($tokens),*],
-        }
-    };
-}
-
-/// Macro to create a const table with every command part that can be
-/// auto-completed and its description
-macro_rules! define_commands {
-    ( [$({ tags: [$( $tags:literal),*], desc: $desc:literal, tokens: $tokens:expr, parser: $parser:path}),*]) => {
-        pub const COMMAND_COMPLETION: &[(&str, &str, TokenStream, fn(&[u8]) -> IResult<&[u8], Result<Action, CommandError>>)] = &[$($( ($tags, $desc, TokenStream { tokens: $tokens }, $parser) ),*),* ];
-    };
-}
-
-pub fn quoted_argument(input: &[u8]) -> IResult<&[u8], &str> {
-    if input.is_empty() {
-        return Err(nom::Err::Error(NomError {
-            input,
-            code: nom::error::ErrorKind::Tag,
-        }));
-    }
-
-    if input[0] == b'"' {
-        let mut i = 1;
-        while i < input.len() {
-            if input[i] == b'\"' && input[i - 1] != b'\\' {
-                return Ok((&input[i + 1..], unsafe {
-                    std::str::from_utf8_unchecked(&input[1..i])
-                }));
-            }
-            i += 1;
-        }
-        Err(nom::Err::Error(NomError {
-            input,
-            code: nom::error::ErrorKind::Tag,
-        }))
-    } else {
-        map_res(is_not(" "), std::str::from_utf8)(input)
-    }
-}
-
-#[derive(Clone, Copy, Debug)]
-pub struct TokenStream {
-    tokens: &'static [TokenAdicity],
-}
-
-use Token::*;
-use TokenAdicity::*;
-
-impl TokenStream {
-    fn matches<'s>(&self, s: &mut &'s str, sugg: &mut HashSet<String>) -> Vec<(&'s str, Token)> {
-        let mut tokens = vec![];
-        for t in self.tokens.iter() {
-            let mut ptr = 0;
-            while ptr + 1 < s.len() && s.as_bytes()[ptr].is_ascii_whitespace() {
-                ptr += 1;
-            }
-            *s = &s[ptr..];
-            //println!("\t before s.is_empty() {:?} {:?}", t, s);
-            if s.is_empty() || *s == " " {
-                match t.inner() {
-                    Literal(lit) => {
-                        sugg.insert(format!("{}{}", if s.is_empty() { " " } else { "" }, lit));
-                    }
-                    Alternatives(v) => {
-                        for t in v.iter() {
-                            //println!("adding empty suggestions for {:?}", t);
-                            let mut _s = *s;
-                            let mut m = t.matches(&mut _s, sugg);
-                            tokens.append(&mut m);
-                        }
-                    }
-                    Seq(_s) => {}
-                    RestOfStringValue => {
-                        sugg.insert(String::new());
-                    }
-                    t @ AttachmentIndexValue
-                    | t @ MailboxIndexValue
-                    | t @ IndexValue
-                    | t @ Filepath
-                    | t @ AccountName
-                    | t @ MailboxPath
-                    | t @ QuotedStringValue
-                    | t @ AlphanumericStringValue => {
-                        let _t = t;
-                        //sugg.insert(format!("{}{:?}", if s.is_empty() { " " }
-                        // else { "" }, t));
-                    }
-                }
-                tokens.push((*s, *t.inner()));
-                return tokens;
-            }
-            match t.inner() {
-                Literal(lit) => {
-                    if lit.starts_with(*s) && lit.len() != s.len() {
-                        sugg.insert(lit[s.len()..].to_string());
-                        tokens.push((s, *t.inner()));
-                        return tokens;
-                    } else if s.starts_with(lit) {
-                        tokens.push((&s[..lit.len()], *t.inner()));
-                        *s = &s[lit.len()..];
-                    } else {
-                        return vec![];
-                    }
-                }
-                Alternatives(v) => {
-                    let mut cont = true;
-                    for t in v.iter() {
-                        let mut _s = *s;
-                        let mut m = t.matches(&mut _s, sugg);
-                        if !m.is_empty() {
-                            tokens.append(&mut m);
-                            //println!("_s is empty {}", _s.is_empty());
-                            cont = !_s.is_empty();
-                            *s = _s;
-                            break;
-                        }
-                    }
-                    if tokens.is_empty() {
-                        return tokens;
-                    }
-                    if !cont {
-                        *s = "";
-                    }
-                }
-                Seq(_s) => {
-                    return vec![];
-                }
-                RestOfStringValue => {
-                    tokens.push((*s, *t.inner()));
-                    return tokens;
-                }
-                AttachmentIndexValue
-                | MailboxIndexValue
-                | IndexValue
-                | Filepath
-                | AccountName
-                | MailboxPath
-                | QuotedStringValue
-                | AlphanumericStringValue => {
-                    let mut ptr = 0;
-                    while ptr + 1 < s.len() && !s.as_bytes()[ptr].is_ascii_whitespace() {
-                        ptr += 1;
-                    }
-                    tokens.push((&s[..ptr + 1], *t.inner()));
-                    *s = &s[ptr + 1..];
-                }
-            }
-        }
-        tokens
-    }
-}
-
-/// `Token` wrapper that defines how many times a token is expected to be
-/// repeated
-#[derive(Clone, Copy, Debug)]
-pub enum TokenAdicity {
-    ZeroOrOne(Token),
-    ZeroOrMore(Token),
-    One(Token),
-    OneOrMore(Token),
-}
-
-impl TokenAdicity {
-    fn inner(&self) -> &Token {
-        match self {
-            ZeroOrOne(ref t) => t,
-            ZeroOrMore(ref t) => t,
-            One(ref t) => t,
-            OneOrMore(ref t) => t,
-        }
-    }
-}
-
-/// A token encountered in the UI's command execution bar
-#[derive(Clone, Copy, Debug)]
-pub enum Token {
-    Literal(&'static str),
-    Filepath,
-    Alternatives(&'static [TokenStream]),
-    Seq(&'static [TokenAdicity]),
-    AccountName,
-    MailboxPath,
-    QuotedStringValue,
-    RestOfStringValue,
-    AlphanumericStringValue,
-    AttachmentIndexValue,
-    MailboxIndexValue,
-    IndexValue,
-}
-
-fn eof(input: &[u8]) -> IResult<&[u8], ()> {
-    if input.is_empty() {
-        Ok((input, ()))
-    } else {
-        Err(nom::Err::Error(NomError {
-            input,
-            code: nom::error::ErrorKind::Tag,
-        }))
-    }
-}
-
-define_commands!([
-                 { tags: ["set", "set seen", "set unseen", "set plain", "set threaded", "set compact"],
-                   desc: "set [seen/unseen], toggles message's Seen flag. set [plain/threaded/compact/conversations] changes the mail listing view",
-                   tokens: &[One(Literal("set")),
-                   One(
-                       Alternatives(&[
-                           to_stream!(One(Literal("seen"))),
-                           to_stream!(One(Literal("unseen"))),
-                           to_stream!(One(Literal("plain"))),
-                           to_stream!(One(Literal("threaded"))),
-                           to_stream!(One(Literal("compact"))),
-                           to_stream!(One(Literal("conversations")))
-                     ])
-                      )
-                   ],
-                   parser: parser::set
-                 },
-                 { tags: ["delete"],
-                   desc: "delete message",
-                   tokens: &[One(Literal("delete"))],
-                   parser: parser::delete_message
-                 },
-                 { tags: ["copyto", "moveto"],
-                   desc: "copy/move message",
-                   tokens: &[One(Alternatives(&[to_stream!(One(Literal("copyto"))), to_stream!(One(Literal("moveto")))])), ZeroOrOne(AccountName), One(MailboxPath)],
-                   parser: parser::copymove
-                 },
-                { tags: ["import "],
-                  desc: "import FILESYSTEM_PATH MAILBOX_PATH",
-                  tokens: &[One(Literal("import")), One(Filepath), One(MailboxPath)],
-                  parser: parser::import
-                },
-                 { tags: ["close"],
-                   desc: "close non-sticky tabs",
-                   tokens: &[One(Literal("close"))],
-                   parser: parser::close
-                 },
-                 { tags: ["go"],
-                   desc: "go <n>, switch to nth mailbox in this account",
-                   tokens: &[One(Literal("goto")), One(MailboxIndexValue)],
-                   parser: parser::goto
-                 },
-                 { tags: ["subsort"],
-                   desc: "subsort [date/subject] [asc/desc], sorts first level replies in threads.",
-                   tokens: &[One(Literal("subsort")), One(Alternatives(&[to_stream!(One(Literal("date"))), to_stream!(One(Literal("subject")))])), One(Alternatives(&[to_stream!(One(Literal("asc"))), to_stream!(One(Literal("desc")))])) ],
-                   parser: parser::subsort
-                 },
-                { tags: ["sort"],
-                  desc: "sort [date/subject] [asc/desc], sorts threads.",
-                   tokens: &[One(Literal("sort")), One(Alternatives(&[to_stream!(One(Literal("date"))), to_stream!(One(Literal("subject")))])), One(Alternatives(&[to_stream!(One(Literal("asc"))), to_stream!(One(Literal("desc")))])) ],
-                  parser: parser::sort
-                },
-                { tags: ["sort"],
-                  desc: "sort <column index> [asc/desc], sorts table columns.",
-                   tokens: &[One(Literal("sort")), One(IndexValue), ZeroOrOne(Alternatives(&[to_stream!(One(Literal("asc"))), to_stream!(One(Literal("desc")))])) ],
-                  parser: parser::sort_column
-                },
-                { tags: ["toggle thread_snooze"],
-                  desc: "turn off new notifications for this thread",
-                  tokens: &[One(Literal("toggle")), One(Literal("thread_snooze"))],
-                  parser: parser::toggle
-                },
-                { tags: ["search"],
-                  desc: "search <TERM>, searches list with given term",
-                  tokens: &[One(Literal("search")), One(RestOfStringValue)],
-                  parser: parser::search
-                },
-                { tags: ["clear-selection"],
-                  desc: "clear-selection",
-                  tokens: &[One(Literal("clear-selection"))],
-                  parser: parser::select
-                },
-                { tags: ["select"],
-                  desc: "select <TERM>, selects envelopes matching with given term",
-                  tokens: &[One(Literal("select")), One(RestOfStringValue)],
-                  parser: parser::select
-                },
-                { tags: ["export-mbox "],
-                  desc: "export-mbox PATH",
-                  tokens: &[One(Literal("export-mbox")), One(Filepath)],
-                  parser: parser::export_mbox
-                },
-                { tags: ["list-archive", "list-post", "list-unsubscribe", "list-"],
-                  desc: "list-[unsubscribe/post/archive]",
-                  tokens: &[One(Alternatives(&[to_stream!(One(Literal("list-archive"))), to_stream!(One(Literal("list-post"))), to_stream!(One(Literal("list-unsubscribe")))]))],
-                  parser: parser::mailinglist
-                },
-                { tags: ["setenv "],
-                  desc: "setenv VAR=VALUE",
-                  tokens: &[One(Literal("setenv")), OneOrMore(Seq(&[One(AlphanumericStringValue), One(Literal("=")), One(QuotedStringValue)]))],
-                  parser: parser::setenv
-                },
-                { tags: ["printenv "],
-                  desc: "printenv VAR",
-                  tokens: &[],
-                  parser: parser::printenv
-                },
-                { tags: ["mailto "],
-                  desc: "mailto MAILTO_ADDRESS",
-                  tokens: &[One(Literal("mailto")), One(QuotedStringValue)],
-                  parser: parser::mailto
-                },
-                /* Pipe pager contents to binary */
-                { tags: ["pipe "],
-                  desc: "pipe EXECUTABLE ARGS",
-                  tokens: &[One(Literal("pipe")), One(Filepath), ZeroOrMore(QuotedStringValue)],
-                  parser: parser::pipe
-                },
-                /* Filter pager contents through binary */
-                { tags: ["filter "],
-                  desc: "filter EXECUTABLE ARGS",
-                  tokens: &[One(Literal("filter")), One(Filepath), ZeroOrMore(QuotedStringValue)],
-                  parser: parser::filter
-                },
-                { tags: ["add-attachment ", "add-attachment-file-picker "],
-                  desc: "add-attachment PATH",
-                  tokens: &[One(
-Alternatives(&[to_stream!(One(Literal("add-attachment")), One(Filepath)), to_stream!(One(Literal("add-attachment-file-picker")))]))],
-                  parser: parser::add_attachment
-                },
-                { tags: ["remove-attachment "],
-                  desc: "remove-attachment INDEX",
-                  tokens: &[One(Literal("remove-attachment")), One(IndexValue)],
-                  parser: parser::remove_attachment
-                },
-                { tags: ["save-draft"],
-                  desc: "save draft",
-                  tokens: &[One(Literal("save-draft"))],
-                  parser: parser::save_draft
-                },
-                { tags: ["toggle sign "],
-                  desc: "switch between sign/unsign for this draft",
-                  tokens: &[One(Literal("toggle")), One(Literal("sign"))],
-                  parser: parser::toggle
-                },
-                { tags: ["toggle encrypt"],
-                  desc: "toggle encryption for this draft",
-                  tokens: &[One(Literal("toggle")), One(Literal("encrypt"))],
-                  parser: parser::toggle
-                },
-                { tags: ["create-mailbox "],
-                  desc: "create-mailbox ACCOUNT MAILBOX_PATH",
-                  tokens: &[One(Literal("create-mailbox")), One(AccountName), One(MailboxPath)],
-                  parser: parser::create_mailbox
-                },
-                { tags: ["subscribe-mailbox "],
-                  desc: "subscribe-mailbox ACCOUNT MAILBOX_PATH",
-                  tokens: &[One(Literal("subscribe-mailbox")), One(AccountName), One(MailboxPath)],
-                  parser: parser::sub_mailbox
-                },
-                { tags: ["unsubscribe-mailbox "],
-                  desc: "unsubscribe-mailbox ACCOUNT MAILBOX_PATH",
-                  tokens: &[One(Literal("unsubscribe-mailbox")), One(AccountName), One(MailboxPath)],
-                  parser: parser::unsub_mailbox
-                },
-                { tags: ["rename-mailbox "],
-                  desc: "rename-mailbox ACCOUNT MAILBOX_PATH_SRC MAILBOX_PATH_DEST",
-                  tokens: &[One(Literal("rename-mailbox")), One(AccountName), One(MailboxPath), One(MailboxPath)],
-                  parser: parser::rename_mailbox
-                },
-                { tags: ["delete-mailbox "],
-                  desc: "delete-mailbox ACCOUNT MAILBOX_PATH",
-                  tokens: &[One(Literal("delete-mailbox")), One(AccountName), One(MailboxPath)],
-                  parser: parser::delete_mailbox
-                },
-                { tags: ["reindex "],
-                  desc: "reindex ACCOUNT, rebuild account cache in the background",
-                  tokens: &[One(Literal("reindex")), One(AccountName)],
-                  parser: parser::reindex
-                },
-                { tags: ["open-in-tab"],
-                  desc: "opens envelope view in new tab",
-                  tokens: &[One(Literal("open-in-tab"))],
-                  parser: parser::open_in_new_tab
-                },
-                { tags: ["save-attachment "],
-                  desc: "save-attachment INDEX PATH",
-                  tokens: &[One(Literal("save-attachment")), One(AttachmentIndexValue), One(Filepath)],
-                  parser: parser::save_attachment
-                },
-                { tags: ["export-mail "],
-                  desc: "export-mail PATH",
-                  tokens: &[One(Literal("export-mail")), One(Filepath)],
-                  parser: parser::export_mail
-                },
-                { tags: ["add-addresses-to-contacts "],
-                  desc: "add-addresses-to-contacts",
-                  tokens: &[One(Literal("add-addresses-to-contacts"))],
-                  parser: parser::add_addresses_to_contacts
-                },
-                { tags: ["tag", "tag add", "tag remove"],
-                   desc: "tag [add/remove], edits message's tags.",
-                   tokens: &[One(Literal("tag")), One(Alternatives(&[to_stream!(One(Literal("add"))), to_stream!(One(Literal("remove")))]))],
-                   parser: parser::_tag
-                },
-                { tags: ["print "],
-                  desc: "print ACCOUNT SETTING",
-                  tokens: &[One(Literal("print")), One(AccountName), One(QuotedStringValue)],
-                  parser: parser::print_account_setting
-                },
-                { tags: ["print "],
-                  desc: "print SETTING",
-                  tokens: &[One(Literal("print")), One(QuotedStringValue)],
-                  parser: parser::print_setting
-                },
-                { tags: ["toggle mouse"],
-                  desc: "toggle mouse support",
-                  tokens: &[One(Literal("toggle")), One(Literal("mouse"))],
-                  parser: parser::toggle
-                },
-                { tags: ["manage-mailboxes"],
-                  desc: "view and manage mailbox preferences",
-                  tokens: &[One(Literal("manage-mailboxes"))],
-                  parser: parser::manage_mailboxes
-                },
-                { tags: ["manage-jobs"],
-                  desc: "view and manage jobs",
-                  tokens: &[One(Literal("manage-jobs"))],
-                  parser: parser::manage_jobs
-                },
-                { tags: ["quit"],
-                  desc: "quit meli",
-                  tokens: &[One(Literal("quit"))],
-                  parser: parser::quit
-                },
-                { tags: ["reload-config"],
-                  desc: "reload configuration file",
-                  tokens: &[One(Literal("reload-config"))],
-                  parser: parser::reload_config
-                }
-]);
-
-/// Get command suggestions for input
-pub fn command_completion_suggestions(input: &str) -> Vec<String> {
-    use crate::melib::ShellExpandTrait;
-    let mut sugg: HashSet<String> = Default::default();
-    for (_tags, _desc, tokens, _) in COMMAND_COMPLETION.iter() {
-        let _m = tokens.matches(&mut &(*input), &mut sugg);
-        if _m.is_empty() {
-            continue;
-        }
-        if let Some((s, Filepath)) = _m.last() {
-            let p = std::path::Path::new(s);
-            sugg.extend(p.complete(true).into_iter());
-        }
-    }
-    sugg.into_iter()
-        .map(|s| format!("{}{}", input, s.as_str()))
-        .collect::<Vec<String>>()
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    #[test]
-    fn test_command_parser() {
-        let mut input = "sort".to_string();
-        macro_rules! match_input {
-            ($input:expr) => {{
-                let mut sugg: HashSet<String> = Default::default();
-                //print!("{}", $input);
-                for (_tags, _desc, tokens, _) in COMMAND_COMPLETION.iter() {
-                    //    //println!("{:?}, {:?}, {:?}", _tags, _desc, tokens);
-                    let _ = tokens.matches(&mut $input.as_str(), &mut sugg);
-                    //    if !m.is_empty() {
-                    //        //print!("{:?} ", desc);
-                    //        //println!(" result = {:#?}\n\n", m);
-                    //    }
-                }
-                //println!("suggestions = {:#?}", sugg);
-                sugg.into_iter()
-                    .map(|s| format!("{}{}", $input.as_str(), s.as_str()))
-                    .collect::<HashSet<String>>()
-            }};
-        }
-        assert_eq!(
-            &match_input!(input),
-            &IntoIterator::into_iter(["sort date".to_string(), "sort subject".to_string()])
-                .collect(),
-        );
-        input = "so".to_string();
-        assert_eq!(
-            &match_input!(input),
-            &IntoIterator::into_iter(["sort".to_string()]).collect(),
-        );
-        input = "so ".to_string();
-        assert_eq!(&match_input!(input), &HashSet::default(),);
-        input = "to".to_string();
-        assert_eq!(
-            &match_input!(input),
-            &IntoIterator::into_iter(["toggle".to_string()]).collect(),
-        );
-        input = "toggle ".to_string();
-        assert_eq!(
-            &match_input!(input),
-            &IntoIterator::into_iter([
-                "toggle mouse".to_string(),
-                "toggle sign".to_string(),
-                "toggle encrypt".to_string(),
-                "toggle thread_snooze".to_string()
-            ])
-            .collect(),
-        );
-    }
-
-    #[test]
-    #[ignore]
-    fn test_parser_interactive() {
-        use std::io;
-        let mut input = String::new();
-        loop {
-            input.clear();
-            print!("> ");
-            match io::stdin().read_line(&mut input) {
-                Ok(_n) => {
-                    println!("Input is {:?}", input.as_str().trim());
-                    let mut sugg: HashSet<String> = Default::default();
-                    let mut vec = vec![];
-                    //print!("{}", input);
-                    for (_tags, _desc, tokens, _) in COMMAND_COMPLETION.iter() {
-                        //println!("{:?}, {:?}, {:?}", _tags, _desc, tokens);
-                        let m = tokens.matches(&mut input.as_str().trim(), &mut sugg);
-                        if !m.is_empty() {
-                            vec.push(tokens);
-                            //print!("{:?} ", desc);
-                            //println!(" result = {:#?}\n\n", m);
-                        }
-                    }
-                    println!(
-                        "suggestions = {:#?}",
-                        sugg.into_iter()
-                            .zip(vec.into_iter())
-                            .map(|(s, v)| format!(
-                                "{}{} {:?}",
-                                input.as_str().trim(),
-                                if input.trim().is_empty() {
-                                    s.trim()
-                                } else {
-                                    s.as_str()
-                                },
-                                v
-                            ))
-                            .collect::<Vec<String>>()
-                    );
-                    if input.trim() == "quit" {
-                        break;
-                    }
-                }
-                Err(error) => println!("error: {}", error),
-            }
-        }
-        println!("alright");
-    }
-
-    #[test]
-    fn test_command_parser_all() {
-        use CommandError::*;
-
-        for cmd in [
-            "set unseen",
-            "set seen",
-            "delete",
-            "copyto somewhere",
-            "moveto somewhere",
-            "import fpath mpath",
-            "close  ",
-            "go 5",
-        ] {
-            parse_command(cmd.as_bytes()).unwrap_or_else(|err| panic!("{} failed {}", cmd, err));
-        }
-
-        assert_eq!(
-            parse_command(b"setfafsfoo").unwrap_err().to_string(),
-            Parsing {
-                inner: "setfafsfoo".into(),
-                kind: "".into(),
-            }
-            .to_string(),
-        );
-        assert_eq!(
-            parse_command(b"set foo").unwrap_err().to_string(),
-            BadValue {
-                inner: "Bad argument for `set`. Accepted arguments are [seen, unseen, plain, \
-                        threaded, compact, conversations]."
-                    .into(),
-            }
-            .to_string(),
-        );
-        assert_eq!(
-            parse_command(b"moveto ").unwrap_err().to_string(),
-            WrongNumberOfArguments {
-                too_many: false,
-                takes: (1, Some(1)),
-                given: 0,
-                __func__: "moveto",
-                inner: "".into(),
-            }
-            .to_string(),
-        );
-        assert_eq!(
-            parse_command(b"reindex 1 2 3").unwrap_err().to_string(),
-            WrongNumberOfArguments {
-                too_many: true,
-                takes: (1, Some(1)),
-                given: 2,
-                __func__: "reindex",
-                inner: "".into(),
-            }
-            .to_string(),
-        );
-    }
-}

meli/src/command/actions.rs

@@ -1,192 +0,0 @@
-/*
- * meli
- *
- * Copyright 2017-2018 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! User actions that need to be handled by the UI
-
-use std::path::PathBuf;
-
-use melib::{email::mailto::Mailto, Flag, SortField, SortOrder};
-
-use crate::components::{Component, ComponentId};
-
-#[derive(Debug)]
-pub enum FlagAction {
-    Set(Flag),
-    Unset(Flag),
-}
-
-#[derive(Debug)]
-pub enum TagAction {
-    Add(String),
-    Remove(String),
-}
-
-#[derive(Debug)]
-pub enum ListingAction {
-    SetPlain,
-    SetThreaded,
-    SetCompact,
-    SetConversations,
-    Search(String),
-    Select(String),
-    SetSeen,
-    SetUnseen,
-    CopyTo(MailboxPath),
-    CopyToOtherAccount(AccountName, MailboxPath),
-    MoveTo(MailboxPath),
-    MoveToOtherAccount(AccountName, MailboxPath),
-    Import(PathBuf, MailboxPath),
-    ExportMbox(Option<melib::mbox::MboxFormat>, PathBuf),
-    Delete,
-    OpenInNewTab,
-    Tag(TagAction),
-    Flag(FlagAction),
-    ClearSelection,
-    ToggleThreadSnooze,
-}
-
-#[derive(Debug)]
-pub enum TabAction {
-    Close,
-    Kill(ComponentId),
-    New(Option<Box<dyn Component>>),
-    ManageMailboxes,
-    ManageJobs,
-}
-
-#[derive(Debug)]
-pub enum MailingListAction {
-    ListPost,
-    ListArchive,
-    ListUnsubscribe,
-}
-
-#[derive(Debug)]
-pub enum ViewAction {
-    Pipe(String, Vec<String>),
-    Filter(String),
-    SaveAttachment(usize, String),
-    ExportMail(String),
-    AddAddressesToContacts,
-}
-
-#[derive(Debug)]
-pub enum ComposeAction {
-    AddAttachment(String),
-    AddAttachmentFilePicker(Option<String>),
-    AddAttachmentPipe(String),
-    RemoveAttachment(usize),
-    SaveDraft,
-    ToggleSign,
-    ToggleEncrypt,
-    Mailto(Mailto),
-}
-
-#[derive(Debug)]
-pub enum AccountAction {
-    ReIndex,
-    PrintAccountSetting(String),
-}
-
-#[derive(Debug)]
-pub enum MailboxOperation {
-    Create(NewMailboxPath),
-    Delete(MailboxPath),
-    Subscribe(MailboxPath),
-    Unsubscribe(MailboxPath),
-    Rename(MailboxPath, NewMailboxPath),
-    // Placeholder
-    SetPermissions(MailboxPath),
-}
-
-#[derive(Debug)]
-pub enum Action {
-    Listing(ListingAction),
-    ViewMailbox(usize),
-    Sort(SortField, SortOrder),
-    SortColumn(usize, SortOrder),
-    SubSort(SortField, SortOrder),
-    Tab(TabAction),
-    MailingListAction(MailingListAction),
-    View(ViewAction),
-    SetEnv(String, String),
-    PrintEnv(String),
-    CurrentDirectory,
-    ChangeCurrentDirectory(PathBuf),
-    Compose(ComposeAction),
-    Mailbox(AccountName, MailboxOperation),
-    AccountAction(AccountName, AccountAction),
-    PrintSetting(String),
-    ReloadConfiguration,
-    ToggleMouse,
-    Quit,
-}
-
-impl Action {
-    pub fn needs_confirmation(&self) -> bool {
-        matches!(
-            self,
-            Self::Listing(ListingAction::Delete)
-                | Self::MailingListAction(_)
-                | Self::Mailbox(_, _)
-                | Self::Quit
-        )
-    }
-}
-
-type AccountName = String;
-type MailboxPath = String;
-type NewMailboxPath = String;
-
-macro_rules! impl_into_action {
-    ($({$t:ty => $var:tt}),*) => {
-        $(
-            impl From<$t> for Action {
-                fn from(v: $t) -> Self {
-                    Self::$var(v)
-                }
-            }
-        )*
-    };
-}
-macro_rules! impl_tuple_into_action {
-    ($({$a:ty,$b:ty => $var:tt}),*) => {
-        $(
-            impl From<($a,$b)> for Action {
-                fn from((a, b): ($a,$b)) -> Self {
-                    Self::$var(a, b)
-                }
-            }
-        )*
-    };
-}
-
-impl_into_action!(
-    { ListingAction => Listing },
-    { TabAction => Tab },
-    { MailingListAction => MailingListAction },
-    { ViewAction => View },
-    { ComposeAction => Compose }
-);
-impl_tuple_into_action!(
-    { AccountName, MailboxOperation => Mailbox },
-    { AccountName, AccountAction => AccountAction }
-);

meli/src/command/argcheck.rs

@@ -1,180 +0,0 @@
-/*
- * meli
- *
- * Copyright 2017 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Helper type for showing the exact reason why a command was invalid.
-
-use super::*;
-
-pub enum ArgCheck<const MIN: u8, const MAX: u8> {
-    Start { __func__: &'static str },
-    BeforeArgument { so_far: u8, __func__: &'static str },
-    Eof { so_far: u8, __func__: &'static str },
-}
-
-impl<const MIN: u8, const MAX: u8> ArgCheck<MIN, MAX> {
-    #[inline]
-    pub fn new(__func__: &'static str) -> Self {
-        Self::Start { __func__ }
-    }
-
-    #[inline]
-    pub fn start(&mut self, input: &[u8]) -> Result<(), CommandError> {
-        let Self::Start { __func__ } = *self else {
-            unreachable!(
-                "ArgCheck::start called with invalid variant: {}",
-                if matches!(self, Self::BeforeArgument { .. }) {
-                    "BeforeArgument"
-                } else {
-                    "Eof"
-                }
-            );
-        };
-        let is_empty = input.trim().is_empty();
-        if is_empty && MIN > 0 {
-            return Err(CommandError::WrongNumberOfArguments {
-                too_many: false,
-                takes: (MIN, MAX.into()),
-                given: 0,
-                __func__,
-                inner: format!(
-                    "needs {}{} arguments.",
-                    if MIN == MAX { "at least " } else { "" },
-                    MIN
-                )
-                .into(),
-            });
-        }
-        *self = Self::BeforeArgument {
-            so_far: 0,
-            __func__,
-        };
-
-        Ok(())
-    }
-
-    #[inline]
-    pub fn inc(&mut self, input: &[u8]) -> Result<(), CommandError> {
-        let Self::BeforeArgument { __func__, so_far } = *self else {
-            unreachable!(
-                "ArgCheck::inc called with invalid variant: {}",
-                if matches!(self, Self::Start { .. }) {
-                    "Start"
-                } else {
-                    "Eof"
-                }
-            );
-        };
-        let is_empty = input.trim().is_empty();
-        let new_value = so_far + 1;
-        if is_empty && new_value > MAX {
-            return Err(CommandError::WrongNumberOfArguments {
-                too_many: true,
-                takes: (MIN, MAX.into()),
-                given: new_value,
-                __func__,
-                inner: format!(
-                    "needs {}{} arguments.",
-                    if MIN == MAX { "at least " } else { "" },
-                    MIN
-                )
-                .into(),
-            });
-        }
-        *self = Self::BeforeArgument {
-            so_far: new_value,
-            __func__,
-        };
-
-        Ok(())
-    }
-
-    #[inline]
-    pub fn finish(&mut self, input: &[u8]) -> Result<(), CommandError> {
-        let Self::BeforeArgument { __func__, so_far } = *self else {
-            unreachable!(
-                "ArgCheck::finish called with invalid variant: {}",
-                if matches!(self, Self::Start { .. }) {
-                    "Start"
-                } else {
-                    "Eof"
-                }
-            );
-        };
-        let is_empty = input.trim().is_empty();
-        if !is_empty {
-            assert!(so_far <= MAX);
-            assert!(so_far >= MIN);
-            return Err(CommandError::WrongNumberOfArguments {
-                too_many: true,
-                takes: (MIN, MAX.into()),
-                given: so_far + 1,
-                __func__,
-                inner: format!(
-                    "needs {}{} arguments.",
-                    if MIN == MAX { "at least " } else { "" },
-                    MIN
-                )
-                .into(),
-            });
-        }
-        *self = Self::Eof { so_far, __func__ };
-
-        Ok(())
-    }
-}
-
-macro_rules! arg_init {
-    (min_arg: $n:expr, max_arg: $x:expr, $func:tt) => {{
-        ArgCheck::<$n, $x>::new(stringify!($func))
-    }};
-}
-
-//macro_rules! arg_value_check {
-//    ($tag:literal, $input:expr) => {{
-//        if tag::<&'_ str, &'_ [u8],
-// melib::nom::error::Error<&[u8]>>($tag)($input).is_err() {            return
-// Ok((                $input,
-//                Err(CommandError::BadValue {
-//                    inner: $tag.to_string().into(),
-//                }),
-//            ));
-//        }
-//        tag($tag)($input)
-//    }};
-//}
-
-macro_rules! arg_chk {
-    (start $check:ident, $input:expr) => {{
-        if let Err(err) = $check.start($input) {
-            return Ok(($input, Err(err)));
-        };
-    }};
-    (inc $check:ident, $input:expr) => {{
-        if let Err(err) = $check.inc($input) {
-            return Ok(($input, Err(err)));
-        };
-    }};
-    (finish $check:ident, $input:expr) => {{
-        if let Err(err) = $check.finish($input) {
-            return Ok(($input, Err(err)));
-        };
-    }};
-}

meli/src/command/error.rs

@@ -1,123 +0,0 @@
-/*
- * meli
- *
- * Copyright 2017 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use super::*;
-
-#[derive(Clone, Debug)]
-pub enum CommandError {
-    Parsing {
-        inner: Cow<'static, str>,
-        kind: Cow<'static, str>,
-    },
-    BadValue {
-        inner: Cow<'static, str>,
-    },
-    WrongNumberOfArguments {
-        too_many: bool,
-        takes: (u8, Option<u8>),
-        given: u8,
-        __func__: &'static str,
-        inner: Cow<'static, str>,
-    },
-    Other {
-        inner: Cow<'static, str>,
-    },
-}
-
-impl<'a> From<nom::Err<melib::nom::error::Error<&'a [u8]>>> for CommandError {
-    fn from(res: nom::Err<melib::nom::error::Error<&'a [u8]>>) -> Self {
-        match res {
-            nom::Err::Incomplete(_) => Self::Parsing {
-                inner: res.to_string().into(),
-                kind: "".into(),
-            },
-            nom::Err::Error(e) | nom::Err::Failure(e) => Self::Parsing {
-                inner: String::from_utf8_lossy(e.input).to_string().into(),
-                kind: format!("{:?}", e.code).into(),
-            },
-        }
-    }
-}
-
-impl std::fmt::Display for CommandError {
-    fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
-        match self {
-            Self::Parsing { inner, kind: _ } => {
-                write!(fmt, "Could not parse command: {}", inner)
-            }
-            Self::BadValue { inner } => {
-                write!(fmt, "Bad value/argument: {}", inner)
-            }
-            Self::WrongNumberOfArguments {
-                too_many,
-                takes,
-                given,
-                __func__,
-                inner: _,
-            } => {
-                if *too_many {
-                    match takes {
-                        (min, None) => {
-                            write!(
-                                fmt,
-                                "{}: Too many arguments. Command takes {} arguments, but {} were \
-                                 given.",
-                                __func__, min, given
-                            )
-                        }
-                        (min, Some(max)) => {
-                            write!(
-                                fmt,
-                                "{}: Too many arguments. Command takes from {} to {} arguments, \
-                                 but {} were given.",
-                                __func__, min, max, given
-                            )
-                        }
-                    }
-                } else {
-                    match takes {
-                        (min, None) => {
-                            write!(
-                                fmt,
-                                "{}: Not enough arguments. Command takes {} arguments, but {} \
-                                 were given.",
-                                __func__, min, given
-                            )
-                        }
-                        (min, Some(max)) => {
-                            write!(
-                                fmt,
-                                "{}: Not enough arguments. Command takes from {} to {} arguments, \
-                                 but {} were given.",
-                                __func__, min, max, given
-                            )
-                        }
-                    }
-                }
-            }
-            Self::Other { inner } => {
-                write!(fmt, "Error: {}", inner)
-            }
-        }
-    }
-}
-
-impl std::error::Error for CommandError {}

meli/src/components.rs

@@ -1,314 +0,0 @@
-/*
- * meli
- *
- * Copyright 2017-2018 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Components visual and logical separations of application interfaces.
-use indexmap::IndexMap;
-///
-/// They can draw on the terminal and receive events, but also do other stuff
-/// as well.
-/// For an example, see the [`notifications`] module.
-/// See also the [`Component`] trait for more details.
-use smallvec::SmallVec;
-use uuid::Uuid;
-
-use super::*;
-
-#[derive(Clone, Copy, Deserialize, Eq, Hash, Ord, PartialEq, PartialOrd, Serialize)]
-#[repr(transparent)]
-pub struct ComponentId(Uuid);
-
-impl AsRef<Uuid> for ComponentId {
-    fn as_ref(&self) -> &Uuid {
-        &self.0
-    }
-}
-
-impl std::fmt::Display for ComponentId {
-    fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
-        std::fmt::Display::fmt(&self.0.as_simple(), fmt)
-    }
-}
-
-impl std::fmt::Debug for ComponentId {
-    fn fmt(&self, fmt: &mut std::fmt::Formatter) -> std::fmt::Result {
-        std::fmt::Display::fmt(&self.0.as_simple(), fmt)
-    }
-}
-
-impl Default for ComponentId {
-    fn default() -> Self {
-        Self(Uuid::new_v4())
-    }
-}
-
-impl std::fmt::LowerHex for ComponentId {
-    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
-        std::fmt::LowerHex::fmt(self.0.as_hyphenated(), f)
-    }
-}
-
-impl std::fmt::UpperHex for ComponentId {
-    #[inline]
-    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
-        std::fmt::UpperHex::fmt(self.0.as_hyphenated(), f)
-    }
-}
-
-pub type ShortcutMap = IndexMap<&'static str, Key>;
-pub type ShortcutMaps = IndexMap<&'static str, ShortcutMap>;
-
-mod private {
-    pub trait Sealed {}
-}
-impl private::Sealed for ShortcutMaps {}
-
-pub trait ExtendShortcutsMaps: private::Sealed {
-    fn extend_shortcuts(&mut self, other: Self);
-}
-
-impl ExtendShortcutsMaps for ShortcutMaps {
-    fn extend_shortcuts(&mut self, mut other: Self) {
-        other.retain(|k, v| {
-            if let Some(m) = self.get_mut(k) {
-                m.extend(v.iter().map(|(k, v)| (*k, v.clone())));
-                false
-            } else {
-                true
-            }
-        });
-        self.extend(other);
-    }
-}
-
-#[derive(Clone, Copy, Debug)]
-pub enum PageMovement {
-    Up(usize),
-    Right(usize),
-    Left(usize),
-    Down(usize),
-    PageUp(usize),
-    PageDown(usize),
-    Home,
-    End,
-}
-
-#[derive(Clone, Copy, Debug, Eq, PartialEq)]
-pub struct ScrollContext {
-    pub shown_lines: usize,
-    pub total_lines: usize,
-    pub has_more_lines: bool,
-}
-
-#[derive(Clone, Copy, Debug)]
-pub enum ScrollUpdate {
-    End(ComponentId),
-    Update {
-        id: ComponentId,
-        context: ScrollContext,
-    },
-}
-
-/// Types implementing this Trait can draw on the terminal and receive events.
-/// If a type wants to skip drawing if it has not changed anything, it can hold
-/// some flag in its fields (eg `self.dirty = false`) and act upon that in their
-/// [`draw`](Component::draw) implementation.
-pub trait Component: std::fmt::Display + std::fmt::Debug + Send + Sync {
-    fn draw(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context);
-    fn process_event(&mut self, event: &mut UIEvent, context: &mut Context) -> bool;
-    fn is_dirty(&self) -> bool;
-    /// If the component is meant to be currently visible to the user.
-    fn is_visible(&self) -> bool {
-        true
-    }
-
-    /// If the component can quit right away without any unsaved or ongoing
-    /// operations.
-    fn can_quit_cleanly(&mut self, _context: &Context) -> bool {
-        true
-    }
-
-    fn set_dirty(&mut self, value: bool);
-
-    fn kill(&mut self, _id: ComponentId, _context: &mut Context) {}
-
-    fn id(&self) -> ComponentId;
-
-    fn shortcuts(&self, _context: &Context) -> ShortcutMaps {
-        Default::default()
-    }
-
-    /// Get status message for the status line.
-    fn status(&self, _context: &Context) -> String {
-        String::new()
-    }
-
-    fn attributes(&self) -> &'static ComponentAttr {
-        &ComponentAttr::DEFAULT
-    }
-
-    fn children(&self) -> IndexMap<ComponentId, &dyn Component> {
-        IndexMap::default()
-    }
-
-    fn children_mut(&mut self) -> IndexMap<ComponentId, &mut dyn Component> {
-        IndexMap::default()
-    }
-
-    fn realize(&self, parent: Option<ComponentId>, context: &mut Context) {
-        // log::trace!("Realizing id {} w/ parent {:?}", self.id(), &parent);
-        context.realized.insert(self.id(), parent);
-    }
-
-    fn unrealize(&self, context: &mut Context) {
-        // log::trace!("Unrealizing id {}", self.id());
-        context.unrealized.insert(self.id());
-        context
-            .replies
-            .push_back(UIEvent::ComponentUnrealize(self.id()));
-    }
-}
-
-impl Component for Box<dyn Component> {
-    fn draw(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context) {
-        (**self).draw(grid, area, context)
-    }
-
-    fn process_event(&mut self, event: &mut UIEvent, context: &mut Context) -> bool {
-        (**self).process_event(event, context)
-    }
-
-    fn is_dirty(&self) -> bool {
-        (**self).is_dirty()
-    }
-
-    fn is_visible(&self) -> bool {
-        (**self).is_visible()
-    }
-
-    fn can_quit_cleanly(&mut self, context: &Context) -> bool {
-        (**self).can_quit_cleanly(context)
-    }
-
-    fn set_dirty(&mut self, value: bool) {
-        (**self).set_dirty(value)
-    }
-
-    fn kill(&mut self, id: ComponentId, context: &mut Context) {
-        (**self).kill(id, context)
-    }
-
-    fn id(&self) -> ComponentId {
-        (**self).id()
-    }
-
-    fn shortcuts(&self, context: &Context) -> ShortcutMaps {
-        (**self).shortcuts(context)
-    }
-
-    fn status(&self, context: &Context) -> String {
-        (**self).status(context)
-    }
-
-    fn attributes(&self) -> &'static ComponentAttr {
-        (**self).attributes()
-    }
-
-    fn children(&self) -> IndexMap<ComponentId, &dyn Component> {
-        (**self).children()
-    }
-
-    fn children_mut(&mut self) -> IndexMap<ComponentId, &mut dyn Component> {
-        (**self).children_mut()
-    }
-
-    fn realize(&self, parent: Option<ComponentId>, context: &mut Context) {
-        (**self).realize(parent, context)
-    }
-
-    fn unrealize(&self, context: &mut Context) {
-        (**self).unrealize(context)
-    }
-}
-
-bitflags::bitflags! {
-    /// Attributes of a [`Component`] widget.
-    ///
-    /// `ComponentAttr::DEFAULT` represents no attribute.
-    pub struct ComponentAttr: u8 {
-        /// Nothing special going on.
-        const DEFAULT        = 0;
-        const HAS_ANIMATIONS = 1;
-        const CONTAINER      = 1 << 1;
-    }
-}
-
-impl Default for ComponentAttr {
-    fn default() -> Self {
-        Self::DEFAULT
-    }
-}
-
-#[derive(Clone, Debug, Eq, PartialEq)]
-pub struct ComponentPath {
-    pub id: ComponentId,
-    pub tail: SmallVec<[ComponentId; 8]>,
-}
-
-impl ComponentPath {
-    pub fn new(id: ComponentId) -> Self {
-        Self {
-            id,
-            tail: SmallVec::default(),
-        }
-    }
-
-    pub fn push_front(&mut self, id: ComponentId) {
-        self.tail.insert(0, self.id);
-        self.id = id;
-    }
-
-    pub fn push_back(&mut self, id: ComponentId) {
-        self.tail.push(id);
-    }
-
-    pub fn resolve<'c>(&self, root: &'c dyn Component) -> Option<&'c dyn Component> {
-        let mut cursor = root;
-        for id in self.tail.iter().rev().chain(std::iter::once(&self.id)) {
-            // log::trace!("resolve cursor = {} next id is {}", cursor.id(), &id);
-            if *id == cursor.id() {
-                // log::trace!("continue;");
-                continue;
-            }
-            cursor = cursor.children().remove(id)?;
-        }
-        Some(cursor)
-    }
-
-    #[inline]
-    pub fn parent(&self) -> Option<&ComponentId> {
-        self.tail.first()
-    }
-
-    #[inline]
-    pub fn root(&self) -> Option<&ComponentId> {
-        self.tail.last()
-    }
-}

meli/src/conf/composing.rs

@@ -1,305 +0,0 @@
-/*
- * meli - conf module
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Configuration for composing email.
-use std::collections::HashMap;
-
-use melib::{conf::ActionFlag, email::HeaderName};
-use serde::{de, Deserialize, Deserializer};
-
-use super::{
-    default_vals::{ask, false_val, none, true_val},
-    deserializers::non_empty_string,
-};
-
-/// Settings for writing and sending new e-mail
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct ComposingSettings {
-    /// A command to pipe new emails to
-    /// Required
-    pub send_mail: SendMail,
-    /// Command to launch editor. Can have arguments. Draft filename is given as
-    /// the last argument. If it's missing, the environment variable $EDITOR is
-    /// looked up.
-    #[serde(
-        default = "none",
-        alias = "editor-command",
-        alias = "editor-cmd",
-        alias = "editor_cmd"
-    )]
-    pub editor_command: Option<String>,
-    /// Embedded editor (for terminal interfaces) instead of forking and
-    /// waiting.
-    #[serde(default = "false_val", alias = "embed")]
-    pub embedded_pty: bool,
-    /// Set "format=flowed" in plain text attachments.
-    /// Default: true
-    #[serde(default = "true_val", alias = "format-flowed")]
-    pub format_flowed: bool,
-    /// Set User-Agent
-    /// Default: empty
-    #[serde(default = "true_val", alias = "insert_user_agent")]
-    pub insert_user_agent: bool,
-    /// Set default header values for new drafts
-    /// Default: empty
-    #[serde(default, alias = "default-header-values")]
-    pub default_header_values: HashMap<HeaderName, String>,
-    /// Wrap header preamble when editing a draft in an editor. This allows you
-    /// to write non-plain text email without the preamble creating syntax
-    /// errors. They are stripped when you return from the editor. The
-    /// values should be a two element array of strings, a prefix and suffix.
-    /// Default: None
-    #[serde(default, alias = "wrap-header-preamble")]
-    pub wrap_header_preamble: Option<(String, String)>,
-    /// Store sent mail after successful submission. This setting is meant to be
-    /// disabled for non-standard behaviour in gmail, which auto-saves sent
-    /// mail on its own. Default: true
-    #[serde(default = "true_val")]
-    pub store_sent_mail: bool,
-    /// The attribution line appears above the quoted reply text.
-    /// The format specifiers for the replied address are:
-    /// - `%+f` — the sender's name and email address.
-    /// - `%+n` — the sender's name (or email address, if no name is included).
-    /// - `%+a` — the sender's email address.
-    /// The format string is passed to strftime(3) with the replied envelope's
-    /// date. Default: "On %a, %0e %b %Y %H:%M, %+f wrote:%n"
-    #[serde(default = "none")]
-    pub attribution_format_string: Option<String>,
-    /// Whether the strftime call for the attribution string uses the POSIX
-    /// locale instead of the user's active locale
-    /// Default: true
-    #[serde(default = "true_val")]
-    pub attribution_use_posix_locale: bool,
-    /// Forward emails as attachment? (Alternative is inline)
-    /// Default: ask
-    #[serde(default = "ask", alias = "forward-as-attachment")]
-    pub forward_as_attachment: ActionFlag,
-    /// Alternative lists of reply prefixes (etc. ["Re:", "RE:", ...]) to strip
-    /// Default: `["Re:", "RE:", "Fwd:", "Fw:", "回复:", "回覆:", "SV:", "Sv:",
-    /// "VS:", "Antw:", "Doorst:", "VS:", "VL:", "REF:", "TR:", "TR:", "AW:",
-    /// "WG:", "ΑΠ:", "Απ:", "απ:", "ΠΡΘ:", "Πρθ:", "πρθ:", "ΣΧΕΤ:", "Σχετ:",
-    /// "σχετ:", "ΠΡΘ:", "Πρθ:", "πρθ:", "Vá:", "Továbbítás:", "R:", "I:",
-    /// "RIF:", "FS:", "BLS:", "TRS:", "VS:", "VB:", "RV:", "RES:", "Res",
-    /// "ENC:", "Odp:", "PD:", "YNT:", "İLT:", "ATB:", "YML:"]`
-    #[serde(default, alias = "reply-prefix-list-to-strip")]
-    pub reply_prefix_list_to_strip: Option<Vec<String>>,
-    /// The prefix to use in reply subjects. The de facto prefix is "Re:".
-    #[serde(default = "res", alias = "reply-prefix")]
-    pub reply_prefix: String,
-    /// Custom `compose-hooks`.
-    #[serde(default, alias = "custom-compose-hooks")]
-    pub custom_compose_hooks: Vec<ComposeHook>,
-    /// Disabled `compose-hooks`.
-    #[serde(default, alias = "disabled-compose-hooks")]
-    pub disabled_compose_hooks: Vec<String>,
-}
-
-impl Default for ComposingSettings {
-    fn default() -> Self {
-        Self {
-            send_mail: SendMail::ShellCommand("false".into()),
-            editor_command: None,
-            embedded_pty: false,
-            format_flowed: true,
-            insert_user_agent: true,
-            default_header_values: HashMap::default(),
-            store_sent_mail: true,
-            wrap_header_preamble: None,
-            attribution_format_string: None,
-            attribution_use_posix_locale: true,
-            forward_as_attachment: ActionFlag::Ask,
-            reply_prefix_list_to_strip: None,
-            reply_prefix: res(),
-            custom_compose_hooks: vec![],
-            disabled_compose_hooks: vec![],
-        }
-    }
-}
-
-fn res() -> String {
-    "Re:".to_string()
-}
-
-macro_rules! named_unit_variant {
-    ($variant:ident) => {
-        pub mod $variant {
-            pub fn serialize<S>(serializer: S) -> Result<S::Ok, S::Error>
-            where
-                S: serde::Serializer,
-            {
-                serializer.serialize_str(stringify!($variant))
-            }
-
-            pub fn deserialize<'de, D>(deserializer: D) -> Result<(), D::Error>
-            where
-                D: serde::Deserializer<'de>,
-            {
-                struct V;
-                impl<'de> serde::de::Visitor<'de> for V {
-                    type Value = ();
-                    fn expecting(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-                        f.write_str(concat!("\"", stringify!($variant), "\""))
-                    }
-                    fn visit_str<E: serde::de::Error>(self, value: &str) -> Result<Self::Value, E> {
-                        if value == stringify!($variant) {
-                            Ok(())
-                        } else {
-                            Err(E::invalid_value(serde::de::Unexpected::Str(value), &self))
-                        }
-                    }
-                }
-                deserializer.deserialize_str(V)
-            }
-        }
-    };
-}
-
-pub mod strings {
-    named_unit_variant!(server_submission);
-}
-
-#[derive(Clone, Debug, Serialize)]
-#[serde(untagged)]
-pub enum SendMail {
-    #[cfg(feature = "smtp")]
-    Smtp(melib::smtp::SmtpServerConf),
-    #[serde(with = "strings::server_submission")]
-    ServerSubmission,
-    ShellCommand(String),
-}
-
-/// Shell command compose hooks (See
-/// [`crate::mail::compose::hooks::Hook`])
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct ComposeHook {
-    #[serde(deserialize_with = "non_empty_string")]
-    name: String,
-    #[serde(deserialize_with = "non_empty_string")]
-    command: String,
-}
-
-impl From<ComposeHook> for crate::mail::hooks::Hook {
-    fn from(c: ComposeHook) -> Self {
-        Self::new_shell_command(c.name.into(), c.command)
-    }
-}
-const SENDMAIL_ERR_HELP: &str = r#"Invalid `send_mail` value.
-
-Here are some valid examples:
-
-Use server submission in protocols that support it (JMAP, NNTP)
-===============================================================
-
-    send_mail = "server_submission"
-
-Using a shell script
-====================
-
-    send_mail = "msmtp --read-recipients --read-envelope-from"
-
-Direct SMTP connection
-======================
-
-    send_mail = { hostname = "mail.example.com", port = 587, auth = { type = "auto", password = { type = "raw", value = "hunter2" } }, security = { type = "STARTTLS" } }
-
-    [composing.send_mail]
-    hostname = "mail.example.com"
-    port = 587
-    auth = { type = "auto", password = { type = "command_eval", value = "/path/to/password_script.sh" } }
-    security = { type = "TLS", danger_accept_invalid_certs = true } }
-
-
-`send_mail` direct SMTP connection fields:
-    - hostname: text
-    - port: valid port number
-    - envelope_from: text (optional, default is empty),
-    - auth: ...
-    - security: ... (optional, default is "auto")
-    - extensions: ... (optional, default is PIPELINING, CHUNKING, PRDR, 8BITMIME, BINARYMIME, SMTPUTF8, AUTH and DSN_NOTIFY)
-
-Possible values for `send_mail.auth`:
-
-    No authentication:
-
-        auth = { type = "none" }
-
-    Regular authentication:
-    Note: `require_auth` and `auth_type` are optional and can be skipped.
-
-        auth = { type = "auto", username = "...", password = "...", require_auth = true, auth_type = ... }
-
-        password can be:
-            password = { type = "raw", value = "..." }
-            password = { type = "command_eval", value = "/path/to/password_script.sh" }
-
-    XOAuth2 authentication:
-    Note: `require_auth` is optional and can be skipped.
-        auth = { type = "xoauth2", token_command = "...", require_auth = true }
-
-Possible values for `send_mail.auth.auth_type` when `auth.type` is "auto":
-
-    auth_type = { plain = false, login = true }
-
-Possible values for `send_mail.security`:
-Note that in all cases field `danger_accept_invalid_certs` is optional and its default value is false.
-
-    security = "none"
-    security = { type = "auto", danger_accept_invalid_certs = false }
-    security = { type = "STARTTLS", danger_accept_invalid_certs = false }
-    security = { type = "TLS", danger_accept_invalid_certs = false }
-
-Possible values for `send_mail.extensions` (All optional and have default values `true`:
-    pipelining
-    chunking
-    8bitmime
-    prdr
-    binarymime
-    smtputf8
-    auth
-    dsn_notify: Array of options e.g. ["FAILURE"]
-"#;
-
-impl<'de> Deserialize<'de> for SendMail {
-    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
-    where
-        D: Deserializer<'de>,
-    {
-        #[derive(Deserialize)]
-        #[serde(untagged)]
-        enum SendMailInner {
-            #[cfg(feature = "smtp")]
-            Smtp(melib::smtp::SmtpServerConf),
-            #[serde(with = "strings::server_submission")]
-            ServerSubmission,
-            ShellCommand(String),
-        }
-
-        match <SendMailInner>::deserialize(deserializer) {
-            #[cfg(feature = "smtp")]
-            Ok(SendMailInner::Smtp(v)) => Ok(Self::Smtp(v)),
-            Ok(SendMailInner::ServerSubmission) => Ok(Self::ServerSubmission),
-            Ok(SendMailInner::ShellCommand(v)) => Ok(Self::ShellCommand(v)),
-            Err(_err) => Err(de::Error::custom(SENDMAIL_ERR_HELP)),
-        }
-    }
-}

meli/src/conf/listing.rs

@@ -1,258 +0,0 @@
-/*
- * meli - listing conf module
- *
- * Copyright 2020 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use melib::{search::Query, Error, Result, ToggleFlag};
-
-use super::{default_vals::*, DotAddressable, IndexStyle};
-
-/// Settings for mail listings
-///
-///
-/// Tree decoration examples:
-///
-///```no_run
-/// const HAS_SIBLING: &str = " ┃";
-/// const NO_SIBLING: &str = "  ";
-/// const HAS_SIBLING_LEAF: &str = " ┣━";
-/// const NO_SIBLING_LEAF: &str = " ┗━";
-/// ```
-///
-///```no_run
-/// const HAS_SIBLING: &str = " |";
-/// const NO_SIBLING: &str = "  ";
-/// const HAS_SIBLING_LEAF: &str = " |\\_";
-/// const NO_SIBLING_LEAF: &str = " \\_";
-/// ```
-///
-///```no_run
-/// const HAS_SIBLING: &str = " ";
-/// const NO_SIBLING: &str = " ";
-/// const HAS_SIBLING_LEAF: &str = " ";
-/// const NO_SIBLING_LEAF: &str = " ";
-/// ```
-///
-///```no_run
-/// const HAS_SIBLING: &str = " │";
-/// const NO_SIBLING: &str = "  ";
-/// const HAS_SIBLING_LEAF: &str = " ├─";
-/// const NO_SIBLING_LEAF: &str = " ╰─";
-/// ```
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct ListingSettings {
-    /// Number of context lines when going to next page.
-    /// Default: 0
-    #[serde(default = "zero_val", alias = "context-lines")]
-    pub context_lines: usize,
-
-    /// Show auto-hiding scrollbar in accounts sidebar menu.
-    /// Default: True
-    #[serde(default = "true_val")]
-    pub show_menu_scrollbar: bool,
-
-    /// Datetime formatting passed verbatim to strftime(3).
-    /// Default: %Y-%m-%d %T
-    #[serde(default = "none", alias = "datetime-fmt")]
-    pub datetime_fmt: Option<String>,
-
-    /// Show recent dates as `X {minutes,hours,days} ago`, up to 7 days.
-    /// Default: true
-    #[serde(default = "true_val", alias = "recent-dates")]
-    pub recent_dates: bool,
-
-    /// Show only envelopes that match this query
-    /// Default: None
-    #[serde(default = "none")]
-    pub filter: Option<Query>,
-
-    #[serde(default, alias = "index-style")]
-    pub index_style: IndexStyle,
-
-    /// Default: " "
-    #[serde(default = "none")]
-    pub sidebar_mailbox_tree_has_sibling: Option<String>,
-
-    /// Default: " "
-    #[serde(default)]
-    pub sidebar_mailbox_tree_no_sibling: Option<String>,
-
-    /// Default: " "
-    #[serde(default)]
-    pub sidebar_mailbox_tree_has_sibling_leaf: Option<String>,
-
-    /// Default: " "
-    #[serde(default)]
-    pub sidebar_mailbox_tree_no_sibling_leaf: Option<String>,
-
-    /// Default: ' '
-    #[serde(default = "default_divider")]
-    pub sidebar_divider: char,
-
-    /// Default: 90
-    #[serde(default = "default_ratio")]
-    pub sidebar_ratio: usize,
-
-    /// Flag to show if thread entry contains unseen mail.
-    /// Default: "●"
-    #[serde(default)]
-    pub unseen_flag: Option<String>,
-
-    /// Flag to show if thread has been snoozed.
-    /// Default: "💤"
-    #[serde(default)]
-    pub thread_snoozed_flag: Option<String>,
-
-    /// Flag to show if thread entry has been selected.
-    /// Default: "☑️"
-    #[serde(default)]
-    pub selected_flag: Option<String>,
-
-    /// Flag to show if thread entry contains attachments.
-    /// Default: "📎"
-    #[serde(default)]
-    pub attachment_flag: Option<String>,
-
-    /// Flag to show if any thread entry contains your address as a receiver.
-    /// Useful to make mailing list threads that CC you stand out.
-    /// Default: "✸"
-    #[serde(default)]
-    pub highlight_self_flag: Option<String>,
-
-    /// Show `highlight_self_flag` or not.
-    /// Default: false
-    #[serde(default)]
-    pub highlight_self: ToggleFlag,
-
-    /// Should threads with different Subjects show a list of those
-    /// subjects on the entry title?
-    /// Default: "true"
-    #[serde(default = "true_val")]
-    pub thread_subject_pack: bool,
-
-    /// In threaded listing style, repeat identical From column values within a
-    /// thread. Not repeating adds empty space in the From column which
-    /// might result in less visual clutter.
-    /// Default: "false"
-    #[serde(default = "false_val")]
-    pub threaded_repeat_identical_from_values: bool,
-
-    /// Show relative indices in menu mailboxes to quickly help with jumping to
-    /// them. Default: "true"
-    #[serde(default = "true_val", alias = "relative-menu-indices")]
-    pub relative_menu_indices: bool,
-
-    /// Show relative indices in listings to quickly help with jumping to
-    /// them. Default: "true"
-    #[serde(default = "true_val", alias = "relative-list-indices")]
-    pub relative_list_indices: bool,
-
-    /// Hide sidebar on launch. Default: "false"
-    #[serde(default = "false_val", alias = "hide-sidebar-on-launch")]
-    pub hide_sidebar_on_launch: bool,
-}
-
-const fn default_divider() -> char {
-    ' '
-}
-
-const fn default_ratio() -> usize {
-    90
-}
-
-impl Default for ListingSettings {
-    fn default() -> Self {
-        Self {
-            context_lines: 0,
-            show_menu_scrollbar: true,
-            datetime_fmt: None,
-            recent_dates: true,
-            filter: None,
-            index_style: IndexStyle::default(),
-            sidebar_mailbox_tree_has_sibling: None,
-            sidebar_mailbox_tree_no_sibling: None,
-            sidebar_mailbox_tree_has_sibling_leaf: None,
-            sidebar_mailbox_tree_no_sibling_leaf: None,
-            sidebar_divider: default_divider(),
-            sidebar_ratio: 90,
-            unseen_flag: None,
-            thread_snoozed_flag: None,
-            selected_flag: None,
-            attachment_flag: None,
-            highlight_self_flag: None,
-            highlight_self: ToggleFlag::Unset,
-            thread_subject_pack: true,
-            threaded_repeat_identical_from_values: false,
-            relative_menu_indices: true,
-            relative_list_indices: true,
-            hide_sidebar_on_launch: false,
-        }
-    }
-}
-
-impl DotAddressable for ListingSettings {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "context_lines" => self.context_lines.lookup(field, tail),
-                    "show_menu_scrollbar" => self.show_menu_scrollbar.lookup(field, tail),
-                    "datetime_fmt" => self.datetime_fmt.lookup(field, tail),
-                    "recent_dates" => self.recent_dates.lookup(field, tail),
-                    "filter" => self.filter.lookup(field, tail),
-                    "index_style" => self.index_style.lookup(field, tail),
-                    "sidebar_mailbox_tree_has_sibling" => {
-                        self.sidebar_mailbox_tree_has_sibling.lookup(field, tail)
-                    }
-                    "sidebar_mailbox_tree_no_sibling" => {
-                        self.sidebar_mailbox_tree_no_sibling.lookup(field, tail)
-                    }
-                    "sidebar_mailbox_tree_has_sibling_leaf" => self
-                        .sidebar_mailbox_tree_has_sibling_leaf
-                        .lookup(field, tail),
-                    "sidebar_mailbox_tree_no_sibling_leaf" => self
-                        .sidebar_mailbox_tree_no_sibling_leaf
-                        .lookup(field, tail),
-                    "sidebar_divider" => self.sidebar_divider.lookup(field, tail),
-                    "sidebar_ratio" => self.sidebar_ratio.lookup(field, tail),
-                    "unseen_flag" => self.unseen_flag.lookup(field, tail),
-                    "thread_snoozed_flag" => self.thread_snoozed_flag.lookup(field, tail),
-                    "selected_flag" => self.selected_flag.lookup(field, tail),
-                    "attachment_flag" => self.attachment_flag.lookup(field, tail),
-                    "highlight_self_flag" => self.highlight_self_flag.lookup(field, tail),
-                    "highlight_self" => self.highlight_self.lookup(field, tail),
-                    "thread_subject_pack" => self.thread_subject_pack.lookup(field, tail),
-                    "threaded_repeat_identical_from_values" => self
-                        .threaded_repeat_identical_from_values
-                        .lookup(field, tail),
-                    "relative_menu_indices" => self.relative_menu_indices.lookup(field, tail),
-                    "relative_list_indices" => self.relative_list_indices.lookup(field, tail),
-                    "hide_sidebar_on_launch" => self.hide_sidebar_on_launch.lookup(field, tail),
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}

meli/src/conf/notifications.rs

@@ -1,94 +0,0 @@
-/*
- * meli - notifications conf module
- *
- * Copyright 2018 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use melib::{Error, Result, ToggleFlag};
-
-use super::{
-    default_vals::{internal_value_false, none, true_val},
-    DotAddressable,
-};
-
-/// Settings for the notifications function.
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct NotificationsSettings {
-    /// Enable notifications.
-    /// Default: True
-    #[serde(default = "true_val")]
-    pub enable: bool,
-
-    /// A command to pipe notifications through.
-    /// Default: None
-    #[serde(default = "none")]
-    pub script: Option<String>,
-
-    /// A command to pipe new mail notifications through (preferred over
-    /// `script`). Default: None
-    #[serde(default = "none")]
-    pub new_mail_script: Option<String>,
-
-    /// A file location which has its size changed when new mail arrives (max
-    /// 128 bytes). Can be used to trigger new mail notifications eg with
-    /// `xbiff(1)`. Default: None
-    #[serde(default = "none", alias = "xbiff-file-path")]
-    pub xbiff_file_path: Option<String>,
-
-    #[serde(default = "internal_value_false", alias = "play-sound")]
-    pub play_sound: ToggleFlag,
-
-    #[serde(default = "none", alias = "sound-file")]
-    pub sound_file: Option<String>,
-}
-
-impl Default for NotificationsSettings {
-    fn default() -> Self {
-        Self {
-            enable: true,
-            script: None,
-            new_mail_script: None,
-            xbiff_file_path: None,
-            play_sound: ToggleFlag::InternalVal(false),
-            sound_file: None,
-        }
-    }
-}
-impl DotAddressable for NotificationsSettings {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "enable" => self.enable.lookup(field, tail),
-                    "script" => self.script.lookup(field, tail),
-                    "new_mail_script" => self.new_mail_script.lookup(field, tail),
-                    "xbiff_file_path" => self.xbiff_file_path.lookup(field, tail),
-                    "play_sound" => self.play_sound.lookup(field, tail),
-                    "sound_file" => self.sound_file.lookup(field, tail),
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}

meli/src/conf/overrides.rs

@@ -1,43 +0,0 @@
-// @generated
-/*
- * meli - conf/overrides.rs
- *
- * Copyright 2020 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#![allow(clippy::derivable_impls)]
-
-//! This module is automatically generated by `config_macros.rs`.
-
-use super::*;
-use melib::HeaderName;
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct PagerSettingsOverride { # [doc = " Number of context lines when going to next page."] # [doc = " Default: 0"] # [serde (alias = "pager-context")] # [serde (default)] pub pager_context : Option < usize > , # [doc = " Stop at the end instead of displaying next mail."] # [doc = " Default: false"] # [serde (alias = "pager-stop")] # [serde (default)] pub pager_stop : Option < bool > , # [doc = " Always show headers when scrolling."] # [doc = " Default: true"] # [serde (alias = "sticky-headers" , alias = "headers-sticky" , alias = "headers_sticky")] # [serde (default)] pub sticky_headers : Option < bool > , # [doc = " The height of the pager in mail view, in percent."] # [doc = " Default: 80"] # [serde (alias = "pager-ratio")] # [serde (default)] pub pager_ratio : Option < usize > , # [doc = " A command to pipe mail output through for viewing in pager."] # [doc = " Default: None"] # [serde (deserialize_with = "non_empty_opt_string")] # [serde (default)] pub filter : Option < Option < String > > , # [doc = " A command to pipe html output before displaying it in a pager"] # [doc = " Default: None"] # [serde (deserialize_with = "non_empty_opt_string" , alias = "html-filter")] # [serde (default)] pub html_filter : Option < Option < String > > , # [doc = " Respect \"format=flowed\""] # [doc = " Default: true"] # [serde (alias = "format-flowed")] # [serde (default)] pub format_flowed : Option < bool > , # [doc = " Split long lines that would overflow on the x axis."] # [doc = " Default: true"] # [serde (alias = "split-long-lines")] # [serde (default)] pub split_long_lines : Option < bool > , # [doc = " Minimum text width in columns."] # [doc = " Default: 80"] # [serde (alias = "minimum-width")] # [serde (default)] pub minimum_width : Option < usize > , # [doc = " Choose `text/html` alternative if `text/plain` is empty in"] # [doc = " `multipart/alternative` attachments."] # [doc = " Default: true"] # [serde (alias = "auto-choose-multipart-alternative")] # [serde (default)] pub auto_choose_multipart_alternative : Option < ToggleFlag > , # [doc = " Show Date: in my timezone"] # [doc = " Default: true"] # [serde (alias = "show-date-in-my-timezone")] # [serde (default)] pub show_date_in_my_timezone : Option < ToggleFlag > , # [doc = " A command to launch URLs with. The URL will be given as the first"] # [doc = " argument of the command. Default: None"] # [serde (deserialize_with = "non_empty_opt_string")] # [serde (default)] pub url_launcher : Option < Option < String > > , # [doc = " A command to open html files."] # [doc = " Default: None"] # [serde (deserialize_with = "non_empty_opt_string" , alias = "html-open")] # [serde (default)] pub html_open : Option < Option < String > > , # [doc = " Extra headers to display, if present, in the default header preamble."] # [doc = " Default: []"] # [serde (alias = "show-extra-headers")] # [serde (default)] pub show_extra_headers : Option < Vec < String > > } impl Default for PagerSettingsOverride { fn default () -> Self { Self { pager_context : None , pager_stop : None , sticky_headers : None , pager_ratio : None , filter : None , html_filter : None , format_flowed : None , split_long_lines : None , minimum_width : None , auto_choose_multipart_alternative : None , show_date_in_my_timezone : None , url_launcher : None , html_open : None , show_extra_headers : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct ListingSettingsOverride { # [doc = " Number of context lines when going to next page."] # [doc = " Default: 0"] # [serde (alias = "context-lines")] # [serde (default)] pub context_lines : Option < usize > , # [doc = " Show auto-hiding scrollbar in accounts sidebar menu."] # [doc = " Default: True"] # [serde (default)] pub show_menu_scrollbar : Option < bool > , # [doc = " Datetime formatting passed verbatim to strftime(3)."] # [doc = " Default: %Y-%m-%d %T"] # [serde (alias = "datetime-fmt")] # [serde (default)] pub datetime_fmt : Option < Option < String > > , # [doc = " Show recent dates as `X {minutes,hours,days} ago`, up to 7 days."] # [doc = " Default: true"] # [serde (alias = "recent-dates")] # [serde (default)] pub recent_dates : Option < bool > , # [doc = " Show only envelopes that match this query"] # [doc = " Default: None"] # [serde (default)] pub filter : Option < Option < Query > > , # [serde (alias = "index-style")] # [serde (default)] pub index_style : Option < IndexStyle > , # [doc = " Default: \" \""] # [serde (default)] pub sidebar_mailbox_tree_has_sibling : Option < Option < String > > , # [doc = " Default: \" \""] # [serde (default)] pub sidebar_mailbox_tree_no_sibling : Option < Option < String > > , # [doc = " Default: \" \""] # [serde (default)] pub sidebar_mailbox_tree_has_sibling_leaf : Option < Option < String > > , # [doc = " Default: \" \""] # [serde (default)] pub sidebar_mailbox_tree_no_sibling_leaf : Option < Option < String > > , # [doc = " Default: ' '"] # [serde (default)] pub sidebar_divider : Option < char > , # [doc = " Default: 90"] # [serde (default)] pub sidebar_ratio : Option < usize > , # [doc = " Flag to show if thread entry contains unseen mail."] # [doc = " Default: \"●\""] # [serde (default)] pub unseen_flag : Option < Option < String > > , # [doc = " Flag to show if thread has been snoozed."] # [doc = " Default: \"💤\""] # [serde (default)] pub thread_snoozed_flag : Option < Option < String > > , # [doc = " Flag to show if thread entry has been selected."] # [doc = " Default: \"☑\u{fe0f}\""] # [serde (default)] pub selected_flag : Option < Option < String > > , # [doc = " Flag to show if thread entry contains attachments."] # [doc = " Default: \"📎\""] # [serde (default)] pub attachment_flag : Option < Option < String > > , # [doc = " Flag to show if any thread entry contains your address as a receiver."] # [doc = " Useful to make mailing list threads that CC you stand out."] # [doc = " Default: \"✸\""] # [serde (default)] pub highlight_self_flag : Option < Option < String > > , # [doc = " Show `highlight_self_flag` or not."] # [doc = " Default: false"] # [serde (default)] pub highlight_self : Option < ToggleFlag > , # [doc = " Should threads with different Subjects show a list of those"] # [doc = " subjects on the entry title?"] # [doc = " Default: \"true\""] # [serde (default)] pub thread_subject_pack : Option < bool > , # [doc = " In threaded listing style, repeat identical From column values within a"] # [doc = " thread. Not repeating adds empty space in the From column which"] # [doc = " might result in less visual clutter."] # [doc = " Default: \"false\""] # [serde (default)] pub threaded_repeat_identical_from_values : Option < bool > , # [doc = " Show relative indices in menu mailboxes to quickly help with jumping to"] # [doc = " them. Default: \"true\""] # [serde (alias = "relative-menu-indices")] # [serde (default)] pub relative_menu_indices : Option < bool > , # [doc = " Show relative indices in listings to quickly help with jumping to"] # [doc = " them. Default: \"true\""] # [serde (alias = "relative-list-indices")] # [serde (default)] pub relative_list_indices : Option < bool > , # [doc = " Hide sidebar on launch. Default: \"false\""] # [serde (alias = "hide-sidebar-on-launch")] # [serde (default)] pub hide_sidebar_on_launch : Option < bool > } impl Default for ListingSettingsOverride { fn default () -> Self { Self { context_lines : None , show_menu_scrollbar : None , datetime_fmt : None , recent_dates : None , filter : None , index_style : None , sidebar_mailbox_tree_has_sibling : None , sidebar_mailbox_tree_no_sibling : None , sidebar_mailbox_tree_has_sibling_leaf : None , sidebar_mailbox_tree_no_sibling_leaf : None , sidebar_divider : None , sidebar_ratio : None , unseen_flag : None , thread_snoozed_flag : None , selected_flag : None , attachment_flag : None , highlight_self_flag : None , highlight_self : None , thread_subject_pack : None , threaded_repeat_identical_from_values : None , relative_menu_indices : None , relative_list_indices : None , hide_sidebar_on_launch : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct NotificationsSettingsOverride { # [doc = " Enable notifications."] # [doc = " Default: True"] # [serde (default)] pub enable : Option < bool > , # [doc = " A command to pipe notifications through."] # [doc = " Default: None"] # [serde (default)] pub script : Option < Option < String > > , # [doc = " A command to pipe new mail notifications through (preferred over"] # [doc = " `script`). Default: None"] # [serde (default)] pub new_mail_script : Option < Option < String > > , # [doc = " A file location which has its size changed when new mail arrives (max"] # [doc = " 128 bytes). Can be used to trigger new mail notifications eg with"] # [doc = " `xbiff(1)`. Default: None"] # [serde (alias = "xbiff-file-path")] # [serde (default)] pub xbiff_file_path : Option < Option < String > > , # [serde (alias = "play-sound")] # [serde (default)] pub play_sound : Option < ToggleFlag > , # [serde (alias = "sound-file")] # [serde (default)] pub sound_file : Option < Option < String > > } impl Default for NotificationsSettingsOverride { fn default () -> Self { Self { enable : None , script : None , new_mail_script : None , xbiff_file_path : None , play_sound : None , sound_file : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct ShortcutsOverride { # [serde (default)] pub general : Option < GeneralShortcuts > , # [serde (default)] pub listing : Option < ListingShortcuts > , # [serde (default)] pub composing : Option < ComposingShortcuts > , # [serde (alias = "contact-list")] # [serde (default)] pub contact_list : Option < ContactListShortcuts > , # [serde (alias = "envelope-view")] # [serde (default)] pub envelope_view : Option < EnvelopeViewShortcuts > , # [serde (alias = "thread-view")] # [serde (default)] pub thread_view : Option < ThreadViewShortcuts > , # [serde (default)] pub pager : Option < PagerShortcuts > } impl Default for ShortcutsOverride { fn default () -> Self { Self { general : None , listing : None , composing : None , contact_list : None , envelope_view : None , thread_view : None , pager : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct ComposingSettingsOverride { # [doc = " A command to pipe new emails to"] # [doc = " Required"] # [serde (default)] pub send_mail : Option < SendMail > , # [doc = " Command to launch editor. Can have arguments. Draft filename is given as"] # [doc = " the last argument. If it's missing, the environment variable $EDITOR is"] # [doc = " looked up."] # [serde (alias = "editor-command" , alias = "editor-cmd" , alias = "editor_cmd")] # [serde (default)] pub editor_command : Option < Option < String > > , # [doc = " Embedded editor (for terminal interfaces) instead of forking and"] # [doc = " waiting."] # [serde (alias = "embed")] # [serde (default)] pub embedded_pty : Option < bool > , # [doc = " Set \"format=flowed\" in plain text attachments."] # [doc = " Default: true"] # [serde (alias = "format-flowed")] # [serde (default)] pub format_flowed : Option < bool > , # [doc = " Set User-Agent"] # [doc = " Default: empty"] # [serde (alias = "insert_user_agent")] # [serde (default)] pub insert_user_agent : Option < bool > , # [doc = " Set default header values for new drafts"] # [doc = " Default: empty"] # [serde (alias = "default-header-values")] # [serde (default)] pub default_header_values : Option < HashMap < HeaderName , String > > , # [doc = " Wrap header preamble when editing a draft in an editor. This allows you"] # [doc = " to write non-plain text email without the preamble creating syntax"] # [doc = " errors. They are stripped when you return from the editor. The"] # [doc = " values should be a two element array of strings, a prefix and suffix."] # [doc = " Default: None"] # [serde (alias = "wrap-header-preamble")] # [serde (default)] pub wrap_header_preamble : Option < Option < (String , String) > > , # [doc = " Store sent mail after successful submission. This setting is meant to be"] # [doc = " disabled for non-standard behaviour in gmail, which auto-saves sent"] # [doc = " mail on its own. Default: true"] # [serde (default)] pub store_sent_mail : Option < bool > , # [doc = " The attribution line appears above the quoted reply text."] # [doc = " The format specifiers for the replied address are:"] # [doc = " - `%+f` — the sender's name and email address."] # [doc = " - `%+n` — the sender's name (or email address, if no name is included)."] # [doc = " - `%+a` — the sender's email address."] # [doc = " The format string is passed to strftime(3) with the replied envelope's"] # [doc = " date. Default: \"On %a, %0e %b %Y %H:%M, %+f wrote:%n\""] # [serde (default)] pub attribution_format_string : Option < Option < String > > , # [doc = " Whether the strftime call for the attribution string uses the POSIX"] # [doc = " locale instead of the user's active locale"] # [doc = " Default: true"] # [serde (default)] pub attribution_use_posix_locale : Option < bool > , # [doc = " Forward emails as attachment? (Alternative is inline)"] # [doc = " Default: ask"] # [serde (alias = "forward-as-attachment")] # [serde (default)] pub forward_as_attachment : Option < ActionFlag > , # [doc = " Alternative lists of reply prefixes (etc. [\"Re:\", \"RE:\", ...]) to strip"] # [doc = " Default: `[\"Re:\", \"RE:\", \"Fwd:\", \"Fw:\", \"回复:\", \"回覆:\", \"SV:\", \"Sv:\","] # [doc = " \"VS:\", \"Antw:\", \"Doorst:\", \"VS:\", \"VL:\", \"REF:\", \"TR:\", \"TR:\", \"AW:\","] # [doc = " \"WG:\", \"ΑΠ:\", \"Απ:\", \"απ:\", \"ΠΡΘ:\", \"Πρθ:\", \"πρθ:\", \"ΣΧΕΤ:\", \"Σχετ:\","] # [doc = " \"σχετ:\", \"ΠΡΘ:\", \"Πρθ:\", \"πρθ:\", \"Vá:\", \"Továbbítás:\", \"R:\", \"I:\","] # [doc = " \"RIF:\", \"FS:\", \"BLS:\", \"TRS:\", \"VS:\", \"VB:\", \"RV:\", \"RES:\", \"Res\","] # [doc = " \"ENC:\", \"Odp:\", \"PD:\", \"YNT:\", \"İLT:\", \"ATB:\", \"YML:\"]`"] # [serde (alias = "reply-prefix-list-to-strip")] # [serde (default)] pub reply_prefix_list_to_strip : Option < Option < Vec < String > > > , # [doc = " The prefix to use in reply subjects. The de facto prefix is \"Re:\"."] # [serde (alias = "reply-prefix")] # [serde (default)] pub reply_prefix : Option < String > , # [doc = " Custom `compose-hooks`."] # [serde (alias = "custom-compose-hooks")] # [serde (default)] pub custom_compose_hooks : Option < Vec < ComposeHook > > , # [doc = " Disabled `compose-hooks`."] # [serde (alias = "disabled-compose-hooks")] # [serde (default)] pub disabled_compose_hooks : Option < Vec < String > > } impl Default for ComposingSettingsOverride { fn default () -> Self { Self { send_mail : None , editor_command : None , embedded_pty : None , format_flowed : None , insert_user_agent : None , default_header_values : None , wrap_header_preamble : None , store_sent_mail : None , attribution_format_string : None , attribution_use_posix_locale : None , forward_as_attachment : None , reply_prefix_list_to_strip : None , reply_prefix : None , custom_compose_hooks : None , disabled_compose_hooks : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct TagsSettingsOverride { # [serde (deserialize_with = "tag_color_de")] # [serde (default)] pub colors : Option < HashMap < TagHash , Color > > , # [serde (deserialize_with = "tag_set_de" , alias = "ignore-tags")] # [serde (default)] pub ignore_tags : Option < HashSet < TagHash > > } impl Default for TagsSettingsOverride { fn default () -> Self { Self { colors : None , ignore_tags : None } } }
-
-# [derive (Debug , Serialize , Deserialize , Clone)] # [serde (deny_unknown_fields)] pub struct PGPSettingsOverride { # [doc = " auto verify signed e-mail according to RFC3156"] # [doc = " Default: true"] # [serde (alias = "auto-verify-signatures")] # [serde (default)] pub auto_verify_signatures : Option < ActionFlag > , # [doc = " auto decrypt encrypted e-mail"] # [doc = " Default: true"] # [serde (alias = "auto-decrypt")] # [serde (default)] pub auto_decrypt : Option < ActionFlag > , # [doc = " always sign sent e-mail"] # [doc = " Default: false"] # [serde (alias = "auto-sign")] # [serde (default)] pub auto_sign : Option < ActionFlag > , # [doc = " Auto encrypt sent e-mail"] # [doc = " Default: false"] # [serde (alias = "auto-encrypt")] # [serde (default)] pub auto_encrypt : Option < ActionFlag > , # [doc = " Default: None"] # [serde (alias = "sign-key")] # [serde (default)] pub sign_key : Option < Option < String > > , # [doc = " Default: None"] # [serde (alias = "decrypt-key")] # [serde (default)] pub decrypt_key : Option < Option < String > > , # [doc = " Default: None"] # [serde (alias = "encrypt-key")] # [serde (default)] pub encrypt_key : Option < Option < String > > , # [doc = " Allow remote lookups"] # [doc = " Default: False"] # [serde (alias = "allow-remote-lookups")] # [serde (default)] pub allow_remote_lookup : Option < ActionFlag > , # [doc = " Remote lookup mechanisms."] # [doc = " Default: \"local,wkd\""] # [cfg_attr (feature = "gpgme" , serde (alias = "remote-lookup-mechanisms"))] # [cfg (feature = "gpgme")] # [serde (default)] pub remote_lookup_mechanisms : Option < melib :: gpgme :: LocateKey > , # [cfg (not (feature = "gpgme"))] # [cfg_attr (not (feature = "gpgme") , serde (alias = "remote-lookup-mechanisms"))] # [serde (default)] pub remote_lookup_mechanisms : Option < String > } impl Default for PGPSettingsOverride { fn default () -> Self { Self { auto_verify_signatures : None , auto_decrypt : None , auto_sign : None , auto_encrypt : None , sign_key : None , decrypt_key : None , encrypt_key : None , allow_remote_lookup : None , remote_lookup_mechanisms : None } } }
-

meli/src/conf/pager.rs

@@ -1,173 +0,0 @@
-/*
- * meli - pager conf module
- *
- * Copyright 2018 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Settings for the pager function.
-
-use melib::{Error, Result, ToggleFlag};
-
-use super::{default_vals::*, deserializers::*, DotAddressable};
-
-/// Settings for the pager function.
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct PagerSettings {
-    /// Number of context lines when going to next page.
-    /// Default: 0
-    #[serde(default = "zero_val", alias = "pager-context")]
-    pub pager_context: usize,
-
-    /// Stop at the end instead of displaying next mail.
-    /// Default: false
-    #[serde(default = "false_val", alias = "pager-stop")]
-    pub pager_stop: bool,
-
-    /// Always show headers when scrolling.
-    /// Default: true
-    #[serde(
-        default = "false_val",
-        alias = "sticky-headers",
-        /* deprecated names */
-        alias = "headers-sticky",
-        alias = "headers_sticky"
-    )]
-    pub sticky_headers: bool,
-
-    /// The height of the pager in mail view, in percent.
-    /// Default: 80
-    #[serde(default = "eighty_val", alias = "pager-ratio")]
-    pub pager_ratio: usize,
-
-    /// A command to pipe mail output through for viewing in pager.
-    /// Default: None
-    #[serde(default = "none", deserialize_with = "non_empty_opt_string")]
-    pub filter: Option<String>,
-
-    /// A command to pipe html output before displaying it in a pager
-    /// Default: None
-    #[serde(
-        default = "none",
-        deserialize_with = "non_empty_opt_string",
-        alias = "html-filter"
-    )]
-    pub html_filter: Option<String>,
-
-    /// Respect "format=flowed"
-    /// Default: true
-    #[serde(default = "true_val", alias = "format-flowed")]
-    pub format_flowed: bool,
-
-    /// Split long lines that would overflow on the x axis.
-    /// Default: true
-    #[serde(default = "true_val", alias = "split-long-lines")]
-    pub split_long_lines: bool,
-
-    /// Minimum text width in columns.
-    /// Default: 80
-    #[serde(default = "eighty_val", alias = "minimum-width")]
-    pub minimum_width: usize,
-
-    /// Choose `text/html` alternative if `text/plain` is empty in
-    /// `multipart/alternative` attachments.
-    /// Default: true
-    #[serde(
-        default = "internal_value_true",
-        alias = "auto-choose-multipart-alternative"
-    )]
-    pub auto_choose_multipart_alternative: ToggleFlag,
-
-    /// Show Date: in my timezone
-    /// Default: true
-    #[serde(default = "internal_value_true", alias = "show-date-in-my-timezone")]
-    pub show_date_in_my_timezone: ToggleFlag,
-
-    /// A command to launch URLs with. The URL will be given as the first
-    /// argument of the command. Default: None
-    #[serde(default = "none", deserialize_with = "non_empty_opt_string")]
-    pub url_launcher: Option<String>,
-
-    /// A command to open html files.
-    /// Default: None
-    #[serde(
-        default = "none",
-        deserialize_with = "non_empty_opt_string",
-        alias = "html-open"
-    )]
-    pub html_open: Option<String>,
-
-    /// Extra headers to display, if present, in the default header preamble.
-    /// Default: []
-    #[serde(default = "Vec::new", alias = "show-extra-headers")]
-    pub show_extra_headers: Vec<String>,
-}
-
-impl Default for PagerSettings {
-    fn default() -> Self {
-        Self {
-            pager_context: 0,
-            pager_stop: false,
-            sticky_headers: false,
-            pager_ratio: 80,
-            filter: None,
-            html_filter: None,
-            html_open: None,
-            format_flowed: true,
-            split_long_lines: true,
-            minimum_width: 80,
-            auto_choose_multipart_alternative: ToggleFlag::InternalVal(true),
-            show_date_in_my_timezone: ToggleFlag::InternalVal(true),
-            url_launcher: None,
-            show_extra_headers: vec![],
-        }
-    }
-}
-
-impl DotAddressable for PagerSettings {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "pager_context" => self.pager_context.lookup(field, tail),
-                    "pager_stop" => self.pager_stop.lookup(field, tail),
-                    "sticky_headers" => self.sticky_headers.lookup(field, tail),
-                    "pager_ratio" => self.pager_ratio.lookup(field, tail),
-                    "filter" => self.filter.lookup(field, tail),
-                    "html_filter" => self.html_filter.lookup(field, tail),
-                    "html_open" => self.html_open.lookup(field, tail),
-                    "format_flowed" => self.format_flowed.lookup(field, tail),
-                    "split_long_lines" => self.split_long_lines.lookup(field, tail),
-                    "minimum_width" => self.minimum_width.lookup(field, tail),
-                    "auto_choose_multipart_alternative" => {
-                        self.auto_choose_multipart_alternative.lookup(field, tail)
-                    }
-                    "show_date_in_my_timezone" => self.show_date_in_my_timezone.lookup(field, tail),
-                    "url_launcher" => self.html_filter.lookup(field, tail),
-                    "show_extra_headers" => self.show_extra_headers.lookup(field, tail),
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}

meli/src/conf/pgp.rs

@@ -1,112 +0,0 @@
-/*
- * meli - configuration module.
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use melib::conf::ActionFlag;
-
-use super::default_vals::*;
-
-/// Settings for digital signing and encryption
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct PGPSettings {
-    /// auto verify signed e-mail according to RFC3156
-    /// Default: true
-    #[serde(default = "true_val", alias = "auto-verify-signatures")]
-    pub auto_verify_signatures: ActionFlag,
-
-    /// auto decrypt encrypted e-mail
-    /// Default: true
-    #[serde(default = "true_val", alias = "auto-decrypt")]
-    pub auto_decrypt: ActionFlag,
-
-    /// always sign sent e-mail
-    /// Default: false
-    #[serde(default = "false_val", alias = "auto-sign")]
-    pub auto_sign: ActionFlag,
-
-    /// Auto encrypt sent e-mail
-    /// Default: false
-    #[serde(default = "false_val", alias = "auto-encrypt")]
-    pub auto_encrypt: ActionFlag,
-
-    // https://tools.ietf.org/html/rfc4880#section-12.2
-    /// Default: None
-    #[serde(default = "none", alias = "sign-key")]
-    pub sign_key: Option<String>,
-
-    /// Default: None
-    #[serde(default = "none", alias = "decrypt-key")]
-    pub decrypt_key: Option<String>,
-
-    /// Default: None
-    #[serde(default = "none", alias = "encrypt-key")]
-    pub encrypt_key: Option<String>,
-
-    /// Allow remote lookups
-    /// Default: False
-    #[serde(
-        default = "action_internal_value_false",
-        alias = "allow-remote-lookups"
-    )]
-    pub allow_remote_lookup: ActionFlag,
-
-    /// Remote lookup mechanisms.
-    /// Default: "local,wkd"
-    #[cfg_attr(
-        feature = "gpgme",
-        serde(
-            default = "default_lookup_mechanism",
-            alias = "remote-lookup-mechanisms"
-        )
-    )]
-    #[cfg(feature = "gpgme")]
-    pub remote_lookup_mechanisms: melib::gpgme::LocateKey,
-    #[cfg(not(feature = "gpgme"))]
-    #[cfg_attr(
-        not(feature = "gpgme"),
-        serde(default, alias = "remote-lookup-mechanisms")
-    )]
-    pub remote_lookup_mechanisms: String,
-}
-
-#[cfg(feature = "gpgme")]
-fn default_lookup_mechanism() -> melib::gpgme::LocateKey {
-    melib::gpgme::LocateKey::LOCAL | melib::gpgme::LocateKey::WKD
-}
-
-impl Default for PGPSettings {
-    fn default() -> Self {
-        Self {
-            auto_verify_signatures: true.into(),
-            auto_decrypt: true.into(),
-            auto_sign: false.into(),
-            auto_encrypt: false.into(),
-            sign_key: None,
-            decrypt_key: None,
-            encrypt_key: None,
-            allow_remote_lookup: action_internal_value_false::<ActionFlag>(),
-            #[cfg(feature = "gpgme")]
-            remote_lookup_mechanisms: default_lookup_mechanism(),
-            #[cfg(not(feature = "gpgme"))]
-            remote_lookup_mechanisms: String::new(),
-        }
-    }
-}

meli/src/conf/shortcuts.rs

@@ -1,281 +0,0 @@
-/*
- * meli - configuration module.
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use indexmap::IndexMap;
-use melib::{Error, Result};
-
-use super::DotAddressable;
-use crate::terminal::Key;
-
-#[macro_export]
-macro_rules! shortcut {
-    ($key:ident == $shortcuts:ident[$section:expr][$val:literal]) => {
-        $shortcuts
-            .get($section)
-            .and_then(|s| s.get($val).map(|v| v == $key))
-            .unwrap_or(false)
-    };
-}
-
-#[derive(Clone, Debug, Default, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct Shortcuts {
-    #[serde(default)]
-    pub general: GeneralShortcuts,
-    #[serde(default)]
-    pub listing: ListingShortcuts,
-    #[serde(default)]
-    pub composing: ComposingShortcuts,
-    #[serde(default, alias = "contact-list")]
-    pub contact_list: ContactListShortcuts,
-    #[serde(default, alias = "envelope-view")]
-    pub envelope_view: EnvelopeViewShortcuts,
-    #[serde(default, alias = "thread-view")]
-    pub thread_view: ThreadViewShortcuts,
-    #[serde(default)]
-    pub pager: PagerShortcuts,
-}
-
-impl Shortcuts {
-    pub const GENERAL: &'static str = "general";
-    pub const LISTING: &'static str = "listing";
-    pub const COMPOSING: &'static str = "composing";
-    pub const CONTACT_LIST: &'static str = "contact_list";
-    pub const ENVELOPE_VIEW: &'static str = "envelope_view";
-    pub const THREAD_VIEW: &'static str = "thread_view";
-    pub const PAGER: &'static str = "pager";
-}
-
-impl DotAddressable for Shortcuts {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "general" => self.general.lookup(field, tail),
-                    "listing" => self.listing.lookup(field, tail),
-                    "composing" => self.composing.lookup(field, tail),
-                    "contact_list" | "contact-list" => self.contact_list.lookup(field, tail),
-                    "envelope_view" | "envelope-view" => self.envelope_view.lookup(field, tail),
-                    "thread_view" | "thread-view" => self.thread_view.lookup(field, tail),
-                    "pager" => self.pager.lookup(field, tail),
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}
-
-#[derive(Debug, Clone, Serialize, Deserialize)]
-pub struct CommandShortcut {
-    pub shortcut: Key,
-    pub command: Vec<String>,
-}
-
-/// Create a struct holding all of a Component's shortcuts.
-#[macro_export]
-macro_rules! shortcut_key_values {
-    (
-        $cname:expr,
-        $(#[$outer:meta])*
-        pub struct $name:ident { $($fname:ident |> $fdesc:literal |> $default:expr),* }) => {
-        $(#[$outer])*
-        #[derive(Debug, Clone, Serialize, Deserialize)]
-        #[serde(default)]
-        #[serde(rename = $cname)]
-        pub struct $name {
-            pub commands: Vec<CommandShortcut>,
-            $(pub $fname : Key),*
-        }
-
-        impl $name {
-            /// Returns a shortcut's description
-            pub fn key_desc(&self, key: &str) -> &'static str {
-                match key {
-                    $(stringify!($fname) => $fdesc),*,
-                        _ => unreachable!()
-                }
-            }
-            /// Returns a hashmap of all shortcuts and their values
-            pub fn key_values(&self) -> IndexMap<&'static str, Key> {
-                [
-                $((stringify!($fname),(self.$fname).clone()),)*
-                ].iter().cloned().collect()
-            }
-        }
-
-        impl Default for $name {
-            fn default() -> Self {
-                Self {
-                    commands : vec![],
-                    $($fname: $default),*
-                }
-            }
-        }
-
-        impl DotAddressable for $name {
-            fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-                match path.first() {
-                    Some(field) => {
-                        let tail = &path[1..];
-                        match *field {
-                            $(stringify!($fname) => self.$fname.lookup(field, tail),)*
-                            other => Err(Error::new(format!(
-                                        "{} has no field named {}",
-                                        parent_field, other
-                            ))),
-                        }
-                    }
-                    None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-                }
-            }
-        }
-    }
-}
-
-shortcut_key_values! { "listing",
-    /// Shortcut listing for a mail listing.
-    pub struct ListingShortcuts {
-        scroll_up |> "Scroll up list." |> Key::Char('k'),
-        scroll_down |> "Scroll down list." |> Key::Char('j'),
-        new_mail |> "Start new mail draft in new tab." |>  Key::Char('m'),
-        next_account |> "Go to next account." |> Key::Char('H'),
-        next_mailbox |> "Go to next mailbox." |> Key::Char('J'),
-        next_page |> "Go to next page." |> Key::PageDown,
-        prev_account |> "Go to previous account." |> Key::Char('L'),
-        prev_mailbox |> "Go to previous mailbox." |> Key::Char('K'),
-        open_mailbox |> "Open selected mailbox." |> Key::Char('\n'),
-        toggle_mailbox_collapse |> "Toggle mailbox collapse in menu." |> Key::Char(' '),
-        prev_page |> "Go to previous page." |> Key::PageUp,
-        search |> "Search within list of e-mails." |> Key::Char('/'),
-        refresh |> "Manually request a mailbox refresh." |> Key::F(5),
-        set_seen |> "Set thread as seen." |> Key::Char('n'),
-        union_modifier |> "Union modifier." |> Key::Ctrl('u'),
-        diff_modifier |> "Difference modifier." |> Key::Ctrl('d'),
-        intersection_modifier |> "Intersection modifier." |> Key::Ctrl('i'),
-        select_entry |> "Select thread entry." |> Key::Char('v'),
-        increase_sidebar |> "Increase sidebar width." |> Key::Ctrl('f'),
-        decrease_sidebar |> "Decrease sidebar width." |> Key::Ctrl('d'),
-        next_entry |> "Focus on next entry." |> Key::Ctrl('n'),
-        previous_entry |> "Focus on previous entry." |> Key::Ctrl('p'),
-        toggle_menu_visibility |> "Toggle visibility of side menu in mail list." |> Key::Char('`'),
-        focus_left |> "Switch focus on the left." |> Key::Left,
-        focus_right |> "Switch focus on the right." |> Key::Right,
-        exit_entry |> "Exit e-mail entry." |> Key::Char('i'),
-        open_entry |> "Open e-mail entry." |> Key::Char('\n')
-    }
-}
-
-shortcut_key_values! { "contact-list",
-    /// Shortcut listing for the contact list view
-    pub struct ContactListShortcuts {
-        scroll_up |> "Scroll up list." |> Key::Char('k'),
-        scroll_down |> "Scroll down list." |> Key::Char('j'),
-        create_contact |> "Create new contact." |> Key::Char('c'),
-        edit_contact |> "Edit contact under cursor." |> Key::Char('e'),
-        delete_contact |> "Delete contact under cursor." |> Key::Char('d'),
-        mail_contact |> "Mail contact under cursor." |> Key::Char('m'),
-        next_account |> "Go to next account." |> Key::Char('H'),
-        prev_account |> "Go to previous account." |> Key::Char('L'),
-        toggle_menu_visibility |> "Toggle visibility of side menu in mail list." |> Key::Char('`')
-    }
-}
-
-shortcut_key_values! { "pager",
-    /// Shortcut listing for the text pager
-    pub struct PagerShortcuts {
-        page_down |> "Go to next pager page." |>  Key::PageDown,
-        page_up |> "Go to previous pager page." |>  Key::PageUp,
-        scroll_down |> "Scroll down pager." |> Key::Char('j'),
-        scroll_up |> "Scroll up pager." |> Key::Char('k')
-    }
-}
-
-shortcut_key_values! { "general",
-    pub struct GeneralShortcuts {
-        toggle_help |> "Toggle help and shortcuts view." |> Key::Char('?'),
-        enter_command_mode |> "Enter COMMAND mode." |> Key::Char(':'),
-        quit |> "Quit meli." |> Key::Char('q'),
-        go_to_tab |> "Go to the nth tab." |> Key::Alt('n'),
-        next_tab |> "Go to the next tab." |> Key::Char('T'),
-        scroll_right |> "Generic scroll right (catch-all setting)" |> Key::Char('l'),
-        scroll_left |> "Generic scroll left (catch-all setting)" |>Key::Char('h'),
-        scroll_up |> "Generic scroll up (catch-all setting)" |> Key::Char('k'),
-        scroll_down |> "Generic scroll down (catch-all setting)" |> Key::Char('j'),
-        next_page |> "Go to next page. (catch-all setting)" |> Key::PageDown,
-        prev_page |> "Go to previous page. (catch-all setting)" |> Key::PageUp,
-        home_page |> "Go to first page. (catch-all setting)" |> Key::Home,
-        end_page |> "Go to last page. (catch-all setting)" |> Key::End,
-        open_entry |> "Open list entry. (catch-all setting)" |> Key::Char('\n'),
-        info_message_next |> "Show next info message, if any." |> Key::Alt('>'),
-        info_message_previous |> "Show previous info message, if any." |> Key::Alt('<'),
-        focus_in_text_field |> "Focus on a text field." |> Key::Char('\n'),
-        next_search_result |> "Scroll to next search result." |> Key::Char('n'),
-        previous_search_result |> "Scroll to previous search result." |> Key::Char('N')
-    }
-}
-
-shortcut_key_values! { "composing",
-    pub struct ComposingShortcuts {
-        edit |> "Edit." |> Key::Char('e'),
-        send_mail |> "Deliver draft to mailer." |> Key::Char('s'),
-        scroll_up |> "Change field focus." |> Key::Char('k'),
-        scroll_down |> "Change field focus." |> Key::Char('j')
-    }
-}
-
-shortcut_key_values! { "envelope-view",
-    pub struct EnvelopeViewShortcuts {
-        add_addresses_to_contacts |> "Select addresses from envelope to add to contacts." |> Key::Char('c'),
-        edit |> "Open envelope in composer." |> Key::Char('e'),
-        go_to_url |> "Go to url of given index." |> Key::Char('g'),
-        open_attachment |> "Opens selected attachment with xdg-open." |> Key::Char('a'),
-        open_mailcap |> "Opens selected attachment according to its mailcap entry." |> Key::Char('m'),
-        open_html |> "Opens html attachment in the default browser." |> Key::Char('v'),
-        reply |> "Reply to envelope." |> Key::Char('R'),
-        reply_to_author |> "Reply to author." |> Key::Ctrl('r'),
-        reply_to_all |> "Reply to all/Reply to list/Follow up." |> Key::Ctrl('g'),
-        forward |> "Forward email." |> Key::Ctrl('f'),
-        return_to_normal_view |> "Return to envelope if viewing raw source or attachment." |> Key::Char('r'),
-        toggle_expand_headers |> "Expand extra headers (References and others)." |> Key::Char('h'),
-        toggle_url_mode |> "Toggles url open mode." |> Key::Char('u'),
-        view_raw_source |> "View envelope source in a pager. (toggles between raw and decoded source)" |> Key::Alt('r'),
-        change_charset |> "Force attachment charset for decoding." |> Key::Char('d')
-    }
-}
-
-shortcut_key_values! { "thread-view",
-    pub struct ThreadViewShortcuts {
-        scroll_up |> "Scroll up list." |> Key::Char('k'),
-        scroll_down |> "Scroll down list." |> Key::Char('j'),
-        collapse_subtree |> "collapse thread branches." |> Key::Char('h'),
-        next_page |> "Go to next page." |> Key::PageDown,
-        prev_page |> "Go to previous page." |> Key::PageUp,
-        reverse_thread_order |> "reverse thread order." |> Key::Ctrl('r'),
-        toggle_mailview |> "toggle mail view visibility." |> Key::Char('p'),
-        toggle_threadview |> "toggle thread view visibility." |> Key::Char('t'),
-        toggle_layout |> "Toggle between horizontal and vertical layout." |> Key::Char(' ')
-    }
-}

meli/src/conf/tags.rs

@@ -1,99 +0,0 @@
-/*
- * meli - configuration module.
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! E-mail tag configuration and {de,}serializing.
-
-use std::collections::{HashMap, HashSet};
-
-use melib::{Error, Result, TagHash};
-use serde::{Deserialize, Deserializer};
-
-use super::DotAddressable;
-use crate::terminal::Color;
-
-#[derive(Clone, Debug, Default, Deserialize, Serialize)]
-#[serde(deny_unknown_fields)]
-pub struct TagsSettings {
-    #[serde(default, deserialize_with = "tag_color_de")]
-    pub colors: HashMap<TagHash, Color>,
-    #[serde(default, deserialize_with = "tag_set_de", alias = "ignore-tags")]
-    pub ignore_tags: HashSet<TagHash>,
-}
-
-pub fn tag_set_de<'de, D, T: std::convert::From<HashSet<TagHash>>>(
-    deserializer: D,
-) -> std::result::Result<T, D::Error>
-where
-    D: Deserializer<'de>,
-{
-    Ok(<Vec<String>>::deserialize(deserializer)?
-        .into_iter()
-        .map(|tag| TagHash::from_bytes(tag.as_bytes()))
-        .collect::<HashSet<TagHash>>()
-        .into())
-}
-
-pub fn tag_color_de<'de, D, T: std::convert::From<HashMap<TagHash, Color>>>(
-    deserializer: D,
-) -> std::result::Result<T, D::Error>
-where
-    D: Deserializer<'de>,
-{
-    #[derive(Deserialize)]
-    #[serde(untagged)]
-    enum _Color {
-        B(u8),
-        C(Color),
-    }
-
-    Ok(<HashMap<String, _Color>>::deserialize(deserializer)?
-        .into_iter()
-        .map(|(tag, color)| {
-            (
-                TagHash::from_bytes(tag.as_bytes()),
-                match color {
-                    _Color::B(b) => Color::Byte(b),
-                    _Color::C(c) => c,
-                },
-            )
-        })
-        .collect::<HashMap<TagHash, Color>>()
-        .into())
-}
-
-impl DotAddressable for TagsSettings {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "colors" => self.colors.lookup(field, tail),
-                    "ignore_tags" => self.ignore_tags.lookup(field, tail),
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}

meli/src/conf/terminal.rs

@@ -1,127 +0,0 @@
-/*
- * meli - configuration module.
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Settings for terminal display
-
-use melib::{Error, Result, ToggleFlag};
-
-use super::{deserializers::non_empty_opt_string, DotAddressable, Themes};
-
-/// Settings for terminal display
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(default, deny_unknown_fields)]
-pub struct TerminalSettings {
-    /// light, dark
-    pub theme: String,
-    pub themes: Themes,
-    pub ascii_drawing: bool,
-    pub use_color: ToggleFlag,
-    /// Use mouse events. This will disable text selection, but you will be able
-    /// to resize some widgets.
-    /// Default: False
-    pub use_mouse: ToggleFlag,
-    /// String to show in status bar if mouse is active.
-    /// Default: "🖱️ "
-    #[serde(deserialize_with = "non_empty_opt_string")]
-    pub mouse_flag: Option<String>,
-    #[serde(deserialize_with = "non_empty_opt_string")]
-    pub window_title: Option<String>,
-    #[serde(deserialize_with = "non_empty_opt_string")]
-    pub file_picker_command: Option<String>,
-    /// Choose between 30-something built in sequences (integers between 0-30)
-    /// or define your own list of strings for the progress spinner
-    /// animation. Default: 0
-    #[serde(default)]
-    pub progress_spinner_sequence: Option<ProgressSpinnerSequence>,
-}
-
-impl Default for TerminalSettings {
-    fn default() -> Self {
-        Self {
-            theme: "dark".to_string(),
-            themes: Themes::default(),
-            ascii_drawing: false,
-            use_color: ToggleFlag::InternalVal(true),
-            use_mouse: ToggleFlag::InternalVal(false),
-            mouse_flag: Some("🖱️ ".to_string()),
-            window_title: Some("meli".to_string()),
-            file_picker_command: None,
-            progress_spinner_sequence: None,
-        }
-    }
-}
-
-impl TerminalSettings {
-    pub fn use_color(&self) -> bool {
-        /* Don't use color if
-         * - Either NO_COLOR is set and user hasn't explicitly set use_colors or
-         * - User has explicitly set use_colors to false
-         */
-        !((std::env::var("NO_COLOR").is_ok()
-            && (self.use_color.is_false() || self.use_color.is_internal()))
-            || (self.use_color.is_false() && !self.use_color.is_internal()))
-    }
-}
-
-impl DotAddressable for TerminalSettings {
-    fn lookup(&self, parent_field: &str, path: &[&str]) -> Result<String> {
-        match path.first() {
-            Some(field) => {
-                let tail = &path[1..];
-                match *field {
-                    "theme" => self.theme.lookup(field, tail),
-                    "themes" => Err(Error::new("unimplemented")),
-                    "ascii_drawing" => self.ascii_drawing.lookup(field, tail),
-                    "use_color" => self.use_color.lookup(field, tail),
-                    "use_mouse" => self.use_mouse.lookup(field, tail),
-                    "mouse_flag" => self.mouse_flag.lookup(field, tail),
-                    "window_title" => self.window_title.lookup(field, tail),
-                    "file_picker_command" => self.file_picker_command.lookup(field, tail),
-                    "progress_spinner_sequence" => {
-                        self.progress_spinner_sequence.lookup(field, tail)
-                    }
-                    other => Err(Error::new(format!(
-                        "{} has no field named {}",
-                        parent_field, other
-                    ))),
-                }
-            }
-            None => Ok(toml::to_string(self).map_err(|err| err.to_string())?),
-        }
-    }
-}
-
-#[derive(Clone, Debug, Deserialize, Serialize)]
-#[serde(untagged)]
-pub enum ProgressSpinnerSequence {
-    Integer(usize),
-    Custom {
-        frames: Vec<String>,
-        #[serde(default = "interval_ms_val")]
-        interval_ms: u64,
-    },
-}
-
-const fn interval_ms_val() -> u64 {
-    crate::utilities::ProgressSpinner::INTERVAL_MS
-}
-
-impl DotAddressable for ProgressSpinnerSequence {}

meli/src/jobs.rs

@@ -1,463 +0,0 @@
-/*
- * meli - jobs executor
- *
- * Copyright 2020 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-//! Async job executor thread pool
-
-use std::{
-    borrow::Cow,
-    future::Future,
-    iter,
-    panic::catch_unwind,
-    sync::{Arc, Mutex},
-    thread,
-    time::Duration,
-};
-
-use crossbeam::{
-    channel::Sender,
-    deque::{Injector, Stealer, Worker},
-    sync::{Parker, Unparker},
-};
-pub use futures::channel::oneshot;
-use indexmap::IndexMap;
-use melib::{log, smol, utils::datetime, uuid::Uuid, UnixTimestamp};
-
-use crate::types::{StatusEvent, ThreadEvent, UIEvent};
-
-type AsyncTask = async_task::Runnable;
-
-fn find_task(
-    local: &Worker<MeliTask>,
-    global: &Injector<MeliTask>,
-    stealers: &[Stealer<MeliTask>],
-) -> Option<MeliTask> {
-    // Pop a task from the local queue, if not empty.
-    local.pop().or_else(|| {
-        // Otherwise, we need to look for a task elsewhere.
-        iter::repeat_with(|| {
-            // Try stealing a batch of tasks from the global queue.
-            global
-                .steal_batch_and_pop(local)
-                // Or try stealing a task from one of the other threads.
-                .or_else(|| stealers.iter().map(|s| s.steal()).collect())
-        })
-        // Loop while no task was stolen and any steal operation needs to be retried.
-        .find(|s| !s.is_retry())
-        // Extract the stolen task, if there is one.
-        .and_then(|s| s.success())
-    })
-}
-
-macro_rules! uuid_hash_type {
-    ($n:ident) => {
-        #[derive(PartialEq, Hash, Eq, Copy, Clone, Ord, PartialOrd, Serialize, Deserialize)]
-        pub struct $n(Uuid);
-
-        impl std::fmt::Debug for $n {
-            fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-                write!(f, "{}", self.0.to_string())
-            }
-        }
-
-        impl std::fmt::Display for $n {
-            fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-                write!(f, "{}", self.0.to_string())
-            }
-        }
-
-        impl Default for $n {
-            fn default() -> Self {
-                Self::new()
-            }
-        }
-
-        impl $n {
-            pub fn new() -> Self {
-                Self(Uuid::new_v4())
-            }
-            pub fn null() -> Self {
-                Self(Uuid::nil())
-            }
-        }
-    };
-}
-uuid_hash_type!(JobId);
-uuid_hash_type!(TimerId);
-
-/// A spawned future and its current state.
-pub struct MeliTask {
-    task: AsyncTask,
-    id: JobId,
-    desc: Cow<'static, str>,
-    timer: bool,
-}
-
-#[derive(Clone, Debug)]
-/// A spawned future's metadata for book-keeping.
-pub struct JobMetadata {
-    pub id: JobId,
-    pub desc: Cow<'static, str>,
-    pub timer: bool,
-    pub started: UnixTimestamp,
-    pub finished: Option<UnixTimestamp>,
-    pub succeeded: bool,
-}
-
-#[derive(Debug)]
-pub struct JobExecutor {
-    global_queue: Arc<Injector<MeliTask>>,
-    workers: Vec<Stealer<MeliTask>>,
-    sender: Sender<ThreadEvent>,
-    parkers: Vec<Unparker>,
-    timers: Arc<Mutex<IndexMap<TimerId, TimerPrivate>>>,
-    pub jobs: Arc<Mutex<IndexMap<JobId, JobMetadata>>>,
-}
-
-#[derive(Debug, Default)]
-struct TimerPrivate {
-    /// Interval for periodic timer.
-    interval: Duration,
-    /// Time until next expiration.
-    value: Duration,
-    active: bool,
-    handle: Option<async_task::Task<()>>,
-    cancel: Arc<Mutex<bool>>,
-}
-
-#[derive(Debug)]
-pub struct Timer {
-    id: TimerId,
-    job_executor: Arc<JobExecutor>,
-}
-
-impl Timer {
-    pub fn id(&self) -> TimerId {
-        self.id
-    }
-
-    pub fn rearm(&self) {
-        self.job_executor.rearm(self.id);
-    }
-
-    pub fn disable(&self) {
-        self.job_executor.disable_timer(self.id);
-    }
-
-    pub fn set_interval(&self, new_val: Duration) {
-        self.job_executor.set_interval(self.id, new_val);
-    }
-}
-
-impl Drop for Timer {
-    fn drop(&mut self) {
-        self.disable();
-    }
-}
-
-impl JobExecutor {
-    /// A queue that holds scheduled tasks.
-    pub fn new(sender: Sender<ThreadEvent>) -> Self {
-        // Create a queue.
-        let mut ret = Self {
-            global_queue: Arc::new(Injector::new()),
-            workers: vec![],
-            parkers: vec![],
-            sender,
-            timers: Arc::new(Mutex::new(IndexMap::default())),
-            jobs: Arc::new(Mutex::new(IndexMap::default())),
-        };
-        let mut workers = vec![];
-        for _ in 0..std::thread::available_parallelism()
-            .map(Into::into)
-            .unwrap_or(1)
-        {
-            let new_worker = Worker::new_fifo();
-            ret.workers.push(new_worker.stealer());
-            let p = Parker::new();
-            ret.parkers.push(p.unparker().clone());
-            workers.push((new_worker, p));
-        }
-
-        // Reactor thread
-        thread::Builder::new()
-            .name("meli-reactor".to_string())
-            .spawn(move || {
-                let ex = smol::Executor::new();
-
-                futures::executor::block_on(ex.run(futures::future::pending::<()>()));
-            })
-            .unwrap();
-
-        // Spawn executor threads the first time the queue is created.
-        for (i, (local, parker)) in workers.into_iter().enumerate() {
-            let global = ret.global_queue.clone();
-            let stealers = ret.workers.clone();
-            thread::Builder::new()
-                .name(format!("meli-executor-{}", i))
-                .spawn(move || loop {
-                    parker.park_timeout(Duration::from_millis(100));
-                    let task = find_task(&local, &global, stealers.as_slice());
-                    if let Some(meli_task) = task {
-                        let MeliTask {
-                            task,
-                            id,
-                            timer,
-                            desc,
-                        } = meli_task;
-                        if !timer {
-                            log::trace!("Worker {} got task {:?} {:?}", i, desc, id);
-                        }
-                        let _ = catch_unwind(|| task.run());
-                        if !timer {
-                            log::trace!("Worker {} returned after {:?} {:?}", i, desc, id);
-                        }
-                    }
-                })
-                .unwrap();
-        }
-        ret
-    }
-
-    /// Spawns a future with a generic return value `R`
-    #[inline(always)]
-    pub fn spawn_specialized<F, R>(&self, desc: Cow<'static, str>, future: F) -> JoinHandle<R>
-    where
-        F: Future<Output = R> + Send + 'static,
-        R: Send + 'static,
-    {
-        let (sender, receiver) = oneshot::channel();
-        let finished_sender = self.sender.clone();
-        let job_id = JobId::new();
-        let injector = self.global_queue.clone();
-        let cancel = Arc::new(Mutex::new(false));
-        let cancel2 = cancel.clone();
-
-        self.jobs.lock().unwrap().insert(
-            job_id,
-            JobMetadata {
-                id: job_id,
-                desc: desc.clone(),
-                started: datetime::now(),
-                finished: None,
-                succeeded: true,
-                timer: false,
-            },
-        );
-
-        // Create a task and schedule it for execution.
-        let (handle, task) = async_task::spawn(
-            async move {
-                let res = future.await;
-                let _ = sender.send(res);
-                finished_sender
-                    .send(ThreadEvent::JobFinished(job_id))
-                    .unwrap();
-            },
-            move |task| {
-                if *cancel.lock().unwrap() {
-                    return;
-                }
-                let desc = desc.clone();
-                injector.push(MeliTask {
-                    task,
-                    id: job_id,
-                    desc,
-                    timer: false,
-                })
-            },
-        );
-        handle.schedule();
-        for unparker in self.parkers.iter() {
-            unparker.unpark();
-        }
-
-        JoinHandle {
-            task: Arc::new(Mutex::new(Some(task))),
-            cancel: cancel2,
-            chan: receiver,
-            job_id,
-        }
-    }
-
-    /// Spawns a future with a generic return value `R` that might block on a
-    /// new thread
-    #[inline(always)]
-    pub fn spawn_blocking<F, R>(&self, desc: Cow<'static, str>, future: F) -> JoinHandle<R>
-    where
-        F: Future<Output = R> + Send + 'static,
-        R: Send + 'static,
-    {
-        self.spawn_specialized(
-            desc,
-            smol::unblock(move || futures::executor::block_on(future)),
-        )
-    }
-
-    pub fn create_timer(self: Arc<Self>, interval: Duration, value: Duration) -> Timer {
-        let timer = TimerPrivate {
-            interval,
-            cancel: Arc::new(Mutex::new(false)),
-            value,
-            active: true,
-            handle: None,
-        };
-        let id = TimerId::default();
-        self.timers.lock().unwrap().insert(id, timer);
-        self.arm_timer(id, value);
-        Timer {
-            id,
-            job_executor: self,
-        }
-    }
-
-    pub fn rearm(&self, timer_id: TimerId) {
-        let mut timers_lck = self.timers.lock().unwrap();
-        if let Some(timer) = timers_lck.get_mut(&timer_id) {
-            let value = timer.value;
-            drop(timers_lck);
-            self.arm_timer(timer_id, value);
-        }
-    }
-
-    fn arm_timer(&self, id: TimerId, value: Duration) {
-        let job_id = JobId::new();
-        let sender = self.sender.clone();
-        let injector = self.global_queue.clone();
-        let timers = self.timers.clone();
-        let cancel = Arc::new(Mutex::new(false));
-        let cancel2 = cancel.clone();
-        let (task, handle) = async_task::spawn(
-            async move {
-                let mut value = value;
-                loop {
-                    smol::Timer::after(value).await;
-                    sender
-                        .send(ThreadEvent::UIEvent(UIEvent::Timer(id)))
-                        .unwrap();
-                    if let Some(interval) = timers.lock().unwrap().get(&id).and_then(|timer| {
-                        if timer.interval.as_millis() == 0 && timer.interval.as_secs() == 0 {
-                            None
-                        } else if timer.active {
-                            Some(timer.interval)
-                        } else {
-                            None
-                        }
-                    }) {
-                        value = interval;
-                    } else {
-                        break;
-                    }
-                }
-            },
-            move |task| {
-                if *cancel.lock().unwrap() {
-                    return;
-                }
-                injector.push(MeliTask {
-                    task,
-                    id: job_id,
-                    desc: "timer".into(),
-                    timer: true,
-                })
-            },
-        );
-        self.timers.lock().unwrap().entry(id).and_modify(|timer| {
-            timer.handle = Some(handle);
-            timer.cancel = cancel2;
-            timer.active = true;
-        });
-        task.schedule();
-        for unparker in self.parkers.iter() {
-            unparker.unpark();
-        }
-    }
-
-    fn disable_timer(&self, id: TimerId) {
-        let mut timers_lck = self.timers.lock().unwrap();
-        if let Some(timer) = timers_lck.get_mut(&id) {
-            timer.active = false;
-            *timer.cancel.lock().unwrap() = true;
-        }
-    }
-
-    fn set_interval(&self, id: TimerId, new_val: Duration) {
-        let mut timers_lck = self.timers.lock().unwrap();
-        if let Some(timer) = timers_lck.get_mut(&id) {
-            timer.interval = new_val;
-        }
-    }
-
-    pub fn set_job_finished(&self, id: JobId) {
-        self.jobs.lock().unwrap().entry(id).and_modify(|entry| {
-            entry.finished = Some(datetime::now());
-        });
-    }
-
-    pub fn set_job_success(&self, id: JobId, value: bool) {
-        self.jobs.lock().unwrap().entry(id).and_modify(|entry| {
-            entry.succeeded = value;
-        });
-    }
-}
-
-pub type JobChannel<T> = oneshot::Receiver<T>;
-
-/// `JoinHandle` for the future that allows us to cancel the task.
-#[derive(Debug)]
-pub struct JoinHandle<T> {
-    pub task: Arc<Mutex<Option<async_task::Task<()>>>>,
-    pub chan: JobChannel<T>,
-    pub cancel: Arc<Mutex<bool>>,
-    pub job_id: JobId,
-}
-
-impl<T> JoinHandle<T> {
-    pub fn cancel(&self) -> Option<StatusEvent> {
-        let mut lck = self.cancel.lock().unwrap();
-        if !*lck {
-            *lck = true;
-            Some(StatusEvent::JobCanceled(self.job_id))
-        } else {
-            None
-        }
-    }
-}
-
-impl<T> std::cmp::PartialEq<JobId> for JoinHandle<T> {
-    fn eq(&self, other: &JobId) -> bool {
-        self.job_id == *other
-    }
-}
-
-/*
-use std::pin::Pin;
-use std::task::{Context, Poll};
-impl Future for JoinHandle {
-    type Output = Result<()>;
-
-    fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
-        match Pin::new(&mut self.inner).poll(cx) {
-            Poll::Pending => Poll::Pending,
-            Poll::Ready(output) => Poll::Ready(output.expect("task failed")),
-        }
-    }
-}
-*/

meli/src/jobs_view.rs

@@ -1,638 +0,0 @@
-/*
- * meli
- *
- * Copyright 2019 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use std::borrow::Cow;
-
-use indexmap::IndexMap;
-
-use super::*;
-use crate::{
-    jobs::{JobId, JobMetadata},
-    melib::{
-        utils::datetime::{self, formats::RFC3339_DATETIME_AND_SPACE},
-        SortOrder,
-    },
-};
-
-#[derive(Clone, Copy, Debug, PartialEq)]
-#[repr(u8)]
-enum Column {
-    _0 = 0,
-    _1,
-    _2,
-    _3,
-    _4,
-}
-
-const fn _assert_len() {
-    if JobManager::HEADERS.len() != Column::_4 as usize + 1 {
-        panic!("JobManager::HEADERS length changed, please update Column enum accordingly.");
-    }
-}
-
-const _: () = _assert_len();
-
-#[derive(Debug)]
-pub struct JobManager {
-    cursor_pos: usize,
-    new_cursor_pos: usize,
-    length: usize,
-    data_columns: DataColumns<5>,
-    min_width: [usize; 5],
-    sort_col: Column,
-    sort_order: SortOrder,
-    entries: IndexMap<JobId, JobMetadata>,
-
-    initialized: bool,
-    theme_default: ThemeAttribute,
-    highlight_theme: ThemeAttribute,
-
-    dirty: bool,
-
-    movement: Option<PageMovement>,
-    id: ComponentId,
-}
-
-impl std::fmt::Display for JobManager {
-    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-        write!(f, "jobs")
-    }
-}
-
-impl JobManager {
-    const HEADERS: [&'static str; 5] = ["id", "desc", "started", "finished", "succeeded"];
-
-    pub fn new(context: &Context) -> Self {
-        let theme_default = crate::conf::value(context, "theme_default");
-        let highlight_theme = if context.settings.terminal.use_color() {
-            crate::conf::value(context, "highlight")
-        } else {
-            ThemeAttribute {
-                attrs: Attr::REVERSE,
-                ..ThemeAttribute::default()
-            }
-        };
-        let mut data_columns = DataColumns::default();
-        data_columns.theme_config.set_single_theme(theme_default);
-        Self {
-            cursor_pos: 0,
-            new_cursor_pos: 0,
-            entries: IndexMap::default(),
-            length: 0,
-            data_columns,
-            min_width: [0; 5],
-            sort_col: Column::_2,
-            sort_order: SortOrder::Desc,
-            theme_default,
-            highlight_theme,
-            initialized: false,
-            dirty: true,
-            movement: None,
-            id: ComponentId::default(),
-        }
-    }
-
-    fn initialize(&mut self, context: &Context) {
-        self.set_dirty(true);
-
-        let mut entries = (*context.main_loop_handler.job_executor.jobs.lock().unwrap()).clone();
-
-        self.length = entries.len();
-        entries.sort_by(|_, a, _, b| match (self.sort_col, self.sort_order) {
-            (Column::_0, SortOrder::Asc) => a.id.cmp(&b.id),
-            (Column::_0, SortOrder::Desc) => b.id.cmp(&b.id),
-            (Column::_1, SortOrder::Asc) => a.desc.cmp(&b.desc),
-            (Column::_1, SortOrder::Desc) => b.desc.cmp(&a.desc),
-            (Column::_2, SortOrder::Asc) => a.started.cmp(&b.started),
-            (Column::_2, SortOrder::Desc) => b.started.cmp(&a.started),
-            (Column::_3, SortOrder::Asc) => a.finished.cmp(&b.finished),
-            (Column::_3, SortOrder::Desc) => b.finished.cmp(&a.finished),
-            (Column::_4, SortOrder::Asc) if a.finished.is_some() && b.finished.is_some() => {
-                a.succeeded.cmp(&b.succeeded)
-            }
-            (Column::_4, SortOrder::Desc) if a.finished.is_some() && b.finished.is_some() => {
-                b.succeeded.cmp(&a.succeeded)
-            }
-            (Column::_4, SortOrder::Asc) if a.finished.is_none() => std::cmp::Ordering::Less,
-            (Column::_4, SortOrder::Asc) => std::cmp::Ordering::Greater,
-            (Column::_4, SortOrder::Desc) if a.finished.is_none() => std::cmp::Ordering::Greater,
-            (Column::_4, SortOrder::Desc) => std::cmp::Ordering::Less,
-        });
-        self.entries = entries;
-
-        macro_rules! hdr {
-            ($idx:literal) => {{
-                Self::HEADERS[$idx].len() + if self.sort_col as u8 == $idx { 1 } else { 0 }
-            }};
-        }
-        self.min_width = [hdr!(0), hdr!(1), hdr!(2), hdr!(3), hdr!(4)];
-
-        for c in self.entries.values() {
-            // title
-            self.min_width[0] = self.min_width[0].max(c.id.to_string().len());
-            // desc
-            self.min_width[1] = self.min_width[1].max(c.desc.len());
-        }
-        self.min_width[2] = "1970-01-01 00:00:00".len();
-        self.min_width[3] = self.min_width[2];
-
-        // name column
-        _ = self.data_columns.columns[0].resize_with_context(
-            self.min_width[0],
-            self.length,
-            context,
-        );
-        self.data_columns.columns[0].grid_mut().clear(None);
-        // path column
-        _ = self.data_columns.columns[1].resize_with_context(
-            self.min_width[1],
-            self.length,
-            context,
-        );
-        self.data_columns.columns[1].grid_mut().clear(None);
-        // size column
-        _ = self.data_columns.columns[2].resize_with_context(
-            self.min_width[2],
-            self.length,
-            context,
-        );
-        self.data_columns.columns[2].grid_mut().clear(None);
-        // subscribed column
-        _ = self.data_columns.columns[3].resize_with_context(
-            self.min_width[3],
-            self.length,
-            context,
-        );
-        self.data_columns.columns[3].grid_mut().clear(None);
-        _ = self.data_columns.columns[4].resize_with_context(
-            self.min_width[4],
-            self.length,
-            context,
-        );
-        self.data_columns.columns[4].grid_mut().clear(None);
-
-        for (idx, e) in self.entries.values().enumerate() {
-            {
-                let area = self.data_columns.columns[0].area().nth_row(idx);
-                self.data_columns.columns[0].grid_mut().write_string(
-                    &e.id.to_string(),
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-
-            {
-                let area = self.data_columns.columns[1].area().nth_row(idx);
-                self.data_columns.columns[1].grid_mut().write_string(
-                    &e.desc,
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-
-            {
-                let area = self.data_columns.columns[2].area().nth_row(idx);
-                self.data_columns.columns[2].grid_mut().write_string(
-                    &datetime::timestamp_to_string(
-                        e.started,
-                        Some(RFC3339_DATETIME_AND_SPACE),
-                        true,
-                    ),
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-
-            {
-                let area = self.data_columns.columns[3].area().nth_row(idx);
-                self.data_columns.columns[3].grid_mut().write_string(
-                    &if let Some(t) = e.finished {
-                        Cow::Owned(datetime::timestamp_to_string(
-                            t,
-                            Some(RFC3339_DATETIME_AND_SPACE),
-                            true,
-                        ))
-                    } else {
-                        Cow::Borrowed("null")
-                    },
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-
-            {
-                let area = self.data_columns.columns[4].area().nth_row(idx);
-                self.data_columns.columns[4].grid_mut().write_string(
-                    &if e.finished.is_some() {
-                        Cow::Owned(format!("{:?}", e.succeeded))
-                    } else {
-                        Cow::Borrowed("-")
-                    },
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-        }
-
-        if self.length == 0 {
-            let message = "No jobs.".to_string();
-            if self.data_columns.columns[0].resize_with_context(message.len(), self.length, context)
-            {
-                let area = self.data_columns.columns[0].area();
-                self.data_columns.columns[0].grid_mut().write_string(
-                    &message,
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs,
-                    area,
-                    None,
-                );
-            }
-        }
-    }
-
-    fn draw_list(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context) {
-        let rows = area.height();
-        if rows == 0 {
-            return;
-        }
-        if self.length == 0 {
-            grid.clear_area(area, self.theme_default);
-
-            grid.copy_area(
-                self.data_columns.columns[0].grid(),
-                area,
-                self.data_columns.columns[0].area(),
-            );
-            context.dirty_areas.push_back(area);
-            return;
-        }
-
-        if let Some(mvm) = self.movement.take() {
-            match mvm {
-                PageMovement::Up(amount) => {
-                    self.new_cursor_pos = self.new_cursor_pos.saturating_sub(amount);
-                }
-                PageMovement::PageUp(multiplier) => {
-                    self.new_cursor_pos = self.new_cursor_pos.saturating_sub(rows * multiplier);
-                }
-                PageMovement::Down(amount) => {
-                    if self.new_cursor_pos + amount < self.length {
-                        self.new_cursor_pos += amount;
-                    } else {
-                        self.new_cursor_pos = self.length - 1;
-                    }
-                }
-                PageMovement::PageDown(multiplier) => {
-                    #[allow(clippy::comparison_chain)]
-                    if self.new_cursor_pos + rows * multiplier < self.length {
-                        self.new_cursor_pos += rows * multiplier;
-                    } else if self.new_cursor_pos + rows * multiplier > self.length {
-                        self.new_cursor_pos = self.length - 1;
-                    } else {
-                        self.new_cursor_pos = (self.length / rows) * rows;
-                    }
-                }
-                PageMovement::Right(amount) => {
-                    self.data_columns.x_offset += amount;
-                    self.data_columns.x_offset = self.data_columns.x_offset.min(
-                        self.data_columns
-                            .widths
-                            .iter()
-                            .map(|w| w + 2)
-                            .sum::<usize>()
-                            .saturating_sub(2),
-                    );
-                }
-                PageMovement::Left(amount) => {
-                    self.data_columns.x_offset = self.data_columns.x_offset.saturating_sub(amount);
-                }
-                PageMovement::Home => {
-                    self.new_cursor_pos = 0;
-                }
-                PageMovement::End => {
-                    self.new_cursor_pos = self.length - 1;
-                }
-            }
-        }
-
-        let prev_page_no = (self.cursor_pos).wrapping_div(rows);
-        let page_no = (self.new_cursor_pos).wrapping_div(rows);
-
-        let top_idx = page_no * rows;
-
-        if self.length >= rows {
-            context
-                .replies
-                .push_back(UIEvent::StatusEvent(StatusEvent::ScrollUpdate(
-                    ScrollUpdate::Update {
-                        id: self.id,
-                        context: ScrollContext {
-                            shown_lines: top_idx + rows,
-                            total_lines: self.length,
-                            has_more_lines: false,
-                        },
-                    },
-                )));
-        } else {
-            context
-                .replies
-                .push_back(UIEvent::StatusEvent(StatusEvent::ScrollUpdate(
-                    ScrollUpdate::End(self.id),
-                )));
-        }
-
-        // If cursor position has changed, remove the highlight from the previous
-        // position and apply it in the new one.
-        if self.cursor_pos != self.new_cursor_pos && prev_page_no == page_no {
-            let old_cursor_pos = self.cursor_pos;
-            self.cursor_pos = self.new_cursor_pos;
-            for &(idx, highlight) in &[(old_cursor_pos, false), (self.new_cursor_pos, true)] {
-                if idx >= self.length {
-                    continue; //bounds check
-                }
-                let new_area = area.nth_row(idx % rows);
-                self.data_columns
-                    .draw(grid, idx, self.cursor_pos, grid.bounds_iter(new_area));
-                let row_attr = if highlight {
-                    self.highlight_theme
-                } else {
-                    self.theme_default
-                };
-                grid.change_theme(new_area, row_attr);
-                context.dirty_areas.push_back(new_area);
-            }
-            return;
-        } else if self.cursor_pos != self.new_cursor_pos {
-            self.cursor_pos = self.new_cursor_pos;
-        }
-        if self.new_cursor_pos >= self.length {
-            self.new_cursor_pos = self.length - 1;
-            self.cursor_pos = self.new_cursor_pos;
-        }
-        // Page_no has changed, so draw new page
-        _ = self
-            .data_columns
-            .recalc_widths((area.width(), area.height()), top_idx);
-        grid.clear_area(area, self.theme_default);
-        // copy table columns
-        self.data_columns
-            .draw(grid, top_idx, self.cursor_pos, grid.bounds_iter(area));
-
-        // highlight cursor
-        grid.change_theme(area.nth_row(self.cursor_pos % rows), self.highlight_theme);
-
-        // clear gap if available height is more than count of entries
-        if top_idx + rows > self.length {
-            grid.change_theme(area.skip_rows(self.length - top_idx), self.theme_default);
-        }
-        context.dirty_areas.push_back(area);
-    }
-}
-
-impl Component for JobManager {
-    fn draw(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context) {
-        if !self.is_dirty() {
-            return;
-        }
-        if !self.initialized {
-            self.initialize(context);
-        }
-        if self.dirty {
-            let area = area.nth_row(0);
-            // Draw column headers.
-            grid.clear_area(area, self.theme_default);
-            let mut x_offset = 0;
-            for (i, (h, w)) in Self::HEADERS.iter().zip(self.min_width).enumerate() {
-                grid.write_string(
-                    h,
-                    self.theme_default.fg,
-                    self.theme_default.bg,
-                    self.theme_default.attrs | Attr::BOLD,
-                    area.skip_cols(x_offset),
-                    None,
-                );
-                if self.sort_col as usize == i {
-                    use SortOrder::*;
-                    let arrow = match (grid.ascii_drawing, self.sort_order) {
-                        (true, Asc) => DataColumns::<5>::ARROW_UP_ASCII,
-                        (true, Desc) => DataColumns::<5>::ARROW_DOWN_ASCII,
-                        (false, Asc) => DataColumns::<5>::ARROW_UP,
-                        (false, Desc) => DataColumns::<5>::ARROW_DOWN,
-                    };
-                    grid.write_string(
-                        arrow,
-                        self.theme_default.fg,
-                        self.theme_default.bg,
-                        self.theme_default.attrs,
-                        area.skip_cols(x_offset + h.len()),
-                        None,
-                    );
-                }
-                x_offset += w + 2;
-            }
-            context.dirty_areas.push_back(area);
-        }
-
-        self.draw_list(grid, area.skip_rows(1), context);
-        self.dirty = false;
-    }
-
-    fn process_event(&mut self, event: &mut UIEvent, context: &mut Context) -> bool {
-        if let UIEvent::ConfigReload { old_settings: _ } = event {
-            self.theme_default = crate::conf::value(context, "theme_default");
-            self.initialized = false;
-            self.set_dirty(true);
-        }
-
-        let shortcuts = self.shortcuts(context);
-        match event {
-            UIEvent::StatusEvent(
-                StatusEvent::JobFinished(_) | StatusEvent::JobCanceled(_) | StatusEvent::NewJob(_),
-            ) => {
-                self.initialized = false;
-                self.set_dirty(true);
-                return false;
-            }
-            UIEvent::Action(Action::SortColumn(column, order)) => {
-                let column = match *column {
-                    0 => Column::_0,
-                    1 => Column::_1,
-                    2 => Column::_2,
-                    3 => Column::_3,
-                    4 => Column::_4,
-                    other => {
-                        context.replies.push_back(UIEvent::StatusEvent(
-                            StatusEvent::DisplayMessage(format!(
-                                "Invalid column index `{}`: there are {} columns.",
-                                other,
-                                Self::HEADERS.len()
-                            )),
-                        ));
-
-                        return true;
-                    }
-                };
-                if (self.sort_col, self.sort_order) != (column, *order) {
-                    self.sort_col = column;
-                    self.sort_order = *order;
-                    self.initialized = false;
-                    self.set_dirty(true);
-                }
-                return true;
-            }
-            UIEvent::Input(Key::Char(ref c)) if c.is_ascii_digit() => {
-                let n = *c as u8 - b'0'; // safe cast because of is_ascii_digit() check;
-                let column = match n {
-                    1 => Column::_0,
-                    2 => Column::_1,
-                    3 => Column::_2,
-                    4 => Column::_3,
-                    5 => Column::_4,
-                    _ => {
-                        return false;
-                    }
-                };
-                if self.sort_col == column {
-                    self.sort_order = !self.sort_order;
-                } else {
-                    self.sort_col = column;
-                    self.sort_order = SortOrder::default();
-                }
-                self.initialized = false;
-                self.set_dirty(true);
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["scroll_up"]) =>
-            {
-                let amount = 1;
-                self.movement = Some(PageMovement::Up(amount));
-                self.set_dirty(true);
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["scroll_down"])
-                    && self.cursor_pos < self.length.saturating_sub(1) =>
-            {
-                let amount = 1;
-                self.set_dirty(true);
-                self.movement = Some(PageMovement::Down(amount));
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["prev_page"]) =>
-            {
-                let mult = 1;
-                self.set_dirty(true);
-                self.movement = Some(PageMovement::PageUp(mult));
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["next_page"]) =>
-            {
-                let mult = 1;
-                self.set_dirty(true);
-                self.movement = Some(PageMovement::PageDown(mult));
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["home_page"]) =>
-            {
-                self.set_dirty(true);
-                self.movement = Some(PageMovement::Home);
-                return true;
-            }
-            UIEvent::Input(ref key)
-                if shortcut!(key == shortcuts[Shortcuts::GENERAL]["end_page"]) =>
-            {
-                self.set_dirty(true);
-                self.movement = Some(PageMovement::End);
-                return true;
-            }
-            UIEvent::Resize => {
-                self.set_dirty(true);
-            }
-            _ => {}
-        }
-        false
-    }
-
-    fn is_dirty(&self) -> bool {
-        self.dirty
-    }
-
-    fn set_dirty(&mut self, value: bool) {
-        self.dirty = value;
-    }
-
-    fn kill(&mut self, uuid: ComponentId, context: &mut Context) {
-        debug_assert!(uuid == self.id);
-        context.replies.push_back(UIEvent::Action(Tab(Kill(uuid))));
-    }
-
-    fn shortcuts(&self, context: &Context) -> ShortcutMaps {
-        let mut map = ShortcutMaps::default();
-
-        map.insert(
-            Shortcuts::GENERAL,
-            context.settings.shortcuts.general.key_values(),
-        );
-        map[Shortcuts::GENERAL].insert("sort by 1st column", Key::Char('1'));
-        map[Shortcuts::GENERAL].insert("sort by 2nd column", Key::Char('2'));
-        map[Shortcuts::GENERAL].insert("sort by 3rd column", Key::Char('3'));
-        map[Shortcuts::GENERAL].insert("sort by 4th column", Key::Char('4'));
-        map[Shortcuts::GENERAL].insert("sort by 5th column", Key::Char('5'));
-
-        map
-    }
-
-    fn id(&self) -> ComponentId {
-        self.id
-    }
-
-    fn can_quit_cleanly(&mut self, _context: &Context) -> bool {
-        true
-    }
-
-    fn status(&self, _context: &Context) -> String {
-        format!(
-            "{} entries. Use `sort <n> [asc/desc]` command or press column index number key \
-             (twice to toggle asc/desc) to sort",
-            self.entries.len()
-        )
-    }
-}

meli/src/lib.rs

@@ -1,161 +0,0 @@
-/*
- * meli - lib.rs
- *
- * Copyright 2017-2022 Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-#![deny(
-    rustdoc::redundant_explicit_links,
-    /* groups */
-    clippy::correctness,
-    clippy::suspicious,
-    clippy::complexity,
-    clippy::perf,
-    clippy::cargo,
-    clippy::nursery,
-    clippy::style,
-    /* restriction */
-    clippy::dbg_macro,
-    clippy::rc_buffer,
-    clippy::as_underscore,
-    clippy::assertions_on_result_states,
-    /* rustdoc */
-    rustdoc::broken_intra_doc_links,
-    /* pedantic */
-    //clippy::cast_lossless,
-    //clippy::cast_possible_wrap,
-    //clippy::ptr_as_ptr,
-    clippy::doc_markdown,
-    clippy::expect_fun_call,
-    clippy::bool_to_int_with_if,
-    clippy::borrow_as_ptr,
-    clippy::cast_ptr_alignment,
-    clippy::large_futures,
-    clippy::waker_clone_wake,
-    clippy::unused_enumerate_index,
-    clippy::unnecessary_fallible_conversions,
-    clippy::struct_field_names,
-    clippy::manual_hash_one,
-    clippy::into_iter_without_iter,
-)]
-#![allow(
-    clippy::option_if_let_else,
-    clippy::missing_const_for_fn,
-    clippy::significant_drop_tightening,
-    clippy::multiple_crate_versions,
-    clippy::significant_drop_in_scrutinee,
-    clippy::cognitive_complexity,
-    clippy::manual_clamp
-)]
-/* Source Code Annotation Tags:
- *
- * Global tags (in tagref format <https://github.com/stepchowfun/tagref>) for source code
- * annotation:
- *
- * - tags from melib/src/lib.rs.
- * - [tag:hardcoded_color_value] Replace hardcoded color values with user configurable ones.
- */
-
-//!
-//!  This crate contains the frontend stuff of the application. The application
-//! entry way on  `src/bin.rs` creates an event loop and passes input to a
-//! thread.
-//!
-//! The mail handling stuff is done in the `melib` crate which includes all
-//! backend needs. The split is done to theoretically be able to create
-//! different frontends with the same innards.
-
-use std::alloc::System;
-pub use std::{collections::VecDeque, path::PathBuf};
-
-#[macro_use]
-extern crate serde_derive;
-extern crate linkify;
-pub use melib::uuid;
-
-pub extern crate bitflags;
-pub extern crate serde_json;
-pub extern crate smallvec;
-pub extern crate termion;
-
-pub use structopt::StructOpt;
-
-#[global_allocator]
-static GLOBAL: System = System;
-
-pub extern crate melib;
-pub use melib::{
-    error::*, log, AccountHash, ActionFlag, Envelope, EnvelopeHash, EnvelopeRef, Flag, LogLevel,
-    Mail, Mailbox, MailboxHash, ThreadHash, ToggleFlag,
-};
-
-pub mod args;
-pub mod subcommands;
-
-#[macro_use]
-pub mod types;
-pub use crate::types::*;
-
-#[macro_use]
-pub mod terminal;
-pub use crate::terminal::*;
-
-#[macro_use]
-pub mod command;
-pub use crate::command::*;
-
-pub mod state;
-pub use crate::state::*;
-
-pub mod components;
-pub use crate::components::*;
-
-pub mod utilities;
-pub use crate::utilities::*;
-
-pub mod contacts;
-pub use crate::contacts::*;
-
-pub mod mail;
-pub use crate::mail::*;
-
-pub mod notifications;
-
-pub mod mailbox_management;
-pub use mailbox_management::*;
-
-pub mod jobs_view;
-pub use jobs_view::*;
-
-#[cfg(feature = "svgscreenshot")]
-pub mod svg;
-
-#[macro_use]
-pub mod conf;
-pub use crate::conf::{
-    DotAddressable, IndexStyle, SearchBackend, Settings, Shortcuts, ThemeAttribute,
-};
-
-#[cfg(feature = "sqlite3")]
-pub mod sqlite3;
-
-pub mod jobs;
-pub mod mailcap;
-
-pub mod accounts;
-pub use self::accounts::Account;

meli/src/mail/compose/edit_attachments.rs

@@ -1,330 +0,0 @@
-/*
- * meli -
- *
- * Copyright  Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use super::*;
-
-#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
-pub enum EditAttachmentCursor {
-    AttachmentNo(usize),
-    #[default]
-    Buttons,
-}
-
-#[derive(Debug)]
-pub enum EditAttachmentMode {
-    Overview,
-    Edit {
-        inner: Box<FormWidget<FormButtonActions>>,
-        no: usize,
-    },
-}
-
-#[derive(Debug)]
-pub struct EditAttachments {
-    /// For shortcut setting retrieval.
-    pub account_hash: Option<AccountHash>,
-    pub mode: EditAttachmentMode,
-    pub buttons: ButtonWidget<FormButtonActions>,
-    pub cursor: EditAttachmentCursor,
-    pub dirty: bool,
-    pub id: ComponentId,
-}
-
-impl EditAttachments {
-    pub fn new(account_hash: Option<AccountHash>) -> Self {
-        //ButtonWidget::new(("Add".into(), FormButtonActions::Other("add")));
-        let mut buttons = ButtonWidget::new(("Go Back".into(), FormButtonActions::Cancel));
-        buttons.set_focus(true);
-        buttons.set_cursor(1);
-        Self {
-            account_hash,
-            mode: EditAttachmentMode::Overview,
-            buttons,
-            cursor: EditAttachmentCursor::Buttons,
-            dirty: true,
-            id: ComponentId::default(),
-        }
-    }
-}
-
-impl EditAttachmentsRefMut<'_, '_> {
-    fn new_edit_widget(
-        &self,
-        no: usize,
-        context: &Context,
-    ) -> Option<Box<FormWidget<FormButtonActions>>> {
-        if no >= self.draft.attachments().len() {
-            return None;
-        }
-        let filename = self.draft.attachments()[no].content_type().name();
-        let mime_type = self.draft.attachments()[no].content_type();
-        let shortcuts = self.shortcuts(context);
-
-        let mut ret = FormWidget::new(
-            ("Save".into(), FormButtonActions::Accept),
-            /* cursor_up_shortcut */
-            shortcuts
-                .get(Shortcuts::COMPOSING)
-                .and_then(|c| c.get("scroll_up").cloned())
-                .unwrap_or_else(|| context.settings.shortcuts.composing.scroll_up.clone()),
-            /* cursor_down_shortcut */
-            shortcuts
-                .get(Shortcuts::COMPOSING)
-                .and_then(|c| c.get("scroll_down").cloned())
-                .unwrap_or_else(|| context.settings.shortcuts.composing.scroll_down.clone()),
-        );
-
-        ret.add_button(("Reset".into(), FormButtonActions::Reset));
-        ret.add_button(("Cancel".into(), FormButtonActions::Cancel));
-        ret.push(("Filename".into(), filename.unwrap_or_default().to_string()));
-        ret.push(("Mime type".into(), mime_type.to_string()));
-        Some(Box::new(ret))
-    }
-}
-
-#[derive(Debug)]
-pub struct EditAttachmentsRefMut<'a, 'b> {
-    pub inner: &'a mut EditAttachments,
-    pub draft: &'b mut Draft,
-}
-
-impl std::fmt::Display for EditAttachmentsRefMut<'_, '_> {
-    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-        write!(f, "edit attachments")
-    }
-}
-
-impl Component for EditAttachmentsRefMut<'_, '_> {
-    fn draw(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context) {
-        if let EditAttachmentMode::Edit {
-            ref mut inner,
-            no: _,
-        } = self.inner.mode
-        {
-            inner.draw(grid, area, context);
-        } else if self.is_dirty() {
-            let attachments_no = self.draft.attachments().len();
-            let theme_default = crate::conf::value(context, "theme_default");
-            grid.clear_area(area, theme_default);
-            if attachments_no == 0 {
-                grid.write_string(
-                    "no attachments",
-                    theme_default.fg,
-                    theme_default.bg,
-                    theme_default.attrs,
-                    area,
-                    None,
-                );
-            } else {
-                grid.write_string(
-                    &format!("{} attachments ", attachments_no),
-                    theme_default.fg,
-                    theme_default.bg,
-                    theme_default.attrs,
-                    area,
-                    None,
-                );
-                for (i, a) in self.draft.attachments().iter().enumerate() {
-                    let bg = if let EditAttachmentCursor::AttachmentNo(u) = self.inner.cursor {
-                        if u == i {
-                            crate::conf::value(context, "highlight").bg
-                        } else {
-                            theme_default.bg
-                        }
-                    } else {
-                        theme_default.bg
-                    };
-                    grid.write_string(
-                        &if let Some(name) = a.content_type().name() {
-                            format!(
-                                "[{}] \"{}\", {} {}",
-                                i,
-                                name,
-                                a.content_type(),
-                                melib::BytesDisplay(a.raw.len())
-                            )
-                        } else {
-                            format!(
-                                "[{}] {} {}",
-                                i,
-                                a.content_type(),
-                                melib::BytesDisplay(a.raw.len())
-                            )
-                        },
-                        theme_default.fg,
-                        bg,
-                        theme_default.attrs,
-                        area.skip(2, 2 + i),
-                        None,
-                    );
-                }
-            }
-            self.inner.buttons.draw(
-                grid,
-                area.skip_rows(3 + self.draft.attachments().len()),
-                context,
-            );
-            self.set_dirty(false);
-            context.dirty_areas.push_back(area);
-        }
-    }
-
-    fn process_event(&mut self, event: &mut UIEvent, context: &mut Context) -> bool {
-        if let EditAttachmentMode::Edit {
-            ref mut inner,
-            ref no,
-        } = self.inner.mode
-        {
-            if inner.process_event(event, context) {
-                match inner.buttons_result() {
-                    Some(FormButtonActions::Accept) | Some(FormButtonActions::Cancel) => {
-                        self.inner.mode = EditAttachmentMode::Overview;
-                    }
-                    Some(FormButtonActions::Reset) => {
-                        let no = *no;
-                        if let Some(inner) = self.new_edit_widget(no, context) {
-                            self.inner.mode = EditAttachmentMode::Edit { inner, no };
-                        }
-                    }
-                    Some(_) | None => {}
-                }
-                return true;
-            }
-        } else {
-            let shortcuts = self.shortcuts(context);
-
-            match event {
-                UIEvent::Input(ref key)
-                    if shortcut!(key == shortcuts[Shortcuts::COMPOSING]["scroll_up"]) =>
-                {
-                    self.set_dirty(true);
-                    match self.inner.cursor {
-                        EditAttachmentCursor::AttachmentNo(ref mut n) => {
-                            if self.draft.attachments().is_empty() {
-                                self.inner.cursor = EditAttachmentCursor::Buttons;
-                                self.inner.buttons.set_focus(true);
-                                self.inner.buttons.process_event(event, context);
-                                return true;
-                            }
-                            *n = n.saturating_sub(1);
-                        }
-                        EditAttachmentCursor::Buttons => {
-                            if !self.inner.buttons.process_event(event, context) {
-                                self.inner.buttons.set_focus(false);
-                                if self.draft.attachments().is_empty() {
-                                    return true;
-                                }
-                                self.inner.cursor = EditAttachmentCursor::AttachmentNo(
-                                    self.draft.attachments().len() - 1,
-                                );
-                            }
-                        }
-                    }
-                    return true;
-                }
-                UIEvent::Input(ref key)
-                    if shortcut!(key == shortcuts[Shortcuts::COMPOSING]["scroll_down"]) =>
-                {
-                    self.set_dirty(true);
-                    match self.inner.cursor {
-                        EditAttachmentCursor::AttachmentNo(ref mut n) => {
-                            if *n + 1 == self.draft.attachments().len() {
-                                self.inner.cursor = EditAttachmentCursor::Buttons;
-                                self.inner.buttons.set_focus(true);
-                                self.inner.buttons.process_event(event, context);
-                                return true;
-                            }
-                            *n += 1;
-                        }
-                        EditAttachmentCursor::Buttons => {
-                            self.inner.buttons.set_focus(true);
-                            self.inner.buttons.process_event(event, context);
-                        }
-                    }
-                    return true;
-                }
-                UIEvent::Input(Key::Char('\n')) => {
-                    match self.inner.cursor {
-                        EditAttachmentCursor::AttachmentNo(ref no) => {
-                            if let Some(inner) = self.new_edit_widget(*no, context) {
-                                self.inner.mode = EditAttachmentMode::Edit { inner, no: *no };
-                            }
-                            self.set_dirty(true);
-                        }
-                        EditAttachmentCursor::Buttons => {
-                            self.inner.buttons.process_event(event, context);
-                        }
-                    }
-                    return true;
-                }
-                _ => {
-                    if self.inner.cursor == EditAttachmentCursor::Buttons
-                        && self.inner.buttons.process_event(event, context)
-                    {
-                        return true;
-                    }
-                }
-            }
-        }
-        false
-    }
-
-    fn is_dirty(&self) -> bool {
-        self.inner.dirty
-            || self.inner.buttons.is_dirty()
-            || if let EditAttachmentMode::Edit { ref inner, no: _ } = self.inner.mode {
-                inner.is_dirty()
-            } else {
-                false
-            }
-    }
-
-    fn set_dirty(&mut self, value: bool) {
-        self.inner.dirty = value;
-        self.inner.buttons.set_dirty(value);
-        if let EditAttachmentMode::Edit {
-            ref mut inner,
-            no: _,
-        } = self.inner.mode
-        {
-            inner.set_dirty(value);
-        }
-    }
-
-    fn kill(&mut self, _uuid: ComponentId, _context: &mut Context) {}
-
-    fn shortcuts(&self, context: &Context) -> ShortcutMaps {
-        let mut map = ShortcutMaps::default();
-
-        let our_map: ShortcutMap = self
-            .inner
-            .account_hash
-            .map(|acc| account_settings!(context[acc].shortcuts.composing).key_values())
-            .unwrap_or_else(|| context.settings.shortcuts.composing.key_values());
-        map.insert(Shortcuts::COMPOSING, our_map);
-
-        map
-    }
-
-    fn id(&self) -> ComponentId {
-        self.inner.id
-    }
-}

meli/src/mail/compose/gpg.rs

@@ -1,267 +0,0 @@
-/*
- * meli
- *
- * Copyright 2020  Manos Pitsidianakis
- *
- * This file is part of meli.
- *
- * meli is free software: you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation, either version 3 of the License, or
- * (at your option) any later version.
- *
- * meli is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License
- * along with meli. If not, see <http://www.gnu.org/licenses/>.
- */
-
-use super::*;
-
-#[derive(Debug)]
-pub enum KeySelection {
-    LoadingKeys {
-        handle: JoinHandle<Result<Vec<melib::gpgme::Key>>>,
-        progress_spinner: ProgressSpinner,
-        secret: bool,
-        local: bool,
-        pattern: String,
-        allow_remote_lookup: ActionFlag,
-    },
-    Error {
-        id: ComponentId,
-        err: Error,
-    },
-    Loaded {
-        widget: Box<UIDialog<melib::gpgme::Key>>,
-        keys: Vec<melib::gpgme::Key>,
-    },
-}
-
-impl std::fmt::Display for KeySelection {
-    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
-        write!(f, "select pgp keys")
-    }
-}
-
-impl KeySelection {
-    pub fn new(
-        secret: bool,
-        local: bool,
-        pattern: String,
-        allow_remote_lookup: ActionFlag,
-        context: &Context,
-    ) -> Result<Self> {
-        use melib::gpgme::*;
-        let mut ctx = Context::new()?;
-        if local {
-            ctx.set_auto_key_locate(LocateKey::LOCAL)?;
-        } else {
-            ctx.set_auto_key_locate(LocateKey::WKD | LocateKey::LOCAL)?;
-        }
-        let job = ctx.keylist(secret, Some(pattern.clone()))?;
-        let handle = context
-            .main_loop_handler
-            .job_executor
-            .spawn_specialized("gpg::keylist".into(), job);
-        let mut progress_spinner = ProgressSpinner::new(8, context);
-        progress_spinner.start();
-        Ok(Self::LoadingKeys {
-            handle,
-            secret,
-            local,
-            pattern,
-            allow_remote_lookup,
-            progress_spinner,
-        })
-    }
-}
-
-impl Component for KeySelection {
-    fn draw(&mut self, grid: &mut CellBuffer, area: Area, context: &mut Context) {
-        match self {
-            Self::LoadingKeys {
-                ref mut progress_spinner,
-                ..
-            } => progress_spinner.draw(grid, area.center_inside((2, 2)), context),
-            Self::Error { ref err, .. } => {
-                let theme_default = crate::conf::value(context, "theme_default");
-                grid.write_string(
-                    &err.to_string(),
-                    theme_default.fg,
-                    theme_default.bg,
-                    theme_default.attrs,
-                    area.center_inside((15, 2)),
-                    Some(0),
-                );
-            }
-            Self::Loaded { ref mut widget, .. } => widget.draw(grid, area, context),
-        }
-    }
-
-    fn process_event(&mut self, event: &mut UIEvent, context: &mut Context) -> bool {
-        match self {
-            Self::LoadingKeys {
-                ref mut progress_spinner,
-                ref mut handle,
-                secret,
-                local,
-                ref mut pattern,
-                allow_remote_lookup,
-                ..
-            } => match event {
-                UIEvent::StatusEvent(StatusEvent::JobFinished(ref id)) if *id == handle.job_id => {
-                    match handle.chan.try_recv() {
-                        Err(_) => { /* Job was canceled */ }
-                        Ok(None) => { /* something happened, perhaps a worker thread panicked */ }
-                        Ok(Some(Ok(keys))) => {
-                            if keys.is_empty() {
-                                let id = progress_spinner.id();
-                                if allow_remote_lookup.is_true() {
-                                    match Self::new(
-                                        *secret,
-                                        *local,
-                                        std::mem::take(pattern),
-                                        *allow_remote_lookup,
-                                        context,
-                                    ) {
-                                        Ok(w) => {
-                                            *self = w;
-                                        }
-                                        Err(err) => *self = Self::Error { err, id },
-                                    }
-                                } else if !*local && allow_remote_lookup.is_ask() {
-                                    *self = Self::Error {
-                                        err: Error::new(format!(
-                                            "No keys found for {}, perform remote lookup?",
-                                            pattern
-                                        )),
-                                        id,
-                                    }
-                                } else {
-                                    *self = Self::Error {
-                                        err: Error::new(format!("No keys found for {}.", pattern)),
-                                        id,
-                                    }
-                                }
-                                if let Self::Error { ref err, .. } = self {
-                                    context.replies.push_back(UIEvent::StatusEvent(
-                                        StatusEvent::DisplayMessage(err.to_string()),
-                                    ));
-                                    let res: Option<melib::gpgme::Key> = None;
-                                    context
-                                        .replies
-                                        .push_back(UIEvent::FinishedUIDialog(id, Box::new(res)));
-                                }
-                                return false;
-                            }
-                            let mut widget = Box::new(UIDialog::new(
-                                "select key",
-                                keys.iter()
-                                    .map(|k| {
-                                        (
-                                            k.clone(),
-                                            if let Some(primary_uid) = k.primary_uid() {
-                                                format!("{} {}", k.fingerprint(), primary_uid)
-                                            } else {
-                                                k.fingerprint().to_string()
-                                            },
-                                        )
-                                    })
-                                    .collect::<Vec<(melib::gpgme::Key, String)>>(),
-                                true,
-                                Some(Box::new(
-                                    move |id: ComponentId, results: &[melib::gpgme::Key]| {
-                                        Some(UIEvent::FinishedUIDialog(
-                                            id,
-                                            Box::new(results.first().cloned()),
-                                        ))
-                                    },
-                                )),
-                                context,
-                            ));
-                            widget.set_dirty(true);
-                            *self = Self::Loaded { widget, keys };
-                        }
-                        Ok(Some(Err(err))) => {
-                            *self = Self::Error {
-                                err,
-                                id: ComponentId::default(),
-                            };
-                        }
-                    }
-                    false
-                }
-                _ => progress_spinner.process_event(event, context),
-            },
-            Self::Error { .. } => false,
-            Self::Loaded { ref mut widget, .. } => widget.process_event(event, context),
-        }
-    }
-
-    fn is_dirty(&self) -> bool {
-        match self {
-            Self::LoadingKeys {
-                ref progress_spinner,
-                ..
-            } => progress_spinner.is_dirty(),
-            Self::Error { .. } => true,
-            Self::Loaded { ref widget, .. } => widget.is_dirty(),
-        }
-    }
-
-    fn set_dirty(&mut self, value: bool) {
-        match self {
-            Self::LoadingKeys {
-                ref mut progress_spinner,
-                ..
-            } => progress_spinner.set_dirty(value),
-            Self::Error { .. } => {}
-            Self::Loaded { ref mut widget, .. } => widget.set_dirty(value),
-        }
-    }
-
-    fn kill(&mut self, _uuid: ComponentId, _context: &mut Context) {}
-
-    fn shortcuts(&self, context: &Context) -> ShortcutMaps {
-        match self {
-            Self::LoadingKeys { .. } | Self::Error { .. } => ShortcutMaps::default(),
-            Self::Loaded { ref widget, .. } => widget.shortcuts(context),
-        }
-    }
-
-    fn id(&self) -> ComponentId {
-        match self {
-            Self::LoadingKeys {
-                ref progress_spinner,
-                ..
-            } => progress_spinner.id(),
-            Self::Error { ref id, .. } => *id,
-            Self::Loaded { ref widget, .. } => widget.id(),
-        }
-    }
-}
-
-#[derive(Clone, Debug)]
-pub struct GpgComposeState {
-    pub sign_mail: Option<ActionFlag>,
-    pub encrypt_mail: Option<ActionFlag>,
-    pub encrypt_keys: Vec<melib::gpgme::Key>,
-    pub encrypt_for_self: bool,
-    pub sign_keys: Vec<melib::gpgme::Key>,
-}
-
-impl Default for GpgComposeState {
-    fn default() -> Self {
-        Self {
-            sign_mail: None,
-            encrypt_mail: None,
-            encrypt_keys: vec![],
-            encrypt_for_self: true,
-            sign_keys: vec![],
-        }
-    }
-}