kde-playground/akonadi/shared/akapplication.h

/*
    Copyright (c) 2008 Volker Krause <vkrause@kde.org>

    This library is free software; you can redistribute it and/or modify it
    under the terms of the GNU Library General Public License as published by
    the Free Software Foundation; either version 2 of the License, or (at your
    option) any later version.

    This library 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 Library General Public
    License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to the
    Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
    02110-1301, USA.
*/

#ifndef AKAPPLICATION_H
#define AKAPPLICATION_H

#include <QtCore/QObject>

#ifndef Q_MOC_RUN
#include <boost/program_options.hpp>
#endif

#include <QCoreApplication>
#include <QApplication>

/**
 * D-Bus session bus monitoring and command line handling.
 */
class AkApplication : public QObject
{
  Q_OBJECT
  public:
    ~AkApplication();
    void parseCommandLine();
    void setDescription( const QString &desc ) { mDescription = desc; }

    void addCommandLineOptions( const boost::program_options::options_description &desc );
    void addPositionalCommandLineOption( const char *option, int count );
    const boost::program_options::variables_map &commandLineArguments() const { return mCmdLineArguments; }

    void printUsage() const;

    /** Returns the instance identifier when running in multi-instance mode, empty string otherwise. */
    static QString instanceIdentifier();

    /** Returns @c true if we run in multi-instance mode. */
    static bool hasInstanceIdentifier();

    /** Returns the AkApplication instance */
    static AkApplication *instance();

    /** Forward to Q[Core]Application for convenience. */
    int exec();

  protected:
    AkApplication( int &argc, char **argv );
    void init();
    QScopedPointer<QCoreApplication> mApp;

  private:
    /** Change instane identifier, for unit tests only. */
    static void setInstanceIdentifier( const QString &instanceId );
    friend void akTestSetInstanceIdentifier( const QString &instanceId );

  private Q_SLOTS:
    void pollSessionBus() const;

  private:
    int mArgc;
    char **mArgv;
    QString mDescription;
    QString mInstanceId;
    static AkApplication *sInstance;

    boost::program_options::options_description mCmdLineOptions;
    boost::program_options::variables_map mCmdLineArguments;
    boost::program_options::positional_options_description mCmdPositionalOptions;
};

template <typename T>
class AkApplicationImpl : public AkApplication
{
  public:
    AkApplicationImpl( int &argc, char **argv )
      : AkApplication( argc, argv )
    {
      mApp.reset( new T( argc, argv ) );
      init();
    }
};

typedef AkApplicationImpl<QCoreApplication> AkCoreApplication;
typedef AkApplicationImpl<QApplication> AkGuiApplication;

#endif