1 files changed, 144 insertions, 0 deletions
diff --git a/www/wiki/extensions/SemanticMediaWiki/src/Query/DescriptionFactory.php b/www/wiki/extensions/SemanticMediaWiki/src/Query/DescriptionFactory.php
new file mode 100644
index 00000000..2a294abe
--- /dev/null
+++ b/www/wiki/extensions/SemanticMediaWiki/src/Query/DescriptionFactory.php
@@ -0,0 +1,144 @@
+<?php
+
+namespace SMW\Query;
+
+use SMW\DIProperty;
+use SMW\DIWikiPage;
+use SMW\Query\Language\ClassDescription;
+use SMW\Query\Language\ConceptDescription;
+use SMW\Query\Language\Conjunction;
+use SMW\Query\Language\Description;
+use SMW\Query\Language\Disjunction;
+use SMW\Query\Language\NamespaceDescription;
+use SMW\Query\Language\SomeProperty;
+use SMW\Query\Language\ThingDescription;
+use SMW\Query\Language\ValueDescription;
+use SMWDataItem as DataItem;
+use SMWDataValue as DataValue;
+
+/**
+ * @license GNU GPL v2+
+ * @since 2.4
+ *
+ * @author mwjames
+ */
+class DescriptionFactory {
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param DataItem $dataItem
+	 * @param DIProperty|null $property = null
+	 * @param integer $comparator
+	 *
+	 * @return ValueDescription
+	 */
+	public function newValueDescription( DataItem $dataItem, DIProperty $property = null, $comparator = SMW_CMP_EQ ) {
+		return new ValueDescription( $dataItem, $property, $comparator );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param DIProperty $property
+	 * @param Description $description
+	 *
+	 * @return SomeProperty
+	 */
+	public function newSomeProperty( DIProperty $property, Description $description ) {
+		return new SomeProperty( $property, $description );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @return ThingDescription
+	 */
+	public function newThingDescription() {
+		return new ThingDescription();
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param Description[] $descriptions
+	 *
+	 * @return Disjunction
+	 */
+	public function newDisjunction( $descriptions = [] ) {
+		return new Disjunction( $descriptions );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param Description[] $descriptions
+	 *
+	 * @return Conjunction
+	 */
+	public function newConjunction( $descriptions = [] ) {
+		return new Conjunction( $descriptions );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param integer $ns
+	 *
+	 * @return NamespaceDescription
+	 */
+	public function newNamespaceDescription( $ns ) {
+		return new NamespaceDescription( $ns );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param DIWikiPage|[] $category
+	 *
+	 * @return ClassDescription
+	 */
+	public function newClassDescription( $category ) {
+		return new ClassDescription( $category );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param DIWikiPage $concept
+	 *
+	 * @return ConceptDescription
+	 */
+	public function newConceptDescription( DIWikiPage $concept ) {
+		return new ConceptDescription( $concept );
+	}
+
+	/**
+	 * @since 2.4
+	 *
+	 * @param DataValue $dataValue
+	 *
+	 * @return Description
+	 */
+	public function newFromDataValue( DataValue $dataValue ) {
+
+		if ( !$dataValue->isValid() ) {
+			return $this->newThingDescription();
+		}
+
+		// Avoid circular reference when called from outside of the DV context
+		$dataValue->setOption( DataValue::OPT_QUERY_CONTEXT, true );
+
+		$description = $dataValue->getQueryDescription( $dataValue->getWikiValue() );
+
+		if ( $dataValue->getProperty() === null ) {
+			return $description;
+		}
+
+		return $this->newSomeProperty(
+			$dataValue->getProperty(),
+			$description
+		);
+	}
+
+}