aboutsummaryrefslogtreecommitdiff
path: root/paludis/resolver/resolver.hh
blob: 8973c55875c1d6b79f4f4022773b3b58c6016b10 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
/* vim: set sw=4 sts=4 et foldmethod=syntax : */

/*
 * Copyright (c) 2009 Ciaran McCreesh
 *
 * This file is part of the Paludis package manager. Paludis is free software;
 * you can redistribute it and/or modify it under the terms of the GNU General
 * Public License version 2, as published by the Free Software Foundation.
 *
 * Paludis is distributed in the hope that it will be useful, but WITHOUT ANY
 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License along with
 * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 * Place, Suite 330, Boston, MA  02111-1307  USA
 */

#ifndef PALUDIS_GUARD_PALUDIS_RESOLVER_RESOLVER_HH
#define PALUDIS_GUARD_PALUDIS_RESOLVER_RESOLVER_HH 1

#include <paludis/resolver/resolver-fwd.hh>
#include <paludis/resolver/resolution-fwd.hh>
#include <paludis/resolver/qpn_s-fwd.hh>
#include <paludis/resolver/constraint-fwd.hh>
#include <paludis/resolver/sanitised_dependencies-fwd.hh>
#include <paludis/resolver/decision-fwd.hh>
#include <paludis/resolver/reason-fwd.hh>
#include <paludis/resolver/use_installed-fwd.hh>
#include <paludis/resolver/destinations-fwd.hh>
#include <paludis/resolver/resolver_functions-fwd.hh>
#include <paludis/util/private_implementation_pattern.hh>
#include <paludis/util/wrapped_forward_iterator-fwd.hh>
#include <paludis/package_id-fwd.hh>
#include <paludis/dep_spec-fwd.hh>
#include <paludis/name.hh>
#include <paludis/environment-fwd.hh>
#include <paludis/repository-fwd.hh>
#include <tr1/memory>

