Compare commits

..

3 Commits

10 changed files with 774 additions and 0 deletions

143
CMakeLists.txt Normal file
View File

@ -0,0 +1,143 @@
#
# Copyright (C) 2024 Dominik Meyer
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <https://www.gnu.org/licenses/>.
#
cmake_minimum_required (VERSION 3.1 FATAL_ERROR)
project (remine-api-cpp VERSION 0.0.1 LANGUAGES CXX)
list(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake/Modules )
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_EXPORT_COMPILE_COMMANDS 1)
include(compdb)
include(doxygen)
build_docs(PROCESS_DOXYFILE DOXYFILE_PATH "docs/Doxyfile.in" )
# generate project specific configuration file
configure_file(${PROJECT_SOURCE_DIR}/src/config.hpp.in ${PROJECT_SOURCE_DIR}/src/config.hpp @ONLY)
#
# All dependencies
#
IF (NOT TARGET CLI11)
set(CLI11_TESTING OFF CACHE BOOL "disable testing")
add_subdirectory(libs/CLI11 EXCLUDE_FROM_ALL)
ENDIF()
IF(NOT TARGET loguru)
set(LOGURU_BUILD_TESTS OFF CACHE BOOL "disable testing")
set(LOGURU_BUILD_EXAMPLES OFF CACHE BOOL "disable testing")
set(LOGURU_INSTALL OFF CACHE BOOL "disable testing")
set(LOGURU_WITH_STREAMS ON CACHE BOOL "disable testing")
add_subdirectory(libs/loguru EXCLUDE_FROM_ALL)
ENDIF()
IF(NOT TARGET nlohmann_json::nlohmann_json)
set(JSON_BuildTests OFF CACHE INTERNAL "")
add_subdirectory(libs/json EXCLUDE_FROM_ALL)
ENDIF()
IF(NOT TARGET httplib::httplib)
set(HTTPLIB_REQUIRE_OPENSSL OFF CACHE INTERNAL "")
set(HTTPLIB_TEST OFF CACHE INTERNAL "")
add_subdirectory(libs/cpp-httplib EXCLUDE_FROM_ALL)
ENDIF()
SET(REDMINE_LIBARIES loguru nlohmann_json::nlohmann_json httplib::httplib)
#
# all source files for the redmine api cpp library
#
SET(REDMINE_API_SOURCES
include/Redmine/Object.hpp
src/Redmine/Object.cpp
include/Redmine/User.hpp
src/Redmine/User.cpp
include/Redmine/API.hpp
src/Redmine/API.cpp
)
add_library(redmine-api-cpp-objlib OBJECT ${REDMINE_API_SOURCES})
set_property(TARGET redmine-api-cpp-objlib PROPERTY POSITION_INDEPENDENT_CODE 1)
target_include_directories(redmine-api-cpp-objlib
PUBLIC
include
PRIVATE
src
)
target_link_libraries(redmine-api-cpp-objlib PUBLIC ${REDMINE_LIBARIES})
add_library(redmine-api-cpp SHARED $<TARGET_OBJECTS:redmine-api-cpp-objlib>)
target_include_directories(redmine-api-cpp
PUBLIC
include
PRIVATE
src
)
target_link_libraries(redmine-api-cpp-objlib PUBLIC ${REDMINE_LIBARIES})
add_library(redmine-api-cpp-static STATIC $<TARGET_OBJECTS:redmine-api-cpp-objlib>)
target_include_directories(redmine-api-cpp-static
PUBLIC
include
PRIVATE
src
)
target_link_libraries(redmine-api-cpp-static PUBLIC ${REDMINE_LIBARIES})
add_executable(redmine-cli
src/Redmine-CLI/main.cpp
src/Redmine-CLI/Redmine.hpp
src/Redmine-CLI/Redmine.cpp
src/Redmine-CLI/Command/Version.hpp
src/Redmine-CLI/Command/Version.cpp
src/Redmine-CLI/Command/MyAccount.hpp
src/Redmine-CLI/Command/MyAccount.cpp
)
target_link_libraries(redmine-cli redmine-api-cpp-static loguru CLI11)
target_include_directories(redmine-cli
PRIVATE
src
)
IF(${REDMINE_API_TESTS})
IF(NOT TARGET Catch2)
add_subdirectory(libs/Catch2 EXCLUDE_FROM_ALL)
include(libs/Catch2/contrib/Catch.cmake)
ENDIF()
#
# add tests as executable
#
add_executable(test_event tests/test_event.cpp)
target_link_libraries(test_event Catch2::Catch2 eventmanager-static)
catch_discover_tests(test_event)
add_executable(test_basic tests/test_basic.cpp)
target_link_libraries(test_basic Catch2::Catch2 eventmanager-static)
catch_discover_tests(test_basic)
ENDIF()

