// Copyright (C) 2015 xaizek <xaizek@posteo.net>
//
// This file is part of dit.
//
// dit is free software: you can redistribute it and/or modify
// it under the terms of version 3 of the GNU Affero General Public
// License as published by the Free Software Foundation.
//
// dit 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 dit. If not, see <http://www.gnu.org/licenses/>.
#ifndef DIT__TESTS_HPP__
#define DIT__TESTS_HPP__
#include <ctime>
#include <functional>
#include <iosfwd>
#include <memory>
#include <sstream>
#include <string>
class Config;
class Item;
class Project;
class Storage;
/**
* @brief Temporarily redirects specified stream into a string.
*/
class StreamCapture
{
public:
/**
* @brief Constructs instance that redirects @p os.
*
* @param os Stream to redirect.
*/
StreamCapture(std::ostream &os) : os(os)
{
rdbuf = os.rdbuf();
os.rdbuf(oss.rdbuf());
}
/**
* @brief Restores original state of the stream.
*/
~StreamCapture()
{
os.rdbuf(rdbuf);
}
public:
/**
* @brief Retrieves captured output collected so far.
*
* @returns String containing the output.
*/
std::string get() const
{
return oss.str();
}
private:
/**
* @brief Stream that is being redirected.
*/
std::ostream &os;
/**
* @brief Temporary output buffer of the stream.
*/
std::ostringstream oss;
/**
* @brief Original output buffer of the stream.
*/
std::streambuf *rdbuf;
};
/**
* @brief Attorney for accessing testing interface of the application classes.
*
* Attorney is from Attorney-Client idiom.
*/
class Tests
{
friend class MockTimeSource;
public:
/**
* @brief Disables adding escape sequences to output.
*/
static void disableDecorations();
/**
* @brief Set custom streams for command output.
*
* @param out Output stream.
* @param err Error stream.
*/
static void setStreams(std::ostream &out, std::ostream &err);
/**
* @brief Makes an instance of @c Project.
*
* @returns The instance.
*/
static std::unique_ptr<Project> makeProject();
/**
* @brief Makes an instance of @c Item, which is not creatable otherwise.
*
* @param id Id for the new item.
*
* @returns The item.
*/
static Item makeItem(std::string id);
/**
* @brief Inserts the item into the storage.
*
* @param storage Storage to place @p item into.
* @param item Item to put into the storage.
*/
static void storeItem(Storage &storage, Item item);
/**
* @brief Retrieves whether configuration has any unsaved changes.
*
* @param config Configuration to check.
*
* @returns @c true if so, otherwise @c false is returned.
*/
static bool configIsModified(Config &config);
/**
* @brief Removes command from command list.
*
* @param name Name of the command to remove.
*/
static void removeCmd(const std::string &name);
private:
/**
* @brief Sets timestamp provider for Item and Change objects.
*
* @param getTime New provider.
*/
static void setTimeSource(std::function<std::time_t()> getTime);
/**
* @brief Resets timestamp provider to its default value.
*/
static void resetTimeSource();
};
/**
* @brief RAII time source replacer.
*/
class MockTimeSource
{
public:
/**
* @brief Sets timestamp provider for Item and Change objects.
*
* @param getTime New provider.
*/
explicit MockTimeSource(std::function<std::time_t()> getTime)
{
Tests::setTimeSource(getTime);
}
/**
* @brief Resets timestamp provider to its default value.
*/
~MockTimeSource()
{
Tests::resetTimeSource();
}
};
#endif // DIT__TESTS_HPP__
Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"
Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/dit
Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/dit
You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a
pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master