VACLibrary.h

/***************************************************************************
 *   Copyright (C) 2024-2025 by Stefan Kebekus                             *
 *   stefan.kebekus@gmail.com                                              *
 *                                                                         *
 *   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 3 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.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/
 
#pragma once
 
#include <QFile>
#include <QStandardPaths>
 
#include "geomaps/VAC.h"
 
 
namespace GeoMaps
{

 
class VACLibrary : public QObject
{
    Q_OBJECT
    QML_ELEMENT
    QML_SINGLETON
 
public:
    VACLibrary(QObject *parent = nullptr);

    ~VACLibrary() override;
 
    //
    // Properties
    //

    Q_PROPERTY(bool isEmpty READ isEmpty NOTIFY dataChanged)
 
    
    Q_PROPERTY(QList<GeoMaps::VAC> vacs READ vacs NOTIFY dataChanged)
 
 
    //
    // Getter Methods
    //

    [[nodiscard]] bool isEmpty() const { return m_vacs.isEmpty(); }

    [[nodiscard]] QList<GeoMaps::VAC> vacs();
 
 
    //
    // Methods
    //

    Q_INVOKABLE void clear();

    [[nodiscard]] Q_INVOKABLE GeoMaps::VAC get(const QString& name);

    [[nodiscard]] Q_INVOKABLE QString importTripKit(const QString& fileName);

    [[nodiscard]] Q_INVOKABLE QString importVAC(const QString& fileName, const QString& name = {});

    Q_INVOKABLE void remove(const QString& name);

    [[nodiscard]] Q_INVOKABLE QString rename(const QString& oldName, const QString& newName);

    [[nodiscard]] Q_INVOKABLE QVector<GeoMaps::VAC> vacsByDistance(const QGeoCoordinate& position, const QString& filter);

    [[nodiscard]] Q_INVOKABLE QVector<GeoMaps::VAC> vacs4Point(const QGeoCoordinate& position);
 
signals:
    void dataChanged();

    void importTripKitStatus(double percent);
 
private:
    Q_DISABLE_COPY_MOVE(VACLibrary)
 
    // This method cleans the VAC directory. It deletes all VAC from m_vacs that
    // have no raster image files. It looks for unmanaged raster image files and
    // either imports them or deletes them.
    void janitor();
 
    // This method saves m_vacs to m_dataFile.
    void save();
 
    // This method returns the absolute path of a given VAC. Needed for iOS
    // after App Update. See GeoMaps::VACLibrary::janitor
    QString absolutePathForVac(GeoMaps::VAC);
 
    QVector<GeoMaps::VAC> m_vacs;
    QString m_vacDirectory {QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + "/VAC"};
    QFile m_dataFile {QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + "/VAC.data"};
 
};
 
} // namespace GeoMaps