From 361a5325c707fa37393c41bac05d82c6e22196f8 Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 14:54:46 +0200
Subject: [PATCH 1/6] #18 the `Versions` class is not to be gitignored, as a
 stub will be present in its place

---
 .gitignore | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 9916a6d..0122635 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,4 +1,3 @@
 /vendor/
-src/PackageVersions/Versions.php
 composer.lock
 clover.xml
\ No newline at end of file

From ecf8760e742cd2fe523eb6afa05f9d47c18a2037 Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 15:02:57 +0200
Subject: [PATCH 2/6] #18 tests for a `FallbackVersions` provider that can work
 with just a `composer.lock` assumed location

---
 .../FallbackVersionsTest.php                  | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 test/PackageVersionsTest/FallbackVersionsTest.php

diff --git a/test/PackageVersionsTest/FallbackVersionsTest.php b/test/PackageVersionsTest/FallbackVersionsTest.php
new file mode 100644
index 0000000..7464fce
--- /dev/null
+++ b/test/PackageVersionsTest/FallbackVersionsTest.php
@@ -0,0 +1,61 @@
+<?php
+
+namespace PackageVersionsTest;
+
+use PackageVersions\FallbackVersions;
+use PackageVersions\Versions;
+use PHPUnit_Framework_TestCase;
+
+/**
+ * @covers \PackageVersions\FallbackVersions
+ */
+final class FallbackVersionsTest extends PHPUnit_Framework_TestCase
+{
+    public function testWillFailWithoutValidComposerLockLocation()
+    {
+        rename(__DIR__ . '/../../composer.lock', __DIR__ . '/../../composer.lock.backup');
+
+        try {
+            FallbackVersions::getVersion('phpunit/phpunit');
+
+            self::fail('An exception was supposed to be thrown');
+        } catch (\UnexpectedValueException $lockFileNotFound) {
+            $srcDir = realpath(__DIR__ . '/../../src/PackageVersions');
+
+            self::assertSame(
+                'PackageVersions could not locate your `composer.lock` location. '
+                . 'This is assumed to be in '
+                . json_encode([$srcDir . '/../../../../../composer.lock', $srcDir . '/../../composer.lock'])
+                . '. If you customized your composer vendor directory and ran composer installation with --no-scripts, '
+                . 'then you are on your own, and we can\'t really help you. '
+                . 'Fix your shit and cut the tooling some slack.',
+                $lockFileNotFound->getMessage()
+            );
+        }
+
+        rename(__DIR__ . '/../../composer.lock.backup', __DIR__ . '/../../composer.lock');
+    }
+
+    public function testValidVersions()
+    {
+        $lockData = json_decode(file_get_contents(__DIR__ . '/../../composer.lock'), true);
+
+        $packages = array_merge($lockData['packages'], $lockData['packages-dev']);
+
+        self::assertNotEmpty($packages);
+
+        foreach ($packages as $package) {
+            self::assertSame(
+                $package['version'] . '@' . $package['source']['reference'],
+                Versions::getVersion($package['name'])
+            );
+        }
+    }
+
+    public function testInvalidVersionsAreRejected()
+    {
+        $this->expectException(\OutOfBoundsException::class);
+
+        Versions::getVersion(uniqid('', true) . '/' . uniqid('', true));
+    }
+}

From 20783c908b27f20b7f86abf4da19ba6718e8ab88 Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 15:03:38 +0200
Subject: [PATCH 3/6] #18 implemented `FallbackVersions` as per specification

---
 src/PackageVersions/FallbackVersions.php | 78 ++++++++++++++++++++++++
 1 file changed, 78 insertions(+)
 create mode 100644 src/PackageVersions/FallbackVersions.php

