Updated to Drupal 8.5. Core Media not yet in use.

[yaffs-website] / vendor / psy / psysh / src / ExecutionLoop / Listener.php

diff --git a/vendor/psy/psysh/src/ExecutionLoop/Listener.php b/vendor/psy/psysh/src/ExecutionLoop/Listener.php
new file mode 100644 (file)
index 0000000..3886a20
--- /dev/null
+++ b/vendor/psy/psysh/src/ExecutionLoop/Listener.php
@@ -0,0 +1,83 @@
+<?php
+
+/*
+ * This file is part of Psy Shell.
+ *
+ * (c) 2012-2018 Justin Hileman
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Psy\ExecutionLoop;
+
+use Psy\Shell;
+
+/**
+ * Execution Loop Listener interface.
+ */
+interface Listener
+{
+    /**
+     * Determines whether this listener should be active.
+     *
+     * @return bool
+     */
+    public static function isSupported();
+
+    /**
+     * Called once before the REPL session starts.
+     *
+     * @param Shell $shell
+     */
+    public function beforeRun(Shell $shell);
+
+    /**
+     * Called at the start of each loop.
+     *
+     * @param Shell $shell
+     */
+    public function beforeLoop(Shell $shell);
+
+    /**
+     * Called on user input.
+     *
+     * Return a new string to override or rewrite user input.
+     *
+     * @param Shell  $shell
+     * @param string $input
+     *
+     * @return string|null User input override
+     */
+    public function onInput(Shell $shell, $input);
+
+    /**
+     * Called before executing user code.
+     *
+     * Return a new string to override or rewrite user code.
+     *
+     * Note that this is run *after* the Code Cleaner, so if you return invalid
+     * or unsafe PHP here, it'll be executed without any of the safety Code
+     * Cleaner provides. This comes with the big kid warranty :)
+     *
+     * @param Shell  $shell
+     * @param string $code
+     *
+     * @return string|null User code override
+     */
+    public function onExecute(Shell $shell, $code);
+
+    /**
+     * Called at the end of each loop.
+     *
+     * @param Shell $shell
+     */
+    public function afterLoop(Shell $shell);
+
+    /**
+     * Called once after the REPL session ends.
+     *
+     * @param Shell $shell
+     */
+    public function afterRun(Shell $shell);
+}