/***************************************************************************
    begin                : Sun Feb 29 2004
    copyright            : (C) 2004 by Scott Wheeler
    email                : wheeler@kde.org
***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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 JUK_FILEHANDLE_H
#define JUK_FILEHANDLE_H

#include <tqstringlist.h>

class TQFileInfo;
class TQDateTime;
class TQDataStream;
class CoverInfo;

class Tag;
class CacheDataStream;

/**
 * An value based, explicitly shared wrapper around file related information
 * used in JuK's playlists.
 */

class FileHandle
{
public:
    FileHandle();
    FileHandle(const FileHandle &f);
    explicit FileHandle(const TQFileInfo &info, const TQString &path = TQString());
    explicit FileHandle(const TQString &path);
    FileHandle(const TQString &path, CacheDataStream &s);
    ~FileHandle();

    /**
     * Forces the FileHandle to reread its information from the disk.
     */
    void refresh();
    void setFile(const TQString &path);

    Tag *tag() const;
    CoverInfo *coverInfo() const;
    TQString absFilePath() const;
    const TQFileInfo &fileInfo() const;

    bool isNull() const;
    bool current() const;
    const TQDateTime &lastModified() const;

    void read(CacheDataStream &s);

    FileHandle &operator=(const FileHandle &f);
    bool operator==(const FileHandle &f) const;
    bool operator!=(const FileHandle &f) const;

    static TQStringList properties();
    TQString property(const TQString &name) const;

    static const FileHandle &null();

private:
    class FileHandlePrivate;
    FileHandlePrivate *d;

    void setup(const TQFileInfo &info, const TQString &path);
};

typedef TQValueList<FileHandle> FileHandleList;

TQDataStream &operator<<(TQDataStream &s, const FileHandle &f);
CacheDataStream &operator>>(CacheDataStream &s, FileHandle &f);

#endif