src/Converter.h

   1 // -*- C++ -*-
   2 /**
   3  * \file Converter.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author Dekel Tsur
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #ifndef CONVERTER_H
  13 #define CONVERTER_H
  14
  15 #include "Graph.h"
  16 #include "OutputParams.h"
  17
  18 #include <vector>
  19 #include <string>
  20
  21
  22 namespace lyx {
  23
  24 namespace support { class FileName; }
  25
  26 class Buffer;
  27 class ErrorList;
  28 class Format;
  29 class Formats;
  30 class OutputParams;
  31
  32
  33 ///
  34 class Converter {
  35 public:
  36         ///
  37         Converter(std::string const & f, std::string const & t, std::string const & c,
  38                   std::string const & l);
  39         ///
  40         void readFlags();
  41         ///
  42         std::string from;
  43         ///
  44         std::string to;
  45         ///
  46         std::string command;
  47         ///
  48         std::string flags;
  49         ///
  50         Format const * From;
  51         ///
  52         Format const * To;
  53
  54         /// The converter is latex or its derivatives
  55         bool latex;
  56         /// The converter is xml
  57         bool xml;
  58         /// This converter needs the .aux files
  59         bool need_aux;
  60         /// If the converter put the result in a directory, then result_dir
  61         /// is the name of the directory
  62         std::string result_dir;
  63         /// If the converter put the result in a directory, then result_file
  64         /// is the name of the main file in that directory
  65         std::string result_file;
  66         /// Command to convert the program output to a LaTeX log file format
  67         std::string parselog;
  68 };
  69
  70
  71 ///
  72 class Converters {
  73 public:
  74         ///
  75         typedef std::vector<Converter> ConverterList;
  76         ///
  77         typedef ConverterList::const_iterator const_iterator;
  78         ///
  79         Converter const & get(int i) const { return converterlist_[i]; }
  80         ///
  81         Converter const * getConverter(std::string const & from,
  82                                        std::string const & to) const;
  83         ///
  84         int getNumber(std::string const & from, std::string const & to) const;
  85         ///
  86         void add(std::string const & from, std::string const & to,
  87                  std::string const & command, std::string const & flags);
  88         //
  89         void erase(std::string const & from, std::string const & to);
  90         ///
  91         void sort();
  92         ///
  93         std::vector<Format const *> const
  94         getReachableTo(std::string const & target, bool clear_visited);
  95         ///
  96         std::vector<Format const *> const
  97         getReachable(std::string const & from, bool only_viewable,
  98                      bool clear_visited);
  99
 100         std::vector<Format const *> importableFormats();
 101         std::vector<Format const *> exportableFormats(bool only_viewable);
 102
 103         std::vector<std::string> loaders() const;
 104         std::vector<std::string> savers() const;
 105
 106         /// Does a conversion path from format \p from to format \p to exist?
 107         bool isReachable(std::string const & from, std::string const & to);
 108         ///
 109         Graph::EdgePath getPath(std::string const & from, std::string const & to);
 110         ///
 111         OutputParams::FLAVOR getFlavor(Graph::EdgePath const & path);
 112         /// Flags for converting files
 113         enum ConversionFlags {
 114                 /// No special flags
 115                 none = 0,
 116                 /// Use the default converter if no converter is defined
 117                 try_default = 1 << 0,
 118                 /// Get the converted file from cache if possible
 119                 try_cache = 1 << 1
 120         };
 121         ///
 122         bool convert(Buffer const * buffer,
 123                      support::FileName const & from_file, support::FileName const & to_file,
 124                      support::FileName const & orig_from,
 125                      std::string const & from_format, std::string const & to_format,
 126                      ErrorList & errorList, int conversionflags = none);
 127         ///
 128         void update(Formats const & formats);
 129         ///
 130         void updateLast(Formats const & formats);
 131         ///
 132         bool formatIsUsed(std::string const & format);
 133         ///
 134         const_iterator begin() const { return converterlist_.begin(); }
 135         ///
 136         const_iterator end() const { return converterlist_.end(); }
 137         ///
 138         void buildGraph();
 139 private:
 140         ///
 141         std::vector<Format const *> const
 142         intToFormat(std::vector<int> const & input);
 143         ///
 144         bool scanLog(Buffer const & buffer, std::string const & command,
 145                      support::FileName const & filename, ErrorList & errorList);
 146         ///
 147         bool runLaTeX(Buffer const & buffer, std::string const & command,
 148                       OutputParams const &, ErrorList & errorList);
 149         ///
 150         ConverterList converterlist_;
 151         ///
 152         std::string latex_command_;
 153         /// If \p from = /path/file.ext and \p to = /path2/file2.ext2 then
 154         /// this method moves each /path/file*.ext file to /path2/file2*.ext2
 155         bool move(std::string const & fmt,
 156                   support::FileName const & from, support::FileName const & to,
 157                   bool copy);
 158         ///
 159         Graph G_;
 160 };
 161
 162 /// The global instance.
 163 /// Implementation is in LyX.cpp.
 164 extern Converters & theConverters();
 165
 166 /// The global copy after reading lyxrc.defaults.
 167 /// Implementation is in LyX.cpp.
 168 extern Converters & theSystemConverters();
 169
 170 } // namespace lyx
 171
 172 #endif //CONVERTER_H