]> git.lyx.org Git - lyx.git/blobdiff - src/VCBackend.h
Fix bug #12772
[lyx.git] / src / VCBackend.h
index 33aefbe968da1e36f2dec1e8e01c3f459a2d4b04..e0f6266513f0a60553761d07481a93c90f89ad5e 100644 (file)
@@ -16,6 +16,7 @@
 #include "support/FileName.h"
 
 #include <string>
+#include <vector>
 
 #include "LyXVC.h"
 
@@ -31,34 +32,55 @@ public:
        enum VCStatus {
                UNLOCKED,
                LOCKED,
-               NOLOCKING
+               NOLOCKING,
        };
 
+       VCS(Buffer * b) : vcstatus_(NOLOCKING), owner_(b) {}
        virtual ~VCS() {}
 
+       /// the name of the vc backend
+       virtual std::string vcname() const = 0;
        /// register a file for version control
        virtual void registrer(std::string const & msg) = 0;
-       /// check in the current revision, returns log
-       virtual std::string checkIn(std::string const & msg) = 0;
-       // can be this operation processed in the current RCS?
+       /// can this operation be processed in the current VCS?
+       virtual bool renameEnabled() = 0;
+       /// rename a file. Return non-empty log on success, empty log on failure.
+       virtual std::string rename(support::FileName const &, std::string const &) = 0;
+       /// can this operation be processed in the current VCS?
+       virtual bool copyEnabled() = 0;
+       /// copy a file. Return non-empty log on success, empty log on failure.
+       virtual std::string copy(support::FileName const &, std::string const &) = 0;
+       /// check in the current revision.
+       /// \p log is non-empty on success and may be empty on failure.
+       virtual LyXVC::CommandResult
+       checkIn(std::string const & msg, std::string & log) = 0;
+       /// can this operation be processed in the current VCS?
        virtual bool checkInEnabled() = 0;
+       /// should a log message provided for next checkin?
+       virtual bool isCheckInWithConfirmation() = 0;
        /// check out for editing, returns log
        virtual std::string checkOut() = 0;
-       // can be this operation processed in the current RCS?
+       /// can this operation be processed in the current VCS?
        virtual bool checkOutEnabled() = 0;
        /// synchronize with repository, returns log
        virtual std::string repoUpdate() = 0;
-       // can be this operation processed in the current RCS?
+       /// can this operation be processed in the current VCS?
        virtual bool repoUpdateEnabled() = 0;
-       // toggle locking property of the file
+       /// toggle locking property of the file
        virtual std::string lockingToggle() = 0;
-       // can be this operation processed in the current RCS?
+       /// can this operation be processed in the current VCS?
        virtual bool lockingToggleEnabled() = 0;
        /// revert current edits
-       virtual void revert() = 0;
-       /// FIXME
+       virtual bool revert() = 0;
+       /// should a confirmation before revert requested?
+       virtual bool isRevertWithConfirmation() = 0;
+       /**
+        * Merge the current with the previous version
+        * in a reverse patch kind of way, so that the
+        * result is to revert the last changes.
+        */
        virtual void undoLast() = 0;
-       // can be this operation processed in the current RCS?
+       /// can this operation be processed in the current VCS?
        virtual bool undoLastEnabled() = 0;
        /**
         * getLog - read the revision log into the given file
@@ -67,27 +89,39 @@ public:
        virtual void getLog(support::FileName const &) = 0;
        /// return the current version description
        virtual std::string const versionString() const = 0;
-       /// set the owning buffer
-       void owner(Buffer * b) { owner_ = b; }
        /// return the owning buffer
        Buffer * owner() const { return owner_; }
        /// return the lock status of this file
-       VCStatus status() const { return vcstatus; }
+       VCStatus status() const { return vcstatus_; }
        /// do we need special handling for read-only toggling?
        /// (also used for check-out operation)
        virtual bool toggleReadOnlyEnabled() = 0;
        /// Return revision info specified by the argument.
        virtual std::string revisionInfo(LyXVC::RevisionInfo const info) = 0;
-
+       /// can this operation be processed in the current VCS?
        virtual bool prepareFileRevision(std::string const & rev, std::string & f) = 0;
-
+       /// can this operation be processed in the current VCS?
        virtual bool prepareFileRevisionEnabled() = 0;
 
+       /// Check the directory given in start and all parent directories
+       /// for the existence of some other file
+       /// \param start : where we start looking (we will strip the filename if given
+       ///                     and just use the directory
+       /// \param file : the directory or file for which to look
+       ///                     Note that this can be e.g. ".git/index", so we will look for the .git
+       ///                     directory and also for an index file in it.
+       /// Returns a FileName object for the found file or else an empty FileName
+       static support::FileName checkParentDirs(support::FileName const & start, std::string const & file);
+
 protected:
        /// parse information from the version file
        virtual void scanMaster() = 0;
 
-       // GUI container for doVCCommandCall
+       /// Prepare a version identifier suitable for RCS and CVS.
+       /// If needed converts last or relative number to the absolute revision.
+       bool makeRCSRevision(std::string const &version, std::string &revis) const;
+
+       /// GUI container for doVCCommandCall
        int doVCCommand(std::string const & cmd, support::FileName const & path, bool reportError = true);
        /**
         * doVCCommandCall - call out to the version control utility
@@ -95,19 +129,14 @@ protected:
         * @param path the path from which to execute
         * @return exit status
         */
