mastodonpp::Connection Class Reference

Represents a connection to an instance. Used for requests. More...

#include <mastodonpp/connection.hpp>

Inheritance diagram for mastodonpp::Connection:

Public Member Functions
	Connection (Instance &instance)
	Construct a new Connection object. More...
answer_type	get (const endpoint_variant &endpoint, const parametermap &parameters)
	Make a HTTP GET call with parameters. More...
answer_type	get (const endpoint_variant &endpoint)
	Make a HTTP GET call. More...
answer_type	post (const endpoint_variant &endpoint, const parametermap &parameters)
	Make a HTTP POST call with parameters. More...
answer_type	post (const endpoint_variant &endpoint)
	Make a HTTP POST call. More...
answer_type	patch (const endpoint_variant &endpoint, const parametermap &parameters)
	Make a HTTP PATCH call with parameters. More...
answer_type	patch (const endpoint_variant &endpoint)
	Make a HTTP PATCH call. More...
answer_type	put (const endpoint_variant &endpoint, const parametermap &parameters)
	Make a HTTP PUT call with parameters. More...
answer_type	put (const endpoint_variant &endpoint)
	Make a HTTP PUT call. More...
answer_type	del (const endpoint_variant &endpoint, const parametermap &parameters)
	Make a HTTP DELETE call with parameters. More...
answer_type	del (const endpoint_variant &endpoint)
	Make a HTTP DELETE call. More...
string	get_new_stream_contents ()
	Copy new stream contents and delete the “original”. More...
vector< event_type >	get_new_events ()
	Get new stream events. More...
void	cancel_stream ()
	Cancel the stream. More...
Public Member Functions inherited from mastodonpp::CURLWrapper
	CURLWrapper ()
	Initializes curl and sets up connection. More...
	CURLWrapper (const CURLWrapper &other)=delete
	Copy constructor. More...
	CURLWrapper (CURLWrapper &&other) noexcept=delete
	Move constructor. More...
virtual	~CURLWrapper () noexcept
	Cleans up curl and connection. More...
CURLWrapper &	operator= (const CURLWrapper &other)=delete
	Copy assignment operator. More...
CURLWrapper &	operator= (CURLWrapper &&other) noexcept=delete
	Move assignment operator. More...
CURL *	get_curl_easy_handle ()
	Returns pointer to the CURL easy handle. More...
string	escape_url (const string_view url) const
	URL encodes the given string. More...
string	unescape_url (const string_view url) const
	URL decodes the given string. More...
void	setup_connection_properties (string_view proxy, string_view access_token, string_view cainfo, string_view useragent)
	Set some properties of the connection. More...

Additional Inherited Members
Protected Member Functions inherited from mastodonpp::CURLWrapper
answer_type	make_request (const http_method &method, string uri, const parametermap &parameters)
	Make a HTTP request. More...
string &	get_buffer ()
	Returns a reference to the buffer libcurl writes into. More...
void	cancel_stream ()
	Cancel the stream. More...
virtual void	set_proxy (string_view proxy)
	Set the proxy to use. More...
void	set_access_token (string_view access_token)
	Set OAuth 2.0 Bearer Access Token. More...
virtual void	set_cainfo (string_view path)
	Set path to Certificate Authority (CA) bundle. More...
virtual void	set_useragent (string_view useragent)
	Sets the User-Agent. More...
Protected Attributes inherited from mastodonpp::CURLWrapper
mutex	_buffer_mutex
	Mutex for get_buffer a.k.a. _curl_buffer_body. More...

Detailed Description

Represents a connection to an instance. Used for requests.

Do not make 2 requests with the same Connection at the same time. You can create as many Connections as you want from one Instance.

Since

0.1.0

Constructor & Destructor Documentation

Connection()

mastodonpp::Connection::Connection ( Instance &  instance )

inlineexplicit

Construct a new Connection object.

Parameters

instance

An Instance with the access data.

Since

0.1.0

        : _instance{instance}
        , _baseuri{instance.get_baseuri()}
    {
        _instance.copy_connection_properties(*this);
    }

Member Function Documentation

cancel_stream()

void mastodonpp::Connection::cancel_stream ( )

inline

Cancel the stream.

The stream will be cancelled, usually whithin a second. The curl_error_code of the answer will be set to 42 (CURLE_ABORTED_BY_CALLBACK).

Since

0.1.0

    {
        CURLWrapper::cancel_stream();
    }

del() [1/2]

answer_type mastodonpp::Connection::del ( const endpoint_variant &  endpoint )

inline

Make a HTTP DELETE call.

Parameters

endpoint

Endpoint as API::endpoint_type or std::string_view.

Since

0.2.0

    {
        return del(endpoint, {});
    }

del() [2/2]

answer_type mastodonpp::Connection::del	(	const endpoint_variant &	endpoint,
		const parametermap &	parameters
	)

Make a HTTP DELETE call with parameters.

