ApplicationFormFactory

Author: mabar

.docs/README.md

@@ -2,10 +2,86 @@
 
 ## Content
 
+- [ApplicationFormFactoryExtension - provides Nette\Application\UI\Form factory](#application-form-factory)
 - [StandaloneFormFactoryExtension - provides Nette\Forms\Form factory](#standalone-form-factory)
 
+## Application Form Factory
+
+ApplicationFormFactory returns instance of Nette\Application\UI\Form. It should be used instead of StandaloneFormFactory if [nette/application](https://github.com/nette/application) is installed.
+
+```yaml
+extensions:
+    forms.application: Contributte\Forms\DI\ApplicationFormFactoryExtension
+```
+
+You can override it by your implementation.
+
+```yaml
+services:
+    forms.application.factory: My\FormFactory
+```
+
+Straightforward is to **inject** factory to presenter.
+
+```php
+namespace App\Presenters;
+
+use Contributte\Forms\IApplicationFormFactory;
+use Nette\Application\UI\Form;
+
+final class UserPresenter extends BasePresenter
+{
+
+    /** @var IApplicationFormFactory @inject */
+    public $factory;
+
+    protected function createComponentUserForm(): Form
+    {
+        $form = $this->factory->create();
+
+        // Add inputs here!
+
+        return $form;
+    }
+
+}
+```
+
+Even better is to use factory in your custom form factory.
+
+```php
+namespace App\Forms;
+
+use Contributte\Forms\IApplicationFormFactory;
+use Nette\Application\UI\Form;
+
+final class UserFormFactory
+{
+
+    /** @var IApplicationFormFactory */
+    private $factory;
+
+    public function __construct(IApplicationFormFactory $factory)
+    {
+        $this->factory = $factory;
+    }
+
+    public function create(): Form
+    {
+        $form = $this->factory->create();
+
+        // Add inputs here!
+
+        return $form;
+    }
+
+}
+```
+
 ## Standalone Form Factory
 
+StandaloneFormFactory returns instance of Nette\Forms\Form. It should be used only if [nette/application](https://github.com/nette/application) is not installed.
+
 ```yaml
 extensions:
     forms.standalone: Contributte\Forms\DI\StandaloneFormFactoryExtension

README.md

@@ -31,6 +31,7 @@ composer require contributte/forms
 
 ## Overview
 
+- [Nette\Forms\Form factory (ApplicationFormFactoryExtension)](https://github.com/contributte/forms/blob/master/.docs/README.md#application-form-factory)
 - [Nette\Forms\Form factory (StandaloneFormFactoryExtension)](https://github.com/contributte/forms/blob/master/.docs/README.md#standalone-form-factory)
 
 ## Maintainers

composer.json

@@ -26,12 +26,16 @@
   "require-dev": {
     "ninjify/qa": "^0.8.0",
     "ninjify/nunjuck": "^0.2",
+    "nette/application": "~2.4.12",
     "nette/di": "~2.4.11",
     "nette/utils": "~2.5.2"
   },
   "suggest": {
     "nette/di": "to use FormFactoryExtension[CompilerExtension]"
   },
+  "conflict": {
+    "nette/application": "<2.4.12"
+  },
   "autoload": {
     "psr-4": {
       "Contributte\\Forms\\": "src"

src/DI/ApplicationFormFactoryExtension.php

@@ -0,0 +1,28 @@
+<?php declare(strict_types = 1);
+
+namespace Contributte\Forms\DI;
+
+use Contributte\Forms\Exception\LogicalException;
+use Contributte\Forms\IApplicationFormFactory;
+use Nette\Application\UI\Form;
+use Nette\DI\CompilerExtension;
+
+class ApplicationFormFactoryExtension extends CompilerExtension
+{
+
+	/**
+	 * Register services
+	 */
+	public function loadConfiguration(): void
+	{
+		if (!class_exists(Form::class)) {
+			throw new LogicalException(sprintf('Install nette/application to use %s factory', Form::class));
+		}
+
+		$builder = $this->getContainerBuilder();
+
+		$builder->addDefinition($this->prefix('factory'))
+			->setImplement(IApplicationFormFactory::class);
+	}
+
+}

src/Exception/LogicalException.php

@@ -0,0 +1,10 @@
+<?php declare(strict_types = 1);
+
+namespace Contributte\Forms\Exception;
+
+use LogicException;
+
+class LogicalException extends LogicException
+{
+
+}

src/IApplicationFormFactory.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types = 1);
+
+namespace Contributte\Forms;
+
+use Nette\Application\UI\Form;
+
+interface IApplicationFormFactory
+{
+
+	public function create(): Form;
+
+}

tests/cases/DI/ApplicationFormFactoryExtension.phpt

@@ -0,0 +1,28 @@
+<?php declare(strict_types = 1);
+
+/**
+ * Test: DI\ApplicationFormFactoryExtension
+ */
+
+use Contributte\Forms\DI\ApplicationFormFactoryExtension;
+use Contributte\Forms\IApplicationFormFactory;
+use Nette\Application\UI\Form;
+use Nette\DI\Compiler;
+use Nette\DI\Container;
+use Nette\DI\ContainerLoader;
+use Tester\Assert;
+
+require_once __DIR__ . '/../../bootstrap.php';
+
+test(function (): void {
+	$loader = new ContainerLoader(TEMP_DIR, true);
+	$class = $loader->load(function (Compiler $compiler): void {
+		$compiler->addExtension('formFactory', new ApplicationFormFactoryExtension());
+	}, 1);
+
+	/** @var Container $container */
+	$container = new $class();
+
+	Assert::type(IApplicationFormFactory::class, $container->getByType(IApplicationFormFactory::class));
+	Assert::type(Form::class, $container->getByType(IApplicationFormFactory::class)->create());
+});