mirror of
https://github.com/qelectrotech/qelectrotech-source-mirror.git
synced 2026-08-03 02:24:13 +02:00
ispyisail
464d516537
Adds a ProjectUsageTracker (sources/project/) that accumulates how
long a project has been the active tab, using QElapsedTimer so the
value is computed on demand rather than via polling. It's hosted on
ProjectPropertiesHandler per that class's own stated design intent
("all new properties should be managed by this class").
The accumulated time is persisted as a new <usage time_spent="N"
enabled="true|false"/> element, a sibling of <properties> in the
project XML, written/read by new QETProject::writeUsageXml()/
readUsageXml(). It rides along on the existing autosave path for
free, since writeBackup() already serializes the full project via
toXml().
QETDiagramEditor::subWindowActivated() now pauses every open
project's tracker except the one whose tab just became current, so
switching between several open projects keeps each project's tracked
time isolated.
Surfaced in the existing Project Properties "Général" page: a
"Temps passé sur ce projet" display, a "Réinitialiser" button, and
an opt-out checkbox ("uniquement enregistré localement dans ce
fichier" - this is local-only, never transmitted anywhere).
Verified beyond compiling: full CMake build, then an actual runtime
session confirming the saved XML's time_spent value, that closing
and reopening the project round-trips and resumes timing, that the
reset button works, and - the key correctness check - that with two
projects open, the inactive one's time_spent stays frozen while the
active one accumulates real elapsed time, over the same interval.
See discussion #576.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
122 lines
3.6 KiB
C++
122 lines
3.6 KiB
C++
/*
|
|
Copyright 2006-2026 The QElectroTech Team
|
|
This file is part of QElectroTech.
|
|
|
|
QElectroTech 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.
|
|
|
|
QElectroTech 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 QElectroTech. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
#include "projectusagetracker.h"
|
|
|
|
#include <QDomElement>
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::secondsSpent
|
|
@return the total accumulated time, in seconds, including the time
|
|
elapsed since the tracker was last made active (if it currently is).
|
|
*/
|
|
qint64 ProjectUsageTracker::secondsSpent() const
|
|
{
|
|
qint64 total = m_seconds_spent;
|
|
if (m_elapsed_timer.isValid()) {
|
|
total += m_elapsed_timer.elapsed() / 1000;
|
|
}
|
|
return total;
|
|
}
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::resetSecondsSpent
|
|
Zero the accumulated time. If the tracker is currently timing, it keeps
|
|
timing from this point on.
|
|
*/
|
|
void ProjectUsageTracker::resetSecondsSpent()
|
|
{
|
|
m_seconds_spent = 0;
|
|
if (m_elapsed_timer.isValid()) {
|
|
m_elapsed_timer.restart();
|
|
}
|
|
}
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::setEnabled
|
|
Enable or disable time tracking for this project. Disabling while
|
|
currently timing flushes the elapsed time first; re-enabling while
|
|
the project is the active tab resumes timing immediately.
|
|
@param enabled
|
|
*/
|
|
void ProjectUsageTracker::setEnabled(bool enabled)
|
|
{
|
|
if (m_enabled == enabled) {
|
|
return;
|
|
}
|
|
|
|
if (!enabled && m_elapsed_timer.isValid()) {
|
|
m_seconds_spent += m_elapsed_timer.elapsed() / 1000;
|
|
m_elapsed_timer.invalidate();
|
|
} else if (enabled && m_active) {
|
|
m_elapsed_timer.start();
|
|
}
|
|
m_enabled = enabled;
|
|
}
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::setActive
|
|
Tell the tracker whether this project's tab is currently the active
|
|
one. No-op if tracking is disabled or the state doesn't change.
|
|
@param active
|
|
*/
|
|
void ProjectUsageTracker::setActive(bool active)
|
|
{
|
|
if (m_active == active) {
|
|
return;
|
|
}
|
|
|
|
if (!active && m_elapsed_timer.isValid()) {
|
|
m_seconds_spent += m_elapsed_timer.elapsed() / 1000;
|
|
m_elapsed_timer.invalidate();
|
|
} else if (active && m_enabled) {
|
|
m_elapsed_timer.start();
|
|
}
|
|
m_active = active;
|
|
}
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::toXml
|
|
Append a <usage> child element to @p parent_element with the current
|
|
accumulated time and enabled state.
|
|
@param parent_element
|
|
*/
|
|
void ProjectUsageTracker::toXml(QDomElement &parent_element) const
|
|
{
|
|
QDomElement usage_element =
|
|
parent_element.ownerDocument().createElement(QStringLiteral("usage"));
|
|
usage_element.setAttribute(QStringLiteral("time_spent"), QString::number(secondsSpent()));
|
|
usage_element.setAttribute(QStringLiteral("enabled"), m_enabled ? QStringLiteral("true") : QStringLiteral("false"));
|
|
parent_element.appendChild(usage_element);
|
|
}
|
|
|
|
/**
|
|
@brief ProjectUsageTracker::fromXml
|
|
Read the <usage> child element of @p parent_element, if any.
|
|
@param parent_element
|
|
*/
|
|
void ProjectUsageTracker::fromXml(const QDomElement &parent_element)
|
|
{
|
|
const QDomElement usage_element = parent_element.firstChildElement(QStringLiteral("usage"));
|
|
if (usage_element.isNull()) {
|
|
return;
|
|
}
|
|
|
|
m_seconds_spent = usage_element.attribute(QStringLiteral("time_spent"), QStringLiteral("0")).toLongLong();
|
|
m_enabled = usage_element.attribute(QStringLiteral("enabled"), QStringLiteral("true")) != QStringLiteral("false");
|
|
}
|