View File

@ -147,6 +147,49 @@ namespace Redmine
*/ */
void setFirstName(const std::string &firstname); void setFirstName(const std::string &firstname);
/**
* @brief Set the Last Name of the user object
*
* *Remember:* you are only updating the local object!
*
* To change something on the server to have to call the appropriate API method.
*
* @param lastname - the new lastname of the user
*/
void setLastName(const std::string &lastname);
/**
* @brief Set the login of the user object
*
* *Remember:* you are only updating the local object!
*
* To change something on the server to have to call the appropriate API method.
*
* @param login - the new login of the user
*/
void setLogin(const std::string &login);
/**
* @brief Set the id of the user object
*
* *Remember:* you are only updating the local object!
*
* To change something on the server to have to call the appropriate API method.
*
* @param id - the new id of the user
*/
void setId(const std::string &id);
/**
* @brief Set the email of the user object
*
* *Remember:* you are only updating the local object!
*
* To change something on the server to have to call the appropriate API method.
*
* @param email - the new email of the user
*/
void setMail(const std::string &mail);
}; // class User }; // class User

View File

@ -0,0 +1,178 @@
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <Redmine-CLI/Command/MyAccount.hpp>
#include <Redmine-CLI/Redmine.hpp>
#include "Redmine/API.hpp"
#include "Redmine/User.hpp"
#include "nlohmann/json_fwd.hpp"
Command::MyAccount::MyAccount(RedmineCLI::Redmine *r)
:
redmine_(r),
output_(TEXT)
{
CLI::App* myAccount = redmine_->getCLI().add_subcommand("myaccount",
"Api Calls on the account of the token owner");
myAccountGet = myAccount->add_subcommand("get", "Get the current information of the token owner");
myAccountGet->needs(redmine_->getTokenOption())->needs(redmine_->getUrlOption());
myAccountGet->callback([&](){get_();});
myAccountGet->add_option("-f,--fields", fields_, "The fields of the user object to print. Supported: firstname, lastname, login, id, mail");
myAccountGet->add_option("-o,--output", output_, "The Output Format to use. Supported: TEXT, YAML")->transform(CLI::CheckedTransformer(outputMap, CLI::ignore_case));
myAccountSet = myAccount->add_subcommand("set", "Set the current information of the token owner");
myAccountSet->needs(redmine_->getTokenOption())->needs(redmine_->getUrlOption());
myAccountSet->add_option("-f,--firstname", firstname_, "the new firstname");
myAccountSet->add_option("-l,--lastname", lastname_, "the new lastname");
myAccountSet->add_option("-a,--login", login_, "the new login");
myAccountSet->add_option("-m,--mail", mail_, "the new email address");
myAccountSet->callback([&](){set_();});
}
void Command::MyAccount::set_() const
{
Redmine::API client{redmine_->getUrl(), redmine_->getToken()};
Redmine::User user = client.getMyAccount();
if (! firstname_.empty())
{
user.setFirstName(firstname_);
}
if (! lastname_.empty())
{
user.setLastName(lastname_);
}
if (! login_.empty())
{
user.setLogin(login_);
}
if (! id_.empty())
{
user.setId(id_);
}
if (! mail_.empty())
{
user.setMail(mail_);
}
client.setMyAccount(user);
}
void Command::MyAccount::get_() const
{
Redmine::API client{redmine_->getUrl(), redmine_->getToken()};
Redmine::User user = client.getMyAccount();
bool hasFirstname = std::find(fields_.begin(), fields_.end(),"firstname")
!= fields_.end() || fields_.empty();
bool hasLastname = std::find(fields_.begin(), fields_.end(),"lastname")
!= fields_.end() || fields_.empty();
bool hasLogin = std::find(fields_.begin(), fields_.end(),"login")
!= fields_.end() || fields_.empty();
bool hasId = std::find(fields_.begin(), fields_.end(),"id")
!= fields_.end() || fields_.empty();
bool hasMail = std::find(fields_.begin(), fields_.end(),"mail")
!= fields_.end() || fields_.empty();
nlohmann::json data;
if (hasFirstname)
{
if (output_ == TEXT)
{
std::cout << "Firstname : " << user.getFirstName() << std::endl;
}
else if (output_ == YAML)
{
data["firstname"]=user.getFirstName();
}
}
if (hasLastname)
{
if (output_ == TEXT)
{
std::cout << "Lastname : " << user.getLastName() << std::endl;
}
else if (output_ == YAML)
{
data["lastname"]=user.getLastName();
}
}
if (hasLogin)
{
if (output_ == TEXT)
{
std::cout << "Login : " << user.getLogin() << std::endl;
}
else if (output_ == YAML)
{
data["login"]=user.getLogin();
}
}
if (hasId)
{
if (output_ == TEXT)
{
std::cout << "Id : " << user.getId() << std::endl;
}
else if (output_ == YAML)
{
data["id"]=user.getId();
}
}
if (hasMail)
{
if (output_ == TEXT)
{
std::cout << "Email : " << user.getEmail() << std::endl;
}
else if (output_ == YAML)
{
data["mail"]=user.getEmail();
}
}
if (output_ == YAML)
{
std::cout << data.dump(1);
}
}

