mastodonpp::Instance Class Reference

Holds the access data of an instance. More...

#include <mastodonpp/instance.hpp>

Inheritance diagram for mastodonpp::Instance:

Public Member Functions
	Instance (string hostname, string access_token)
	Construct a new Instance object. More...
string_view	get_hostname () const
	Returns the hostname. More...
string_view	get_baseuri () const
	Returns the base URI. More...
string_view	get_access_token () const
	Returns the access token. More...
uint64_t	get_max_chars () const
	Returns the maximum number of characters per post. More...
Public Member Functions inherited from mastodonpp::CURLWrapper
	CURLWrapper ()
	Initializes curl and sets up connection. More...
	CURLWrapper (const CURLWrapper &other)=default
	Copy constructor. More...
	CURLWrapper (CURLWrapper &&other) noexcept=default
	Move constructor. More...
virtual	~CURLWrapper () noexcept
	Cleans up curl and connection. More...
CURLWrapper &	operator= (const CURLWrapper &other)=default
	Copy assignment operator. More...
CURLWrapper &	operator= (CURLWrapper &&other) noexcept=default
	Move assignment operator. More...
answer_type	make_request (const http_method &method, const string_view &uri)
	Make a request. More...

Detailed Description

Holds the access data of an instance.

Since

0.1.0

Constructor & Destructor Documentation

Instance()

mastodonpp::Instance::Instance ( string  hostname, string  access_token  )

explicit

Construct a new Instance object.

Also queries /api/v1/instance for ‘max_toot_chars’.

Parameters

hostname	The hostname of the instance.
access_token	Your access token.

Since

0.1.0

    : _hostname{move(hostname)}
    , _baseuri{"https://" + _hostname}
    , _access_token{move(access_token)}
    , _max_chars{500}
{
    try
    {
        const auto answer{make_request(http_method::GET,
                                       _baseuri + "/api/v1/instance")};
        if (answer)
        {
            debuglog << "Querying instance for max_toot_chars…\n";
            auto &body{answer.body};
            size_t pos_start{body.find("max_toot_chars")};
            if (pos_start == string::npos)
            {
                debuglog << "max_toot_chars not found.";
                return;
            }
            pos_start = body.find(':', pos_start) + 1;
            const size_t pos_end{body.find(',', pos_start)};
 
            const auto max_toot_chars{body.substr(pos_start,
                                                  pos_end - pos_start)};
            _max_chars = std::stoull(max_toot_chars);
            debuglog << "Set _max_chars to: " << _max_chars << '\n';
        }
    }
    catch (const std::exception &e)
    {
        debuglog << "Unexpected exception: " << e.what() << '\n';
    }
}

Member Function Documentation

get_access_token()

string_view mastodonpp::Instance::get_access_token ( ) const

inline

Returns the access token.

Since

0.1.0

    {
        return _access_token;
    }

get_baseuri()

string_view mastodonpp::Instance::get_baseuri ( ) const

inline

Returns the base URI.

The base URI is “https://” + the hostname.

Since

0.1.0

    {
        return _baseuri;
    }

get_hostname()

string_view mastodonpp::Instance::get_hostname ( ) const

inline

Returns the hostname.

Since

0.1.0

    {
        return _hostname;
    }

get_max_chars()

uint64_t mastodonpp::Instance::get_max_chars ( ) const

inline

Returns the maximum number of characters per post.

Since

0.1.0

    {
        return _max_chars;
    }

---

The documentation for this class was generated from the following files:

• include/instance.hpp
• src/instance.cpp