Enhance text with extra functionality and aliases

pygmt/tests/test_text.py

@@ -78,6 +78,16 @@ def test_text_input_single_filename():
     return fig
 
 
+@pytest.mark.mpl_image_compare
+def test_text_input_external_filename():
+    """
+    Run text by passing in an external filename to textfiles
+    """
+    fig = Figure()
+    fig.text(region=[0, 6.5, 0, 6.5], textfiles="@Table_5_11.txt")
+    return fig
+
+
 @pytest.mark.mpl_image_compare
 def test_text_input_multiple_filenames():
     """
@@ -100,13 +110,13 @@ def test_text_nonexistent_filename():
 @pytest.mark.mpl_image_compare
 def test_text_position(region):
     """
-    Print text at center middle and four corners (top left/right, bottom
-    left/right) of map.
+    Print text at center middle (CM) and eight other positions
+    (Top/Middle/Bottom x Left/Centre/Right).
     """
     fig = Figure()
     fig.text(region=region, projection="x1c", frame="a", position="CM", text="C M")
-    for position in ("TL", "TR", "BL", "BR"):
-        fig.text(frame="a", position=position, text=position)
+    for position in ("TL", "TC", "TR", "ML", "MR", "BL", "BC", "BR"):
+        fig.text(position=position, text=position)
     return fig
 
 
@@ -124,13 +134,13 @@ def test_text_xy_with_position_fails(region):
 @pytest.mark.mpl_image_compare
 def test_text_position_offset_with_line(region):
     """
-    Print text at centre middle and  four corners (top left/right, bottom
-    left/right) of map, offset by 0.5 cm, with a line drawn from the original
-    to the shifted point.
+    Print text at centre middle (CM) and eight other positions
+    (Top/Middle/Bottom x Left/Centre/Right), offset by 0.5 cm, with a line
+    drawn from the original to the shifted point.
     """
     fig = Figure()
     fig.text(region=region, projection="x1c", frame="a", position="CM", text="C M")
-    for position in ("TL", "TR", "BL", "BR"):
+    for position in ("TL", "TC", "TR", "ML", "MR", "BL", "BC", "BR"):
         fig.text(position=position, text=position, offset="j0.5c+v")
     return fig