reformat strings

Author: BriannaLind

reformat_strings.py

@@ -0,0 +1,45 @@
+# filename: reformat_strings.py
+# Usage: python reformat_strings.py
+
+import re
+from pathlib import Path
+from textwrap import wrap
+
+SRC_DIR = Path("src/planet_overlap")
+MAX_LINE = 79
+
+STRING_PATTERN = re.compile(r'(?P<quote>["\']{3}|["\'])(?P<content>.*?)(?P=quote)', re.DOTALL)
+
+def split_long_string(s, max_length=MAX_LINE):
+    """Split a string into multiple concatenated strings <= max_length."""
+    lines = wrap(s, width=max_length, break_long_words=False, replace_whitespace=False)
+    # Wrap each line in quotes
+    return "(\n    " + "\n    ".join(f'"{line}"' for line in lines) + "\n)"
+
+def process_file(file_path):
+    with open(file_path, "r", encoding="utf-8") as f:
+        content = f.read()
+
+    def replacer(match):
+        quote = match.group("quote")
+        text = match.group("content")
+        # Only process if longer than max
+        if "\n" in text or len(text) > MAX_LINE:
+            # Remove internal newlines to avoid double line breaks
+            text_clean = " ".join(line.strip() for line in text.splitlines())
+            return split_long_string(text_clean)
+        return match.group(0)
+
+    new_content = STRING_PATTERN.sub(replacer, content)
+
+    with open(file_path, "w", encoding="utf-8") as f:
+        f.write(new_content)
+
+    print(f"Processed {file_path}")
+
+def main():
+    for py_file in SRC_DIR.rglob("*.py"):
+        process_file(py_file)
+
+if __name__ == "__main__":
+    main()

src/planet_overlap/__init__.py

@@ -1,12 +1,7 @@
-"""
-planet_overlap
-
-Smart PlanetScope imagery querying and analysis with:
-- Conditional spatial tiling
-- Robust retry handling
-- Progress tracking
-- Multi-AOI support
-- Point buffering
-"""
+(
+    " planet_overlap  Smart PlanetScope imagery querying and analysis with: -"
+    "Conditional spatial tiling - Robust retry handling - Progress tracking - Multi-"
+    "AOI support - Point buffering"
+)
 
 __version__ = "0.1.0"

src/planet_overlap/analysis.py

@@ -80,10 +80,10 @@ def calculate_intersections(
     min_sun_angle: float = 0,
     area_threshold: float = 25.0,
 ) -> Tuple[np.ndarray, np.ndarray]:
-    """
-    Compute pairwise intersected areas and sun angle differences between polygons.
-    Only compares polygons from the same instrument and different satellites.
-    """
+    (
+    " Compute pairwise intersected areas and sun angle differences between polygons."
+    "Only compares polygons from the same instrument and different satellites."
+)
     n = len(polygons)
     area_2d = np.zeros((n, n), dtype=np.float32)
     sun_diff_2d = np.zeros((n, n), dtype=np.float32)
@@ -117,9 +117,9 @@ def process_tiles(
     min_view_angle: float = 3,
     min_sun_angle: float = 0,
 ) -> gpd.GeoDataFrame:
-    """
-    Process multiple tiles/datasets and return a unified GeoDataFrame.
-    """
+    (
+    " Process multiple tiles/datasets and return a unified GeoDataFrame."
+)
     merged_properties = []
     merged_geometries = []
     merged_ids = []

src/planet_overlap/client.py

@@ -1,16 +1,11 @@
-"""
-client.py - Entry point for running Planet Overlap analysis.
-
-This script:
-1. Reads AOI GeoJSON files.
-2. Applies filters (geometry, date, cloud cover, sun angle).
-3. Handles spatial and temporal tiling automatically.
-4. Calls pagination module to fetch imagery.
-5. Calls analysis module to compute overlaps and sun angles.
-6. Stores output to configurable directory.
-
-Supports multiple AOIs and multiple date ranges.
-"""
+(
+    " client.py - Entry point for running Planet Overlap analysis.  This script: 1."
+    "Reads AOI GeoJSON files. 2. Applies filters (geometry, date, cloud cover, sun"
+    "angle). 3. Handles spatial and temporal tiling automatically. 4. Calls"
+    "pagination module to fetch imagery. 5. Calls analysis module to compute"
+    "overlaps and sun angles. 6. Stores output to configurable directory.  Supports"
+    "multiple AOIs and multiple date ranges."
+)
 
 # client.py
 import logging
@@ -24,16 +19,11 @@
 def prepare_filters(
     geojson_paths: List[str], date_ranges: List[Tuple[str, str]]
 ) -> dict:
