mastodonpp

mastodonpp is a C++ wrapper for the Mastodon API. It replaces mastodon-cpp.

We aim to create a library that is comfortable, yet minimal. All API endpoints from Mastodon and Pleroma are stored in enum classes, to counteract typos and make your life easier. The network-facing code is built on libcurl, a mature and stable library that is available on virtually every operating system. The library does not parse the responses itself, but returns to you the raw data, because we know everyone has their favorite JSON library and we don’t want to impose our choice on you!

Table of Contents

• Features
• Usage
  • Example
• Install
  • From source

Features

This is still a work in progress; here is a rough overview of the features:

• ❏ Requests

  • ✓ GET requests.

  • ✓ Streaming GET requests.

  • ✓ POST requests.

  • ❏ PATCH requests.

  • ❏ PUT requests.

  • ❏ DELETE requests.

• ✓ Report maximum allowed character per post.

• ❏ Comfortable access to pagination headers.

• ❏ Comfortable function to register a new “app” (get an access token).

Usage

Have a look at the reference.

Example

#include "mastodonpp.hpp"
#include <iostream>

int main()
{
    mastodonpp::Instance instance{"example.com", {}};
    mastodonpp::Connection connection{instance};

    const mastodonpp::parametermap parameters
        {
            {"status", "How is the wheather?"},
            {"poll[options]", vector<string_view>{"Nice", "not nice"}},
            {"poll[expires_in]", "86400"}
        };
    auto answer{connection.post(mastodonpp::API::v1::statuses, parameters)};

    if (answer)
    {
        std::cout << answer << std::endl;
    }
}

More examples are included in the reference.

Install

From source

Dependencies

• Tested OS: Linux

• C++ compiler (tested: GCC 7/8/9, clang 6/7)

• CMake (at least: 3.9)

• libcurl (at least: 7.56)

• Optional

  • Documentation: Doxygen (tested: 1.8)

  • Tests: Catch (tested: 2.5 / 1.2)

  • DEB package: dpkg (tested: 1.18)

  • RPM package: rpm-build (tested: 4.11)

Get sourcecode

Release

Download the current release at schlomp.space.

Development version

git clone https://schlomp.space/tastytea/mastodonpp.git

Compile

mkdir -p build && cd build
cmake ..
cmake --build . -- -j$(nproc --ignore=1)

CMake options:

• -DCMAKE_BUILD_TYPE=Debug for a debug build.

• -DWITH_TESTS=YES if you want to compile the tests.

• -DWITH_EXAMPLES=YES if you want to compile the examples.

• One of:

  • -DWITH_DEB=YES if you want to be able to generate a deb-package.

  • -DWITH_RPM=YES if you want to be able to generate an rpm-package.

https://schlomp.space/tastytea/mastodonpp/raw/branch/main/CONTRIBUTING.adoc