[formrecognizer] Update code to language code (Azure#22921)

* update to language code

* update samples

* fix path for async sample

Author: catalinaperalta

sdk/formrecognizer/azure-ai-formrecognizer/azure/ai/formrecognizer/_models.py

@@ -2252,9 +2252,9 @@ def from_dict(cls, data):
 class DocumentLanguage(object):
     """An object representing the detected language for a given text span.
 
-    :ivar code: Detected language code. Value may be an ISO 639-1 language code (ex.
+    :ivar language_code: Detected language code. Value may be an ISO 639-1 language code (ex.
      "en", "fr") or a BCP 47 language tag (ex. "zh-Hans").
-    :vartype code: str
+    :vartype language_code: str
     :ivar spans: Location of the text elements in the concatenated content that the language
      applies to.
     :vartype spans: list[~azure.ai.formrecognizer.DocumentSpan]
@@ -2263,21 +2263,21 @@ class DocumentLanguage(object):
     """
 
     def __init__(self, **kwargs):
-        self.code = kwargs.get("code", None)
+        self.language_code = kwargs.get("language_code", None)
         self.spans = kwargs.get("spans", None)
         self.confidence = kwargs.get("confidence", None)
 
     @classmethod
     def _from_generated(cls, language):
         return cls(
-            code=language.language_code,
+            language_code=language.language_code,
             spans=prepare_document_spans(language.spans),
             confidence=language.confidence,
         )
 
     def __repr__(self):
-        return "DocumentLanguage(code={}, spans={}, confidence={})".format(
-            self.code,
+        return "DocumentLanguage(language_code={}, spans={}, confidence={})".format(
+            self.language_code,
             repr(self.spans),
             self.confidence,
         )
@@ -2290,7 +2290,7 @@ def to_dict(self):
         :rtype: dict
         """
         return {
-            "code": self.code,
+            "language_code": self.language_code,
             "spans": [f.to_dict() for f in self.spans]
             if self.spans
             else [],
@@ -2307,7 +2307,7 @@ def from_dict(cls, data):
         :rtype: DocumentLanguage
         """
         return cls(
-            code=data.get("code", None),
+            language_code=data.get("language_code", None),
             spans=[DocumentSpan.from_dict(v) for v in data.get("spans")]  # type: ignore
             if len(data.get("spans", [])) > 0
             else [],

sdk/formrecognizer/azure-ai-formrecognizer/samples/v3.2-beta/async_samples/sample_analyze_read_async.py

@@ -35,6 +35,7 @@ async def analyze_read():
             os.path.abspath(__file__),
             "..",
             "..",
+            "..",
             "./sample_forms/forms/Form_1.jpg",
         )
     )
@@ -58,7 +59,7 @@ async def analyze_read():
 
     print("----Languages detected in the document----")
     for language in result.languages:
-        print("Language code: '{}' with confidence {}".format(language.code, language.confidence))
+        print("Language code: '{}' with confidence {}".format(language.language_code, language.confidence))
 
     for page in result.pages:
         print("----Analyzing document from page #{}----".format(page.page_number))

sdk/formrecognizer/azure-ai-formrecognizer/samples/v3.2-beta/sample_analyze_read.py

@@ -55,7 +55,7 @@ def analyze_read():
 
     print("----Languages detected in the document----")
     for language in result.languages:
-        print("Language code: '{}' with confidence {}".format(language.code, language.confidence))
+        print("Language code: '{}' with confidence {}".format(language.language_code, language.confidence))
 
     for page in result.pages:
         print("----Analyzing document from page #{}----".format(page.page_number))

sdk/formrecognizer/azure-ai-formrecognizer/tests/test_repr.py

@@ -231,8 +231,8 @@ def document_line(bounding_box, document_span):
 
 @pytest.fixture
 def document_language(document_span):
-    model = _models.DocumentLanguage(code="en", spans=[document_span[0]], confidence=0.99)
-    model_repr = "DocumentLanguage(code={}, spans=[{}], confidence={})".format(
+    model = _models.DocumentLanguage(language_code="en", spans=[document_span[0]], confidence=0.99)
+    model_repr = "DocumentLanguage(language_code={}, spans=[{}], confidence={})".format(
             "en",
             document_span[1],
             0.99,

sdk/formrecognizer/azure-ai-formrecognizer/tests/test_to_dict_v3.py

@@ -1024,7 +1024,7 @@ def test_analyze_result_to_dict(self):
             content="Sample\nFile content.",
             languages=[
                 _models.DocumentLanguage(
-                    code="en",
+                    language_code="en",
                     spans=[
                         _models.DocumentSpan(offset=5, length=2),
                     ],
@@ -1259,7 +1259,7 @@ def test_analyze_result_to_dict(self):
             "content": "Sample\nFile content.",
             "languages": [
                 {
-                    "code": "en",
+                    "language_code": "en",
                     "spans": [
                         {
                             "offset": 5,

sdk/formrecognizer/azure-ai-formrecognizer/tests/testcase.py

@@ -541,7 +541,7 @@ def assertDocumentLanguagesTransformCorrect(self, transformed_languages, raw_lan
         if transformed_languages == [] and not raw_languages:
             return
         for lang, expected in zip(transformed_languages, raw_languages):
-            assert lang.code == expected.language_code
+            assert lang.language_code == expected.language_code
             for span, expected_span in zip(lang.spans or [], expected.spans or []):
                 self.assertSpanTransformCorrect(span, expected_span)
             assert lang.confidence == expected.confidence