3 * Easy-to use interface to the ZYPP dependency resolver
5 * Author: Stefan Hundhammer <sh@suse.de>
9 #ifndef ZYPP_PROBLEMSOLUTION_H
10 #define ZYPP_PROBLEMSOLUTION_H
15 #include "zypp/base/ReferenceCounted.h"
16 #include "zypp/base/PtrTypes.h"
17 #include "zypp/solver/detail/Resolver.h"
18 #include "zypp/ResolverProblem.h"
19 #include "zypp/solver/detail/SolutionAction.h"
20 #include "zypp/solver/detail/Types.h"
22 /////////////////////////////////////////////////////////////////////////
24 { ///////////////////////////////////////////////////////////////////////
28 * Class representing one possible solution to one problem found during resolving
30 * All problems should have at least 2-3 (mutually exclusive) solutions:
32 * - Undo: Do not perform the offending transaction
33 * (do not install the package that had unsatisfied requirements,
34 * do not remove the package that would break other packages' requirements)
36 * - Remove referrers: Remove all packages that would break because
37 * they depend on the package that is requested to be removed
39 * - Ignore: Inject artificial "provides" for a missing requirement
40 * (pretend that requirement is satisfied)
42 class ProblemSolution : public base::ReferenceCounted
48 * In particular, delete all members of _actions.
55 ResolverProblem_Ptr _problem;
56 solver::detail::CSolutionActionList _actions;
57 std::string _description;
65 ProblemSolution( ResolverProblem_Ptr parent, const std::string & description, const std::string & details );
72 // ---------------------------------- I/O
74 friend std::ostream& operator<<(std::ostream&, const ProblemSolution & solution);
75 friend std::ostream& operator<<(std::ostream&, const ProblemSolutionList & solutionlist);
76 friend std::ostream& operator<<(std::ostream&, const CProblemSolutionList & solutionlist);
78 // ---------------------------------- accessors
80 * Return a one-line text description of this solution.
82 std::string description() const { return _description; }
85 * Return a (possibly multi-line) detailed description of this
86 * solution or an empty string if there are no useful details.
88 std::string details() const { return _details; }
91 * Return the parent dependency problem.
93 ResolverProblem_Ptr problem() const { return _problem; }
95 // ---------------------------------- methods
98 * Apply this solution, i.e. execute all of its actions.
100 * Returns 'true' on success, 'false' if actions could not be performed.
102 bool apply (solver::detail::Resolver & resolver);
105 * Add an action to the actions list.
107 void addAction( solver::detail::SolutionAction_constPtr action );
109 solver::detail::CSolutionActionList actions() {return _actions;}
114 ///////////////////////////////////////////////////////////////////////
116 /////////////////////////////////////////////////////////////////////////
118 #endif // ZYPP_PROBLEMSOLUTION_H