/*********************************************************************/
// dar - disk archive - a backup/restoration program
// Copyright (C) 2002-2026 Denis Corbin
//
// 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 2
// 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, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// to contact the author, see the AUTHOR file
/*********************************************************************/

    /// \file mask.hpp
    /// \brief here lies a collection of mask classes
    ///
    /// The mask classes defined here are to be used to filter files
    /// in the libdar API calls.
    /// \ingroup API

#ifndef MASK_HPP
#define MASK_HPP

#include "/opt/local/include/dar/libdar_my_config.h"

extern "C"
{
#if LIBDAR_HAS_UNISTD_H
#include <unistd.h>
#endif

#if LIBDAR_HAS_REGEX_H
#include <regex.h>
#endif
} // end extern "C"

#include <string>
#include <deque>

#include "/opt/local/include/dar/erreurs.hpp"
#include "/opt/local/include/dar/path.hpp"

namespace libdar
{

	/// \addtogroup API
	/// @{

        /// the generic class, parent of all masks

	/// this is a pure virtual class that is used in API call
	/// any of the following mask classes inherit from this class
    class mask
    {
    public :
	mask() {};
	mask(const mask & ref) = default;
	mask(mask && ref) noexcept = default;
	mask & operator = (const mask & ref) = default;
	mask & operator = (mask && ref) noexcept = default;
        virtual ~mask() = default;

	    /// check wether the given string is covered by the mask

	    /// \param[in] expression is the filename to check
	    /// \return true if the given filename is covered by the mask
	    /// \note only libdar internally needs to call this method
        virtual bool is_covered(const std::string &expression) const = 0;

	    /// check whether the given path is covered by the mask

	    /// \param[in] chemin is the path to check
	    /// \return true if the given path is covered by the mask
	    /// \note only libdar internally needs to call this method
	    /// \note this is an optional method to the previous one, it can be overwritten
	virtual bool is_covered(const path & chemin) const { return is_covered(chemin.display()); };

	    /// dump in human readable form the nature of the mask

	    /// \param[in] prefix used for indentation withing the output string
	virtual std::string dump(const std::string & prefix = "") const = 0;

	    /// this is to be able to copy a mask without knowing its
	    /// exact class and without loosing its specialized data
        virtual mask *clone() const = 0;
    };


        /// boolean mask, either always true or false

	/// it matches all files or no files at all
    class bool_mask : public mask
    {
    public :
	    /// the constructor

	    /// \param[in] always is the value that this mask will always return
	    /// when the is_covered method will be used
	    /// \note once initialized an object cannot change its behavior
        bool_mask(bool always) { val = always; };
	bool_mask(const bool_mask & ref) = default;
	bool_mask(bool_mask && ref) noexcept = default;
	bool_mask & operator = (const bool_mask & ref) = default;
	bool_mask & operator = (bool_mask && ref) noexcept = default;
	~bool_mask() = default;

