FEATURE: Add cli-commands for taxonomy management

- `taxonomy:list` List all taxonomy vocabularies
- `taxonomy:import` Import taxonomy content, expects filename + vocabulary-name (with globbing)
- `taxonomy:export` Export taxonomy content, expects filename + vocabulary-name (with globbing)
- `taxonomy:prune` Prune taxonomy content, expects vocabulary-name (with globbing)

Classes/Command/TaxonomyCommandController.php

@@ -0,0 +1,183 @@
+<?php
+namespace Sitegeist\Taxonomy\Command;
+
+use Neos\Flow\Annotations as Flow;
+use Neos\Flow\Cli\CommandController;
+use Neos\ContentRepository\Domain\Model\NodeInterface;
+use Neos\ContentRepository\Domain\Service\ImportExport\NodeExportService;
+use Neos\ContentRepository\Domain\Service\ImportExport\NodeImportService;
+use Neos\ContentRepository\Domain\Repository\NodeDataRepository;
+use Neos\Eel\FlowQuery\FlowQuery;
+use Sitegeist\Taxonomy\Service\TaxonomyService;
+
+/**
+ * @Flow\Scope("singleton")
+ */
+class TaxonomyCommandController extends CommandController
+{
+
+    /**
+     * @var array
+     * @Flow\InjectConfiguration
+     */
+    protected $configuration;
+
+    /**
+     * @Flow\Inject
+     * @var NodeImportService
+     */
+    protected $nodeImportService;
+
+    /**
+     * @var NodeExportService
+     * @Flow\Inject
+     */
+    protected $nodeExportService;
+
+    /**
+     * @var NodeDataRepository
+     * @Flow\Inject
+     */
+    protected $nodeDataRepository;
+
+    /**
+     * @var TaxonomyService
+     * @Flow\Inject
+     */
+    protected $taxonomyService;
+
+    /**
+     * List taxonomy vocabularies
+     *
+     * @param string $vocabularyNode vocabularay nodename(path) to prune (globbing is supported)
+     * @return void
+     */
+    public function listCommand()
+    {
+        $taxonomyRoot = $this->taxonomyService->getRoot();
+
+        /**
+         * @var NodeInterface[] $vocabularyNodes
+         */
+        $vocabularyNodes = (new FlowQuery([$taxonomyRoot]))
+            ->children('[instanceof ' . $this->taxonomyService->getVocabularyNodeType() . ' ]')
+            ->get();
+
+        /**
+         * @var NodeInterface $vocabularyNode
+         */
+        foreach ($vocabularyNodes as $vocabularyNode) {
+            $this->outputLine($vocabularyNode->getName());
+        }
+    }
+
+    /**
+     * Import taxonomy content
+     *
+     * @param string $filename relative path and filename to the XML file to read.
+     * @param string $vocabularyNode vocabularay nodename(path) to import (globbing is supported)
+     * @return void
+     */
+    public function importCommand($filename, $vocabulary = null)
+    {
+        $xmlReader = new \XMLReader();
+        $xmlReader->open($filename, null, LIBXML_PARSEHUGE);
+
+        $taxonomyRoot = $this->taxonomyService->getRoot();
+
+        while ($xmlReader->read()) {
+            if ($xmlReader->nodeType != \XMLReader::ELEMENT || $xmlReader->name !== 'vocabulary') {
+                continue;
+            }
+
+            $vocabularyName = (string) $xmlReader->getAttribute('name');
+            if (is_string($vocabulary) && fnmatch($vocabulary, $vocabularyName) == false) {
+                continue;
+            }
+
+            $this->nodeImportService->import($xmlReader, $taxonomyRoot->getPath());
+            $this->outputLine('Imported vocabulary %s from file %s', [$vocabularyName, $filename]);
+        }
+    }
+
+    /**
+     * Export taxonomy content
+     *
+     * @param string $filename filename for the xml that is written.
+     * @param string $vocabularyNode vocabularay nodename(path) to export (globbing is supported)
+     * @return void
+     */
+    public function exportCommand($filename, $vocabulary = null)
+    {
+        $xmlWriter = new \XMLWriter();
+        $xmlWriter->openUri($filename);
+        $xmlWriter->setIndent(true);
+
+        $xmlWriter->startDocument('1.0', 'UTF-8');
+        $xmlWriter->startElement('root');
+
+        $taxonomyRoot = $this->taxonomyService->getRoot();
+
+        /**
+         * @var NodeInterface[] $vocabularyNodes
+         */
+        $vocabularyNodes = (new FlowQuery([$taxonomyRoot]))
+            ->children('[instanceof ' . $this->taxonomyService->getVocabularyNodeType() . ' ]')
+            ->get();
+
+        /**
+         * @var NodeInterface $vocabularyNode
+         */
+        foreach ($vocabularyNodes as $vocabularyNode) {
+            $vocabularyName = $vocabularyNode->getName();
+            if (is_string($vocabulary) && fnmatch($vocabulary, $vocabularyName) == false) {
+                continue;
+            }
+            $xmlWriter->startElement('vocabulary');
+            $xmlWriter->writeAttribute('name', $vocabularyName);
+            $this->nodeExportService->export($vocabularyNode->getPath(), 'live', $xmlWriter,  false, false);
+            $this->outputLine('Exported vocabulary %s to file %s', [$vocabularyName, $filename]);
+            $xmlWriter->endElement();
+        }
+
+        $xmlWriter->endElement();
+        $xmlWriter->endDocument();
+
+        $xmlWriter->flush();
+    }
+
+    /**
+     * Prune taxonomy content
+     *
+     * @param string $vocabularyNode vocabularay nodename(path) to prune (globbing is supported)
+     * @return void
+     */
+    public function pruneCommand($vocabulary)
+    {
+        $taxonomyRoot = $this->taxonomyService->getRoot();
+
+        /**
+         * @var NodeInterface[] $vocabularyNodes
+         */
+        $vocabularyNodes = (new FlowQuery([$taxonomyRoot]))
+            ->children('[instanceof ' . $this->taxonomyService->getVocabularyNodeType() . ' ]')
+            ->get();
+
+        /**
+         * @var NodeInterface $vocabularyNode
+         */
+        foreach ($vocabularyNodes as $vocabularyNode) {
+            $vocabularyName = $vocabularyNode->getName();
+            if (is_string($vocabulary) && fnmatch($vocabulary, $vocabularyName) == false) {
+                continue;
+            }
+            $this->nodeDataRepository->removeAllInPath($vocabularyNode->getPath());
+            $dimensionNodes = $this->nodeDataRepository->findByPath($vocabularyNode->getPath());
+            foreach ($dimensionNodes as $node) {
+                $this->nodeDataRepository->remove($node);
+            }
+
+            $this->outputLine('Pruned vocabulary %s', [$vocabularyName]);
+        }
+    }
+}

README.md

@@ -95,7 +95,16 @@ startingPoint:
 
 Vocabularies and Taxonomies will always be created in all base-dimensions. This way it is ensured that they can
 always be referenced. The title and description of a taxons and vocabularies can be translated as is required for
-the project.    
+the project.
+
+## CLI Commands
+
+The taxonomy package includes some cli commands for managing the taxonomies.
+
+- `taxonomy:list` List all taxonomy vocabularies
+- `taxonomy:import` Import taxonomy content, expects filename + vocabulary-name (with globbing)
+- `taxonomy:export` Export taxonomy content, expects filename + vocabulary-name (with globbing)
+- `taxonomy:prune` Prune taxonomy content, expects vocabulary-name (with globbing)
 
 ## Privileges