A C++ wrapper for the basic C datatypes defined by the pEpEngine.
Go to file
heck 1e331a12a2 Doc: format README.md 2022-02-22 22:37:31 +01:00
src add .clang-format / reformat 2022-02-14 15:25:55 +01:00
test Build: more warnings etc... 2022-02-22 22:36:50 +01:00
.clang-format add .clang-format / reformat 2022-02-14 15:25:55 +01:00
.clang-tidy add .clang-tidy 2022-02-22 22:37:12 +01:00
.gitignore .gitignore 2022-02-14 15:28:18 +01:00
Design_de.md add German design document for libpEpDatatypes. 2021-10-06 19:18:51 +02:00
LICENSE Initial commit 2021-05-04 12:52:20 +02:00
Makefile make 'all' a PONY target. 2021-06-09 14:25:53 +02:00
Makefile.conf Build: more warnings etc... 2022-02-22 22:36:50 +01:00
README.md Doc: format README.md 2022-02-22 22:37:31 +01:00
local.conf.example Build: adds gtest prefix, clean out unused clutter 2022-02-14 15:28:09 +01:00


libpEpDatatypes A C++ wrapper for the basic C datatypes defined by the pEpEngine.


Requirements & Platforms

  • License: GPL3

  • C++ standard: C++11

  • supported compilers: at least gcc and clang (both have to work)

  • Build sytem: GNU Make Platforms: Linux, macOS ** Target: static library libpEpDatatypes.a

  • Windows and Android builds will be done separatly

Design goals & principles

  • implement move c'tor & operator for cheep moves
  • Qpen question: deep copy / shallow copy (with ref couning?) / only explicit copy?
  • always initialize all members. Better safe than sorry.
  • Ownership of the member pointees: rule of thumb: "const" pointees are non-owned, non-const pointees are owned by the data structure. Exceptional cases are documented explicitly.

Public API

  • defined in namespace pEp::DT
  • header files are installed in PREFIX/include/pEp/ and are used via #include <pEp/filename.hh> (Also shared with libpEpAdapter!)
  • the linked list datatypes implement the API of std::forward_list

Example usage

The following API is the target we're heading to:

#include <pEp/Types.hh>
#include <pEp/Adapter.hh>

int main()
    pEp::Message msg = "From: Alice Cooper <alice@mail.com>\n"
                       "To: Bob Smith <bob@mail.com>\n"
                       "Subject: Meeting\n"
                       "Dear Bob,\n"
                       "I will come.\n"

    try {
        auto enc = msg.encrypt();
    catch (pEp::err& e)

    return 0;

As an intermediate step the p≡p API in the engine must be fully supported:

#include <pEp/message_api.h> // from pEpEngine
#include <pEp/Types.hh>      // from libpEpDatatypes
#include <pEp/Adapter.hh>    // from libpEpDatatypes

int main()
    pEp::Message msg_plain =
            "From: Alice Cooper <alice@mail.com>\nTo: Bob "
            "Smith <bob@mail.com>\nSubject: Meeting\n\n"
            "Dear Bob,\n\nI will come.\n\nAlice."_CRLF;
    ::message* msg_enc = nullptr;
    PEP_STATUS status = encrypt_message(msg_plain, enc_enc, ...);
    pEp::Message msg{std::move(msg_enc)}; // ownership of the pointee goes to 'msg'
    return 0;

Implementation details

  • Code-formatting: clang-format. Please try and use .clang-format
  • Include guards: #ifdef/#define style (not #pragma once), naming style: LIBPEPDATATYPES_FILENAME_HH