View File

@ -0,0 +1,105 @@
#pragma once
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <CLI/App.hpp>
#include <Redmine/API.hpp>
#include <atomic>
#include <cstdint>
#include <memory>
#include <string>
#define LOGURU_WITH_STREAMS 1
#include <loguru.hpp>
#include <CLI/CLI.hpp>
// forward declaration
namespace RedmineCLI
{
class Redmine;
};
namespace Command
{
/**
* @brief class for processing the CLI11 parsed command lines
*
*/
class MyAccount
{
private:
/// the main redmine cli application context
RedmineCLI::Redmine *redmine_;
/// enum for identifying supported output types
enum outputType : std::uint16_t
{
/// output is just text
TEXT,
/// output is yaml
YAML
};
std::map<std::string, outputType> outputMap{{"text", TEXT}, {"yaml", YAML}};
/// pointer to the get subcommand
CLI::App* myAccountGet;
/// pointer to the set subcommand
CLI::App* myAccountSet;
/// vector to hold requested attribute fields
std::vector<std::string> fields_;
/// requested output type
outputType output_;
/// the actual implementation of the information get
void get_() const;
/// the actual implementation of the information set
void set_() const;
/// parameter for setting the firstname
std::string firstname_;
/// parameter for setting the lastname
std::string lastname_;
/// parameter for setting the login
std::string login_;
/// parameter for setting the id
std::string id_;
/// parameter for setting the email
std::string mail_;
public:
/**
* @brief Construct a new CLIProcessor object
*
*/
MyAccount(RedmineCLI::Redmine *r);
}; // class MyAccount
}; // namespace Command

View File

@ -0,0 +1,36 @@
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <Redmine-CLI/Command/Version.hpp>
#include <Redmine-CLI/Redmine.hpp>
#include "Redmine/User.hpp"
#include "config.hpp"
#include <iostream>
Command::Version::Version(RedmineCLI::Redmine *r)
:
redmine_(r),
version_(nullptr)
{
version_ = redmine_->getCLI().add_subcommand("version", "Print current program version");
version_->callback( [&](){
std::cout << "redmine-api-client Version " << PROJECT_VERSION << std::endl;
});
}

View File

@ -0,0 +1,62 @@
#pragma once
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <CLI/App.hpp>
#include <Redmine/API.hpp>
#include <memory>
#include <string>
#define LOGURU_WITH_STREAMS 1
#include <loguru.hpp>
#include <CLI/CLI.hpp>
// forward declaration
namespace RedmineCLI
{
class Redmine;
};
namespace Command
{
/**
* @brief Command for printing the version of the redmine-cli
*
*/
class Version
{
private:
/// the main redmine cli application context
RedmineCLI::Redmine *redmine_;
/// pointer to the version subcommand
CLI::App* version_;
public:
/**
* @brief Construct a new CLIProcessor object
*
* @param redmineURL - the url to the redmine instance
* @param apiToken - the token to authenticate api requests
*/
Version(RedmineCLI::Redmine *r);
}; // class Version
}; // namespace Command

View File