	    /// inherited from the mask class
        bool is_covered(const std::string & expression) const override { return val; };
        bool is_covered(const path & chemin) const override { return val; };
	std::string dump(const std::string & prefix) const override { return prefix + (val ? gettext("TRUE") : gettext("FALSE")); };

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) bool_mask(val); };

    private :
        bool val;
    };


        /// matches as done on shell command lines (see "man 7 glob")

    class simple_mask : public mask
    {
    public :

	    /// the constructor to use by libdar external programs

	    /// \param[in] wilde_card_expression is the glob expression that defines the mask
	    /// \param[in] case_sensit whether the mask is case sensitive or not
        simple_mask(const std::string & wilde_card_expression, bool case_sensit);

	    /// copy constructor
        simple_mask(const simple_mask & m) = default;

	    /// move constructor
	simple_mask(simple_mask && ref) noexcept = default;

	    /// assignment operator
        simple_mask & operator = (const simple_mask & m) = default;

	    /// move operator
	simple_mask & operator = (simple_mask && ref) noexcept = default;

	    /// default destructor
	~simple_mask() = default;


	    /// inherited from the mask class
        bool is_covered(const std::string &expression) const override;

	    /// inherited from the mask class
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) simple_mask(*this); };

    private :
        std::string the_mask;
	bool case_s;
    };


        /// matches regular expressions (see "man 7 regex")

    class regular_mask : public mask
    {
    public :

	    /// the constructor to be used by libdar external programs

	    /// \param[in] wilde_card_expression is the regular expression that defines the mask
	    /// \param[in] x_case_sensit whether the mask is case sensitive or not
        regular_mask(const std::string & wilde_card_expression,
		     bool x_case_sensit);

	    /// the copy constructor
	regular_mask(const regular_mask & ref): mask(ref) { copy_from(ref); };

	    /// the move constructor
	regular_mask(regular_mask && ref) noexcept: mask(std::move(ref)) { move_from(std::move(ref)); };

	    /// the assignment operator
	regular_mask & operator = (const regular_mask & ref);

	    /// the move operator
	regular_mask & operator = (regular_mask && ref) noexcept;

	    /// destructor
        virtual ~regular_mask() { detruit(); };

	    /// inherited from the mask class
        bool is_covered(const std::string & expression) const override;

	    /// inherited from the mask class
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) regular_mask(*this); };

    private :
        regex_t preg;
	std::string mask_exp; ///< used only by the copy constructor
	bool case_sensit;     ///< used only by the copy constructor

	void set_preg(const std::string & wilde_card_expression,
		      bool x_case_sensit);

	void copy_from(const regular_mask & ref);
	void move_from(regular_mask && ref) noexcept;
	void detruit() noexcept { regfree(&preg); };
    };


        /// negation of another mask

	/// this is the first mask built over masks
	/// it realizes the negation of the given mask
    class not_mask : public mask
    {
    public :
	    /// the constructor to be used by libdar external programs

	    /// \param[in] m is the mask to negate
	    /// \note the mask used as argument need not to survive the just created not_mask object
	    /// as an internal copy of the mask given in argument has been done.
        not_mask(const mask &m) { copy_from(m); };

	    /// copy constructor
        not_mask(const not_mask & m) : mask(m) { copy_from(m); };

	    /// move constructor
	not_mask(not_mask && m) noexcept: mask(std::move(m)) { nullifyptr(); move_from(std::move(m)); };

	    /// assignment operator
        not_mask & operator = (const not_mask & m);

	    /// move operator
	not_mask & operator = (not_mask && m) noexcept { move_from(std::move(m)); return *this; };

	    /// destructor
        ~not_mask() { detruit(); };

	    /// inherited from the mask class
        bool is_covered(const std::string &expression) const override { return !ref->is_covered(expression); };
        bool is_covered(const path & chemin) const override { return !ref->is_covered(chemin); };
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) not_mask(*this); };

    private :
        mask *ref;

	void nullifyptr() noexcept { ref = nullptr; };
        void copy_from(const not_mask &m);
        void copy_from(const mask &m);
	void move_from(not_mask && ref) noexcept;
        void detruit();
    };


        /// makes an *AND* operator between two or more masks

    class et_mask : public mask
    {
    public :

	    /// the constructor to be used by libdar external programs

	    /// \note at this stage the mask is not usable and will
	    /// throw an exception until some mask are added to the *AND*
	    /// thanks to the add_mask() method
        et_mask() {}; // field "lst" is an object and initialized by its default constructor

	    /// copy constructor
        et_mask(const et_mask &m) : mask(m) { copy_from(m); };

	    /// move constructor
	et_mask(et_mask && m) noexcept: mask(std::move(m)) { move_from(std::move(m)); };

	    /// assignment operator
        et_mask & operator = (const et_mask &m);

	    /// move operator
	et_mask & operator = (et_mask && m) noexcept { mask::operator = (std::move(m)); move_from(std::move(m)); return *this; };

	    /// destructor
        ~et_mask() { detruit(); };


	    /// add a mask to the operator

	    /// \param[in] toadd a mask to add to the *AND* operator
	    /// \note the mask given in argument has not to survive the et_mask to which it has been added
	    /// a internal copy of the mask has been done.
        void add_mask(const mask & toadd);

	    /// inherited from the mask class
        bool is_covered(const std::string & expression) const override { return t_is_covered(expression); };
        bool is_covered(const path & chemin) const override { return t_is_covered(chemin); };
	std::string dump(const std::string & prefix) const override { return dump_logical(prefix, gettext("AND")); };

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) et_mask(*this); };

	    /// the number of mask on which is done the *AND* operator

	    /// \return the number of mask that has been added thanks to the add_mask() method
	    /// \note there is no mean to remove a given mask once it has been added (see the clear method)
        U_I size() const { return lst.size(); };

	    /// return a pointer by index to composing mask (index start at zero and should be strictly less than what size() returns)
	const mask* get_added(U_I index) const { return lst[index]; };

	    /// clear the mask

	    /// remove all previously added masks
	    /// \note that after this call the mask is no more usable as the *AND* operator cannot be done
	    /// on any mask
	void clear() { detruit(); };

    protected :
        std::deque<mask *> lst;

	std::string dump_logical(const std::string & prefix, const std::string & boolop) const;

    private :
        void copy_from(const et_mask & m);
	void move_from(et_mask && m) noexcept;
        void detruit();

	template<class T> bool t_is_covered(const T & expression) const
	{
	    std::deque<mask *>::const_iterator it = lst.begin();

	    if(lst.empty())
		throw Erange("et_mask::is_covered", dar_gettext("No mask in the list of mask to operate on"));

	    while(it != lst.end() && (*it)->is_covered(expression))
		++it;

	    return it == lst.end();
	}

    };


        /// makes the *OR* operator between two or more masks

	/// this mask has exactly the same use as the et_mask
	/// please see the et_mask documentation. The only difference
	/// is that it makes an *OR* operation rather than an *AND*
	/// with the masks added thanks to the add_mask method
    class ou_mask : public et_mask
    {
    public:
	ou_mask() {};
	ou_mask(const ou_mask & ref) = default;
	ou_mask(ou_mask && ref) noexcept = default;
	ou_mask & operator = (const ou_mask & ref) = default;
	ou_mask & operator = (ou_mask && ref) noexcept = default;
	~ou_mask() = default;

	    /// inherited from the mask class
        bool is_covered(const std::string & expression) const override { return t_is_covered(expression); };
        bool is_covered(const path & chemin) const override { return t_is_covered(chemin); };
	std::string dump(const std::string & prefix) const override { return dump_logical(prefix, gettext("OR")); };
	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) ou_mask(*this); };

    private:
	template<class T> bool t_is_covered(const T & expression) const
	{
	    std::deque<mask *>::const_iterator it = lst.begin();

	    if(lst.empty())
		throw Erange("et_mask::is_covered", dar_gettext("No mask to operate on in the list of mask"));

	    while(it != lst.end() && ! (*it)->is_covered(expression))
		it++;

	    return it != lst.end();
	}

    };


        /// string matches if it is subdir of mask or mask is a subdir of expression

    class simple_path_mask : public mask
    {
    public :
	    /// the constructor to be used by libdar external programs

	    /// \param[in] p the path the compare with
	    /// \param[in] case_sensit whether the mask is case sensitive or not
	    /// \note p must be a valid path
        simple_path_mask(const path &p, bool case_sensit) : chemin(p) { case_s = case_sensit; };
	simple_path_mask(const simple_path_mask & ref) = default;
	simple_path_mask(simple_path_mask && ref) noexcept = default;
	simple_path_mask & operator = (const simple_path_mask & ref) = default;
	simple_path_mask & operator = (simple_path_mask && ref) noexcept = default;
	~simple_path_mask() = default;

	    /// inherited from the mask class
        bool is_covered(const std::string & expression) const override { throw SRC_BUG; };
        bool is_covered(const path & chemin) const override;
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) simple_path_mask(*this); };

    private :
        path chemin;
	bool case_s;
    };


        /// matches if string is exactly the given mask (no wilde card expression)

    class same_path_mask : public mask
    {
    public :
	    /// the constructor to be used by libdar external programs

	    /// \param[in] p is the path to compare with
	    /// \param[in] case_sensit whether the mask is case sensitive or not
        same_path_mask(const std::string &p, bool case_sensit) { chemin = p; case_s = case_sensit; };
	same_path_mask(const same_path_mask & ref) = default;
	same_path_mask(same_path_mask && ref) noexcept = default;
	same_path_mask & operator = (const same_path_mask & ref) = default;
	same_path_mask & operator = (same_path_mask && ref) noexcept = default;
	~same_path_mask() = default;

	    /// inherited from the mask class
        bool is_covered(const std::string &chemin) const override;

	    /// inherited from the mask class
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
        mask *clone() const override { return new (std::nothrow) same_path_mask(*this); };

    private :
        std::string chemin;
	bool case_s;
    };


	/// matches if string is the given constructor string or a sub directory of it

    class exclude_dir_mask : public mask
    {
    public:
	    /// the constructor to be used by libdar external programs

	    /// \param[in] p is the path to compare with
	    /// \param[in] case_sensit whether the mask is case sensitive or not
	exclude_dir_mask(const std::string &p, bool case_sensit) { chemin = p; case_s = case_sensit;};
	exclude_dir_mask(const exclude_dir_mask & ref) = default;
	exclude_dir_mask(exclude_dir_mask && ref) noexcept = default;
	exclude_dir_mask & operator = (const exclude_dir_mask & ref) = default;
	exclude_dir_mask & operator = (exclude_dir_mask && ref) noexcept = default;
	~exclude_dir_mask() = default;

	    /// inherited from the mask class
	bool is_covered(const std::string &expression) const override { throw SRC_BUG; }
	bool is_covered(const path &chemin) const override { return chemin.is_subdir_of(chemin, case_s); };
	std::string dump(const std::string & prefix) const override;

	    /// inherited from the mask class
	mask *clone() const override { return new (std::nothrow) exclude_dir_mask(*this); };

    private:
	std::string chemin;
	bool case_s;
    };

	/// @}

} // end of namespace

#endif
