osmsg 1.2.1__tar.gz → 1.2.2__tar.gz

{osmsg-1.2.1 → osmsg-1.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: osmsg
-Version: 1.2.1
+Version: 1.2.2
 Summary: OpenStreetMap Stats Generator: Commandline
 Keywords: osm,stats,commandline,openstreetmap
 Author: Kshitij Raj Sharma
@@ -78,7 +78,8 @@ brew install osgeonepal/tap/osmsg          # macOS / Linux (Homebrew tap)
 ```
 
 On Windows, download `osmsg.exe` from the [latest release](https://github.com/osgeonepal/osmsg/releases)
-and run it directly, no Python required.
+and double-click it to open the desktop app. Fill in the dates and options, click Run, and open the
+output folder. The CLI below is for macOS, Linux, and pip/uv users.
 
 ## Quick start
 
@@ -237,7 +238,7 @@ docker-compose `environment:` block all reach the same setting. CLI flag wins ov
 | `--history` / `--no-history` | `OSMSG_HISTORY` | on | Read covered months from the published dataset. |
 | `--history-url` | `OSMSG_HISTORY_URL` | `osmsg-history` | Published dataset location. |
 | `--insert` | (none) | off | Load history into the store and seed resume, then exit. No window loads all of it. |
-| `--osh-file` / `--changeset-file` | (none) | unset | Insert from local planet history + changeset files instead of the dataset. |
+| `--osh-file` / `--changeset-file` | (none) | unset | Insert from local planet history + changeset files. |
 | `--changeset-pad-hours` | `OSMSG_CHANGESET_PAD_HOURS` | `1` | See below. |
 | (auto-bootstrap on `--update`) | `OSMSG_BOOTSTRAP` | `hour` | `hour`, `day`, or `week`. Used when `--update` runs against an empty DB. |
 | (auto-bootstrap on `--update`) | `OSMSG_BOOTSTRAP_DAYS` | unset | Integer N; overrides `OSMSG_BOOTSTRAP`. |

{osmsg-1.2.1 → osmsg-1.2.2}/README.md

@@ -46,7 +46,8 @@ brew install osgeonepal/tap/osmsg          # macOS / Linux (Homebrew tap)
 ```
 
 On Windows, download `osmsg.exe` from the [latest release](https://github.com/osgeonepal/osmsg/releases)
-and run it directly, no Python required.
+and double-click it to open the desktop app. Fill in the dates and options, click Run, and open the
+output folder. The CLI below is for macOS, Linux, and pip/uv users.
 
 ## Quick start
 
@@ -205,7 +206,7 @@ docker-compose `environment:` block all reach the same setting. CLI flag wins ov
 | `--history` / `--no-history` | `OSMSG_HISTORY` | on | Read covered months from the published dataset. |
 | `--history-url` | `OSMSG_HISTORY_URL` | `osmsg-history` | Published dataset location. |
 | `--insert` | (none) | off | Load history into the store and seed resume, then exit. No window loads all of it. |
-| `--osh-file` / `--changeset-file` | (none) | unset | Insert from local planet history + changeset files instead of the dataset. |
+| `--osh-file` / `--changeset-file` | (none) | unset | Insert from local planet history + changeset files. |
 | `--changeset-pad-hours` | `OSMSG_CHANGESET_PAD_HOURS` | `1` | See below. |
 | (auto-bootstrap on `--update`) | `OSMSG_BOOTSTRAP` | `hour` | `hour`, `day`, or `week`. Used when `--update` runs against an empty DB. |
 | (auto-bootstrap on `--update`) | `OSMSG_BOOTSTRAP_DAYS` | unset | Integer N; overrides `OSMSG_BOOTSTRAP`. |

osmsg-1.2.2/osmsg/__version__.py

@@ -0,0 +1 @@
+__version__ = "1.2.2"

osmsg-1.2.2/osmsg/gui.py

@@ -0,0 +1,195 @@
+"""Minimal tkinter desktop UI for running osmsg and saving the output."""
+
+from __future__ import annotations
+
+import datetime as dt
+import os
+import queue
+import sys
+import threading
+from pathlib import Path
+from typing import Any
+
+from .exceptions import NoDataFoundError, OsmsgError
+from .pipeline import RunConfig, run
+
+UTC = dt.UTC
+FORMATS = ["parquet", "csv", "json", "markdown"]
+
+
+def _parse_date(value: str) -> dt.datetime | None:
+    value = value.strip()
+    if not value:
+        return None
+    for fmt in ("%Y-%m-%d %H:%M:%S", "%Y-%m-%d"):
+        try:
+            return dt.datetime.strptime(value, fmt).replace(tzinfo=UTC)
+        except ValueError:
+            continue
+    raise OsmsgError(f"Unrecognized date: {value!r}. Use YYYY-MM-DD.")
+
+
+def _split(value: str | None) -> list[str] | None:
+    items: list[str] = [part.strip() for part in (value or "").split(",") if part.strip()]
+    return items if items else None
+
+
+def build_config(form: dict[str, object], output_dir: str) -> RunConfig:
+    """Map the form fields to a RunConfig, raising OsmsgError on invalid input."""
+    formats = [name for name in FORMATS if form.get(name)]
+    if not formats:
+        raise OsmsgError("Pick at least one output format.")
+    start = _parse_date(str(form.get("start", "")))
+    if start is None:
+        raise OsmsgError("Start date is required (YYYY-MM-DD).")
+    return RunConfig(
+        name=str(form.get("name") or "stats"),
+        start_date=start,
+        end_date=_parse_date(str(form.get("end", ""))),
+        hashtags=_split(str(form.get("hashtags") or "")),
+        additional_tags=_split(str(form.get("tags") or "")),
+        tag_mode="all" if form.get("all_tags") else "none",
+        summary=bool(form.get("summary")),
+        formats=formats,
+        output_dir=Path(output_dir or "."),
+    )
+
+
+def _open_folder(path: Path) -> None:
+    if sys.platform == "win32":
+        os.startfile(path)  # noqa: S606
+    elif sys.platform == "darwin":
+        import subprocess
+
+        subprocess.run(["open", str(path)], check=False)
+    else:
+        import subprocess
+
+        subprocess.run(["xdg-open", str(path)], check=False)
+
+
+class _Redirector:
+    def __init__(self, sink: queue.Queue) -> None:
+        self.sink = sink
+
+    def write(self, text: str) -> None:
+        if text:
+            self.sink.put(("log", text))
+
+    def flush(self) -> None:
+        pass
+
+    def isatty(self) -> bool:
+        return False
+
+
+class App:
+    def __init__(self) -> None:
+        import tkinter as tk
+        from tkinter import filedialog, scrolledtext, ttk
+
+        self._tk = tk
+        self._filedialog = filedialog
+        self.events: queue.Queue = queue.Queue()
+        self.out_dir = str(Path.home() / "osmsg")
+
+        self.root = tk.Tk()
+        self.root.title("osmsg")
+        self.vars: dict[str, Any] = {}
+        frame = ttk.Frame(self.root, padding=12)
+        frame.grid(sticky="nsew")
+
+        rows = [
+            ("Name", "name", "stats"),
+            ("Start (YYYY-MM-DD)", "start", ""),
+            ("End (blank = now)", "end", ""),
+            ("Hashtags (comma-sep)", "hashtags", ""),
+            ("Tags (comma-sep)", "tags", ""),
+        ]
+        for i, (label, key, default) in enumerate(rows):
+            ttk.Label(frame, text=label).grid(row=i, column=0, sticky="w", pady=2)
+            var = tk.StringVar(value=default)
+            ttk.Entry(frame, textvariable=var, width=40).grid(row=i, column=1, columnspan=3, sticky="we", pady=2)
+            self.vars[key] = var
+
+        self.vars["all_tags"] = tk.BooleanVar()
+        self.vars["summary"] = tk.BooleanVar()
+        ttk.Checkbutton(frame, text="All tags", variable=self.vars["all_tags"]).grid(row=5, column=0, sticky="w")
+        ttk.Checkbutton(frame, text="Daily summary", variable=self.vars["summary"]).grid(row=5, column=1, sticky="w")
+
+        fmt_frame = ttk.LabelFrame(frame, text="Formats", padding=6)
+        fmt_frame.grid(row=6, column=0, columnspan=4, sticky="we", pady=6)
+        for i, name in enumerate(FORMATS):
+            var = tk.BooleanVar(value=name in ("parquet", "csv"))
+            ttk.Checkbutton(fmt_frame, text=name, variable=var).grid(row=0, column=i, padx=4)
+            self.vars[name] = var
+
+        self.out_label = ttk.Label(frame, text=f"Output: {self.out_dir}")
+        self.out_label.grid(row=7, column=0, columnspan=3, sticky="w")
+        ttk.Button(frame, text="Choose folder", command=self._choose_folder).grid(row=7, column=3, sticky="e")
+
+        self.run_btn = ttk.Button(frame, text="Run", command=self._on_run)
+        self.run_btn.grid(row=8, column=0, pady=8, sticky="w")
+        self.open_btn = ttk.Button(frame, text="Open output folder", command=lambda: _open_folder(Path(self.out_dir)))
+        self.open_btn.grid(row=8, column=1, pady=8, sticky="w")
+
+        self.log = scrolledtext.ScrolledText(frame, width=70, height=14, state="disabled")
+        self.log.grid(row=9, column=0, columnspan=4, sticky="nsew")
+        self.root.after(120, self._drain)
+
+    def _choose_folder(self) -> None:
+        chosen = self._filedialog.askdirectory(initialdir=self.out_dir)
+        if chosen:
+            self.out_dir = chosen
+            self.out_label.config(text=f"Output: {self.out_dir}")
+
+    def _append(self, text: str) -> None:
+        self.log.config(state="normal")
+        self.log.insert("end", text)
+        self.log.see("end")
+        self.log.config(state="disabled")
+
+    def _on_run(self) -> None:
+        try:
+            cfg = build_config({k: v.get() for k, v in self.vars.items()}, self.out_dir)
+        except OsmsgError as exc:
+            self._append(f"\n{exc}\n")
+            return
+        self.run_btn.config(state="disabled")
+        self._append(f"\nRunning into {self.out_dir} ...\n")
+        threading.Thread(target=self._worker, args=(cfg,), daemon=True).start()
+
+    def _worker(self, cfg: RunConfig) -> None:
+        saved = sys.stdout, sys.stderr
+        sys.stdout = sys.stderr = _Redirector(self.events)  # type: ignore[assignment]
+        try:
+            result = run(cfg)
+            self.events.put(("done", f"Done. {result['rows']} rows. Files in {self.out_dir}"))
+        except NoDataFoundError:
+            self.events.put(("done", "No data found for that range."))
+        except OsmsgError as exc:
+            self.events.put(("done", f"Error: {exc}"))
+        except Exception as exc:
+            self.events.put(("done", f"Unexpected error: {type(exc).__name__}: {exc}"))
+        finally:
+            sys.stdout, sys.stderr = saved
+
+    def _drain(self) -> None:
+        try:
+            while True:
+                kind, payload = self.events.get_nowait()
+                if kind == "log":
+                    self._append(payload)
+                else:
+                    self._append(f"\n{payload}\n")
+                    self.run_btn.config(state="normal")
+        except queue.Empty:
+            pass
+        self.root.after(120, self._drain)
+
+    def run(self) -> None:
+        self.root.mainloop()
+
+
+def launch() -> None:
+    App().run()

{osmsg-1.2.1 → osmsg-1.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "osmsg"
-version = "1.2.1"
+version = "1.2.2"
 description = "OpenStreetMap Stats Generator: Commandline"
 readme = "README.md"
 authors = [
@@ -41,6 +41,9 @@ repository = "https://github.com/osgeonepal/osmsg"
 [project.scripts]
 osmsg = "osmsg.cli:app"
 
+[project.gui-scripts]
+osmsg-gui = "osmsg.gui:launch"
+
 [build-system]
 requires = ["uv_build>=0.5.15,<0.9"]
 build-backend = "uv_build"

osmsg-1.2.1/osmsg/__version__.py

@@ -1 +0,0 @@
-__version__ = "1.2.1"