added path pattern

Author: transistive

src/Patterns/Path.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace WikibaseSolutions\CypherDSL\Patterns;
+
+use WikibaseSolutions\CypherDSL\Traits\PathTrait;
+use WikibaseSolutions\CypherDSL\Types\StructuralTypes\PathType;
+use WikibaseSolutions\CypherDSL\Types\StructuralTypes\StructuralType;
+
+class Path implements PathType
+{
+    use PathTrait;
+
+    /** @var Relationship[] */
+    private array $relationships = [];
+
+    public function __construct()
+    {
+    }
+
+    public function toQuery(): string
+    {
+        $cql = '';
+        if ($this->getVariable() !== null) {
+            $cql = $this->getName()->toQuery() . ' = ';
+        }
+
+        foreach ($this->relationships as $relationship) {
+            $cql .= $relationship->getLeft()->toQuery();
+            $cql .= $relationship->toRelationshipQuery();
+        }
+
+        if (isset($relationship)) {
+            $cql .= $relationship->getRight()->toQuery();
+        }
+
+        return $cql;
+    }
+
+    public function relationshipTo(StructuralType $pattern): Path
+    {
+        $this->relationships[] = $this->getLatestNode()->relationshipUni($pattern);
+
+        return $this;
+    }
+
+    public function relationshipFrom(StructuralType $pattern): Path
+    {
+        $this->relationships[] = $this->getLatestNode()->relationshipUni($pattern);
+
+        return $this;
+    }
+
+    public function relationshipUni(StructuralType $pattern): Path
+    {
+        $this->relationships[] = $this->getLatestNode()->relationshipUni($pattern);
+
+        return $this;
+    }
+
+    private function getLatestNode(): StructuralType
+    {
+        return $this->relationships[count($this->relationships) - 1]->getRight();
+    }
+}

src/Patterns/Relationship.php

@@ -24,6 +24,7 @@
 use DomainException;
 use InvalidArgumentException;
 use LogicException;
+use WikibaseSolutions\CypherDSL\Property;
 use WikibaseSolutions\CypherDSL\Traits\EscapeTrait;
 use WikibaseSolutions\CypherDSL\Traits\RelationshipTrait;
 use WikibaseSolutions\CypherDSL\Types\StructuralTypes\RelationshipType;
@@ -201,7 +202,7 @@ public function toQuery(): string
         $a = $this->left->toQuery();
         $b = $this->right->toQuery();
 
-        return $a . $this->direction[0] . $this->conditionToString() . $this->direction[1] . $b;
+        return $a . $this->toRelationshipQuery() . $b;
     }
 
     /**
@@ -327,4 +328,14 @@ public function property(string $property): Property
     {
         return new Property($this->getName(), $property);
     }
+
+    /**
+     * Returns the relationship part of the pattern without the nodes.
+     *
+     * @return string
+     */
+    public function toRelationshipQuery(): string
+    {
+        return $this->direction[0] . $this->conditionToString() . $this->direction[1];
+    }
 }

src/Traits/PathTrait.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace WikibaseSolutions\CypherDSL\Traits;
+
+trait PathTrait
+{
+    use HasVariableTrait;
+}

src/Types/StructuralTypes/PathType.php

@@ -21,9 +21,11 @@
 
 namespace WikibaseSolutions\CypherDSL\Types\StructuralTypes;
 
+use WikibaseSolutions\CypherDSL\Types\AnyType;
+
 /**
  * Represents the type "node".
  */
-interface PathType extends StructuralType
+interface PathType extends AnyType
 {
 }