Added proxy object for static calls to encoder

Author: paquettg

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+# github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# ko_fi: # Replace with a single Ko-fi username
+tidelift: "packagist/paquettg/string-encoder"
+# community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+# liberapay: # Replace with a single Liberapay username
+# issuehunt: # Replace with a single IssueHunt username
+# otechie: # Replace with a single Otechie username
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.travis.yml

@@ -1,14 +1,19 @@
 language: php
 
 php:
-  - 7.1
   - 7.2
   - 7.3
+  - 7.4
 
 install:
   - composer self-update
-  - composer install
+  - composer install --dev --no-interaction
 
 script:
-  phpunit
+  - mkdir -p build/logs
+  - php vendor/bin/phpunit --coverage-clover build/logs/clover.xml
 
+after_success:
+  - travis_retry php vendor/bin/php-coveralls -v
+  - wget https://scrutinizer-ci.com/ocular.phar
+  - php ocular.phar code-coverage:upload --format=php-clover build/logs/clover.xml

CHANGELOG.md

@@ -12,6 +12,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added ability to validate encoding.
 - Added SECURITY.md policy.
 - Added static analysis tools.
+- Added FUNDING.yml policy.
+- Added proxy support for static calls to encoder.
 
 ### Changed
 - Removed support for PHP < 7.2.

src/StringEncoder/DTO/EncodingDTO.php

@@ -8,7 +8,7 @@
 use StringEncoder\Exceptions\InvalidEncodingException;
 use StringEncoder\MB\Validator;
 
-class EncodingDTO
+final class EncodingDTO
 {
     /**
      * @var string

src/StringEncoder/Discovery/ValidatorDiscovery.php

@@ -6,7 +6,7 @@
 
 use StringEncoder\MB\Validator;
 
-class ValidatorDiscovery
+final class ValidatorDiscovery
 {
     /**
      * @var Validator|null

src/StringEncoder/Encoder.php

@@ -9,7 +9,7 @@
 use StringEncoder\Exceptions\InvalidEncodingException;
 use StringEncoder\MB\Convert;
 
-class Encoder
+final class Encoder
 {
     /**
      * @var EncodingDTO|null

src/StringEncoder/Proxy/Encoder.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace StringEncoder\Proxy;
+
+use StringEncoder\Contracts\ConvertWriteInterface;
+use StringEncoder\Encoder as EncoderImplementation;
+use StringEncoder\Exceptions\InvalidEncodingException;
+
+final class Encoder
+{
+    /**
+     * @var EncoderImplementation
+     */
+    private static $encoder = null;
+
+    /**
+     * @throws InvalidEncodingException
+     */
+    public static function mountFromEncoding(string $targetEncoding, ?string $sourceEncoding = null): void
+    {
+        $encoder = new EncoderImplementation();
+        $encoder->setTargetEncoding($targetEncoding);
+        if ($sourceEncoding !== null) {
+            $encoder->setSourceEncoding($sourceEncoding);
+        }
+        self::mount('Encoder', $encoder);
+    }
+
+    /**
+     * Call this to mount the static facade. The facade allows you to use
+     * this object as a $className.
+     */
+    public static function mount(string $className = 'Encoder', ?EncoderImplementation $encoder = null): bool
+    {
+        if (!\class_exists($className)) {
+            \class_alias(__CLASS__, $className);
+        }
+        if ($encoder instanceof EncoderImplementation) {
+            self::$encoder = $encoder;
+        }
+
+        return true;
+    }
+
+    public static function getMountedEncoder(): ?EncoderImplementation
+    {
+        return self::$encoder;
+    }
+
+    public static function unload(): void
+    {
+        self::$encoder = null;
+    }
+
+    public static function getTargetEncoding(): ?string
+    {
+        return self::$encoder->getTargetEncoding();
+    }
+
+    public static function setTargetEncoding(string $encoding): void
+    {
+        self::$encoder->setTargetEncoding($encoding);
+    }
+
+    public static function getSourceEncoding(): ?string
+    {
+        return self::$encoder->getSourceEncoding();
+    }
+
+    public static function setSourceEncoding(string $encoding): void
+    {
+        self::$encoder->setSourceEncoding($encoding);
+    }
+
+    public static function convert(): ConvertWriteInterface
+    {
+        return self::$encoder->convert();
+    }
+}

tests/tests/EncoderTest.php

@@ -7,7 +7,7 @@
 use PHPUnit\Framework\TestCase;
 use StringEncoder\Encoder;
 
-class ContentTest extends TestCase
+class EncoderTest extends TestCase
 {
     private $encoder;
 

tests/tests/Proxy/EncoderMountFromEncodingTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace tests\Proxy;
+
+use PHPUnit\Framework\TestCase;
+use StringEncoder\Proxy\Encoder;
+
+class EncoderMountFromEncodingTest extends TestCase
+{
+    public function setUp()
+    {
+        Encoder::mountFromEncoding('ISO-8859-1', 'UTF-8');
+    }
+
+    public function tearDown()
+    {
+        Encoder::unload();
+    }
+
+    public function testConvert()
+    {
+        $string = Encoder::convert()->fromString('my string')->toString();
+        $this->assertEquals('my string', $string);
+    }
+
+    public function testGetMountedEncoder()
+    {
+        $encoder = Encoder::getMountedEncoder();
+        $this->assertTrue($encoder instanceof \StringEncoder\Encoder);
+    }
+}

tests/tests/Proxy/EncoderTest.php

@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace tests\Proxy;
+
+use PHPUnit\Framework\TestCase;
+use StringEncoder\Proxy\Encoder;
+
+class EncoderTest extends TestCase
+{
+    public function setUp()
+    {
+        Encoder::mount('Encoder', new \StringEncoder\Encoder());
+    }
+
+    public function tearDown()
+    {
+        Encoder::unload();
+    }
+
+    public function testSetSource()
+    {
+        \Encoder::setSourceEncoding('ISO-8859-1');
+        $this->assertEquals('ISO-8859-1', \Encoder::getSourceEncoding());
+    }
+
+    public function testSetTarget()
+    {
+        \Encoder::setTargetEncoding('ISO-8859-1');
+        $this->assertEquals('ISO-8859-1', \Encoder::getTargetEncoding());
+    }
+}