#include <list>
#include "zypp/base/PtrTypes.h"
-//#include "zypp/base/ReferenceCounted.h"
-//#include "zypp/base/NonCopyable.h"
#include "zypp/Pathname.h"
#include "zypp/ZConfig.h"
-#include "zypp/Repository.h"
#include "zypp/RepoInfo.h"
#include "zypp/repo/RepoException.h"
#include "zypp/repo/RepoType.h"
///////////////////////////////////////////////////////////////////
namespace zypp
{ /////////////////////////////////////////////////////////////////
+ class Service; //predef
/**
* Parses \a repo_file and returns a list of \ref RepoInfo objects
* corresponding to repositories found within the file.
- *
+ *
* \param repo_file Valid URL of the repo file.
* \return found list<RepoInfo>
*
*/
struct RepoManagerOptions
{
- RepoManagerOptions();
-
+ /** Default ctor following \ref ZConfig global settings.
+ * If an optional \c root_r directory is given, all paths will
+ * be prefixed accordingly.
+ * \code
+ * root_r\repoCachePath
+ * \repoRawCachePath
+ * \repoSolvCachePath
+ * \repoPackagesCachePath
+ * \knownReposPath
+ * \endcode
+ */
+ RepoManagerOptions( const Pathname & root_r = Pathname() );
+
+ /** Test setup adjusting all paths to be located below one \c root_r directory.
+ * \code
+ * root_r\ - repoCachePath
+ * \raw - repoRawCachePath
+ * \solv - repoSolvCachePath
+ * \packages - repoPackagesCachePath
+ * \repos.d - knownReposPath
+ * \endcode
+ */
+ static RepoManagerOptions makeTestSetup( const Pathname & root_r );
+
Pathname repoCachePath;
Pathname repoRawCachePath;
+ Pathname repoSolvCachePath;
+ Pathname repoPackagesCachePath;
Pathname knownReposPath;
+ Pathname knownServicesPath;
+ bool probe;
};
+
+
/**
* \short creates and provides information about known sources.
*
/** Implementation */
class Impl;
+ /** service typedefs */
+ typedef std::set<Service> ServiceSet;
+ typedef ServiceSet::const_iterator ServiceConstIterator;
+ typedef ServiceSet::size_type ServiceSizeType;
+
public:
RepoManager( const RepoManagerOptions &options = RepoManagerOptions() );
/** Dtor */
~RepoManager();
-
+
enum RawMetadataRefreshPolicy
{
RefreshIfNeeded,
- RefreshForced
+ RefreshForced,
+ RefreshIfNeededIgnoreDelay
};
-
+
enum CacheBuildPolicy
{
BuildIfNeeded,
BuildForced
};
-
+
enum RepoRemovePolicy
{
-
+
};
/**
*/
RepoStatus metadataStatus( const RepoInfo &info ) const;
+ /**
+ * Possibly return state of checkIfRefreshMEtadata function
+ */
+ enum RefreshCheckStatus {
+ REFRESH_NEEDED, /**< refresh is needed */
+ REPO_UP_TO_DATE, /**< repository not changed */
+ REPO_CHECK_DELAYED /**< refresh is delayed due to settings */
+ };
+
+ /**
+ * Checks whether to refresh metadata for specified repository and url.
+ * <p>
+ * The need for refresh is evaluated according to the following conditions,
+ * in that order:
+ * <ul>
+ * <li>the refresh policy (refresh may be forced)
+ * <li>the repo.refresh.delay ZConfig value compared to the difference between
+ * cached index file timestamp and actual time
+ * <li>the timestamp of cached repo index file compared to the remote
+ * index file timestamp.
+ * </ul>
+ * <p>
+ * This method checks the status against the specified url only. If more
+ * baseurls are defined for in the RepoInfo, each one must be check
+ * individually. Example:
+ *
+ * <code>
+ *
+ * RepoInfo info;
+ * // try urls one by one
+ * for ( RepoInfo::urls_const_iterator it = info.baseUrlsBegin();
+ * it != info.baseUrlsEnd(); ++it )
+ * {
+ * try
+ * {
+ * // check whether to refresh metadata
+ * // if the check fails for this url, it throws, so another url will be checked
+ * if (checkIfToRefreshMetadata(info, *it, policy)!=RepoInfo::REFRESH_NEEDED)
+ * return;
+ *
+ * // do the actual refresh
+ * }
+ * catch (const Exception & e)
+ * {
+ * ZYPP_CAUGHT(e);
+ * ERR << *it << " doesn't look good. Trying another url." << endl;
+ * }
+ * } // for all urls
+ *
+ * handle("No more URLs.");
+ *
+ * </code>
+ *
+ * \param info
+ * \param url
+ * \param policy
+ * \return state of repository
+ * \see RefreshCheckStatus
+ * \throws RepoUnknownTypeException
+ * \throws repo::RepoNoAliasException if can't figure an alias
+ * \throws Exception on unknown error
+ *
+ */
+ RefreshCheckStatus checkIfToRefreshMetadata( const RepoInfo &info,
+ const Url &url,
+ RawMetadataRefreshPolicy policy = RefreshIfNeeded);
+
+ /**
+ * \short Path where the metadata is downloaded and kept
+ *
+ * Given a repoinfo, tells where \ref RepoManager will download
+ * and keep the raw metadata.
+ *
+ * \param info Repository information
+ *
+ * \throws repo::RepoNoAliasException if can't figure an alias
+ */
+ Pathname metadataPath( const RepoInfo &info ) const;
+
+
+ /**
+ * \short Path where the rpm packages are downloaded and kept
+ *
+ * Given a repoinfo, tells where \ref RepoProvidePackage will download
+ * and keep the .rpm files.
+ *
+ * \param info Repository information
+ *
+ * \throws repo::RepoNoAliasException if can't figure an alias
+ */
+ Pathname packagesPath( const RepoInfo &info ) const;
+
+
/**
* \short Refresh local raw cache
*
* \throws repo::RepoNoAliasException if can't figure an alias
* \throws repo::RepoUnknownTypeException if the metadata is unknown
* \throws repo::RepoException if the repository is invalid
- * (no valid metadata found at any of baseurls)
- * \throws Exception on unknown error.
+ * (no valid metadata found at any of baseurls)
*/
void refreshMetadata( const RepoInfo &info,
RawMetadataRefreshPolicy policy = RefreshIfNeeded,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short Clean local metadata
*
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
/**
+ * \short Clean local package cache
+ *
+ * Empty local directory with downloaded packages
+ *
+ * \throws repo::RepoNoAliasException if can't figure an alias
+ * \throws Exception on unknown error.
+ */
+ void cleanPackages( const RepoInfo &info,
+ const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
+
+ /**
* \short Status of metadata cache
*/
RepoStatus cacheStatus( const RepoInfo &info ) const;
-
+
/**
* \short Refresh local cache
*
- * Will try to build the cache from
- * local metadata.
+ * Will try to build the cache from local metadata.
*
* If the cache exists it will be overwriten.
*
* \note the local metadata must be valid.
*
- * \throws repo::RepoNoAliasException if can't figure
- * an alias to look in cache
- *
+ * \throws repo::RepoNoAliasException if can't figure
+ * an alias to look in cache
* \throws repo::RepoMetadataException if the metadata
- * is not enough to build a cache (empty, incorrect, or
- * refresh needed)
+ * is not enough to build a cache (empty, incorrect, or
+ * refresh needed)
+ * \throws repo::RepoUnknownTypeException
+ * \throws parser::ParseException if parser encounters an error.
* \throws Exception on unknown error.
*/
void buildCache( const RepoInfo &info,
CacheBuildPolicy policy = BuildIfNeeded,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short clean local cache
*
* \note the local metadata must be valid.
*
* \throws repo::RepoNoAliasException if can't figure an alias to look in cache
+ * \throws cache::CacheRecordNotFoundException if the cache could not be
+ * cleaned because of repository record not found.
* \throws Exception on unknown error.
*/
void cleanCache( const RepoInfo &info,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short Whether a repository exists in cache
*
* \param RepoInfo to be checked.
*/
bool isCached( const RepoInfo &info ) const;
-
- /**
- * \short Create a repository object from the cache data
+
+
+ /**
+ * \short Load resolvables into the pool
*
* Creating from cache requires that the repository is
* refreshed (metadata downloaded) and cached
* \throws repo::RepoNoAliasException if can't figure an alias to look in cache
* \throw RepoNotCachedException When the source is not cached.
*/
- Repository createFromCache( const RepoInfo &info,
- const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
- /**
- * \short Create a repository object from raw metadata
- *
- * Creating from cache requires that the repository is
- * refreshed (metadata downloaded)
- *
- * \throw Exception If there are errors parsing the
- * raw metadata
- */
- Repository createFromMetadata( const RepoInfo &info,
- const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+ void loadFromCache( const RepoInfo &info,
+ const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
/**
* \short Probe repo metadata type.
*
* \todo FIXME Should this be private?
*/
repo::RepoType probe( const Url &url ) const;
-
-
+
+
/**
* \short Adds a repository to the list of known repositories.
*
- *
*
- * \throws repo::RepoAlreadyExistsException If the repo clash some
- * unique attribute like alias
*
- * \throws RepoAlreadyExistsException
+ * \throws repo::RepoAlreadyExistsException If the repo clash some
+ * unique attribute like alias
+ * \throws RepoUnknownType If repository type can't be determined
+ * \throws RepoException If the access to the url fails (while probing).
+ * \throws Exception On other errors.
*/
void addRepository( const RepoInfo &info,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short Adds repositores from a repo file to the list of known repositories.
* \param url Url of the repo file
- *
- * \throws repo::RepoAlreadyExistsException If the repo clash some
+ *
+ * \throws repo::RepoAlreadyExistsException If the repo clash some
* unique attribute like alias
*
* \throws RepoAlreadyExistsException
* \throws MediaException If the access to the url fails
* \throws ParseException If the file parsing fails
+ * \throws RepoUnknownType If repository type can't be determined
+ * \throws RepoException ON other repository related errors
* \throws Exception On other errors.
*/
void addRepositories( const Url &url,
*/
void removeRepository( const RepoInfo & info,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short Modify repository attributes
*
+ * \throws RepoAlreadyExistsException if the alias specified in newinfo
+ * is already used by another repository
* \throws RepoNotFoundException If no repo match
* \throws ParseException If the file parsing fails
* \throws Exception On other errors.
*/
RepoInfo getRepositoryInfo( const std::string &alias,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
-
+
/**
* \short Find repository info by URL.
*
const url::ViewOption & urlview = url::ViewOption::DEFAULTS,
const ProgressData::ReceiverFnc & progressrcv = ProgressData::ReceiverFnc() );
+ void addService( const std::string& name, const Url& url );
+
+ void removeService( const std::string& name );
+
+ bool serviceEmpty() const;
+
+ ServiceSizeType serviceSize() const;
+
+ ServiceConstIterator serviceBegin() const;
+
+ ServiceConstIterator serviceEnd() const;
+
+ const Service& getService( const std::string& name ) const;
+
+ void refreshServices();
+
+ /**
+ * modify service, except name change
+ * ( you need remove and add if you want change name )
+ */
+ void modifyService(const Service& service) const;
+
protected:
RepoStatus rawMetadataStatus( const RepoInfo &info );
- RepoStatus cacheStatus( const RepoInfo &info );
+ void setCacheStatus( const RepoInfo &info, const RepoStatus &status );
+
+ /**
+ * Update timestamp of repository index file for the specified repository \a info.
+ * Used in \ref checkIfToRefreshMetadata() for repo.refresh.delay feature.
+ */
+ void touchIndexFile(const RepoInfo & info);
+
public:
private:
projects / platform / upstream / libzypp.git / blobdiff