839: Add support for reference geometry for geo questions

pyxform/builder.py

@@ -13,6 +13,7 @@
 from pyxform.errors import ErrorCode, PyXFormError
 from pyxform.external_instance import ExternalInstance
 from pyxform.question import (
+    GeoQuestion,
     InputQuestion,
     MultipleChoiceQuestion,
     Option,
@@ -39,6 +40,11 @@
     "select1": MultipleChoiceQuestion,
     "trigger": TriggerQuestion,
     "upload": UploadQuestion,
+    "__by_type__": {
+        "geopoint": GeoQuestion,
+        "geoshape": GeoQuestion,
+        "geotrace": GeoQuestion,
+    },
 }
 SECTION_CLASSES = {
     const.GROUP: GroupedSection,
@@ -157,7 +163,9 @@ def _create_question_from_dict(
 
         if question_class:
             if choices:
-                d_choices = d.get(const.CHOICES, d.get(const.CHILDREN))
+                d_choices = choices.get(
+                    d.get(const.ITEMSET), d.get(const.CHOICES, d.get(const.CHILDREN))
+                )
                 if d_choices:
                     return question_class(
                         question_type_dictionary=question_type_dictionary,
@@ -166,7 +174,7 @@ def _create_question_from_dict(
                             for k, v in d.items()
                             if k not in {const.CHOICES, const.CHILDREN}
                         },
-                        choices=choices.get(d[const.ITEMSET], d_choices),
+                        choices=d_choices,
                     )
 
             return question_class(question_type_dictionary=question_type_dictionary, **d)
@@ -196,6 +204,10 @@ def _get_question_class(question_type_str, question_type_dictionary):
         and find what class it maps to going through
         type_dictionary -> QUESTION_CLASSES
         """
+        by_type = QUESTION_CLASSES["__by_type__"].get(question_type_str, None)
+        if by_type is not None:
+            return by_type
+
         control_tag = ""
         question_type = question_type_dictionary.get(question_type_str)
         if question_type:

pyxform/constants.py

@@ -194,11 +194,13 @@ class ParametersAudit(StrEnum):
 class ParametersGeo(StrEnum):
     ALLOW_MOCK_ACCURACY = "allow-mock-accuracy"
     INCREMENTAL = "incremental"
+    REFERENCE_GEO = "reference-geo"
 
 
 class ParametersGeoPoint(StrEnum):
     ALLOW_MOCK_ACCURACY = "allow-mock-accuracy"
     CAPTURE_ACCURACY = "capture-accuracy"
+    REFERENCE_GEO = "reference-geo"
     WARNING_ACCURACY = "warning-accuracy"
 
 

pyxform/errors.py

@@ -521,6 +521,15 @@ class ErrorCode(Enum):
             "The following are invalid parameter key(s): '{rejected}'."
         ),
     )
+    SURVEY_006: Detail = Detail(
+        name="Survey sheet - invalid geo parameter 'reference-geo'",
+        msg=(
+            "[row : {row}] On the 'survey' sheet, the 'parameters' value is invalid. "
+            "For geo questions, the 'reference-geo' parameter must be either: "
+            "a choices list_name, an entities list_name, a reference variable containing "
+            "the name of a repeat, or the name of an attached CSV file."
+        ),
+    )
 
 
 class PyXFormError(Exception):