From bd46f663ae6e427f828d543932b7b33ff0c594df Mon Sep 17 00:00:00 2001
From: Moshe Weitzman <weitzman@tejasa.com>
Date: Fri, 31 Dec 2021 15:05:58 -0500
Subject: [PATCH] More deletion

---
 src/Cache/CacheInterface.php        | 114 ------------------
 src/Cache/CommandCache.php          |  64 ----------
 src/Cache/FileCache.php             | 175 ----------------------------
 src/Cache/JSONCache.php             |  32 -----
 src/Commands/core/CacheCommands.php |   3 +-
 5 files changed, 1 insertion(+), 387 deletions(-)
 delete mode 100644 src/Cache/CacheInterface.php
 delete mode 100644 src/Cache/CommandCache.php
 delete mode 100644 src/Cache/FileCache.php
 delete mode 100644 src/Cache/JSONCache.php

diff --git a/src/Cache/CacheInterface.php b/src/Cache/CacheInterface.php
deleted file mode 100644
index 5cf54469e9..0000000000
--- a/src/Cache/CacheInterface.php
+++ /dev/null
@@ -1,114 +0,0 @@
-<?php
-
-/**
- * @file
- * Definition of Drush\Cache\CacheInterface.
- */
-
-namespace Drush\Cache;
-
-/**
- * Interface for cache implementations.
- *
- * All cache implementations have to implement this interface.
- * JSONCache provides the default implementation, which can be
- * consulted as an example.
- *
- * To make Drush use your implementation for a certain cache bin, you have to
- * set a variable with the name of the cache bin as its key and the name of
- * your class as its value. For example, if your implementation of
- * CacheInterface was called MyCustomCache, the following line in
- * drushrc.php would make Drush use it for the 'example' bin:
- * @code
- *  $options['cache-class-example'] = 'MyCustomCache;
- * @endcode
- *
- * Additionally, you can register your cache implementation to be used by
- * default for all cache bins by setting the option 'cache-default-class' to
- * the name of your implementation of the CacheInterface, e.g.
- * @code
- *  $options['cache-default-class'] = 'MyCustomCache;
- * @endcode
- *
- * @see \Drupal\Core\Cache\CacheBackendInterface
- *
- * @deprecated
- */
-interface CacheInterface
-{
-
-    /**
-     * Constructor.
-     *
-     * @param $bin
-     *   The cache bin for which the object is created.
-     */
-    public function __construct($bin);
-
-    /**
-     * Return data from the persistent cache.
-     *
-     * @param string $cid
-     *   The cache ID of the data to retrieve.
-     *
-     * @return
-     *   The cache or FALSE on failure.
-     */
-    public function get($cid);
-
-    /**
-     * Return data from the persistent cache when given an array of cache IDs.
-     *
-     * @param array $cids
-     *   An array of cache IDs for the data to retrieve. This is passed by
-     *   reference, and will have the IDs successfully returned from cache
-     *   removed.
-     *
-     * @return
-     *   An array of the items successfully returned from cache indexed by cid.
-     */
-    public function getMultiple(&$cids);
-
-    /**
-     * Store data in the persistent cache.
-     *
-     * @param string $cid
-     *   The cache ID of the data to store.
-     * @param array $data
-     *   The data to store in the cache.
-     * @param $expire
-     *   One of the following values:
-     *   - DRUSH_CACHE_PERMANENT: Indicates that the item should never be removed unless
-     *     explicitly told to using _drush_cache_clear_all() with a cache ID.
-     *   - DRUSH_CACHE_TEMPORARY: Indicates that the item should be removed at the next
-     *     general cache wipe.
-     *   - A Unix timestamp: Indicates that the item should be kept at least until
-     *     the given time, after which it behaves like CACHE_TEMPORARY.
-     */
-    public function set($cid, $data, $expire = DRUSH_CACHE_PERMANENT);
-
-    /**
-     * Expire data from the cache. If called without arguments, expirable
-     * entries will be cleared from all known cache bins.
-     *
-     * @param string $cid
-     *   If set, the cache ID to delete. Otherwise, all cache entries that can
-     *   expire are deleted.
-     * @param bool $wildcard
-     *   If set to TRUE, the $cid is treated as a substring
-     *   to match rather than a complete ID. The match is a right hand
-     *   match. If '*' is given as $cid, the bin $bin will be emptied.
-     */
-    public function clear($cid = null, $wildcard = false);
-
-    /**
-     * Check if a cache bin is empty.
-     *
-     * A cache bin is considered empty if it does not contain any valid data for
-     * any cache ID.
-     *
-     * @return
-     *   TRUE if the cache bin specified is empty.
-     */
-    public function isEmpty();
-}
diff --git a/src/Cache/CommandCache.php b/src/Cache/CommandCache.php
deleted file mode 100644
index 39661d526d..0000000000
--- a/src/Cache/CommandCache.php
+++ /dev/null
@@ -1,64 +0,0 @@
-<?php
-
-namespace Drush\Cache;
-
-use Consolidation\AnnotatedCommand\Cache\SimpleCacheInterface;
-
-/**
- * Command cache implementation.
- *
- * This wrapper implements a cache usable with the annotated-command
- * library's command cache. It uses a Drush JSONCache for its back-end.
- */
-class CommandCache implements SimpleCacheInterface
-{
-
-    protected $cacheBackend;
-
-    public function __construct(CacheInterface $cacheBackend)
-    {
-        $this->cacheBackend = $cacheBackend;
-    }
-
-    /**
-     * Test for an entry from the cache
-     * @param string $key
-     * @return boolean
-     */
-    public function has($key)
-    {
-        $cacheItem = $this->cacheBackend->get($key);
-        return $this->valid($cacheItem);
-    }
-    /**
-     * Get an entry from the cache
-     * @param string $key
-     * @return array
-     */
-    public function get($key)
-    {
-        $cacheItem = $this->cacheBackend->get($key);
-        if (!$this->valid($cacheItem)) {
-            return [];
-        }
-        // TODO: FileCache::get() should just return the
-        // data element, not the entire cacheItem. Then we
-        // could make it implement SimpleCacheInterface & do
-        // away with this adapter class.
-        return $cacheItem->data;
-    }
-    /**
-     * Store an entry in the cache
-     * @param string $key
-     * @param array $data
-     */
-    public function set($key, $data)
-    {
-        $this->cacheBackend->set($key, $data);
-    }
-
-    protected function valid($cacheItem)
-    {
-        return is_object($cacheItem) && isset($cacheItem->data);
-    }
-}
diff --git a/src/Cache/FileCache.php b/src/Cache/FileCache.php
deleted file mode 100644
index 848fdd6f70..0000000000
--- a/src/Cache/FileCache.php
+++ /dev/null
@@ -1,175 +0,0 @@
-<?php
-
-/**
- * @file
- * Definition of Drush\Cache\FileCache.
- */
-
-namespace Drush\Cache;
-
-use Drush\Drush;
-use Symfony\Component\Filesystem\Filesystem;
-use Symfony\Component\Finder\Finder;
-use Webmozart\PathUtil\Path;
-
-/**
- * Default cache implementation.
- *
- * This cache implementation uses plain text files
- * containing serialized php to store cached data. Each cache bin corresponds
- * to a directory by the same name.
- *
- * @deprecated
- */
-class FileCache implements CacheInterface
-{
-    const EXTENSION = '.cache';
-    protected $bin;
-
-    public function __construct($bin)
-    {
-        $this->bin = $bin;
-        $this->directory = $this->cacheDirectory();
-    }
-
-    /**
-     * Returns the cache directory for the given bin.
-     *
-     * @param string $bin
-     */
-    public function cacheDirectory($bin = null)
-    {
-        $bin = $bin ? $bin : $this->bin;
-        return Path::join(Drush::config()->cache(), $bin);
-    }
-
-    public function get($cid)
-    {
-        $cids = [$cid];
-        $cache = $this->getMultiple($cids);
-        return reset($cache);
-    }
-
-    public function getMultiple(&$cids)
-    {
-        try {
-            $cache = [];
-            foreach ($cids as $cid) {
-                $filename = $this->getFilePath($cid);
-                if (!file_exists($filename)) {
-                    return [];
-                }
-
-                $item = $this->readFile($filename);
-                if ($item) {
-                    $cache[$cid] = $item;
-                }
-            }
-            $cids = array_diff($cids, array_keys($cache));
-            return $cache;
-        } catch (\Exception $e) {
-            return [];
-        }
-    }
-
-    /**
-     * Returns the contents of the given filename unserialized.
-     *
-     * @param string $filename
-     *   Absolute path to filename to read contents from.
-     */
-    public function readFile($filename)
-    {
-        $item = file_get_contents($filename);
-        return $item ? unserialize($item) : false;
-    }
-
-    public function set($cid, $data, $expire = DRUSH_CACHE_PERMANENT)
-    {
-        $created = time();
-
-        $cache = new \stdClass;
-        $cache->cid = $cid;
-        $cache->data = is_object($data) ? clone $data : $data;
-        $cache->created = $created;
-        if ($expire == DRUSH_CACHE_TEMPORARY) {
-            $cache->expire = $created + 2591999;
-        } elseif ($expire != DRUSH_CACHE_PERMANENT && $expire < 2592000) {
-        // Expire time is in seconds if less than 30 days, otherwise is a timestamp.
-            $cache->expire = $created + $expire;
-        } else {
-            $cache->expire = $expire;
-        }
-
-        // Ensure the cache directory still exists, in case a backend process
-        // cleared the cache after the cache was initialized.
-        $fs = new Filesystem();
-        $fs->mkdir($this->directory);
-
-        $filename = $this->getFilePath($cid);
-        return $this->writeFile($filename, $cache);
-    }
-
-    /**
-     * Serializes data and write it to the given filename.
-     *
-     * @param string $filename
-     *   Absolute path to filename to write cache data.
-     * @param $cache
-     *   Cache data to serialize and write to $filename.
-     */
-    public function writeFile($filename, $cache)
-    {
-        return file_put_contents($filename, serialize($cache));
-    }
-
-    public function clear($cid = null, $wildcard = false)
-    {
-        $fs = new Filesystem();
-        $bin_dir = $this->cacheDirectory();
-        $files = [];
-        if (empty($cid)) {
-            $fs->remove($bin_dir);
-        } else {
-            if ($wildcard) {
-                if ($cid == '*') {
-                    $fs->remove($bin_dir);
-                } else {
-                    $files = Finder::create()
-                      ->files()
-                      ->name($cid)
-                      ->in($bin_dir);
-                }
-            } else {
-                $files[] = $this->getFilePath($cid);
-            }
-
-            $fs->remove($files);
-        }
-    }
-
-    public function isEmpty()
-    {
-        $files = Finder::create()
-          ->files()
-          ->name()
-          ->exclude()
-          ->depth(0)
-          ->in($this->directory);
-        return empty($files);
-    }
-
-    /**
-     * Converts a cache id to a full path.
-     *
-     * @param $cid
-     *   The cache ID of the data to retrieve.
-     *
-     * @return
-     *   The full path to the cache file.
-     */
-    protected function getFilePath($cid)
-    {
-        return $this->directory . '/' . str_replace([':', '\\', '/'], '.', $cid) . self::EXTENSION;
-    }
-}
diff --git a/src/Cache/JSONCache.php b/src/Cache/JSONCache.php
deleted file mode 100644
index 5f5c8ffd97..0000000000
--- a/src/Cache/JSONCache.php
+++ /dev/null
@@ -1,32 +0,0 @@
-<?php
-
-/**
- * @file
- * Definition of Drush\Cache\JSONCache.
- */
-
-namespace Drush\Cache;
-
-/**
- * JSON cache storage backend.
- *
- * @deprecated
- */
-class JSONCache extends FileCache
-{
-    const EXTENSION = '.json';
-
-    public function readFile($filename)
-    {
-        $item = file_get_contents($filename);
-        return $item ? (object)json_decode($item, true) : false;
-    }
-
-    public function writeFile($filename, $cache)
-    {
-        $json = json_encode($cache, JSON_PRETTY_PRINT);
-        // json_encode() does not escape <, > and &, so we do it with str_replace().
-        $json = str_replace(['<', '>', '&'], ['\u003c', '\u003e', '\u0026'], $json);
-        return file_put_contents($filename, $json);
-    }
-}
diff --git a/src/Commands/core/CacheCommands.php b/src/Commands/core/CacheCommands.php
index 413ac5009c..b80548af59 100644
--- a/src/Commands/core/CacheCommands.php
+++ b/src/Commands/core/CacheCommands.php
@@ -300,8 +300,7 @@ public function getTypes($include_bootstrapped_types = false): array
     public static function clearDrush(): void
     {
         try {
-            drush_cache_clear_all(null, 'default');// No longer used by Drush core, but still cleared for backward compat.
-            drush_cache_clear_all(null, 'factory'); // command info from annotated-command library (i.e. parsed annotations)
+            // No longer anything to do here. Left because some commandfiles may try to call this.
         } catch (IOException $e) {
             // Sometimes another process writes files into a bin dir and \Drush\Cache\FileCache::clear fails.
             // That is not considered an error. https://github.com/drush-ops/drush/pull/4535.