Moved all Types into dedicated Flow/Types namespace for flow-php/types component

Author: norberttech

.github/workflows/monorepo-split.yml

@@ -42,6 +42,8 @@ jobs:
             split_repository: 'filesystem'
           - local_path: 'src/lib/snappy'
             split_repository: 'snappy'
+          - local_path: 'src/lib/types'
+            split_repository: 'types'
 
           - local_path: 'src/adapter/etl-adapter-avro'
             split_repository: 'etl-adapter-avro'

bin/docs.php

@@ -4,6 +4,7 @@
 declare(strict_types=1);
 
 use Flow\Documentation\{FunctionCollector, FunctionsExtractor};
+use Flow\ETL\Attribute\Module;
 use Symfony\Component\Console\Application;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\{InputArgument, InputInterface};
@@ -47,6 +48,7 @@ public function execute(InputInterface $input, OutputInterface $output) : int
             __DIR__ . '/../src/adapter/etl-adapter-text/src/Flow/ETL/Adapter/Text/functions.php',
             __DIR__ . '/../src/adapter/etl-adapter-xml/src/Flow/ETL/Adapter/XML/functions.php',
             __DIR__ . '/../src/lib/filesystem/src/Flow/Filesystem/DSL/functions.php',
+            __DIR__ . '/../src/lib/types/src/Flow/Types/DSL/functions.php',
             __DIR__ . '/../src/bridge/filesystem/azure/src/Flow/Filesystem/Bridge/Azure/DSL/functions.php',
             __DIR__ . '/../src/bridge/filesystem/async-aws/src/Flow/Filesystem/Bridge/AsyncAWS/DSL/functions.php',
             __DIR__ . '/../src/lib/azure-sdk/src/Flow/Azure/SDK/DSL/functions.php',
@@ -60,6 +62,13 @@ public function execute(InputInterface $input, OutputInterface $output) : int
         $normalizedFunctions = [];
 
         foreach ($extractor->extract($paths) as $function) {
+            if (($attribute = $function->attributes->findByName('DocumentationDSL')) !== null) {
+
+                if ($attribute->arguments['module'] === Module::DEPRECATED) {
+                    continue;
+                }
+            }
+
             $normalizedFunctions[] = $function->normalize();
         }
 

composer.json

@@ -122,6 +122,7 @@
                 "src/lib/parquet-viewer/src/Flow",
                 "src/lib/parquet/src/Flow",
                 "src/lib/snappy/src/Flow",
+                "src/lib/types/src/Flow",
                 "src/tools/documentation/src/Flow"
             ],
             "Flow\\Doctrine\\Bulk\\": [
@@ -154,6 +155,7 @@
             "src/lib/filesystem/src/Flow/Filesystem/DSL/functions.php",
             "src/lib/parquet/src/Flow/Parquet/functions.php",
             "src/lib/parquet/src/stubs.php",
+            "src/lib/types/src/Flow/Types/DSL/functions.php",
             "src/lib/snappy/polyfill.php"
         ]
     },
@@ -187,6 +189,7 @@
                 "src/lib/parquet-viewer/tests/Flow",
                 "src/lib/parquet/tests/Flow",
                 "src/lib/snappy/tests/Flow",
+                "src/lib/types/tests/Flow",
                 "src/tools/documentation/tests/Flow"
             ],
             "Flow\\Doctrine\\Bulk\\Tests\\": [
@@ -227,6 +230,7 @@
             "@test:lib:parquet",
             "@test:lib:parquet-viewer",
             "@test:lib:snappy",
+            "@test:lib:types",
             "@test:bridge:filesystem-azure",
             "@test:bridge:filesystem-async-aws",
             "@test:bridge:monolog-http",
@@ -276,6 +280,9 @@
         "test:lib:snappy": [
             "tools/phpunit/vendor/bin/phpunit --testsuite=lib-snappy-integration --log-junit ./var/phpunit/logs/lib-snappy-integration.junit.xml --coverage-clover=./var/phpunit/coverage/clover/lib-snappy-integration.coverage.xml --coverage-html=./var/phpunit/coverage/html/lib-snappy-integration"
         ],
+        "test:lib:types": [
+            "tools/phpunit/vendor/bin/phpunit --testsuite=lib-types-unit --log-junit ./var/phpunit/logs/lib-types-unit.junit.xml --coverage-clover=./var/phpunit/coverage/clover/lib-types-unit.coverage.xml --coverage-html=./var/phpunit/coverage/html/lib-types-unit"
+        ],
         "test:bridge:filesystem-azure": [
             "tools/phpunit/vendor/bin/phpunit --testsuite=bridge-filesystem-azure-unit --log-junit ./var/phpunit/logs/bridge-filesystem-azure-unit.junit.xml --coverage-clover=./var/phpunit/coverage/clover/bridge-filesystem-azure-unit.coverage.xml --coverage-html=./var/phpunit/coverage/html/bridge-filesystem-azure-unit",
             "tools/phpunit/vendor/bin/phpunit --testsuite=bridge-filesystem-azure-integration --log-junit ./var/phpunit/logs/bridge-filesystem-azure-integration.junit.xml --coverage-clover=./var/phpunit/coverage/clover/bridge-filesystem-azure-integration.coverage.xml --coverage-html=./var/phpunit/coverage/html/bridge-filesystem-azure-integration"
@@ -403,6 +410,7 @@
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/lib.parquet.xml",
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/lib.parquet-viewer.xml",
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/lib.snappy.xml",
+            "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/lib.types.xml",
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/adapter.chartjs.xml",
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/adapter.csv.xml",
             "./tools/phpdocumentor/vendor/bin/phpdoc --config=./phpdoc/adapter.doctrine.xml",

documentation/components/libs/types.md

@@ -0,0 +1,9 @@
+# Types
+
+- [⬅️️ Back](../../introduction.md)
+
+## Installation
+
+```
+composer require flow-php/types:~--FLOW_PHP_VERSION--
+```

examples/clean.php

@@ -18,13 +18,13 @@
     exit(1);
 }
 
-if (false === \in_array(PHP_SAPI, ['cli', 'phpdbg', 'embed'], true)) {
+if (false === in_array(PHP_SAPI, ['cli', 'phpdbg', 'embed'], true)) {
     print PHP_EOL . 'This script may only be invoked from a command line, got "' . PHP_SAPI . '"' . PHP_EOL;
 
     exit(1);
 }
 
-\ini_set('memory_limit', -1);
+ini_set('memory_limit', -1);
 
 $finder = new Finder();
 $finder->in(__DIR__ . '/topics')

examples/run.php

@@ -17,13 +17,13 @@
     exit(1);
 }
 
-if (false === \in_array(PHP_SAPI, ['cli', 'phpdbg', 'embed'], true)) {
+if (false === in_array(PHP_SAPI, ['cli', 'phpdbg', 'embed'], true)) {
     print PHP_EOL . 'This script may only be invoked from a command line, got "' . PHP_SAPI . '"' . PHP_EOL;
 
     exit(1);
 }
 
-\ini_set('memory_limit', -1);
+ini_set('memory_limit', -1);
 
 $output = new ConsoleOutput();
 $intput = new ArgvInput(definition: new InputDefinition(