FIX: docs build

argweaver/io/bed.py

@@ -34,6 +34,7 @@ def subset_bed(data, region):
     ----------
     bedfile : {py:obj}`str`
         Path to the bed file.
+
     region : {py:obj}`str`
         Subset of the file, in format {chrom}:{start}-{end}
 

argweaver/utils.py

@@ -4,8 +4,29 @@
 if typing.TYPE_CHECKING:
     from typing import Tuple
 
+__all__ = ["parse_region"]
+
 
 def parse_region(region: str) -> "Tuple[str, int, int]":
+    """Parse a region string.
+
+    Start and end are 1-based and inclusive. End must be greater than or equal to start.
+
+    Parameters
+    ----------
+    region : str
+        A string in the format {chrom}:{start}-{end}
+
+    Returns
+    -------
+    Tuple[str, int, int]
+        A tuple of (chrom, start, end)
+
+    Raises
+    ------
+    ValueError
+        If the region string is invalid.
+    """
     mo = re.match(r"(\w+):(\d+)-(\d+)", region)
     if mo is None:
         raise ValueError(f"Invalid region string: {region}")