initial commit

Author: MartkCz

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+indent_size = tab
+tab_width = 4
+
+[*.yml]
+indent_style = space
+indent_size = 4
+
+[composer.json]
+indent_style = space
+indent_size = 4

.gitignore

@@ -0,0 +1,6 @@
+## ide
+/.idea/
+
+## composer
+/composer.lock
+/vendor/

.travis.yml

@@ -0,0 +1,35 @@
+language: php
+php:
+    - 7.4
+
+before_install:
+    - phpenv config-rm xdebug.ini || return 0 # Turn off XDebug
+
+install:
+    - travis_retry composer install --no-progress --prefer-dist # Install dependencies
+
+after_failure:
+    - for i in $(find tests -name \*.actual); do echo "--- $i"; cat $i; echo; echo; done # Print *.actual content
+
+jobs:
+    include:
+        - stage: Tests
+          php: 7.4
+          script:
+              - make tests
+
+        - stage: Code style
+          php: 7.4
+          script:
+              - make cs
+
+        - stage: PHPStan
+          php: 7.4
+          script:
+              - make phpstan
+
+sudo: false
+
+cache:
+    directories:
+        - $HOME/.composer/cache

LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Makefile

@@ -0,0 +1,21 @@
+.PHONY: phpstan tests cs csfix lint
+
+check: tests cs phpstan lint
+
+vendor: composer.json composer.lock
+	composer install
+
+tests: vendor
+	vendor/bin/tester -s -p php --colors 1 -C tests/cases
+
+lint: vendor
+	vendor/bin/linter src tests
+
+cs: vendor
+	vendor/bin/codesniffer src tests
+
+csfix: vendor
+	vendor/bin/codefixer src tests
+
+phpstan: vendor
+	vendor/bin/phpstan analyse -l max -c phpstan.neon src

README.md

@@ -0,0 +1,5 @@
+## doctrine utility
+
+[![Build Status](https://travis-ci.org/utilitte/doctrine.svg?branch=master)](https://travis-ci.org/utilitte/doctrine)
+[![Licence](https://img.shields.io/packagist/l/utilitte/doctrine.svg)](https://packagist.org/packages/utilitte/doctrine)
+[![Latest stable](https://img.shields.io/packagist/v/utilitte/doctrine.svg)](https://packagist.org/packages/utilitte/doctrine)

composer.json

@@ -0,0 +1,24 @@
+{
+    "name": "utilitte/doctrine",
+    "description": "",
+    "license": "proprietary",
+    "type": "library",
+    "require": {
+        "php": ">=7.4",
+        "utilitte/php": "^1.0",
+        "doctrine/orm": "^2.7",
+        "doctrine/collections": "^1.6"
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^0.12.33",
+        "phpstan/extension-installer": "^1.0",
+        "phpstan/phpstan-deprecation-rules": "^0.12.2",
+        "utilitte/qa": "~1.0.0",
+        "nette/tester": "^2.3.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Utilitte\\Doctrine\\": "src/"
+        }
+    }
+}

phpstan.neon

@@ -0,0 +1,64 @@
+<?php declare(strict_types = 1);
+
+namespace Utilitte\Doctrine\Association;
+
+use Doctrine\Common\Collections\Collection;
+use Utilitte\Php\Arrays;
+use Utilitte\Php\ValueObject\ArraySynchronized;
+
+final class ArrayCollectionSynchronizer
+{
+
+	public const REMOVE = 0b0001;
+	public const ADD = 0b0010;
+
+	/**
+	 * @template T of object
+	 * @phpstan-param Collection<mixed, T> $collection
+	 * @phpstan-param T[] $values
+	 * @param object[] $values
+	 */
+	public static function synchronize(
+		Collection $collection,
+		array $values,
+		int $options = self::ADD | self::REMOVE
+	): ArraySynchronized
+	{
+		return self::synchronizeByComparator($collection, $values, null, $options);
+	}
+
+	/**
+	 * @template T of object
+	 * @phpstan-param Collection<mixed, T> $collection
+	 * @phpstan-param T[] $values
+	 * @param object[] $values
+	 */
+	public static function synchronizeByComparator(
+		Collection $collection,
+		array $values,
+		?callable $comparator = null,
+		int $options = self::ADD | self::REMOVE
+	): ArraySynchronized
+	{
+		$synchronized = Arrays::synchronize($collection->toArray(), $values, $comparator);
+
+		if ($opRemove = $options & self::REMOVE) {
+			foreach ($synchronized->getRemoved() as $key => $_) {
+				$collection->remove($key);
+			}
+		}
+
+		if ($opAdd = $options & self::ADD) {
+			foreach ($synchronized->getAdded() as $element) {
+				$collection->add($element);
+			}
+		}
+
+		return new ArraySynchronized(
+			$opAdd ? $synchronized->getAdded() : [],
+			$opRemove ? $synchronized->getRemoved() : [],
+			$collection->toArray()
+		);
+	}
+
+}

src/Association/ArrayCollectionSynchronizer.php

@@ -0,0 +1,60 @@
+<?php declare(strict_types = 1);
+
+namespace Utilitte\Doctrine;
+
+use Doctrine\ORM\EntityManagerInterface;
+use InvalidArgumentException;
+
+final class DoctrineIdentityExtractor
+{
+
+	private EntityManagerInterface $em;
+
+	public function __construct(EntityManagerInterface $em)
+	{
+		$this->em = $em;
+	}
+
+	/**
+	 * @param object[] $entities
+	 * @return mixed[]
+	 */
+	public function extractIdentities(iterable $entities, bool $allowMixing = false): array
+	{
+		$type = null;
+		$ids = [];
+
+		foreach ($entities as $entity) {
+			if (!is_object($entity)) {
+				throw new InvalidArgumentException(
+					sprintf('Given array must be an array of object, %s contained in array', gettype($entity))
+				);
+			}
+
+			$className = get_class($entity);
+
+			if (!$allowMixing) {
+				$this->checkType($className, $type);
+			}
+
+			$values = $this->em->getClassMetadata($className)->getIdentifierValues($entity);
+			$ids[] = current($values);
+		}
+
+		return $ids;
+	}
+
+	private function checkType(string $class, ?string $type): void
+	{
+		if (!$type) {
+			return;
+		}
+
+		if ($type !== $class) {
+			throw new InvalidArgumentException(
+				sprintf('Given array must be an array of %s, %s contained in array', $type, $class)
+			);
+		}
+	}
+
+}