/***************************************************************************
                         snumplugin.h  -  description
                             -------------------
    begin                : Tue Aug 05 2010
    copyright            : (C) 2010 by Matteo Azzali
    email                : matte.azzali@NOSPAMalice.it
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef _SNUM_PLUGIN_H_
#define _SNUM_PLUGIN_H_

#include "fileplugin.h"


class SnumPlugin : public FilePlugin {
 public:
    SnumPlugin( PluginLoader* loader );
    
    ~SnumPlugin();

    /** 
     * @returns the type of the plugin.
     */
    inline virtual int type() const;

    /**
     * This function is the core of your plugin.
     *
     * It does the actual processing of a file, filename or token depending of the type 
     * of your plugin.
     *
     * \see type()
     *
     * @param b the parent BatchRenamer instance calling this plugin
     * @param index the index of the current file (i.e. the first file has index 0,
     *              the second file to be renamed has index 1 ....)
     * @param filenameOrToken this parameter depends on the type of your plugin.
     *                        If type is ePluginType_File, this is the absolute path
     *                        or URL to the renamed file.
     *                        If type is ePluginType_Filename, this is the filename
     *                        (without path) as created by KRename.
     *                        If type is ePluginType_Token, this is the contents of a token
     *                        in brackets. If your plugin supports the token [example],
     *                        KRename will pass the strign "example" to your method.
     * @param eCurrentType the current type of plugin that is requested (for plugins that support more than one type)
     *
     * @returns the result of the function, depending on type().
     * @returns QString::null if this plugin has nothing to do.
     * @returns A new filename if type is ePluginType_Filename
     * @returns the value of the token if type is ePluginType_Token
     * @returns an error message or QString::null if type is ePluginType_File
     */
    virtual QString processFile( BatchRenamer* b, int index, const QString & filenameOrToken, EPluginType eCurrentType );

    /** Returns help descriptions for the supported tokens
     *
     *  The returned stringlist contains strings that are the tokens
     *  and the description separated by ;;
     *
     *  @returns a stringlist containing help on the supported tokens
     */
    inline const QStringList & help() const;

    /** Create a user interface for this plugin
     *
     *  @param parent the parent widget of this plugin
     */


 private:
    /** Return the number.
     *
     *  @param unicoded the string which is to be extracted
     *
     *  @returns the number part of the string, season, or episode or both
     */
    QString extractnum(const QString & unicoded, int a);

 private:
    QStringList m_help;

};

inline int SnumPlugin::type() const
{
    return ePluginType_Token;
}

inline const QStringList & SnumPlugin::help() const
{
    return m_help;
}

#endif // _SNUM_PLUGIN_H_
