grawgo 2.0.0__py3-none-any.whl

grawgo/__init__.py

@@ -0,0 +1,9 @@
+import logging
+from os import getenv
+
+logging.basicConfig(
+    level=getattr(
+        logging, getenv(key="LOG_LEVEL", default="INFO").upper(), logging.INFO
+    ),
+    format="%(levelname)s: %(message)s",
+)

grawgo/api.py

@@ -0,0 +1,179 @@
+from logging import info
+from typing import Any
+from urllib.parse import urlparse
+
+from requests import Response, get, post
+
+
+class Api:
+    def __init__(
+        self,
+        base_url: str,
+        username: str = "",
+        password: str = "",
+        logging: bool = False,
+    ) -> None:
+        self.base_url: str = base_url
+        self.auth: tuple[str, str] = (username, password)
+        self.logging: bool = logging
+        self.verify_https: bool = urlparse(self.base_url).hostname != "localhost"
+
+    def log(self, message: str | dict[str, Any]) -> None:
+        if self.logging:
+            if isinstance(message, dict) and "password" in message:
+                message = {**message, "password": "[REDACTED]"}
+
+            info(msg=message)
+
+    def log_response(self, response: Response) -> None:
+        if self.logging and not response.ok:
+            info(msg=response.status_code)
+            info(msg=response.content)
+
+    def get(self, path: str, authorized: bool = True) -> Response:
+        self.log(message=f"GET {self.base_url}/{path}")
+
+        auth = None
+        if authorized:
+            auth = self.auth
+
+        response: Response = get(
+            url=f"{self.base_url}/{path}",
+            headers={
+                "Accept": "application/json",
+            },
+            auth=auth,
+            verify=self.verify_https,
+        )
+
+        self.log_response(response=response)
+        return response
+
+    def post(self, path: str, json: Any) -> Response:
+        # TODO: fix for list in json instead of dict
+        # sanitized_json: dict[str, Any] = {**json}
+        # if "password" in sanitized_json:
+        #    sanitized_json["password"] = "[REDACTED]"
+        # self.log(message=f"POST {self.base_url}/{path} {sanitized_json}")
+
+        response: Response = post(
+            url=f"{self.base_url}/{path}",
+            headers={"Accept": "application/json", "Content-Type": "application/json"},
+            auth=self.auth,
+            json=json,
+            verify=self.verify_https,
+        )
+
+        self.log_response(response=response)
+        return response
+
+    def status(self) -> Response:
+        return self.get(path="status", authorized=False)
+
+    def user_self(self) -> Response:
+        return self.get(path="user/self")
+
+    def user_self_stations(self) -> list[Any]:
+        return self.user_self().json()["data"]["stations"]
+
+    def user_self_first_station(self):
+        return self.user_self_stations()[0]
+
+    def create_user(self, email: str, password: str, role: str, name: str) -> Response:
+        return self.post(
+            path="user",
+            json={
+                "email": email,
+                "password": password,
+                "role": role,
+                "name": name,
+            },
+        )
+
+    def create_station(
+        self,
+        name: str,
+        operation_type: str,
+        wmo_id: int,
+        latitude: float,
+        longitude: float,
+        altitude: float,
+    ) -> Response:
+        return self.post(
+            path="station",
+            json={
+                "name": name,
+                "type": operation_type,
+                "wmo_id": wmo_id,
+                "latitude": latitude,
+                "longitude": longitude,
+                "altitude": altitude,
+            },
+        )
+
+    def create_flight(
+        self,
+        station_id: int,
+        status: str,
+        sonde_serial: str,
+        set_frequency: float,
+        sonde_firmware_version: str,
+    ) -> Response:
+        return self.post(
+            path="flight",
+            json={
+                "station_id": station_id,
+                "status": status,
+                "sonde_serial": sonde_serial,
+                "set_frequency": set_frequency,
+                "sonde_firmware_version": sonde_firmware_version,
+            },
+        )
+
+    def create_measurement(
+        self,
+        flight_id: int,
+        time_after_launch: int,
+        utc_time: str,
+        pressure: float,
+        temperature: float,
+        humidity: float,
+        wind_speed: float,
+        wind_direction: float,
+        latitude: float,
+        longitude: float,
+        altitude: float,
+        vertical_speed: float,
+        geo_potential: float,
+        dew_point: float,
+        elevation: float,
+        azimuth: float,
+        distance: float,
+    ) -> Response:
+        return self.post(
+            path="measurement",
+            json=[
+                {
+                    "flight_id": flight_id,
+                    "time_after_launch": time_after_launch,
+                    "utc_time": utc_time,
+                    "pressure": pressure,
+                    "temperature": temperature,
+                    "humidity": humidity,
+                    "wind_speed": wind_speed,
+                    "wind_direction": wind_direction,
+                    "latitude": latitude,
+                    "longitude": longitude,
+                    "altitude": altitude,
+                    "vertical_speed": vertical_speed,
+                    "geo_potential": geo_potential,
+                    "dew_point": dew_point,
+                    "elevation": elevation,
+                    "azimuth": azimuth,
+                    "distance": distance,
+                },
+            ],
+        )
+
+    def attach_station_to_user(self, user_id: int, station_id: int) -> Response:
+        return self.post(path=f"user/{user_id}/attachStation/{station_id}", json={})

grawgo-2.0.0.dist-info/METADATA

@@ -0,0 +1,25 @@
+Metadata-Version: 2.4
+Name: grawgo
+Version: 2.0.0
+Summary: A python lib to use the grawGo api
+Author-email: Niklas Wildenburg <niklas.wildenburg@graw.de>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/GrawRadiosondes/grawgo-python-api
+Project-URL: Bug Tracker, https://github.com/GrawRadiosondes/grawgo-python-api/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests~=2.34.0
+Dynamic: license-file
+
+# grawGo API
+
+## Release
+
+1. `ruff format`
+2. Bump version in [pyproject.toml](pyproject.toml)
+3. Commit
+4. Apply SemVer tag
+5. Push commit and tag

grawgo-2.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+grawgo/__init__.py,sha256=WqkJBewYxX-SGGMGv3kFESnTzQCCg4XmAIsMLtBiPus,207
+grawgo/api.py,sha256=d9TVnBTli4_eYL7rVwp6tAreMUixVwn595Iwdy8rVbA,5440
+grawgo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+grawgo-2.0.0.dist-info/licenses/LICENSE,sha256=497WkD2tIov9SXAD-r8HV9AfC6o1WimjUay0UPu2w9M,1073
+grawgo-2.0.0.dist-info/METADATA,sha256=_5IBP-DeVOFN3x90OdGlkDnErvt_lj3WwCp5zfMm2HQ,724
+grawgo-2.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+grawgo-2.0.0.dist-info/top_level.txt,sha256=vvf4tXSUGiLQGs5uuvLgx9MVr8owt3aXwBbblRQUkFE,16
+grawgo-2.0.0.dist-info/RECORD,,

grawgo-2.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

grawgo-2.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GRAW Radiosondes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

grawgo-2.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+__init__
+grawgo