zypp/RepoStatus.h

   1 /*---------------------------------------------------------------------\
   2 |                          ____ _   __ __ ___                          |
   3 |                         |__  / \ / / . \ . \                         |
   4 |                           / / \ V /|  _/  _/                         |
   5 |                          / /__ | | | | | |                           |
   6 |                         /_____||_| |_| |_|                           |
   7 |                                                                      |
   8 \---------------------------------------------------------------------*/
   9 /** \file       zypp/RepoStatus.h
  10  *
  11 */
  12 #ifndef ZYPP2_REPOSTATUS_H
  13 #define ZYPP2_REPOSTATUS_H
  14
  15 #include <iosfwd>
  16 #include "zypp/base/PtrTypes.h"
  17 #include "zypp/CheckSum.h"
  18 #include "zypp/Date.h"
  19
  20 ///////////////////////////////////////////////////////////////////
  21 namespace zypp
  22 { /////////////////////////////////////////////////////////////////
  23
  24   ///////////////////////////////////////////////////////////////////
  25   //
  26   //    CLASS NAME : RepoStatus
  27   //
  28   /**
  29    * \short Local facts about a repository
  30    * This class represents the status of a
  31    * repository on the system.
  32    *
  33    * Anything that is not provided on the metadata
  34    * files, like the timestamp of the downloaded
  35    * metadata, and its checksum.
  36    */
  37   class RepoStatus
  38   {
  39     friend std::ostream & operator<<( std::ostream & str, const RepoStatus & obj );
  40
  41   public:
  42
  43     /**
  44      * reads the status from a file which contains the
  45      * checksum and timestamp in each line.
  46      *
  47      * \throws Exception If the file is not valid or accessible
  48      */
  49     static RepoStatus fromCookieFile( const Pathname &path );
  50
  51     /**
  52      * Checksum of the repository.
  53      * Usually the checksum of the index, but any
  54      * checksum that changes when the repository changes
  55      * in any way is sufficient.
  56      */
  57     std::string checksum() const;
  58
  59     /**
  60      * timestamp of the repository. If the repository
  61      * changes, it has to be updated as well with the
  62      * new timestamp.
  63      */
  64     Date timestamp() const;
  65
  66     /**
  67      * \short Is the status empty?
  68      *
  69      * An empty status means that the status
  70      * was not calculated.
  71      */
  72     bool empty() const;
  73
  74     /**
  75      * set the repository checksum \see checksum
  76      * \param checksum
  77      */
  78     RepoStatus & setChecksum( const std::string &checksum );
  79
  80     /**
  81      * set the repository timestamp \see timestamp
  82      * \param timestamp
  83      */
  84     RepoStatus & setTimestamp( const Date &timestamp );
  85
  86     /** Implementation  */
  87     class Impl;
  88
  89   public:
  90     /** Default ctor */
  91     RepoStatus();
  92
  93     /**
  94      * \short Status from a single file
  95      * As most repository state is represented
  96      * by the status of the index file, you can
  97      * construct the status from a file.
  98      *
  99      * \note construct from a non existing
 100      * file will result in an empty status
 101      */
 102     RepoStatus( const Pathname &file );
 103
 104     /** Dtor */
 105     ~RepoStatus();
 106
 107   public:
 108
 109   private:
 110     /** Pointer to implementation */
 111     RWCOW_pointer<Impl> _pimpl;
 112   };
 113   ///////////////////////////////////////////////////////////////////
 114
 115   /** \relates RepoStatus Stream output */
 116   std::ostream & operator<<( std::ostream & str, const RepoStatus & obj );
 117
 118   /**
 119    * combines 2 repostatus with a checksum based on both
 120    * checksums and the newest timestamp
 121    */
 122   RepoStatus operator&&( const RepoStatus &lhs, const RepoStatus &rhs );
 123
 124   /////////////////////////////////////////////////////////////////
 125 } // namespace zypp
 126 ///////////////////////////////////////////////////////////////////
 127 #endif // ZYPP2_REPOSTATUS_H