From e41d4321d1442f0570d17cbd1bd60b78163ab599 Mon Sep 17 00:00:00 2001
From: Dominik Liebler <liebler.dominik@gmail.com>
Date: Thu, 12 Sep 2019 21:03:12 +0200
Subject: [PATCH] check references to PHP files in READMEs

---
 .travis.yml        |  1 +
 check-refs-readmes | 65 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 66 insertions(+)
 create mode 100755 check-refs-readmes

diff --git a/.travis.yml b/.travis.yml
index 68b7076..8aa7ae4 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -25,3 +25,4 @@ script:
   - vendor/bin/phpunit
   - vendor/bin/phpcs .
   - vendor/bin/psalm --show-info=false
+  - ./check-refs-readmes
diff --git a/check-refs-readmes b/check-refs-readmes
new file mode 100755
index 0000000..4c6b4ec
--- /dev/null
+++ b/check-refs-readmes
@@ -0,0 +1,65 @@
+#!/usr/bin/env php
+<?php
+
+// checks if all the PHP have been referenced in a README.rst
+// and lists all PHP files that have not been referenced
+
+function getFileIterator(string $regex): Generator {
+    $directory = new RecursiveDirectoryIterator(__DIR__);
+    $iterator = new RecursiveIteratorIterator($directory);
+    $iterator = new RegexIterator($iterator, $regex, RecursiveRegexIterator::GET_MATCH);
+
+    foreach ($iterator as $list) {
+        foreach ($list as $file) {
+            yield $file;
+        }
+    }
+}
+
+function getFiles($regex) {
+    $files = [];
+
+    foreach (getFileIterator($regex) as $file) {
+        $vendor = __DIR__ . '/vendor';
+
+        if (substr($file, 0, strlen($vendor)) != $vendor && $file != __FILE__) {
+            $files[] = $file;
+        }
+    }
+
+    return $files;
+}
+
+function getFilesFromReadmes() {
+    $allFiles = [];
+    $start = '.. literalinclude::';
+
+    foreach (getFiles('/^.+\.rst$/') as $rst) {
+        $dirName = dirname($rst);
+
+        $lines = file($rst);
+        $lines = array_filter($lines, function (string $line) use ($start): bool {
+            return substr($line, 0, strlen($start)) == $start;
+        });
+
+        $files = array_map(function (string $line) use ($dirName, $start): string {
+            return trim($dirName . '/' . substr($line, strlen($start) + 1));
+        }, $lines);
+
+        $allFiles = array_merge($allFiles, (array) $files);
+    }
+
+    return $allFiles;
+}
+
+$phpFiles = getFiles('/^.+\.php$/');
+$filesFromReadme = getFilesFromReadmes();
+$diff = array_diff($phpFiles, $filesFromReadme);
+
+foreach ($diff as $file) {
+    echo $file . PHP_EOL;
+}
+
+if (count($diff) != 0) {
+    exit(1);
+}