vcsdiff.h 4.42 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21
/* This file is part of KDevelop
 *
 * Copyright 2007 Andreas Pakulat <apaku@gmx.de>
 * Copyright 2007 Matthew Woehlke <mw_triad@users.sourceforge.net>
 *
 * 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.
 *
 * 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., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
 */

22 23
#ifndef KDEVPLATFORM_VCSDIFF_H
#define KDEVPLATFORM_VCSDIFF_H
24

25
//Needed first as it provides a hash-function for QHash
26
#include "vcslocation.h"
27

28
#include <QHash>
29
#include <QSharedDataPointer>
30

31 32
#include "vcsexport.h"

33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
class QString;
class QByteArray;

namespace KDevelop
{

class KDEVPLATFORMVCS_EXPORT VcsDiff
{
public:
    /**
     * Specify the type of difference the diff() method should create. Note that a
     * request for DiffUnified may not be honored, e.g. if the items being diffed are
     * binary rather than text.
     */
    enum Type
    {
49 50 51
        DiffRaw         /**< Request complete copies of both items. */,
        DiffUnified     /**< Request copy of first item with diff. */,
        DiffDontCare    /**< Don't care; plugin will return whichever is easiest. */
52 53 54 55
    };

    enum Content
    {
56 57
        Binary          /**< Binary diff, using the full content of both files.*/,
        Text            /**< Textual diff.*/
58 59 60
    };

    VcsDiff();
61
    virtual ~VcsDiff();
62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
    VcsDiff( const VcsDiff& );

    /**
     * @returns the type of diff, i.e. raw or unified
     */
    Type type() const;

    /**
     * @returns the content type, i.e. binary or text
     */
    Content contentType() const;

    /**
     * @returns the binary content of the first file of the difference or
     * an empty QByteArray if this is a textual diff
     */
78
    QHash<KDevelop::VcsLocation, QByteArray> leftBinaries() const;
79 80 81 82 83

    /**
     * @returns the binary content of the second file of the difference or
     * an empty QByteArray if this is a textual diff
     */
84
    QHash<KDevelop::VcsLocation, QByteArray> rightBinaries() const;
85 86 87 88 89

    /**
     * @returns the textual content of the first file of the difference or
     * an empty QString if this is a binary diff
     */
90
    QHash<KDevelop::VcsLocation, QString> leftTexts() const;
91 92 93 94 95

    /**
     * @returns the textual content of the second file of the difference or
     * an empty QString if this is a unified or binary diff
     */
96
    QHash<KDevelop::VcsLocation, QString> rightTexts() const;
97 98 99 100 101 102 103

    /**
     * @returns the difference between the first and the second file in
     * unified diff format or an empty QString if this is a binary diff
     * or a textual diff using raw format
     */
    QString diff() const;
104 105
    
    /** @returns the base directory of the diff. */
Milian Wolff's avatar
Milian Wolff committed
106
    QUrl baseDiff() const;
107 108 109 110 111 112 113

	/**
	 * Depth - number of directories to left-strip from paths in the patch - see "patch -p"
     * Defaults to 0
	 */
    uint depth() const;

114
    /** Sets the base directory of the diff to the @p url */
115
    void setBaseDiff(const QUrl& url);
116
    /** Sets the depth of the diff to @p depth */
117
    void setDepth(const uint depth);
118 119

    void setDiff( const QString& );
120 121 122 123 124 125 126 127 128 129
    void addLeftBinary( const KDevelop::VcsLocation&, const QByteArray& );
    void removeLeftBinary( const KDevelop::VcsLocation& );
    void addRightBinary( const KDevelop::VcsLocation&, const QByteArray& );
    void removeRightBinary( const KDevelop::VcsLocation& );

    void addLeftText( const KDevelop::VcsLocation&, const QString& );
    void removeLeftText( const KDevelop::VcsLocation& );
    void addRightText( const KDevelop::VcsLocation&, const QString& );
    void removeRightText( const KDevelop::VcsLocation& );

130 131 132
    void setType( Type );
    void setContentType( Content );
    VcsDiff& operator=( const VcsDiff& rhs);
133 134 135
    
    /** @returns whether there are not changes on the diff */
    bool isEmpty() const;
136
    
137
private:
138
    QSharedDataPointer<class VcsDiffPrivate> d;
139 140 141 142 143
};

}

Q_DECLARE_METATYPE( KDevelop::VcsDiff )
144
Q_DECLARE_TYPEINFO( KDevelop::VcsDiff, Q_MOVABLE_TYPE );
145 146 147

#endif