@ -0,0 +1,38 @@
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include <Redmine-CLI/Command/MyAccount.hpp>
#include "Redmine-CLI/Command/Version.hpp"
#include <Redmine-CLI/Redmine.hpp>
#include <memory>
RedmineCLI::Redmine::Redmine(CLI::App &cli)
:
cli_(cli),
version_(nullptr)
{
CLIredmineApiToken_ = cli_.add_option("-t,--token",redmineApiToken_,
"The API token for accessing redmine")->envname("REDMINE_API_TOKEN");
CLIredmineUrl_ = cli_.add_option("-u,--url",redmineUrl_,"The URL to the redmine server (e.g. https://redmine.org)")->envname("REDMINE_URL");
// add all commands here
version_ = std::make_unique<Command::Version>(this);
myAccount_ = std::make_unique<Command::MyAccount>(this);
}

108
src/Redmine-CLI/Redmine.hpp Normal file
View File

@ -0,0 +1,108 @@
#pragma once
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include "Redmine-CLI/Command/MyAccount.hpp"
#include "Redmine-CLI/Command/Version.hpp"
#include <CLI/App.hpp>
#include <CLI/Option.hpp>
#include <memory>
namespace RedmineCLI
{
/**
* @brief Main class for the CLI appication
*
* This class holds the main CLI::APP context and
* initializes commands for the application.
*
*/
class Redmine
{
private:
/// Main CLI11 application context
CLI::App &cli_;
/// CLI option for getting the redmine api token
CLI::Option *CLIredmineApiToken_;
/// CLI option for getting the redmine url
CLI::Option *CLIredmineUrl_;
/// the redmine api token itself
std::string redmineApiToken_;
/// the redmine url itself
std::string redmineUrl_;
/// pointer to the version subcommand
std::unique_ptr<Command::Version> version_;
/// pointer to the myAccount subcommand
std::unique_ptr<Command::MyAccount> myAccount_;
public:
/**
* @brief Main constructor for just creating an object and providing the main CLI::App Context
*
* @param cli - the CLI::App context
*/
explicit Redmine(CLI::App &cli);
/**
* @brief return the CLI::App context as a reference
*
* @return CLI::App&
*/
CLI::App & getCLI() const {return cli_;}
/**
* @brief Return a pointer to the CLI::Option for the redmine app token
*
* This is helpful as you can make it needed in a subcommand of the application.
*
* @return CLI::Option*
*/
CLI::Option* getTokenOption() { return CLIredmineApiToken_;}
/**
* @brief Return a pointer to the CLI::Option for the redmine url
*
* This is helpful as you can make it needed in a subcommand of the application.
*
* @return CLI::Option*
*/
CLI::Option* getUrlOption() { return CLIredmineUrl_;}
/**
* @brief return the parsed app token
*
* @return std::string
*/
std::string getToken() {return redmineApiToken_;}
/**
* @brief return the parsed redmine url
*
* @return std::string
*/
std::string getUrl() {return redmineUrl_;}
}; // class Redmine
}; // namespace RedmineCLI

41
src/Redmine-CLI/main.cpp Normal file
View File

@ -0,0 +1,41 @@
/*
* Copyright (C) 2024 Dominik Meyer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#include "Redmine-CLI/Redmine.hpp"
#include "config.hpp"
#include "config.hpp.in"
#include <CLI/App.hpp>
#include <CLI/Option.hpp>
#include <Redmine/API.hpp>
#include <Redmine/Exception/Api.hpp>
#include <string>
#include <vector>
#define LOGURU_WITH_STREAMS 1
#include <loguru.hpp>
#include <CLI/CLI.hpp>
int main(int argc, char **argv)
{
CLI::App app("A command line client for the redmine project management server");
RedmineCLI::Redmine redmineCli{app};
CLI11_PARSE(app, argc, argv);
}

View File

@ -83,3 +83,23 @@ void Redmine::User::setFirstName(const std::string &firstname)
{ {
data_["user"]["firstname"]=firstname; data_["user"]["firstname"]=firstname;
} }
void Redmine::User::setLastName(const std::string &lastname)
{
data_["user"]["lastname"]=lastname;
}
void Redmine::User::setLogin(const std::string &login)
{
data_["user"]["login"]=login;
}
void Redmine::User::setId(const std::string &id)
{
data_["user"]["id"]=id;
}
void Redmine::User::setMail(const std::string &mail)
{
data_["user"]["mail"]=mail;
}