namespace paludis
{
    namespace resolver
    {
        class PALUDIS_VISIBLE Resolver :
            private PrivateImplementationPattern<Resolver>
        {
            private:
                QualifiedPackageName _package_from_spec(const PackageDepSpec &) const;

                const std::tr1::shared_ptr<Resolution> _create_resolution_for_qpn_s(const QPN_S &) const;
                const std::tr1::shared_ptr<Resolution> _resolution_for_qpn_s(const QPN_S &, const bool create);
                const std::tr1::shared_ptr<Resolution> _resolution_for_qpn_s(const QPN_S &) const;

                const std::tr1::shared_ptr<const QPN_S_Sequence> _get_qpn_s_s_for_blocker(const BlockDepSpec &) const;

                const std::tr1::shared_ptr<Constraint> _make_constraint_from_target(
                        const QPN_S &,
                        const PackageDepSpec &,
                        const std::tr1::shared_ptr<const Reason> &) const;

                const std::tr1::shared_ptr<Constraint> _make_constraint_from_dependency(
                        const QPN_S &, const SanitisedDependency &,
                        const std::tr1::shared_ptr<const Reason> &) const;

                const std::tr1::shared_ptr<Decision> _decision_from_package_id(
                        const QPN_S &, const std::tr1::shared_ptr<const PackageID> &) const;

                void _apply_resolution_constraint(const QPN_S &,
                        const std::tr1::shared_ptr<Resolution> &,
                        const std::tr1::shared_ptr<const Constraint> &);

                void _verify_new_constraint(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &,
                        const std::tr1::shared_ptr<const Constraint> &);

                void _made_wrong_decision(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &,
                        const std::tr1::shared_ptr<const Constraint> &) PALUDIS_ATTRIBUTE((noreturn));

                bool _constraint_matches(
                        const std::tr1::shared_ptr<const Constraint> &,
                        const std::tr1::shared_ptr<const Decision> &) const;

                const std::tr1::shared_ptr<Destinations> _make_destinations_for(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &) const;

                const std::tr1::shared_ptr<Destination> _make_slash_destination_for(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &) const;

                const std::tr1::shared_ptr<const PackageIDSequence> _find_replacing(
                        const std::tr1::shared_ptr<const PackageID> &,
                        const std::tr1::shared_ptr<const Repository> &) const;

                void _resolve_dependencies();
                void _resolve_destinations();
                void _resolve_arrows();
                void _resolve_order();

                void _decide(const QPN_S &, const std::tr1::shared_ptr<Resolution> & resolution);

                const std::tr1::shared_ptr<Decision> _try_to_find_decision_for(
                        const QPN_S &, const std::tr1::shared_ptr<const Resolution> & resolution) const;

                const std::tr1::shared_ptr<const PackageID> _best_installed_id_for(
                        const QPN_S &, const std::tr1::shared_ptr<const Resolution> &) const;

                const std::tr1::shared_ptr<const PackageID> _best_installable_id_for(
                        const QPN_S &, const std::tr1::shared_ptr<const Resolution> &) const;

                const std::tr1::shared_ptr<const PackageID> _best_id_from(
                        const std::tr1::shared_ptr<const PackageIDSequence> &,
                        const QPN_S &, const std::tr1::shared_ptr<const Resolution> &) const;

                void _add_dependencies(const QPN_S & our_qpn_s, const std::tr1::shared_ptr<Resolution> & our_resolution);

                bool _care_about_dependency_spec(const QPN_S &, const std::tr1::shared_ptr<const Resolution> &,
                        const SanitisedDependency &) const;

                bool _causes_pre_arrow(const DependencyReason &) const;

                bool _can_order_now(const QPN_S &, const std::tr1::shared_ptr<const Resolution> & resolution,
                        const int ignorable_pass) const;

                void _do_order(const QPN_S &, const std::tr1::shared_ptr<Resolution> & resolution);

                void _unable_to_decide(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &) const PALUDIS_ATTRIBUTE((noreturn));

                void _unable_to_order_more() const PALUDIS_ATTRIBUTE((noreturn));

                const std::tr1::shared_ptr<Constraints> _initial_constraints_for(const QPN_S &) const;

                void _suggest_restart_with(const QPN_S &,
                        const std::tr1::shared_ptr<const Resolution> &,
                        const std::tr1::shared_ptr<const Constraint> &,
                        const std::tr1::shared_ptr<const Decision> &) const PALUDIS_ATTRIBUTE((noreturn));

                const std::tr1::shared_ptr<const Constraint> _make_constraint_for_preloading(
                        const QPN_S &,
                        const std::tr1::shared_ptr<const Decision> &) const;

                bool _dependency_to_destination_slash(
                        const QPN_S &, const SanitisedDependency &) const;

                bool _same_slot(const std::tr1::shared_ptr<const PackageID> & a,
                        const std::tr1::shared_ptr<const PackageID> & b) const;

                bool _already_met(const SanitisedDependency & dep) const;

                const std::string _find_cycle(const QPN_S &, const int ignorable_pass) const;

            public:
                Resolver(
                        const Environment * const,
                        const ResolverFunctions &);
                ~Resolver();

                void add_target_with_reason(const PackageDepSpec &, const std::tr1::shared_ptr<const Reason> &);
                void add_target(const PackageDepSpec &);
                void add_target(const SetName &);

                void resolve();

                struct ConstIteratorTag;
                typedef WrappedForwardIterator<ConstIteratorTag,
                        const std::tr1::shared_ptr<const Resolution> > ConstIterator;
                ConstIterator begin() const PALUDIS_ATTRIBUTE((warn_unused_result));
                ConstIterator end() const PALUDIS_ATTRIBUTE((warn_unused_result));

                struct ResolutionsByQPN_SConstIteratorTag;
                typedef WrappedForwardIterator<ResolutionsByQPN_SConstIteratorTag,
                        const std::pair<const QPN_S, std::tr1::shared_ptr<Resolution> > > ResolutionsByQPN_SConstIterator;
                ResolutionsByQPN_SConstIterator begin_resolutions_by_qpn_s() const PALUDIS_ATTRIBUTE((warn_unused_result));
                ResolutionsByQPN_SConstIterator end_resolutions_by_qpn_s() const PALUDIS_ATTRIBUTE((warn_unused_result));

                int find_any_score(const QPN_S &, const SanitisedDependency &) const;

        };
    }
}

#endif