Add ContentTypes utils

Author: rozsival

README.md

@@ -20,6 +20,7 @@ composer require wavevision/utils
 The package contains useful classes for:
 
 - [Arrays](./src/Utils/Arrays.php) – array helpers (manipulate, sort, extract etc.)
+- [ContentTypes](./src/Utils/ContentTypes.php) – format extensions and filenames for content types
 - [DOM](./src/Utils/DOM) – create and format data attributes for HTML elements
 - [ExternalProgram](./src/Utils/ExternalProgram/Executor.php) – simple external command runner
 - [Finder](./src/Utils/Finder.php) – adds sorting to [nette/finder](https://github.com/nette/finder)

composer.json

@@ -43,7 +43,7 @@
   "require-dev": {
     "jakub-onderka/php-parallel-lint": "^1.0",
     "mikey179/vfsstream": "^1.6",
-    "phing/phing": "^2.16",
+    "phing/phing": "^3.0-alpha3",
     "php-coveralls/php-coveralls": "^2.1",
     "php-mock/php-mock-phpunit": "^2.4",
     "phpstan/phpstan": "^0.12.3",

composer.lock

@@ -144,10 +144,10 @@ function (array $item) use ($key) {
 	}
 
 	/**
-	 * @param iterable<mixed> $collection
+	 * @param mixed $collection
 	 * @return mixed
 	 */
-	public static function firstItem(iterable $collection)
+	public static function firstItem($collection)
 	{
 		return $collection[self::firstKey($collection)] ?? null;
 	}
@@ -356,17 +356,17 @@ public static function jsonPath(array $data, string $expression)
 	}
 
 	/**
-	 * @param iterable<mixed> $collection
+	 * @param mixed $collection
 	 * @return mixed
 	 */
-	public static function lastItem(iterable $collection)
+	public static function lastItem($collection)
 	{
 		return $collection[self::lastKey($collection)] ?? null;
 	}
 
 	/**
 	 * @param iterable<mixed> $collection
-	 * @return mixed
+	 * @return int|string|null
 	 */
 	public static function lastKey(iterable $collection)
 	{

src/Utils/Arrays.php

@@ -0,0 +1,61 @@
+<?php declare (strict_types = 1);
+
+namespace Wavevision\Utils;
+
+use Nette\StaticClass;
+
+class ContentTypes
+{
+
+	use StaticClass;
+
+	public const CSS = 'text/css';
+
+	public const CSS_EXTENSION = 'css';
+
+	public const JPEG = 'image/jpeg';
+
+	public const JPEG_EXTENSION = 'jpg';
+
+	public const JS = 'application/javascript';
+
+	public const JS_EXTENSION = 'js';
+
+	public const PDF = 'application/pdf';
+
+	public const PDF_EXTENSION = 'pdf';
+
+	public const PNG = 'image/png';
+
+	public const PNG_EXTENSION = 'png';
+
+	public const SVG = 'image/svg+xml';
+
+	public const SVG_EXTENSION = 'svg';
+
+	public const ZIP = 'application/zip';
+
+	public const ZIP_EXTENSION = 'zip';
+
+	public const CONTENT_TYPE_FILE_EXTENSIONS = [
+		self::CSS => self::CSS_EXTENSION,
+		self::JPEG => self::JPEG_EXTENSION,
+		self::JS => self::JS_EXTENSION,
+		self::PDF => self::PDF_EXTENSION,
+		self::PNG => self::PNG_EXTENSION,
+		self::SVG => self::SVG_EXTENSION,
+		self::ZIP => self::ZIP_EXTENSION,
+	];
+
+	public static function getExtension(string $contentType, bool $withDelimiter = false): string
+	{
+		$ext = self::CONTENT_TYPE_FILE_EXTENSIONS[$contentType];
+		return $withDelimiter ? ".$ext" : $ext;
+	}
+
+	public static function getFilename(string $file, string $contentType): string
+	{
+		return $file . self::getExtension($contentType, true);
+	}
+
+}

src/Utils/ContentTypes.php

@@ -58,6 +58,16 @@ public function name(): string
 		return $this->currentName;
 	}
 
+	/**
+	 * @param Html<mixed> $element
+	 * @return Html<mixed>
+	 */
+	public function remove(Html $element): Html
+	{
+		$element->removeAttribute($this->currentName);
+		return $element;
+	}
+
 	/**
 	 * @param mixed $value
 	 */

src/Utils/DOM/DataAttribute.php

@@ -0,0 +1,22 @@
+<?php declare (strict_types = 1);
+
+namespace Wavevision\UtilsTests;
+
+use PHPUnit\Framework\TestCase;
+use Wavevision\Utils\ContentTypes;
+
+class ContentTypesTest extends TestCase
+{
+
+	public function testGetExtension(): void
+	{
+		$this->assertEquals('js', ContentTypes::getExtension(ContentTypes::JS));
+		$this->assertEquals('.js', ContentTypes::getExtension(ContentTypes::JS, true));
+	}
+
+	public function testGetFilename(): void
+	{
+		$this->assertEquals('style.css', ContentTypes::getFilename('style', ContentTypes::CSS));
+	}
+
+}

tests/UtilsTests/ContentTypesTest.php

@@ -32,6 +32,14 @@ public function testName(): void
 		$this->assertEquals('data-prefix-test', $this->createDataAttribute('prefix')->name());
 	}
 
+	public function testRemove(): void
+	{
+		$attribute = $this->createDataAttribute();
+		$element = Html::el();
+		$this->assertTrue($attribute->assign($element)->getAttribute($attribute->name()) === '');
+		$this->assertNull($attribute->remove($element)->getAttribute($attribute->name()));
+	}
+
 	public function testValue(): void
 	{
 		$this->assertEquals('something', $this->createDataAttribute()->value('something'));