gpx-link 1.19.0__tar.gz

gpx_link-1.19.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.3
+Name: gpx-link
+Version: 1.19.0
+Summary: View GPX waypoints on OpenStreetMap and open locations in Google Maps
+Author: Markus Borris
+Author-email: Markus Borris <devmborrs@gmail.com>
+Requires-Dist: gpxpy>=1.6.2
+Requires-Dist: pyside6>=6.6.0 ; extra == 'gui'
+Requires-Python: >=3.10
+Provides-Extra: gui

gpx_link-1.19.0/pyproject.toml

@@ -0,0 +1,63 @@
+[project]
+name = "gpx-link"
+version = "1.19.0"
+description = "View GPX waypoints on OpenStreetMap and open locations in Google Maps"
+requires-python = ">=3.10"
+authors = [
+    { name = "Markus Borris", email = "devmborrs@gmail.com" },
+]
+dependencies = [
+    "gpxpy>=1.6.2",
+]
+
+[project.optional-dependencies]
+gui = [
+    "PySide6>=6.6.0",
+]
+
+[project.scripts]
+gpx-link = "gpx_link.cli:main"
+gpx-link-gui = "gpx_link.gui.app:main"
+
+[build-system]
+requires = ["uv_build>=0.11.11,<0.12.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "detect-secrets>=1.5.0",
+    "pre-commit>=4.6.0",
+    "pytest>=9.0.3",
+    "pytest-cov>=7.1.0",
+    "python-semantic-release>=10.5.0,<11",
+    "ruff>=0.15.12",
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+src = ["src"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = [
+    "--cov=gpx_link",
+    "--cov-report=term-missing",
+    "--cov-report=xml",
+]
+
+[tool.coverage.run]
+source = ["gpx_link"]
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.codespell]
+skip = ".venv,uv.lock,android/Gemfile.lock"
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+build_command = "uv build"

gpx_link-1.19.0/src/gpx_link/__init__.py

@@ -0,0 +1,23 @@
+"""GPX waypoint parsing, map HTML generation, and Google Maps URLs."""
+
+from gpx_link.bounds import Bounds, bounds_for_waypoints
+from gpx_link.html_map import build_leaflet_html
+from gpx_link.maps_urls import google_maps_url
+from gpx_link.models import GeoPath, Waypoint
+from gpx_link.parser import (
+    load_map_features_from_paths,
+    load_waypoints_from_files,
+    load_waypoints_from_paths,
+)
+
+__all__ = [
+    "Bounds",
+    "GeoPath",
+    "Waypoint",
+    "bounds_for_waypoints",
+    "build_leaflet_html",
+    "google_maps_url",
+    "load_map_features_from_paths",
+    "load_waypoints_from_files",
+    "load_waypoints_from_paths",
+]

gpx_link-1.19.0/src/gpx_link/__main__.py

@@ -0,0 +1,4 @@
+from gpx_link.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

gpx_link-1.19.0/src/gpx_link/bounds.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+from gpx_link.models import GeoPath, Waypoint
+
+# Minimum span so a single point still gets a sensible zoom (degrees).
+_MIN_SPAN_DEG = 0.002
+# Fraction of lat/lon span added on each side before map fit (smaller = tighter crop).
+_DEFAULT_PAD_RATIO = 0.04
+
+
+@dataclass(frozen=True, slots=True)
+class Bounds:
+    min_lat: float
+    max_lat: float
+    min_lon: float
+    max_lon: float
+
+    def padded(self, pad_ratio: float = _DEFAULT_PAD_RATIO) -> Bounds:
+        lat_span = max(self.max_lat - self.min_lat, _MIN_SPAN_DEG)
+        lon_span = max(self.max_lon - self.min_lon, _MIN_SPAN_DEG)
+        plat = lat_span * pad_ratio
+        plon = lon_span * pad_ratio
+        return Bounds(
+            min_lat=self.min_lat - plat,
+            max_lat=self.max_lat + plat,
+            min_lon=self.min_lon - plon,
+            max_lon=self.max_lon + plon,
+        )
+
+
+def bounds_for_waypoints(waypoints: list[Waypoint]) -> Bounds | None:
+    """Return axis-aligned bounds for all waypoints, or None if empty."""
+    return bounds_for_map(waypoints, [])
+
+
+def bounds_for_tracks_from_file(paths: list[GeoPath], source: Path) -> Bounds | None:
+    """Bounds for ``kind == track`` segments originating from ``source`` only."""
+    resolved = source.resolve()
+    tracks = [
+        p for p in paths if p.kind == "track" and p.source_path.resolve() == resolved
+    ]
+    return bounds_for_map([], tracks)
+
+
+def bounds_for_map(
+    waypoints: list[Waypoint],
+    paths: list[GeoPath],
+) -> Bounds | None:
+    """Bounding box over waypoints and path vertices; None if both are empty."""
+    lats: list[float] = []
+    lons: list[float] = []
+    for w in waypoints:
+        lats.append(w.latitude)
+        lons.append(w.longitude)
+    for p in paths:
+        for lat, lon in p.points:
+            lats.append(lat)
+            lons.append(lon)
+    if not lats:
+        return None
+    return Bounds(
+        min_lat=min(lats),
+        max_lat=max(lats),
+        min_lon=min(lons),
+        max_lon=max(lons),
+    )

gpx_link-1.19.0/src/gpx_link/cli.py

@@ -0,0 +1,69 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from gpx_link.html_map import build_leaflet_html
+from gpx_link.parser import load_map_features_from_paths
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="gpx-link",
+        description="List GPX waypoints and export an OpenStreetMap HTML view.",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p_list = sub.add_parser("list", help="Print waypoints as JSON lines")
+    p_list.add_argument(
+        "gpx",
+        nargs="+",
+        type=Path,
+        help="GPX file path(s)",
+    )
+
+    p_html = sub.add_parser("html", help="Write Leaflet + OSM HTML to stdout or file")
+    p_html.add_argument(
+        "gpx",
+        nargs="+",
+        type=Path,
+        help="GPX file path(s)",
+    )
+    p_html.add_argument(
+        "-o",
+        "--output",
+        type=Path,
+        help="Output file (default: stdout)",
+    )
+
+    args = parser.parse_args(argv)
+    paths = [p.expanduser().resolve() for p in args.gpx]
+
+    if args.command == "list":
+        wpts, _ = load_map_features_from_paths(paths)
+        for w in wpts:
+            line = {
+                "source": str(w.source_path),
+                "name": w.name,
+                "latitude": w.latitude,
+                "longitude": w.longitude,
+                "elevation_m": w.elevation_m,
+                "description": w.description,
+                "symbol": w.symbol,
+                "waypoint_type": w.waypoint_type,
+            }
+            sys.stdout.write(json.dumps(line, ensure_ascii=False) + "\n")
+        return 0
+
+    if args.command == "html":
+        wpts, geopaths = load_map_features_from_paths(paths)
+        html = build_leaflet_html(wpts, geopaths)
+        if args.output:
+            args.output.write_text(html, encoding="utf-8")
+        else:
+            sys.stdout.write(html)
+        return 0
+
+    return 1

gpx_link-1.19.0/src/gpx_link/gui/__init__.py

@@ -0,0 +1 @@
+"""Qt desktop UI (optional dependency: PySide6)."""