Completed
Push — master ( 5e447a...e8aa6a )
by
unknown
03:32
created

MergePlugin::onDependencySolve()   B

Complexity

Conditions 5
Paths 6

Size

Total Lines 23
Code Lines 11

Duplication

Lines 0
Ratio 0 %

Code Coverage

Tests 17
CRAP Score 5

Importance

Changes 0
Metric Value
dl 0
loc 23
ccs 17
cts 17
cp 1
rs 8.5906
c 0
b 0
f 0
cc 5
eloc 11
nc 6
nop 1
crap 5
1
<?php
2
/**
3
 * This file is part of the Composer Merge plugin.
4
 *
5
 * Copyright (C) 2015 Bryan Davis, Wikimedia Foundation, and contributors
6
 *
7
 * This software may be modified and distributed under the terms of the MIT
8
 * license. See the LICENSE file for details.
9
 */
10
11
namespace Wikimedia\Composer;
12
13
use Wikimedia\Composer\Merge\ExtraPackage;
14
use Wikimedia\Composer\Merge\MissingFileException;
15
use Wikimedia\Composer\Merge\PluginState;
16
17
use Composer\Composer;
18
use Composer\DependencyResolver\Operation\InstallOperation;
19
use Composer\EventDispatcher\Event as BaseEvent;
20
use Composer\EventDispatcher\EventSubscriberInterface;
21
use Composer\Factory;
22
use Composer\Installer;
23
use Composer\Installer\InstallerEvent;
24
use Composer\Installer\InstallerEvents;
25
use Composer\Installer\PackageEvent;
26
use Composer\Installer\PackageEvents;
27
use Composer\IO\IOInterface;
28
use Composer\Package\RootPackageInterface;
29
use Composer\Plugin\PluginInterface;
30
use Composer\Script\Event as ScriptEvent;
31
use Composer\Script\ScriptEvents;
32
33
/**
34
 * Composer plugin that allows merging multiple composer.json files.
35
 *
36
 * When installed, this plugin will look for a "merge-plugin" key in the
37
 * composer configuration's "extra" section. The value for this key is
38
 * a set of options configuring the plugin.
39
 *
40
 * An "include" setting is required. The value of this setting can be either
41
 * a single value or an array of values. Each value is treated as a glob()
42
 * pattern identifying additional composer.json style configuration files to
43
 * merge into the configuration for the current compser execution.
44
 *
45
 * The "autoload", "autoload-dev", "conflict", "provide", "replace",
46
 * "repositories", "require", "require-dev", and "suggest" sections of the
47
 * found configuration files will be merged into the root package
48
 * configuration as though they were directly included in the top-level
49
 * composer.json file.
50
 *
51
 * If included files specify conflicting package versions for "require" or
52
 * "require-dev", the normal Composer dependency solver process will be used
53
 * to attempt to resolve the conflict. Specifying the 'replace' key as true will
54
 * change this default behaviour so that the last-defined version of a package
55
 * will win, allowing for force-overrides of package defines.
56
 *
57
 * By default the "extra" section is not merged. This can be enabled by
58
 * setitng the 'merge-extra' key to true. In normal mode, when the same key is
59
 * found in both the original and the imported extra section, the version in
60
 * the original config is used and the imported version is skipped. If
61
 * 'replace' mode is active, this behaviour changes so the imported version of
62
 * the key is used, replacing the version in the original config.
63
 *
64
 *
65
 * @code
66
 * {
67
 *     "require": {
68
 *         "wikimedia/composer-merge-plugin": "dev-master"
69
 *     },
70
 *     "extra": {
71
 *         "merge-plugin": {
72
 *             "include": [
73
 *                 "composer.local.json"
74
 *             ]
75
 *         }
76
 *     }
77
 * }
78
 * @endcode
79
 *
80
 * @author Bryan Davis <[email protected]>
81
 */
