|
1 | 1 | // graph_edges.cpp -- P4b: the edges the dependency worklist records, one per |
2 | 2 | // consumer, dependency, visibility and table, with what each edge asks of its |
3 | | -// dependency. Split from graph.cpp at the boundary of what an edge is, when the |
| 3 | +// dependency, and the usage requirements the edges carry. Split from graph.cpp at the boundary of what an edge is, when the |
4 | 4 | // edge learned to carry `embed' and `exclude' (design 2026-11-02 §14.1). |
5 | 5 |
|
6 | 6 | module mcpp.build.prepare; |
@@ -136,4 +136,88 @@ void recordDependencyEdge( |
136 | 136 | }); |
137 | 137 | } |
138 | 138 |
|
| 139 | +// The usage requirements every edge carries to its consumer: a dependency's |
| 140 | +// public usage reaches the consumer's own units (Private, Public), its users |
| 141 | +// (Public, Interface), or, on a dev edge, the consumer's tests only. A fixpoint |
| 142 | +// over `dependencyEdges`, run again whenever a pass changed what a package |
| 143 | +// publishes. |
| 144 | +void define_usage_requirements(PrepareState& state) { |
| 145 | + state.computeUsageRequirements = [&state] { |
| 146 | + bool changed = true; |
| 147 | + while (changed) { |
| 148 | + changed = false; |
| 149 | + for (auto const& edge : state.dependencyEdges) { |
| 150 | + if (edge.consumerPackageIndex >= state.packages.size() |
| 151 | + || edge.dependencyPackageIndex >= state.packages.size()) { |
| 152 | + continue; |
| 153 | + } |
| 154 | + auto& consumer = state.packages[edge.consumerPackageIndex]; |
| 155 | + auto const& dependency = state.packages[edge.dependencyPackageIndex]; |
| 156 | + // A build dependency serves the build program, which is planned |
| 157 | + // in its own graph: its include directories and interface |
| 158 | + // defines do not reach this consumer's target compile (mcpp#797). |
| 159 | + if (edge.buildTable) continue; |
| 160 | + // A package of programs publishes no usage requirements to its |
| 161 | + // consumers (#649 E6): nothing of it is compiled or linked here. |
| 162 | + if (edge.dependencyPackageIndex > 0 |
| 163 | + && state.isProgramOnlyPackage(dependency.manifest)) continue; |
| 164 | + |
| 165 | + // A dev-dependency serves the consumer's tests: its usage |
| 166 | + // reaches the test units and neither the consumer's own |
| 167 | + // sources nor the consumer's users, so those sources compile |
| 168 | + // under `mcpp test` as under `mcpp build`. |
| 169 | + if (edge.devTable) { |
| 170 | + auto& tests = consumer.testBuild; |
| 171 | + changed = state.appendUniquePaths(tests.includeDirs, dependency.publicUsage.includeDirs) |
| 172 | + || changed; |
| 173 | + changed = state.appendUniquePaths(tests.includeDirsAfter, |
| 174 | + dependency.publicUsage.includeDirsAfter) |
| 175 | + || changed; |
| 176 | + changed = state.appendUniqueFlags(tests.cflags, dependency.publicUsage.cflags) || changed; |
| 177 | + changed = state.appendUniqueFlags(tests.cxxflags, dependency.publicUsage.cxxflags) || changed; |
| 178 | + continue; |
| 179 | + } |
| 180 | + |
| 181 | + if (edge.visibility == mcpp::modgraph::DependencyVisibility::Private |
| 182 | + || edge.visibility == mcpp::modgraph::DependencyVisibility::Public) { |
| 183 | + changed = state.appendUniquePaths(consumer.privateBuild.includeDirs, |
| 184 | + dependency.publicUsage.includeDirs) |
| 185 | + || changed; |
| 186 | + // #249: after-dirs ride the same edges but keep their |
| 187 | + // after-ness — consumers receive them as -idirafter, |
| 188 | + // never upgraded to -I. |
| 189 | + changed = state.appendUniquePaths(consumer.privateBuild.includeDirsAfter, |
| 190 | + dependency.publicUsage.includeDirsAfter) |
| 191 | + || changed; |
| 192 | + // Interface defines (a dependency's active-feature `defines`) |
| 193 | + // ride the same edges as include dirs: they must reach the |
| 194 | + // consumer's own TUs so header-only switches like |
| 195 | + // EIGEN_USE_BLAS take effect where the headers are used. |
| 196 | + changed = state.appendUniqueFlags(consumer.privateBuild.cflags, |
| 197 | + dependency.publicUsage.cflags) |
| 198 | + || changed; |
| 199 | + changed = state.appendUniqueFlags(consumer.privateBuild.cxxflags, |
| 200 | + dependency.publicUsage.cxxflags) |
| 201 | + || changed; |
| 202 | + } |
| 203 | + if (edge.visibility == mcpp::modgraph::DependencyVisibility::Public |
| 204 | + || edge.visibility == mcpp::modgraph::DependencyVisibility::Interface) { |
| 205 | + changed = state.appendUniquePaths(consumer.publicUsage.includeDirs, |
| 206 | + dependency.publicUsage.includeDirs) |
| 207 | + || changed; |
| 208 | + changed = state.appendUniquePaths(consumer.publicUsage.includeDirsAfter, |
| 209 | + dependency.publicUsage.includeDirsAfter) |
| 210 | + || changed; |
| 211 | + changed = state.appendUniqueFlags(consumer.publicUsage.cflags, |
| 212 | + dependency.publicUsage.cflags) |
| 213 | + || changed; |
| 214 | + changed = state.appendUniqueFlags(consumer.publicUsage.cxxflags, |
| 215 | + dependency.publicUsage.cxxflags) |
| 216 | + || changed; |
| 217 | + } |
| 218 | + } |
| 219 | + } |
| 220 | + }; |
| 221 | +} |
| 222 | + |
139 | 223 | } // namespace mcpp::build |
0 commit comments