ES-DE/es-core/src/AsyncHandle.h

//  SPDX-License-Identifier: MIT
//
//  EmulationStation Desktop Edition
//  AsyncHandle.h
//
//  Asynchronous operations used by GuiScraperSearch and Scraper.
//

#ifndef ES_CORE_ASYNC_HANDLE_H
#define ES_CORE_ASYNC_HANDLE_H

#include <string>

enum AsyncHandleStatus {
    ASYNC_IN_PROGRESS,
    ASYNC_ERROR,
    ASYNC_DONE
};

// Handle for some asynchronous operations.
class AsyncHandle
{
public:
    AsyncHandle() : mStatus(ASYNC_IN_PROGRESS) {};
    virtual ~AsyncHandle() {};

    virtual void update() = 0;

    // Update and return the latest status.
    inline AsyncHandleStatus status() { update(); return mStatus; }

    // User-friendly string of our current status.
    // Will return error message if status() == SEARCH_ERROR.
    inline std::string getStatusString()
    {
        switch (mStatus) {
            case ASYNC_IN_PROGRESS:
                return "in progress";
            case ASYNC_ERROR:
                return mError;
            case ASYNC_DONE:
                return "done";
            default:
                return "something impossible has occured; row, row, fight the power";
        }
    }

protected:
    inline void setStatus(AsyncHandleStatus status) { mStatus = status; }
    inline void setError(const std::string& error) { setStatus(ASYNC_ERROR); mError = error; }

    std::string mError;
    AsyncHandleStatus mStatus;
};

#endif // ES_CORE_ASYNC_HANDLE_H