converters.py

class AngleConverter:
    """Accept any valid input value for an astropy.coordinates.Angle and ensure the
    returned value is a float in decimal degrees. The unit should be included in the input
    value."""
    regex = r"\d+(\.\d+)?\s?\w+"

    def to_python(self, value) -> float:
        """
        Return the decimal degrees from the coordinate input as an Angle object.

        Args:
            value: The value of the angle input.

        Returns:
            The angle returned as an Angle object.
        """
        return Angle(value).deg

    def to_url(self, value) -> str:
        """
        Return the string format of an Angle object from the coordinate input.

        Args:
            value: The value of the angle input.

        Returns:
            The string representation of the Angle object created from the input.
        """
        return value.to_string()

class DeclinationConverter:
    """Accept both decimal and sexigesimal representations of Dec and ensure the returned
    value is a float in decimal degrees. The input units are always assumed to be degrees."""
    regex = r"(?:\+|-)?(?:\d{1,2}:\d{1,2}:\d{1,2}(?:\.\d+)?|\d+(?:\.\d+)?)"

    def to_python(self, value: str) -> float:
        """
        Return the decimal degrees from the coordinate input as a python float
        object.

        Args:
            value: The value of the declination input.

        Returns:
            The decimal degrees value.
        """
        return Latitude(value, unit="deg").deg

    def to_url(self, value: str) -> str:
        """
        Return the decimal degrees from the coordinate input in a URL format.

        Args:
            value: The value of the declination input.

        Returns:
            The decimal degrees value as a string.
        """
        return value.to_string(unit="deg", decimal=True)

class RightAscensionConverter:
    """Accept both decimal and sexigesimal representations of RA and ensure the returned
    value is a float in decimal degrees. If the input is in sexigesimal format, assume
    it is in units of hourangle."""
    regex = r"(?:\d+(?:\.\d+)?|\d{1,2}:\d{1,2}:\d{1,2}(?:\.\d+)?)"

    def to_python(self, value: str) -> float:
        """
        Return the decimal degrees from the coordinate input as a python float
        object.

        Args:
            value: The value of the RA input.

        Returns:
            The decimal degrees value.
        """
        unit = "hourangle" if ":" in value else "deg"
        return Longitude(value, unit=unit).deg

    def to_url(self, value: str) -> str:
        """
        Return the decimal degrees from the coordinate input in a URL format.

        Args:
            value: The value of the RA input.

        Returns:
            The decimal degrees value as a string.
        """
        return value.to_string(unit="deg", decimal=True)