Implement default position/box for legend

pygmt/base_plotting.py

@@ -621,7 +621,7 @@ def image(self, imagefile, **kwargs):
     @fmt_docstring
     @use_alias(R="region", J="projection", D="position", F="box")
     @kwargs_to_strings(R="sequence")
-    def legend(self, spec=None, **kwargs):
+    def legend(self, spec=None, position="JTR+jTR", **kwargs):
         """
         Plot legends on maps.
 
@@ -644,13 +644,18 @@ def legend(self, spec=None, **kwargs):
         {R}
         position (D) : str
             ``'[g|j|J|n|x]refpoint+wwidth[/height][+jjustify][+lspacing][+odx[/dy]]'``
-            Defines the reference point on the map for the legend.
+            Defines the reference point on the map for the legend. By default, uses
+            'JTR+jTR' which places the legend in the upper-right corner, inside.
         box (F) : bool or str
             ``'[+cclearances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]'``
             Without further options, draws a rectangular border around the
             legend using **MAP_FRAME_PEN**.
         """
         kwargs = self._preprocess(**kwargs)
+
+        if "D" not in kwargs:
+            kwargs["D"] = position
+
         with Session() as lib:
             if spec is None:
                 specfile = ""

pygmt/tests/test_legend.py

@@ -28,6 +28,22 @@ def test_legend_position():
     return fig
 
 
+@pytest.mark.mpl_image_compare
+def test_legend_default_position():
+    """
+    Try using the default legend position.
+    """
+
+    fig = Figure()
+
+    fig.basemap(region=[-1, 1, -1, 1], frame=True)
+
+    fig.plot(x=[0], y=[0], style="p10p", label="Default")
+    fig.legend()
+
+    return fig
+
+
 @pytest.mark.mpl_image_compare
 def test_legend_entries():
     """