better docstrings and ruff fixes

fastkml/links.py

@@ -13,7 +13,7 @@
 # You should have received a copy of the GNU Lesser General Public License
 # along with this library; if not, write to the Free Software Foundation, Inc.,
 # 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
-
+"""Link and Icon elements."""
 from typing import Any
 from typing import Dict
 from typing import Optional
@@ -107,6 +107,15 @@ def __repr__(self) -> str:
         )
 
     def __bool__(self) -> bool:
+        """
+        Check if the link has a valid href.
+
+        Returns
+        -------
+        bool
+            True if the link has a valid href, False otherwise.
+
+        """
         return bool(self.href)
 
 

fastkml/mixins.py

@@ -26,17 +26,21 @@
 
 
 class TimeMixin:
+    """Mixin for classes that have a time element."""
+
     times: Optional[Union[TimeSpan, TimeStamp]] = None
 
     @property
     def time_stamp(self) -> Optional[KmlDateTime]:
-        """This just returns the datetime portion of the timestamp."""
+        """Return the timestamp."""
         return self.times.timestamp if isinstance(self.times, TimeStamp) else None
 
     @property
     def begin(self) -> Optional[KmlDateTime]:
+        """Return the start time of a time span."""
         return self.times.begin if isinstance(self.times, TimeSpan) else None
 
     @property
     def end(self) -> Optional[KmlDateTime]:
+        """Return the end time of a time span."""
         return self.times.end if isinstance(self.times, TimeSpan) else None