-    """
-    Build filters for multiple AOIs and date ranges.
-
-    Args:
-        geojson_paths: List of file paths to AOI geojsons.
-        date_ranges: List of (start_date, end_date) tuples.
-
-    Returns:
-        Dictionary containing combined filters.
-    """
+    (
+    " Build filters for multiple AOIs and date ranges.  Args: geojson_paths: List of"
+    "file paths to AOI geojsons. date_ranges: List of (start_date, end_date) tuples."
+    "Returns: Dictionary containing combined filters."
+)
     filters = build_filters(geojson_paths, date_ranges)
     logging.info(
         "Filters prepared for %d AOIs/date ranges", len(filters.get("config", []))
@@ -42,31 +32,22 @@ def prepare_filters(
 
 
 def load_aois(geojson_paths: List[str]):
-    """
-    Load AOIs from GeoJSON files.
-
-    Args:
-        geojson_paths: List of AOI geojson paths.
-
-    Returns:
-        List of AOI geometries.
-    """
+    (
+    " Load AOIs from GeoJSON files.  Args: geojson_paths: List of AOI geojson paths."
+    "Returns: List of AOI geometries."
+)
     aois = [load_aoi(path) for path in geojson_paths]
     logging.info("Loaded %d AOIs", len(aois))
     return aois
 
 
 def run_client(geojson_paths: List[str], date_ranges: List[Tuple[str, str]]):
-    """
-    Full client workflow: load AOIs, prepare filters, and return filters + AOIs.
-
-    Args:
-        geojson_paths: List of AOI GeoJSON paths.
-        date_ranges: List of (start_date, end_date) tuples.
-
-    Returns:
-        Tuple of (filters dict, list of AOI geometries)
-    """
+    (
+    " Full client workflow: load AOIs, prepare filters, and return filters + AOIs."
+    "Args: geojson_paths: List of AOI GeoJSON paths. date_ranges: List of"
+    "(start_date, end_date) tuples.  Returns: Tuple of (filters dict, list of AOI"
+    "geometries)"
+)
     aois = load_aois(geojson_paths)
     filters = prepare_filters(geojson_paths, date_ranges)
     # Use filters downstream; previously 'combined_filter' was unused

src/planet_overlap/filters.py

@@ -1,38 +1,27 @@
-"""
-filters.py
-Builds Planet API search filters dynamically for multiple AOIs, multiple date ranges,
-cloud cover, and sun angle thresholds.
-"""
+(
+    " filters.py Builds Planet API search filters dynamically for multiple AOIs,"
+    "multiple date ranges, cloud cover, and sun angle thresholds."
+)
 
 from datetime import datetime
 from typing import List, Tuple, Dict, Any
 from shapely.geometry import Polygon, mapping
 
 
 def geometry_filter(aoi: Polygon) -> Dict[str, Any]:
-    """
-    Convert a shapely Polygon into a Planet GeometryFilter.
-
-    Args:
-        aoi (Polygon): The area of interest.
-
-    Returns:
-        dict: GeometryFilter for Planet API.
-    """
+    (
+    " Convert a shapely Polygon into a Planet GeometryFilter.  Args: aoi (Polygon):"
+    "The area of interest.  Returns: dict: GeometryFilter for Planet API."
+)
     return {"type": "GeometryFilter", "field_name": "geometry", "config": mapping(aoi)}
 
 
 def date_range_filter(start: datetime, end: datetime) -> Dict[str, Any]:
-    """
-    Convert a start/end datetime into a Planet DateRangeFilter.
-
-    Args:
-        start (datetime): Start date.
-        end (datetime): End date.
-
-    Returns:
-        dict: DateRangeFilter for Planet API.
-    """
+    (
+    " Convert a start/end datetime into a Planet DateRangeFilter.  Args: start"
+    "(datetime): Start date. end (datetime): End date.  Returns: dict:"
+    "DateRangeFilter for Planet API."
+)
     return {
         "type": "DateRangeFilter",
         "field_name": "acquired",
@@ -44,15 +33,10 @@ def date_range_filter(start: datetime, end: datetime) -> Dict[str, Any]:
 
 
 def cloud_cover_filter(max_cloud: float) -> Dict[str, Any]:
-    """
-    Filter scenes by maximum cloud cover fraction.
-
-    Args:
-        max_cloud (float): Max cloud fraction (0.0-1.0).
-
-    Returns:
-        dict: RangeFilter for cloud_cover.
-    """
+    (
+    " Filter scenes by maximum cloud cover fraction.  Args: max_cloud (float): Max"
+    "cloud fraction (0.0-1.0).  Returns: dict: RangeFilter for cloud_cover."
+)
     return {
         "type": "RangeFilter",
         "field_name": "cloud_cover",
@@ -61,15 +45,10 @@ def cloud_cover_filter(max_cloud: float) -> Dict[str, Any]:
 
 
 def sun_angle_filter(min_sun_angle: float) -> Dict[str, Any]:
-    """
-    Filter scenes by minimum sun angle.
-
-    Args:
-        min_sun_angle (float): Minimum sun angle in degrees.
-
-    Returns:
-        dict: RangeFilter for sun elevation.
-    """
+    (
+    " Filter scenes by minimum sun angle.  Args: min_sun_angle (float): Minimum sun"
+    "angle in degrees.  Returns: dict: RangeFilter for sun elevation."
+)
     return {
         "type": "RangeFilter",
         "field_name": "sun_elevation",
@@ -83,19 +62,14 @@ def build_filters(
     max_cloud: float = 0.5,
     min_sun_angle: float = 0.0,
 ) -> Dict[str, Any]:
-    """
-    Build a Planet API search filter combining multiple AOIs, date ranges,
-    cloud cover, and sun angle constraints.
-
-    Args:
-        aois (List[Polygon]): List of AOI polygons.
-        date_ranges (List[Tuple[datetime, datetime]]): List of start/end date tuples.
-        max_cloud (float): Maximum cloud fraction.
-        min_sun_angle (float): Minimum sun elevation in degrees.
-
-    Returns:
-        dict: Combined Planet API filter ready for pagination.
-    """
+    (
+    " Build a Planet API search filter combining multiple AOIs, date ranges, cloud"
+    "cover, and sun angle constraints.  Args: aois (List[Polygon]): List of AOI"
+    "polygons. date_ranges (List[Tuple[datetime, datetime]]): List of start/end date"
+    "tuples. max_cloud (float): Maximum cloud fraction. min_sun_angle (float):"
+    "Minimum sun elevation in degrees.  Returns: dict: Combined Planet API filter"
+    "ready for pagination."
+)
     # Combine multiple AOIs with OrFilter
     if len(aois) == 1:
         geom_filter = geometry_filter(aois[0])

src/planet_overlap/geometry.py

@@ -1,9 +1,8 @@
-"""
-geometry.py
-Handles AOI (Area of Interest) loading, point detection, buffering,
-and preparation for Planet API requests.
-Supports single/multiple AOIs, points, and polygons.
-"""
+(
+    " geometry.py Handles AOI (Area of Interest) loading, point detection,"
+    "buffering, and preparation for Planet API requests. Supports single/multiple"
+    "AOIs, points, and polygons."
+)
 
 from pathlib import Path
 from shapely.geometry import Point, Polygon
@@ -16,15 +15,11 @@
 
 
 def load_aoi(paths: List[Union[str, Path]]) -> List[Polygon]:
-    """
-    Load AOIs from multiple GeoJSON files or single polygons.
-
-    Args:
-        paths (List[str | Path]): List of GeoJSON file paths
-
-    Returns:
-        List[Polygon]: List of polygons representing AOIs
-    """
+    (
+    " Load AOIs from multiple GeoJSON files or single polygons.  Args: paths"
+    "(List[str | Path]): List of GeoJSON file paths  Returns: List[Polygon]: List of"
+    "polygons representing AOIs"
+)
     aois: List[Polygon] = []
     for path in paths:
         path = Path(path)
@@ -44,16 +39,12 @@ def load_aoi(paths: List[Union[str, Path]]) -> List[Polygon]:
 
 
 def buffer_points(points: List[Point], buffer_deg: float = 0.01) -> List[Polygon]:
-    """
-    Converts points into small polygons (buffers) for Planet requests.
-
-    Args:
-        points (List[Point]): List of shapely Point objects
-        buffer_deg (float): Buffer radius in degrees (default 0.01 ~1 km)
-
-    Returns:
-        List[Polygon]: Buffered polygons
-    """
+    (
+    " Converts points into small polygons (buffers) for Planet requests.  Args:"
+    "points (List[Point]): List of shapely Point objects buffer_deg (float): Buffer"
+    "radius in degrees (default 0.01 ~1 km)  Returns: List[Polygon]: Buffered"
+    "polygons"
+)
     buffered = [pt.buffer(buffer_deg) for pt in points]
     logger.info(
         f"Buffered {len(points)} points into polygons with {buffer_deg}° radius"
@@ -62,15 +53,10 @@ def buffer_points(points: List[Point], buffer_deg: float = 0.01) -> List[Polygon
 
 
 def unify_aois(aois: List[Polygon]) -> Polygon:
-    """
-    Merge multiple AOIs into a single polygon if needed.
-
-    Args:
-        aois (List[Polygon]): List of polygons
-
-    Returns:
-        Polygon: Single merged polygon
-    """
+    (
+    " Merge multiple AOIs into a single polygon if needed.  Args: aois"
+    "(List[Polygon]): List of polygons  Returns: Polygon: Single merged polygon"
+)
     merged = unary_union(aois)
     if isinstance(merged, Polygon):
         return merged

src/planet_overlap/logger.py

@@ -3,9 +3,9 @@
 
 
 def setup_logger(log_file: str | None = None):
-    """
-    Configure logging for console and optional file output.
-    """
+    (
+    " Configure logging for console and optional file output."
+)
     handlers = [logging.StreamHandler(sys.stdout)]
 
     if log_file: