MediaWiki 1.30.2

[autoinstallsdev/mediawiki.git] / vendor / wikimedia / testing-access-wrapper / README.md

diff --git a/vendor/wikimedia/testing-access-wrapper/README.md b/vendor/wikimedia/testing-access-wrapper/README.md
new file mode 100644 (file)
index 0000000..fb9b0a3
--- /dev/null
+++ b/vendor/wikimedia/testing-access-wrapper/README.md
@@ -0,0 +1,41 @@
+[![Latest Stable Version]](https://packagist.org/packages/wikimedia/testing-access-wrapper) [![License]](https://packagist.org/packages/wikimedia/testing-access-wrapper)
+
+Wikimedia Testing Access Wrapper
+================================
+
+Testing Access Wrapper is a simple helper for writing unit tests which provides
+convenient shortcuts for using reflection to access non-public properties/methods.
+
+The code was originally part of MediaWiki. See composer.json for a list of authors.
+
+Usage
+-----
+
+```php
+use Wikimedia\TestingAccessWrapper;
+
+class NonPublic {
+       protected $prop;
+       protected function func() {}
+       protected static function staticFunc() {}
+}
+
+$object = new NonPublic();
+$wrapper = TestingAccessWrapper::newFromObject( $object );
+$classWrapper = TestingAccessWrapper::newFromClass( NonPublic::class );
+
+$wrapper->prop = 'foo';
+$wrapper->func();
+$classWrapper->staticFunc();
+```
+
+Running tests
+-------------
+
+    composer install
+    composer test
+
+
+---
+[Latest Stable Version]: https://poser.pugx.org/wikimedia/testing-access-wrapper/v/stable.svg
+[License]: https://poser.pugx.org/wikimedia/testing-access-wrapper/license.svg