Improve frame

Author: seisman

pygmt/params/frame.py

@@ -3,9 +3,10 @@
 """
 
 import dataclasses
+from typing import Any, Literal
+
 from pygmt.alias import Alias
 from pygmt.params.base import BaseParam
-from typing import Any
 
 
 @dataclasses.dataclass(repr=False)
@@ -53,25 +54,77 @@ class Axis(BaseParam):
     """
     Class for setting up one axis of a plot.
 
+    Attributes
+    ----------
+    interval
+        Intervals for annotations and major tick spacing, minor tick spacing, and/or
+        grid line spacing.
+    angle
+        Plot slanted annotations (for Cartesian plots only), where *angle* is measured
+        with respect to the horizontal and must be in the -90 <= *angle* <= 90 range.
+        Default is normal (i.e., ``angle=90``) for y-axis and parallel (i.e.,
+        ``angle=0``) for x-axis annotations. These defaults can be changed via
+        :gmt-term:`MAP_ANNOT_ORTHO`.
+    skip_edge
+        Skip annotations that fall exactly at the ends of the axis. Choose from ``left``
+        or ``right`` to skip only the lower or upper annotation, respectively, or
+        ``True`` to skip both.
+    fancy
+        Give fancy annotations with W|E|S|N suffixes encoding the sign (for geographic
+        axes only).
+    label/hlabel
+        Add a label to the axis (for Cartesian plots only). The label is placed parallel
+        to the axis by default; use **hlabel** to force a horizontal label for y-axis,
+        which is useful for very short labels.
+    alt_label/alt_hlabel
+        Add an alternate label for the right or upper axes. The label is placed parallel
+        to the axis by default; use **alt_hlabel** to force a horizontal label for
+        y-axis, which is useful for very short labels. [For Cartesian plots only].
+    prefix
+        Add a leading text prefix for axis annotation (e.g., dollar sign for plots
+        related to money) (for Cartesian plots only). For geographic maps the addition
+        of degree symbols, etc. is automatic and controlled by
+        :gmt-term:`FORMAT_GEO_MAP`.
+    unit
+        Append a unit to the annotations (for Cartesian plots only). For geographic maps
+        the addition of degree symbols, etc. is automatic and controlled by
+        :gmt-term:`FORMAT_GEO_MAP`.
+
     Examples
     --------
     >>> from pygmt.params import Axis
     >>> str(Axis(10, angle=30, label="X axis", unit="km"))
     '10+a30+lX axis+ukm'
     """
 
-    interval: float | str
-    angle: float | str | None = None
+    interval: float | str  # How to make it more Pythonic?
+    angle: float | None = None
+    skip_edge: Literal["left", "right"] | bool = False
+    fancy: bool = False
     label: str | None = None
+    hlabel: str | None = None
+    alt_label: str | None = None
+    alt_hlabel: str | None = None
+    prefix: str | None = None
     unit: str | None = None
 
     @property
     def _aliases(self):
         return [
-            Alias(self.interval),
-            Alias(self.angle, prefix="+a"),
-            Alias(self.label, prefix="+l"),
-            Alias(self.unit, prefix="+u"),
+            Alias(self.interval, name="interval"),
+            Alias(self.angle, name="angle", prefix="+a"),
+            Alias(
+                self.skip_edge,
+                name="skip_edge",
+                prefix="+e",
+                mapping={True: True, "left": "l", "right": "r"},
+            ),
+            Alias(self.fancy, name="fancy", prefix="+f"),
+            Alias(self.label, name="label", prefix="+l"),
+            Alias(self.hlabel, name="hlabel", prefix="+L"),
+            Alias(self.alt_label, name="alt_label", prefix="+s"),
+            Alias(self.alt_hlabel, name="alt_hlabel", prefix="+S"),
+            Alias(self.unit, name="unit", prefix="+u"),
         ]