File indexing completed on 2024-05-05 05:54:31

 /*
     SPDX-FileCopyrightText: 2015 Elvis Angelaccio <elvis.angelaccio@kde.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #ifndef SESSION_H
 #define SESSION_H
 
 #include "lap.h"
 
 #include <QMetaType>
 #include <QVector>
 
 /**
  * @brief A session represents a single Kronometer instance.
  * A session is made by a stopwatch time, a date timestamp and by zero or more laps.
  * An optional name and an optional note are also provided.
  */
 class Session
 {
 
 public:
 
     explicit Session(int time = 0, const QDateTime& date = QDateTime::currentDateTime());
 
     /**
      * Set the session's name.
      * @param name The string to be set as name.
      */
     void setName(const QString& name);
 
     /**
      * Set the session's annotation.
      * @param note The note to be set.
      */
     void setNote(const QString& note);
 
     /**
      * Set the session's stopwatch (raw) time.
      * @param time The stopwatch raw time.
      */
     void setTime(int time);
 
     /**
      * Set the session's date (timestamp).
      * @param date The date to be set as timestamp.
      */
     void setDate(const QDateTime& date);
 
     /**
      * Set whether the session data is outdated.
      * @param isOutdated Whether the session is outdated.
      */
     void setIsOutdated(bool isOutdated);
 
     /**
      * @return The session name.
      */
     QString name() const;
 
     /**
      * @return The session note.
      */
     QString note() const;
 
     /**
      * @return The session stopwatch raw time.
      */
     int time() const;
 
     /**
      * @return The session date.
      */
     QDateTime date() const;
 
     /**
      * Whether the session data is outdated.
      * @return True if the session is outdated, false otherwise.
      */
     bool isOutdated() const;
 
     /**
      * @return The session laps.
      */
     QVector<Lap> laps() const;
 
     /**
      * Whether the session is empty.
      * @return True if the session is empty, false otherwise.
      */
     bool isEmpty() const;
 
     /**
      * Add a lap to the session.
      * @param lap The lap the be added.
      */
     void addLap(const Lap& lap);
 
     /**
      * Reset the stopwatch time and remove all the laps from the session.
      */
     void clear();
 
     /**
      * Serialize the session on the given JSON object.
      * @param json A JSON object.
      */
     void write(QJsonObject& json) const;
 
     /**
      * Deserialize a session from the given JSON object.
      * @param json A JSON object.
      * @return A deserialized session.
      */
     static Session fromJson(const QJsonObject& json);
 
     bool operator==(const Session& right) const;
     bool operator!=(const Session& right) const;
 
 private:
 
     QString m_name;       /** Session name. */
     QString m_note;       /** Custom session annotation. */
     int  m_time;          /** Session stopwatch time. */
     QDateTime m_date;     /** Session date (timestamp of the last update). */
     QVector<Lap> m_laps;    /** Session laps. */
     bool m_isOutdated = false;    /** Whether the session data is outdated. */
 };
 
 Q_DECLARE_METATYPE(Session)
 
 #endif