File: verifier.h

package info (click to toggle)
biometryd 0.4.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 1,524 kB
  • sloc: cpp: 10,213; ansic: 191; python: 42; makefile: 33
file content (68 lines) | stat: -rw-r--r-- 2,247 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
/*
 * Copyright (C) 2016 Canonical, Ltd.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; version 3.
 *
 * 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 Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 * Authored by: Thomas Voß <thomas.voss@canonical.com>
 *
 */

#ifndef BIOMETRY_VERIFIER_H_
#define BIOMETRY_VERIFIER_H_

#include <biometry/do_not_copy_or_move.h>
#include <biometry/operation.h>
#include <biometry/progress.h>

namespace biometry
{
/// @cond
class Application;
class Reason;
class User;
/// @endcond

/// @brief Verification bundles the types passed to an observer of verification operations.
struct BIOMETRY_DLL_PUBLIC Verification
{
    /// @brief Result enumerates all possible results of a verification operation.
    enum class Result
    {
        verified, ///< The given user could be verified.
        not_verified ///< The given user could not be verified.
    };

    typedef biometry::Progress Progress; ///< Progress information about the completion status of an operation.
    typedef std::string Reason;          ///< Details about cancelation of an operation.
    typedef std::string Error;           ///< Describes error conditions.
    typedef Result Result;               ///< Describes the result of a verification operation.
};

/// @brief Verifier abstracts verification of a user.
class BIOMETRY_DLL_PUBLIC Verifier : private DoNotCopyOrMove
{
public:
    // Safe us some typing
    typedef std::shared_ptr<Verifier> Ptr;

    /// @brief verify_user returns an operation that represents the verification of 'user' for 'reason'.
    virtual Operation<Verification>::Ptr verify_user(const Application& app, const User& user, const Reason& reason) = 0;

protected:
    /// @cond
    Verifier() = default;
    /// @endcond
};
}

#endif // BIOMETRY_VERIFIER_H_