Parameters

endpoint	Endpoint as API::endpoint_type or std::string_view.
parameters	A map of parameters.

Since

0.2.0

{
    return make_request(http_method::DELETE,
                        endpoint_to_uri(endpoint), parameters);
}

get() [1/2]

answer_type mastodonpp::Connection::get ( const endpoint_variant &  endpoint )

inline

Make a HTTP GET call.

Example:

auto answer{connection.get("/api/v1/instance")};

Parameters

endpoint

Endpoint as API::endpoint_type or std::string_view.

Since

0.1.0

    {
        return get(endpoint, {});
    }

get() [2/2]

answer_type mastodonpp::Connection::get	(	const endpoint_variant &	endpoint,
		const parametermap &	parameters
	)

Make a HTTP GET call with parameters.

Example:

auto answer{connection.get(mastodonpp::API::v1::accounts_id_followers,
                           {
                               {"id", "12"},
                               {"limit", "10"}
                           })};

Parameters

endpoint	Endpoint as API::endpoint_type or std::string_view.
parameters	A map of parameters.

Since

0.1.0

{
    return make_request(http_method::GET,
                        endpoint_to_uri(endpoint), parameters);
}

get_new_events()

vector< event_type > mastodonpp::Connection::get_new_events

(

)

Get new stream events.

Since

0.1.0

{
    _buffer_mutex.lock();
    auto &buffer{get_buffer()};
    vector<event_type> events;
 
    size_t pos{0};
    constexpr string_view search_event{"event: "};
    while ((pos = buffer.find(search_event)) != string::npos)
    {
        const auto endpos{buffer.find("\n\n", pos)};
        if (endpos == string::npos)
        {
            break;
        }
 
        event_type event;
        pos += search_event.size();
        event.type = buffer.substr(pos, buffer.find('\n', pos) - pos);
        constexpr string_view search_data{"data: "};
        pos = buffer.find(search_data) + search_data.size();
        event.data = buffer.substr(pos, endpos - pos);
        events.push_back(event);
 
        buffer.erase(0, endpos);
    }
 
    _buffer_mutex.unlock();
    return events;
}

get_new_stream_contents()

string mastodonpp::Connection::get_new_stream_contents

(

)

Copy new stream contents and delete the “original”.

Note that the last event is not necessarily complete, it could happen that you are calling this function mid-transfer. You have to check the data integrity yourself.

Using get_new_events() instead is recommended.

Since

0.1.0

{
    _buffer_mutex.lock();
    auto &buffer{get_buffer()};
    const string buffer_copy{buffer};
    buffer.clear();
    _buffer_mutex.unlock();
    return buffer_copy;
}

patch() [1/2]

answer_type mastodonpp::Connection::patch ( const endpoint_variant &  endpoint )

inline

Make a HTTP PATCH call.

Parameters

endpoint

Endpoint as API::endpoint_type or std::string_view.

Since

0.2.0

    {
        return patch(endpoint, {});
    }

patch() [2/2]

answer_type mastodonpp::Connection::patch	(	const endpoint_variant &	endpoint,
		const parametermap &	parameters
	)

Make a HTTP PATCH call with parameters.

Parameters

endpoint	Endpoint as API::endpoint_type or std::string_view.
parameters	A map of parameters.

Since

0.2.0

{
    return make_request(http_method::PATCH,
                        endpoint_to_uri(endpoint), parameters);
}

post() [1/2]

answer_type mastodonpp::Connection::post ( const endpoint_variant &  endpoint )

inline

Make a HTTP POST call.

Parameters

endpoint

Endpoint as API::endpoint_type or std::string_view.

Since

0.1.0

    {
        return post(endpoint, {});
    }

post() [2/2]

answer_type mastodonpp::Connection::post	(	const endpoint_variant &	endpoint,
		const parametermap &	parameters
	)

Make a HTTP POST call with parameters.

Example:

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

Parameters

endpoint	Endpoint as API::endpoint_type or std::string_view.
parameters	A map of parameters.

Since

0.1.0

{
    return make_request(http_method::POST,
                        endpoint_to_uri(endpoint), parameters);
}

put() [1/2]

answer_type mastodonpp::Connection::put ( const endpoint_variant &  endpoint )

inline

Make a HTTP PUT call.

Parameters

endpoint

Endpoint as API::endpoint_type or std::string_view.

Since

0.2.0

    {
        return put(endpoint, {});
    }

put() [2/2]

answer_type mastodonpp::Connection::put	(	const endpoint_variant &	endpoint,
		const parametermap &	parameters
	)

Make a HTTP PUT call with parameters.

Parameters

endpoint	Endpoint as API::endpoint_type or std::string_view.
parameters	A map of parameters.

Since

0.2.0

{
    return make_request(http_method::PUT,
                        endpoint_to_uri(endpoint), parameters);
}

---

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

• include/connection.hpp
• src/connection.cpp