diff --git a/src/PackageVersions/FallbackVersions.php b/src/PackageVersions/FallbackVersions.php
new file mode 100644
index 0000000..831f5b1
--- /dev/null
+++ b/src/PackageVersions/FallbackVersions.php
@@ -0,0 +1,78 @@
+<?php
+
+namespace PackageVersions;
+
+/**
+ * @internal
+ *
+ * This is a fallback for {@see \PackageVersions\Versions::getVersion()}
+ * Do not use this class directly: it is intended to be only used when
+ * {@see \PackageVersions\Versions} fails to be generated, which typically
+ * happens when running composer with `--no-scripts` flag)
+ */
+final class FallbackVersions
+{
+    private function __construct()
+    {
+    }
+
+    /**
+     * @param string $packageName
+     *
+     * @return string
+     *
+     * @throws \OutOfBoundsException if a version cannot be located
+     * @throws \UnexpectedValueException if the composer.lock file could not be located
+     */
+    public static function getVersion(string $packageName) : string
+    {
+        $versions = iterator_to_array(self::getVersions(self::getComposerLockPath()));
+
+        if (! array_key_exists($packageName, $versions)) {
+            throw new \OutOfBoundsException(
+                'Required package "' . $packageName . '" is not installed: cannot detect its version'
+            );
+        }
+
+        return $versions[$packageName];
+    }
+
+    /**
+     * @return string
+     *
+     * @throws \UnexpectedValueException
+     */
+    private static function getComposerLockPath() : string
+    {
+        // bold assumption, but there's not here to fix everyone's problems.
+        $checkedPaths = [__DIR__ . '/../../../../../composer.lock', __DIR__ . '/../../composer.lock'];
+
+        foreach ($checkedPaths as $path) {
+            if (file_exists($path)) {
+                return $path;
+            }
+        }
+
+        throw new \UnexpectedValueException(sprintf(
+            'PackageVersions could not locate your `composer.lock` location. This is assumed to be in %s. '
+            . 'If you customized your composer vendor directory and ran composer installation with --no-scripts, '
+            . 'then you are on your own, and we can\'t really help you. Fix your shit and cut the tooling some slack.',
+            json_encode($checkedPaths)
+        ));
+    }
+
+    private static function getVersions(string $composerLockFile) : \Generator
+    {
+        $lockData = json_decode(file_get_contents($composerLockFile), true);
+
+        $lockData['packages-dev'] = $lockData['packages-dev'] ?? [];
+
+        foreach (array_merge($lockData['packages'], $lockData['packages-dev']) as $package) {
+            yield $package['name'] => $package['version'] . '@' . (
+                $package['source']['reference']?? $package['dist']['reference'] ?? ''
+            );
+        }
+
+        yield 'unknown/root-package@UNKNOWN';
+    }
+}

From c70fd71141254d85c22b156094bb50c4fc487dba Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 15:04:12 +0200
Subject: [PATCH 4/6] #18 stubbed out `Versions` class, so that it works even
 when the package is installed with `--no-scripts`

---
 src/PackageVersions/Versions.php | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 src/PackageVersions/Versions.php

diff --git a/src/PackageVersions/Versions.php b/src/PackageVersions/Versions.php
new file mode 100644
index 0000000..9de8496
--- /dev/null
+++ b/src/PackageVersions/Versions.php
@@ -0,0 +1,29 @@
+<?php
+
+namespace PackageVersions;
+
+/**
+ * This is a stub class: it is in place only for scenarios where PackageVersions
+ * is installed with a `--no-scripts` flag, in which scenarios the Versions class
+ * is not being replaced.
+ *
+ * If you are reading this docBlock inside your `vendor/` dir, then this means
+ * that PackageVersions didn't correctly install, and is in "fallback" mode.
+ */
+final class Versions
+{
+    const VERSIONS = [];
+
+    private function __construct()
+    {
+    }
+
+    /**
+     * @throws \OutOfBoundsException if a version cannot be located
+     * @throws \UnexpectedValueException if the composer.lock file could not be located
+     */
+    public static function getVersion(string $packageName) : string
+    {
+        return FallbackVersions::getVersion($packageName);
+    }
+}

From 9599960a162da88f26c790f07576361d9d66320d Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 15:04:51 +0200
Subject: [PATCH 5/6] #18 gitignoring `PackageVersions\Versions` again, since
 the stub is now in place

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index 0122635..9916a6d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
 /vendor/
+src/PackageVersions/Versions.php
 composer.lock
 clover.xml
\ No newline at end of file

From 0a1a91ea4d08baa225724845431bee542773fd1a Mon Sep 17 00:00:00 2001
From: Marco Pivetta <ocramius@gmail.com>
Date: Fri, 22 Jul 2016 15:08:36 +0200
Subject: [PATCH 6/6] #18 testing with `--no-scripts`

---
 .travis.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.travis.yml b/.travis.yml
index e6c99d4..a3e7622 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -9,6 +9,7 @@ env:
   - DEPENDENCIES=""
   - DEPENDENCIES="--prefer-lowest --prefer-stable"
   - DEPENDENCIES="--classmap-authoritative"
+  - DEPENDENCIES="--no-scripts"
 
 before_script:
   - sh .travis.install.sh