* integrated abandoned stringEncode/encode class

Author: axelbecher

composer.json

@@ -22,7 +22,7 @@
         "ext-mbstring": "*",
         "ext-zlib": "*",
         "ext-curl": "*",
-        "translate5/string-encoder": "dev-master",
+        "ext-iconv": "*",
         "php-http/httplug": "^2.1",
         "guzzlehttp/guzzle": "^7.8",
         "guzzlehttp/psr7": "^2.7",

src/PHPHtmlParser/DTO/Tag/AttributeDTO.php

@@ -4,8 +4,8 @@
 
 namespace PHPHtmlParser\DTO\Tag;
 
-use stringEncode\Encode;
-use stringEncode\Exception;
+use Exception;
+use PHPHtmlParser\Encode;
 
 final class AttributeDTO
 {

src/PHPHtmlParser/Dom/Node/AbstractNode.php

@@ -12,7 +12,7 @@
 use PHPHtmlParser\Exceptions\Tag\AttributeNotFoundException;
 use PHPHtmlParser\Finder;
 use PHPHtmlParser\Selector\Selector;
-use stringEncode\Encode;
+use PHPHtmlParser\Encode;
 
 /**
  * Dom node object.

src/PHPHtmlParser/Dom/Node/InnerNode.php

@@ -8,7 +8,7 @@
 use PHPHtmlParser\Exceptions\ChildNotFoundException;
 use PHPHtmlParser\Exceptions\CircularException;
 use PHPHtmlParser\Exceptions\LogicalException;
-use stringEncode\Encode;
+use PHPHtmlParser\Encode;
 
 /**
  * Inner node of the html tree, might have children.

src/PHPHtmlParser/Dom/Parser.php

@@ -17,7 +17,7 @@
 use PHPHtmlParser\Exceptions\LogicalException;
 use PHPHtmlParser\Exceptions\StrictException;
 use PHPHtmlParser\Options;
-use stringEncode\Encode;
+use PHPHtmlParser\Encode;
 
 class Parser implements ParserInterface
 {

src/PHPHtmlParser/Dom/Tag.php

@@ -6,7 +6,7 @@
 
 use PHPHtmlParser\DTO\Tag\AttributeDTO;
 use PHPHtmlParser\Exceptions\Tag\AttributeNotFoundException;
-use stringEncode\Encode;
+use PHPHtmlParser\Encode;
 
 /**
  * Class Tag.
@@ -263,7 +263,7 @@ public function setAttributes(array $attr)
     /**
      * Returns all attributes of this tag.
      *
-     * @throws \stringEncode\Exception
+     * @throws \Exception
      *
      * @return AttributeDTO[]
      */
@@ -286,7 +286,7 @@ public function getAttributes(): array
      * Returns an attribute by the key.
      *
      * @throws AttributeNotFoundException
-     * @throws \stringEncode\Exception
+     * @throws \Exception
      */
     public function getAttribute(string $key): AttributeDTO
     {

src/PHPHtmlParser/Encode.php

@@ -0,0 +1,123 @@
+<?php
+namespace PHPHtmlParser;
+
+use Exception;
+
+class Encode {
+
+	/**
+	 * The encoding that the string is currently in.
+	 *
+	 * @var string
+	 */
+	protected $from;
+	
+	/**
+	 * The encoding that we would like the string to be in.
+	 *
+	 * @var string
+	 */
+	protected $to;
+
+	/**
+	 * Sets the default charsets for thie package.
+	 */
+	public function __construct()
+	{
+		// default from encoding
+		$this->from = 'CP1252';
+
+		// default to encoding
+		$this->to = 'UTF-8';
+	}
+
+	/**
+	 * Sets the charset that we will be converting to.
+	 *
+	 * @param string $charset
+	 * @chainable
+	 */
+	public function to($charset)
+	{
+		$this->to = strtoupper($charset);
+		return $this;
+	}
+
+	/**
+	 * Sets the charset that we will be converting from.
+	 *
+	 * @param string $charset
+	 * @chainable
+	 */
+	public function from($charset)
+	{
+		$this->from = strtoupper($charset);
+	}
+
+	/**
+	 * Returns the to and from charset that we will be using.
+	 *
+	 * @return array
+	 */
+	public function charset()
+	{
+		return [
+			'from' => $this->from,
+			'to'   => $this->to,
+		];
+	}
+
+	/**
+	 * Attempts to detect the encoding of the given string from the encodingList.
+	 *
+	 * @param string $str
+	 * @param array $encodingList
+	 * @return bool
+	 */
+	public function detect($str, $encodingList = ['UTF-8', 'CP1252'])
+	{
+		$charset = mb_detect_encoding($str, $encodingList);
+		if ($charset === false)
+		{
+			// could not detect charset
+			return false;
+		}
+
+		$this->from = $charset;
+		return true;
+	}
+
+	/**
+	 * Attempts to convert the string to the proper charset.
+	 *
+	 * @return string
+	 */
+	public  function convert($str)
+	{
+		if ($this->from != $this->to)
+		{
+			$str = iconv($this->from, $this->to, $str);
+		}
+
+		if ($str === false)
+		{
+			// the convertion was a failure
+			throw new Exception('The convertion from "'.$this->from.'" to "'.$this->to.'" was a failure.');
+		}
+
+		// deal with BOM issue for utf-8 text
+		if ($this->to == 'UTF-8')
+		{
+			if (substr($str, 0, 3) == "\xef\xbb\xbf")
+			{
+				$str = substr($str, 3);
+			}
+			if (substr($str, -3, 3) == "\xef\xbb\xbf")
+			{
+				$str = substr($str, 0, -3);
+			}
+		}
+
+		return $str;
+	}
+}

tests/Node/TextTest.php

@@ -6,7 +6,7 @@
 use PHPHtmlParser\Dom\Node\TextNode;
 use PHPHtmlParser\Options;
 use PHPUnit\Framework\TestCase;
-use stringEncode\Encode;
+use PHPHtmlParser\Encode;
 
 class NodeTextTest extends TestCase
 {