rl-476/field-name FieldName:

- add text getters for field property: by type and by name

Author: Aleksey Shundrik

example/example.py

@@ -30,6 +30,10 @@
 
     # text fields example
     doc_number_field = response.text.get_field(TextFieldType.DOCUMENT_NUMBER)
+    doc_number_field_by_name = response.text.get_field_by_name("Document Number")
+
+    assert doc_number_field == doc_number_field_by_name
+    
     doc_number_mrz = doc_number_field.get_value()
     doc_number_visual = doc_number_field.get_value(Source.VISUAL)
     doc_number_visual_validity = doc_number_field.source_validity(Source.VISUAL)

regula/documentreader/webclient/ext/models/text.py

@@ -12,6 +12,24 @@ def get_field(self, field_type: int, lcid: int = None) -> Optional[TextField]:
                 return field
         return None
 
+    def get_field_value(self, field_type: int, lcid: int = None) -> Optional[str]:
+        field = self.get_field(field_type, lcid)
+        if field:
+            return field.value
+        return None
+
+    def get_field_by_name(self, field_name: str, lcid: int = None) -> Optional[TextField]:
+        for field in self.field_list:
+            if field.field_name == field_name and (not lcid or field.lcid == lcid):
+                return field
+        return None
+
+    def get_field_value_by_name(self, field_name: str, lcid: int = None) -> Optional[str]:
+        field = self.get_field_by_name(field_name, lcid)
+        if field:
+            return field.value
+        return None
+
     @GenText.field_list.getter
     def field_list(self) -> List[TextField]:
         # fix type hinting