82
class MergePlugin implements PluginInterface, EventSubscriberInterface
83
{
84
85
    /**
86
     * Offical package name
87
     */
88
    const PACKAGE_NAME = 'wikimedia/composer-merge-plugin';
89
90
    /**
91
     * Name of the composer 1.1 init event.
92
     */
93
    const COMPAT_PLUGINEVENTS_INIT = 'init';
94
95
    /**
96
     * @var Composer $composer
97
     */
98
    protected $composer;
99
100
    /**
101
     * @var PluginState $state
102
     */
103
    protected $state;
104
105
    /**
106
     * @var Logger $logger
107
     */
108
    protected $logger;
109
110
    /**
111
     * Files that have already been fully processed
112
     *
113
     * @var string[] $loaded
114
     */
115
    protected $loaded = array();
116
117
    /**
118
     * Files that have already been partially processed
119
     *
120
     * @var string[] $loadedNoDev
121
     */
122
    protected $loadedNoDev = array();
123
124
    /**
125
     * {@inheritdoc}
126
     */
127 165
    public function activate(Composer $composer, IOInterface $io)
128
    {
129 165
        $this->composer = $composer;
130 165
        $this->state = new PluginState($this->composer);
131 165
        $this->logger = new Logger('merge-plugin', $io);
132 165
    }
133
134
    /**
135
     * {@inheritdoc}
136
     */
137 5
    public static function getSubscribedEvents()
138
    {
139
        return array(
140
            // Use our own constant to make this event optional. Once
141
            // composer-1.1 is required, this can use PluginEvents::INIT
142
            // instead.
143 5
            self::COMPAT_PLUGINEVENTS_INIT => 'onInit',
144 5
            InstallerEvents::PRE_DEPENDENCIES_SOLVING => 'onDependencySolve',
145 5
            PackageEvents::POST_PACKAGE_INSTALL => 'onPostPackageInstall',
146 5
            ScriptEvents::POST_INSTALL_CMD => 'onPostInstallOrUpdate',
147 5
            ScriptEvents::POST_UPDATE_CMD => 'onPostInstallOrUpdate',
148 5
            ScriptEvents::PRE_AUTOLOAD_DUMP => 'onInstallUpdateOrDump',
149 5
            ScriptEvents::PRE_INSTALL_CMD => 'onInstallUpdateOrDump',
150 5
            ScriptEvents::PRE_UPDATE_CMD => 'onInstallUpdateOrDump',
151 5
        );
152
    }
153
154
    /**
155
     * Handle an event callback for initialization.
156
     *
157
     * @param \Composer\EventDispatcher\Event $event
158
     */
159 60
    public function onInit(BaseEvent $event)
160
    {
161 60
        $this->state->loadSettings();
162
        // It is not possible to know if the user specified --dev or --no-dev
163
        // so assume it is false. The dev section will be merged later when
164
        // the other events fire.
165 60
        $this->state->setDevMode(false);
166 60
        $this->mergeFiles($this->state->getIncludes(), false);
167 60
        $this->mergeFiles($this->state->getRequires(), true);
168 60
    }
169
170
    /**
171
     * Handle an event callback for an install, update or dump command by
172
     * checking for "merge-plugin" in the "extra" data and merging package
173
     * contents if found.
174
     *
175
     * @param ScriptEvent $event
176
     */
177 145
    public function onInstallUpdateOrDump(ScriptEvent $event)
178
    {
179 145
        $this->state->loadSettings();
180 145
        $this->state->setDevMode($event->isDevMode());
181 145
        $this->mergeFiles($this->state->getIncludes(), false);
182 145
        $this->mergeFiles($this->state->getRequires(), true);
183
184 140
        if ($event->getName() === ScriptEvents::PRE_AUTOLOAD_DUMP) {
185 140
            $this->state->setDumpAutoloader(true);
186 140
            $flags = $event->getFlags();
187 140
            if (isset($flags['optimize'])) {
188 140
                $this->state->setOptimizeAutoloader($flags['optimize']);
189 140
            }
190 140
        }
191 140
    }
192
193
    /**
194
     * Find configuration files matching the configured glob patterns and
195
     * merge their contents with the master package.
196
     *
197
     * @param array $patterns List of files/glob patterns
198
     * @param bool $required Are the patterns required to match files?
199
     * @throws MissingFileException when required and a pattern returns no
200
     *      results
201
     */
202 145
    protected function mergeFiles(array $patterns, $required = false)
203
    {
204 145
        $root = $this->composer->getPackage();
205
206 145
        $files = array_map(
207 145
            function ($files, $pattern) use ($required) {
208 145
                if ($required && !$files) {
209 5
                    throw new MissingFileException(
210 5
                        "merge-plugin: No files matched required '{$pattern}'"
211 5
                    );
212
                }
213 140
                return $files;
214 145
            },
215 145
            array_map('glob', $patterns),
216
            $patterns
217 145
        );
218
219 145
        foreach (array_reduce($files, 'array_merge', array()) as $path) {
220 140
            $this->mergeFile($root, $path);
221 145
        }
222 145
    }
223
224
    /**
225
     * Read a JSON file and merge its contents
226
     *
227
     * @param RootPackageInterface $root
228
     * @param string $path
229
     */
230 140
    protected function mergeFile(RootPackageInterface $root, $path)
231
    {
232 140
        if (isset($this->loaded[$path]) ||
233 140
            (isset($this->loadedNoDev[$path]) && !$this->state->isDevMode())
234 140
        ) {
235 140
            $this->logger->debug(
236 140
                "Already merged <comment>$path</comment> completely"
237 140
            );
238 140
            return;
239
        }
240
241 140
        $package = new ExtraPackage($path, $this->composer, $this->logger);
242
243 140
        if (isset($this->loadedNoDev[$path])) {
244 60
            $this->logger->info(
245 60
                "Loading -dev sections of <comment>{$path}</comment>..."
246 60
            );
247 60
            $package->mergeDevInto($root, $this->state);
248 60
        } else {
249 140
            $this->logger->info("Loading <comment>{$path}</comment>...");
250 140
            $package->mergeInto($root, $this->state);
251
        }
252
253 140
        if ($this->state->isDevMode()) {
254 135
            $this->loaded[$path] = true;
255 135
        } else {
256 65
            $this->loadedNoDev[$path] = true;
257
        }
258
259 140
        if ($this->state->recurseIncludes()) {
260 135
            $this->mergeFiles($package->getIncludes(), false);
261 135
            $this->mergeFiles($package->getRequires(), true);
262 135
        }
263 140
    }
264
265
    /**
266
     * Handle an event callback for pre-dependency solving phase of an install
267
     * or update by adding any duplicate package dependencies found during
268
     * initial merge processing to the request that will be processed by the
269
     * dependency solver.
270
     *
271
     * @param InstallerEvent $event
272
     */
273 140
    public function onDependencySolve(InstallerEvent $event)
274
    {
275 140
        $request = $event->getRequest();
276 140
        foreach ($this->state->getDuplicateLinks('require') as $link) {
277 25
            $this->logger->info(
278 25
                "Adding dependency <comment>{$link}</comment>"
279 25
            );
280 25
            $request->install($link->getTarget(), $link->getConstraint());
281 140
        }
282
283
        // Issue #113: Check devMode of event rather than our global state.
284
        // Composer fires the PRE_DEPENDENCIES_SOLVING event twice for
285
        // `--no-dev` operations to decide which packages are dev only
286
        // requirements.
287 140
        if ($this->state->shouldMergeDev() && $event->isDevMode()) {
288 135
            foreach ($this->state->getDuplicateLinks('require-dev') as $link) {
289 10
                $this->logger->info(
290 10
                    "Adding dev dependency <comment>{$link}</comment>"
291 10
                );
292 10
                $request->install($link->getTarget(), $link->getConstraint());
293 135
            }
294 135
        }
295 140
    }
296
297
    /**
298
     * Handle an event callback following installation of a new package by
299
     * checking to see if the package that was installed was our plugin.
300
     *
301
     * @param PackageEvent $event
302
     */
303 15
    public function onPostPackageInstall(PackageEvent $event)
304
    {
305 15
        $op = $event->getOperation();
306 15
        if ($op instanceof InstallOperation) {
307 15
            $package = $op->getPackage()->getName();
308 15
            if ($package === self::PACKAGE_NAME) {
309 10
                $this->logger->info('composer-merge-plugin installed');
310 10
                $this->state->setFirstInstall(true);
311 10
                $this->state->setLocked(
312 10
                    $event->getComposer()->getLocker()->isLocked()
313 10
                );
314 10
            }
315 15
        }
316 15
    }
317
318
    /**
319
     * Handle an event callback following an install or update command. If our
320
     * plugin was installed during the run then trigger an update command to
321
     * process any merge-patterns in the current config.
322
     *
323
     * @param ScriptEvent $event
324
     */
325 140
    public function onPostInstallOrUpdate(ScriptEvent $event)
326
    {
327
        // @codeCoverageIgnoreStart
328
        if ($this->state->isFirstInstall()) {
329
            $this->state->setFirstInstall(false);
330
            $this->logger->info(
331
                '<comment>' .
332
                'Running additional update to apply merge settings' .
333
                '</comment>'
334
            );
335
336
            $config = $this->composer->getConfig();
337
338
            $preferSource = $config->get('preferred-install') == 'source';
339
            $preferDist = $config->get('preferred-install') == 'dist';
340
341
            $installer = Installer::create(
342
                $event->getIO(),
343
                // Create a new Composer instance to ensure full processing of
344
                // the merged files.
345
                Factory::create($event->getIO(), null, false)
346
            );
347
348
            $installer->setPreferSource($preferSource);
349
            $installer->setPreferDist($preferDist);
350
            $installer->setDevMode($event->isDevMode());
351
            $installer->setDumpAutoloader($this->state->shouldDumpAutoloader());
352
            $installer->setOptimizeAutoloader(
353
                $this->state->shouldOptimizeAutoloader()
354
            );
355
356
            if ($this->state->forceUpdate()) {
357
                // Force update mode so that new packages are processed rather
358
                // than just telling the user that composer.json and
359
                // composer.lock don't match.
360
                $installer->setUpdate(true);
361
            }
362
363
            $installer->run();
364
        }
365
        // @codeCoverageIgnoreEnd
366 140
    }
367
}
368
// vim:sw=4:ts=4:sts=4:et:
369