X-Git-Url: https://scripts.mit.edu/gitweb/autoinstallsdev/mediawiki.git/blobdiff_plain/19e297c21b10b1b8a3acad5e73fc71dcb35db44a..6932310fd58ebef145fa01eb76edf7150284d8ea:/vendor/wikimedia/scoped-callback/README.md

diff --git a/vendor/wikimedia/scoped-callback/README.md b/vendor/wikimedia/scoped-callback/README.md
new file mode 100644
index 00000000..b8f7a5f4
--- /dev/null
+++ b/vendor/wikimedia/scoped-callback/README.md
@@ -0,0 +1,41 @@
+[![Latest Stable Version]](https://packagist.org/packages/wikimedia/scoped-callback) [![License]](https://packagist.org/packages/wikimedia/scoped-callback)
+
+ScopedCallback
+==============
+
+The ScopedCallback class allows for running a function after the
+instance goes out of scope. It can be useful for making sure
+teardown or cleanup functions run even if exceptions are thrown.
+It also makes for a cleaner API for developers, by not requiring
+the callback to be called manually each time.
+
+Additional documentation about the library can be found on
+[MediaWiki.org](https://www.mediawiki.org/wiki/ScopedCallback).
+
+
+Usage
+-----
+
+    use Wikimedia\ScopedCallback;
+    $sc = new ScopedCallback( [ $this, 'teardown' ] );
+    // Even if this throws an exception, the callback will run
+    // or it'll run at the end of the function
+    $this->fooBar();
+    // If you want to manually call the callback
+    ScopedCallback::consume( $sc );
+    // or
+    unset( $sc );
+    // If you want to prevent it from being called
+    ScopedCallback::cancel( $sc );
+
+
+Running tests
+-------------
+
+    composer install --prefer-dist
+    composer test
+
+
+---
+[Latest Stable Version]: https://poser.pugx.org/wikimedia/scoped-callback/v/stable.svg
+[License]: https://poser.pugx.org/wikimedia/scoped-callback/license.svg