cppTBot is a C++ library for creating and managing bot applications. This repository provides the necessary files and instructions to integrate cppTBot into your CMake-based project using CMake's FetchContent module.
- CMake 3.14 or higher
- C++17 or higher compiler
To use cppTBot in your project, you can utilize CMake's FetchContent module. Below is a full sample CMakeLists.txt file to demonstrate how to integrate cppTBot into your project.
cmake_minimum_required(VERSION 3.14)
project(MyBotApp VERSION 1.0 LANGUAGES CXX)
# Specify the C++ standard
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED True)
# Include FetchContent module
include(FetchContent)
# Fetch cppTBot from GitHub
FetchContent_Declare(
cppTBot
GIT_REPOSITORY https://github.com/ignacionr/cpptbot.git
GIT_TAG main # You can specify a particular commit, tag, or branch here
)
# Make cppTBot available
FetchContent_MakeAvailable(cppTBot)
# Add your executable
add_executable(MyBotApp src/main.cpp)
# Specify the include directory for nlohmann_json
target_include_directories(MyBotApp PRIVATE
${CMAKE_BINARY_DIR}/_deps/cpptbot-src/include
)
target_link_libraries(MyBotApp PRIVATE cpr::cpr nlohmann_json::nlohmann_json)
Here is a simple example of main.cpp to get you started with cppTBot.
#include <fstream>
#include <iostream>
#include <memory>
#include <unordered_set>
#include <nlohmann/json.hpp>
#include <cpptbot.hpp>
template<typename chat_t, typename msg_t>
class parrot {
public:
parrot(chat_t &chat): chat_{chat} {
chat.receive(*this);
}
void operator()(msg_t msg) {
std::cerr << "repeating: " << msg.dump() << std::endl;
chat_.send(msg);
if (--count_ < 0) {
chat_.send({{"text", "This session is over."}});
chat_.receive({});
}
}
private:
chat_t &chat_;
int count_{3};
};
uint64_t read_last_chat_id() {
uint64_t result{};
std::ifstream in("last_chat.txt");
if (in.is_open()) {
in >> result;
}
return result;
}
void write_last_chat_id(uint64_t value) {
std::ofstream out("last_chat.txt");
out << value;
}
int main() {
// Read API key from environment variable
const char* env_api_key = std::getenv("TBOT_SAMPLE_KEY");
if (env_api_key == nullptr)
{
std::cerr << "Error: TBOT_SAMPLE_KEY environment variable not set." << std::endl;
return 1;
}
using parrot_t = parrot<ignacionr::chat<nlohmann::json>,nlohmann::json>;
std::unordered_set<std::unique_ptr<parrot_t>> parrots;
ignacionr::cpptbot bot{env_api_key};
// reopen last chat
if (auto last_chat = read_last_chat_id(); last_chat) {
auto &chat = bot.chat_from_id(last_chat);
chat.send({{"text", "and, we're back!"}});
parrots.emplace(new parrot_t(chat));
}
bot.poll([&parrots](auto &chat, auto chat_id) {
write_last_chat_id(chat_id);
parrots.emplace(new parrot_t(chat));
});
}- Create a
CMakeLists.txtfile in your project's root directory as shown above. - Create a
main.cppfile or other source files as needed. - Create a build directory and run CMake and your build tool:
mkdir build
cd build
cmake ..
cmake --build .- Run your application:
./MyBotAppinclude/- Header file for cppTBotsrc/- Source files for cppTBotsample/- Sample CMakeLists and source filestests/- Unit tests for cppTBot
Contributions are welcome! Please fork the repository and submit a pull request with your changes.
This project is licensed under the MIT License - see the LICENSE file for details.
For any questions or support, please open an issue on the repository or contact the maintainer.