-       static int doVCCommandCall(std::string const & cmd, support::FileName const & path);
-
-       /**
-        * The master VC file. For RCS this is *,v or RCS/ *,v. master should
-        * have full path.
-        */
-       support::FileName master_;
+       static int doVCCommandCall(std::string const & cmd,
+                       support::FileName const & path = support::FileName());
 
        /// The status of the VC controlled file.
-       VCStatus vcstatus;
+       VCStatus vcstatus_;
 
        /// The buffer using this VC
-       Buffer * owner_;
+       Buffer * const owner_;
 };
 
 
@@ -116,54 +145,78 @@ class RCS : public VCS {
 public:
 
        explicit
-       RCS(support::FileName const & m);
+       RCS(support::FileName const & m, Buffer * b);
 
-       /// return the revision file for the given file, if found
+       /// Determine whether the file is under RCS control
+       /// \return the file containing the meta-data (FILE,v) if so, else empty
        static support::FileName const findFile(support::FileName const & file);
 
-       static void retrieve(support::FileName const & file);
+       /// get file from repo, the caller must ensure that it does not exist locally
+       static bool retrieve(support::FileName const & file);
+
+       std::string vcname() const override { return "RCS"; }
+
+       void registrer(std::string const & msg) override;
+
+       bool renameEnabled() override;
+
+       std::string rename(support::FileName const &, std::string const &) override;
+
+       bool copyEnabled() override;
 
-       virtual void registrer(std::string const & msg);
+       std::string copy(support::FileName const &, std::string const &) override;
 
-       virtual std::string checkIn(std::string const & msg);
+       LyXVC::CommandResult
+       checkIn(std::string const & msg, std::string & log) override;
 
-       virtual bool checkInEnabled();
+       bool checkInEnabled() override;
 
-       virtual std::string checkOut();
+       bool isCheckInWithConfirmation() override;
 
-       virtual bool checkOutEnabled();
+       std::string checkOut() override;
 
-       virtual std::string repoUpdate();
+       bool checkOutEnabled() override;
 
-       virtual bool repoUpdateEnabled();
+       std::string repoUpdate() override;
 
-       virtual std::string lockingToggle();
+       bool repoUpdateEnabled() override;
 
-       virtual bool lockingToggleEnabled();
+       std::string lockingToggle() override;
 
-       virtual void revert();
+       bool lockingToggleEnabled() override;
 
-       virtual void undoLast();
+       bool revert() override;
 
-       virtual bool undoLastEnabled();
+       bool isRevertWithConfirmation() override;
 
-       virtual void getLog(support::FileName const &);
+       void undoLast() override;
 
-       virtual std::string const versionString() const {
+       bool undoLastEnabled() override;
+
+       void getLog(support::FileName const &) override;
+
+       std::string const versionString() const override {
                return "RCS: " + version_;
        }
 
-       virtual bool toggleReadOnlyEnabled();
+       bool toggleReadOnlyEnabled() override;
 
-       virtual std::string revisionInfo(LyXVC::RevisionInfo const info);
+       std::string revisionInfo(LyXVC::RevisionInfo const info) override;
 
-       virtual bool prepareFileRevision(std::string const & rev, std::string & f);
+       bool prepareFileRevision(std::string const & rev, std::string & f) override;
 
-       virtual bool prepareFileRevisionEnabled();
+       bool prepareFileRevisionEnabled() override;
 
 protected:
-       virtual void scanMaster();
+       void scanMaster() override;
 private:
+       bool getRevisionInfo();
+       /**
+        * The master VC file. For RCS this is *,v or RCS/ *,v.
+        * master should have full path.
+        */
+       support::FileName master_;
+
        /**
         * The version of the VC file. I am not sure if this can be a
         * string or if it must be a float/int.
@@ -171,6 +224,12 @@ private:
        std::string version_;
        /// The user currently keeping the lock on the VC file (or "Unlocked").
        std::string locker_;
+       /// Cache for revision info.
+       std::string rev_date_cache_;
+       ///
+       std::string rev_time_cache_;
+       ///
+       std::string rev_author_cache_;
 };
 
 
@@ -179,55 +238,74 @@ class CVS : public VCS {
 public:
        ///
        explicit
-       CVS(support::FileName const & m, support::FileName const & f);
+       CVS(support::FileName const & m, Buffer * b);
 
-       /// return the revision file for the given file, if found
+       /// Determine whether the file is under CVS control
+       /// \return the file containing the meta-data (CVS/entries) if so, else empty
        static support::FileName const findFile(support::FileName const & file);
 
-       virtual void registrer(std::string const & msg);
+       /// get file from repo, the caller must ensure that it does not exist locally
+       static bool retrieve(support::FileName const & file);
+
+       std::string vcname() const override { return "CVS"; }
+
+       void registrer(std::string const & msg) override;
+
+       bool renameEnabled() override;
+
+       std::string rename(support::FileName const &, std::string const &) override;
 
-       virtual std::string checkIn(std::string const & msg);
+       bool copyEnabled() override;
 
-       virtual bool checkInEnabled();
+       std::string copy(support::FileName const &, std::string const &) override;
 
-       virtual std::string checkOut();
+       LyXVC::CommandResult
+       checkIn(std::string const & msg, std::string & log) override;
 
-       virtual bool checkOutEnabled();
+       bool checkInEnabled() override;
 
-       virtual std::string repoUpdate();
+       bool isCheckInWithConfirmation() override;
 
-       virtual bool repoUpdateEnabled();
+       std::string checkOut() override;
 
-       virtual std::string lockingToggle();
+       bool checkOutEnabled() override;
 
-       virtual bool lockingToggleEnabled();
+       std::string repoUpdate() override;
 
-       virtual void revert();
+       bool repoUpdateEnabled() override;
 
-       virtual void undoLast();
+       std::string lockingToggle() override;
 
-       virtual bool undoLastEnabled();
+       bool lockingToggleEnabled() override;
 
-       virtual void getLog(support::FileName const &);
+       bool isRevertWithConfirmation() override;
 
-       /// Check for messages in cvs output. 
+       bool revert() override;
+
+       void undoLast() override;
+
+       bool undoLastEnabled() override;
+
+       void getLog(support::FileName const &) override;
+
+       /// Check for messages in cvs output.
        /// Returns conflict line.
        std::string scanLogFile(support::FileName const & f, std::string & status);
 
-       virtual std::string const versionString() const {
+       std::string const versionString() const override {
                return "CVS: " + version_;
        }
 
-       virtual bool toggleReadOnlyEnabled();
+       bool toggleReadOnlyEnabled() override;
 
-       virtual std::string revisionInfo(LyXVC::RevisionInfo const info);
+       std::string revisionInfo(LyXVC::RevisionInfo const info) override;
 
-       virtual bool prepareFileRevision(std::string const & rev, std::string & f);
+       bool prepareFileRevision(std::string const & rev, std::string & f) override;
 
-       virtual bool prepareFileRevisionEnabled();
+       bool prepareFileRevisionEnabled() override;
 
 protected:
-       virtual void scanMaster();
+       void scanMaster() override;
        /// the mode of operation for some VC commands
        enum OperationMode {
                Directory = 0,
@@ -245,29 +323,60 @@ protected:
        };
 
 private:
-       support::FileName file_;
+       /**
+        * The master VC file. For CVS this is CVS/Entries
+        * master should have full path.
+        */
+       support::FileName master_;
        // revision number from scanMaster
        std::string version_;
 
+       /**
+        * doVCCommandWithOutput
+        * - call out to the version control utility
+        * - it is able to collect output in a file
+        * @param cmd the command to execute
+        * @param path the path from which to execute
+        * @param output the path where to store output
+        * @param reportError display of low level error message dialog
+        * @return exit status
+        */
+       int doVCCommandWithOutput(std::string const & cmd,
+                       support::FileName const & path,
+                       support::FileName const & output,
+                       bool reportError = true);
+       static int doVCCommandCallWithOutput(std::string const & cmd,
+                       support::FileName const & path,
+                       support::FileName const & output);
+
        /// return the quoted pathname if Directory or filename if File
-       virtual std::string const getTarget(OperationMode opmode) const;
+       std::string const getTarget(OperationMode opmode) const;
        /// collect the diff of file or directory against repository
        /// result is placed in temporary file
        void getDiff(OperationMode opmode, support::FileName const & tmpf);
        /// make the file ready for editing:
        /// save a copy in CVS/Base and change file permissions to rw if needed
-       virtual int edit();
+       int edit();
        /// revert the edit operation
-       virtual int unedit();
+       int unedit();
        /// retrieve repository changes into working copy
-       virtual int update(OperationMode opmode, support::FileName const & tmpf);
+       int update(OperationMode opmode, support::FileName const & tmpf);
        /// check readonly state for file
        /// assume true when file is writable
-       virtual bool isLocked() const;
+       bool isLocked() const;
        /// query and parse the cvs status of file
-       virtual CvsStatus getStatus();
+       CvsStatus getStatus();
        /// convert enum to string
-       virtual docstring toString(CvsStatus status) const;
+       docstring toString(CvsStatus status) const;
+
+       /// cache the info values of current file revision
+       /// author, date and time of commit
+       std::string rev_author_cache_;
+       std::string rev_date_cache_;
+       std::string rev_time_cache_;
+       /// fills the cache values, returns true if successfull.
+       void getRevisionInfo();
+       bool have_rev_info_;
 };
 
 
@@ -276,51 +385,69 @@ class SVN : public VCS {
 public:
        ///
        explicit
-       SVN(support::FileName const & m, support::FileName const & f);
+       SVN(Buffer * b);
 
-       /// return the revision file for the given file, if found
-       static support::FileName const findFile(support::FileName const & file);
+       /// Determine whether the file is under SVN control
+       static bool findFile(support::FileName const & file);
+
+       /// get file from repo, the caller must ensure that it does not exist locally
+       static bool retrieve(support::FileName const & file);
+
+       std::string vcname() const override { return "SVN"; }
+
+       void registrer(std::string const & msg) override;
 
-       virtual void registrer(std::string const & msg);
+       bool renameEnabled() override;
 
-       virtual std::string checkIn(std::string const & msg);
+       std::string rename(support::FileName const &, std::string const &) override;
 
-       virtual bool checkInEnabled();
+       bool copyEnabled() override;
 
-       virtual std::string checkOut();
+       std::string copy(support::FileName const &, std::string const &) override;
 
-       virtual bool checkOutEnabled();
+       LyXVC::CommandResult
+       checkIn(std::string const & msg, std::string & log) override;
 
-       virtual std::string repoUpdate();
+       bool checkInEnabled() override;
 
-       virtual bool repoUpdateEnabled();
+       bool isCheckInWithConfirmation() override;
 
-       virtual std::string lockingToggle();
+       std::string checkOut() override;
 
-       virtual bool lockingToggleEnabled();
+       bool checkOutEnabled() override;
 
-       virtual void revert();
+       std::string repoUpdate() override;
 
-       virtual void undoLast();
+       bool repoUpdateEnabled() override;
 
-       virtual bool undoLastEnabled();
+       std::string lockingToggle() override;
 
-       virtual void getLog(support::FileName const &);
+       bool lockingToggleEnabled() override;
 
-       virtual std::string const versionString() const {
+       bool revert() override;
+
+       bool isRevertWithConfirmation() override;
+
+       void undoLast() override;
+
+       bool undoLastEnabled() override;
+
+       void getLog(support::FileName const &) override;
+
+       std::string const versionString() const override {
                return "SVN: " + rev_file_cache_;
        }
 
-       virtual bool toggleReadOnlyEnabled();
+       bool toggleReadOnlyEnabled() override;
 
-       virtual std::string revisionInfo(LyXVC::RevisionInfo const info);
+       std::string revisionInfo(LyXVC::RevisionInfo const info) override;
 
-       virtual bool prepareFileRevision(std::string const & rev, std::string & f);
+       bool prepareFileRevision(std::string const & rev, std::string & f) override;
 
-       virtual bool prepareFileRevisionEnabled();
+       bool prepareFileRevisionEnabled() override;
 
 protected:
-       virtual void scanMaster();
+       void scanMaster() override;
        /// Check for messages in svn output. Returns error.
        std::string scanLogFile(support::FileName const & f, std::string & status);
        /// checks locking policy and setup locked_mode_
@@ -328,10 +455,12 @@ protected:
        /// is the loaded file locked?
        bool isLocked() const;
        /// acquire/release write lock for the current file
-       void fileLock(bool lock, support::FileName const & tmpf, std::string & status);
+       bool fileLock(bool lock, support::FileName const & tmpf, std::string & status);
+       /// Check in files \p f with log \p msg
+       LyXVC::CommandResult checkIn(std::vector<support::FileName> const & f,
+                                    std::string const & msg, std::string & log);
 
 private:
-       support::FileName file_;
        /// is the loaded file under locking policy?
        bool locked_mode_;
        /**
@@ -355,6 +484,111 @@ private:
        std::string rev_tree_cache_;
 };
 
+
+/**
+ * Very basic git support:
+ * Remote repos are completely ignored, only the local tree is considered.
+ * How push and pull could be integrated with the LyX VCS interface needs
+ * to be discussed.
+ */
+class GIT : public VCS {
+public:
+       ///
+       explicit
+       GIT(Buffer * b);
+
+       /// Determine whether the file is under GIT control
+       /// \return the file itself if so, else empty
+       static bool findFile(support::FileName const & file);
+
+       /// get file from repo, the caller must ensure that it does not exist locally
+       static bool retrieve(support::FileName const & file);
+
+       std::string vcname() const override { return "GIT"; }
+
+       void registrer(std::string const & msg) override;
+
+       bool renameEnabled() override;
+
+       std::string rename(support::FileName const &, std::string const &) override;
+
+       bool copyEnabled() override;
+
+       std::string copy(support::FileName const &, std::string const &) override;
+
+       LyXVC::CommandResult
+       checkIn(std::string const & msg, std::string & log) override;
+
+       bool checkInEnabled() override;
+
+       bool isCheckInWithConfirmation() override;
+
+       std::string checkOut() override;
+
+       bool checkOutEnabled() override;
+
+       std::string repoUpdate() override;
+
+       bool repoUpdateEnabled() override;
+
+       std::string lockingToggle() override;
+
+       bool lockingToggleEnabled() override;
+
+       bool revert() override;
+
+       bool isRevertWithConfirmation() override;
+
+       void undoLast() override;
+
+       bool undoLastEnabled() override;
+
+       void getLog(support::FileName const &) override;
+
+       std::string const versionString() const override {
+               return "GIT: ?";
+       }
+
+       bool toggleReadOnlyEnabled() override;
+
+       std::string revisionInfo(LyXVC::RevisionInfo const info) override;
+
+       bool prepareFileRevision(std::string const & rev, std::string & f) override;
+
+       bool prepareFileRevisionEnabled() override;
+
+protected:
+       void scanMaster() override;
+       /// Check for messages in svn output. Returns error.
+       std::string scanLogFile(support::FileName const & f, std::string & status);
+       /// Check in files \p f with log \p msg
+       LyXVC::CommandResult checkIn(std::vector<support::FileName> const & f,
+                                    std::string const & msg, std::string & log);
+
+private:
+       /**
+        * Real code for obtaining file revision info. Fills all file-related caches
+        * and returns true if successfull.
+        * "?" is stored in rev_file_cache_ as a signal if request for obtaining info
+        * was already unsuccessful.
+        */
+       bool getFileRevisionInfo();
+       /// cache for file revision number, "?" if already unsuccessful, isNumber==true
+       std::string rev_file_cache_;
+       /// cache for abbreviated file revision number, "?" if already unsuccessful, isNumber==true
+       std::string rev_file_abbrev_cache_;
+       /// cache for author of last commit
+       std::string rev_author_cache_;
+       /// cache for date of last commit
+       std::string rev_date_cache_;
+       /// cache for time of last commit
+       std::string rev_time_cache_;
+       /// fills rev_tree_cache_, returns true if successfull.
+       bool getTreeRevisionInfo();
+       /// cache for tree revision number, "?" if already unsuccessful
+       std::string rev_tree_cache_;
+};
+
 } // namespace lyx
 
 #endif // VCBACKEND_H