tcx2ics 0.1.0__tar.gz

tcx2ics-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Iztok Fister Jr.
+
+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.

tcx2ics-0.1.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.3
+Name: tcx2ics
+Version: 0.1.0
+Summary: Generate ICS calendar events from TCX workout files
+Author: Iztok Fister Jr.
+Author-email: iztok@iztok.dev
+Requires-Python: <4.0,>=3.12
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: tcxreader (>=0.4.11,<0.5.0)
+Description-Content-Type: text/markdown
+
+# tcx2ics
+
+Convert a `.tcx` activity file (from Garmin, Strava, etC.) into a single `.ics`
+calendar event with basic workout Statistics.
+
+The calendar event contains:
+- start and end time of the activity
+- sport type
+- total duration
+- total distance
+
+
+## 📦 Installation
+
+### pip
+
+Install tcx2ics with pip:
+
+```sh
+pip install tcx2ics
+```
+
+## 🚀 Examples
+
+### Basic example
+
+```python
+from tcx2ics import Tcx2Ics
+Tcx2Ics().convert("15.tcx", "workout.ics")
+```
+
+## 🔑 License
+
+This package is distributed under the MIT License. This license can be found online at <http://www.opensource.org/licenses/MIT>.
+
+## Disclaimer
+
+This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!
+
+## 🔗 Related frameworks
+
+[1] [AST-Monitor: A wearable Raspberry Pi computer for cyclists](https://github.com/firefly-cpp/AST-Monitor)
+
+[2] [TCXReader.jl: Julia package designed for parsing TCX files](https://github.com/firefly-cpp/TCXReader.jl)
+
+[3] [TCXWriter: A Tiny Library for writing/creating TCX files on Arduino](https://github.com/firefly-cpp/tcxwriter)
+

tcx2ics-0.1.0/README.md

@@ -0,0 +1,46 @@
+# tcx2ics
+
+Convert a `.tcx` activity file (from Garmin, Strava, etC.) into a single `.ics`
+calendar event with basic workout Statistics.
+
+The calendar event contains:
+- start and end time of the activity
+- sport type
+- total duration
+- total distance
+
+
+## 📦 Installation
+
+### pip
+
+Install tcx2ics with pip:
+
+```sh
+pip install tcx2ics
+```
+
+## 🚀 Examples
+
+### Basic example
+
+```python
+from tcx2ics import Tcx2Ics
+Tcx2Ics().convert("15.tcx", "workout.ics")
+```
+
+## 🔑 License
+
+This package is distributed under the MIT License. This license can be found online at <http://www.opensource.org/licenses/MIT>.
+
+## Disclaimer
+
+This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk!
+
+## 🔗 Related frameworks
+
+[1] [AST-Monitor: A wearable Raspberry Pi computer for cyclists](https://github.com/firefly-cpp/AST-Monitor)
+
+[2] [TCXReader.jl: Julia package designed for parsing TCX files](https://github.com/firefly-cpp/TCXReader.jl)
+
+[3] [TCXWriter: A Tiny Library for writing/creating TCX files on Arduino](https://github.com/firefly-cpp/tcxwriter)

tcx2ics-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "tcx2ics"
+version = "0.1.0"
+description = "Generate ICS calendar events from TCX workout files"
+authors = [
+    {name = "Iztok Fister Jr.",email = "iztok@iztok.dev"}
+]
+readme = "README.md"
+requires-python = "<4.0,>=3.12"
+dependencies = [
+    "tcxreader (>=0.4.11,<0.5.0)"
+]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

tcx2ics-0.1.0/tcx2ics/__init__.py

@@ -0,0 +1,3 @@
+from .tcx2ics import Tcx2Ics
+
+__all__ = ["Tcx2Ics"]

tcx2ics-0.1.0/tcx2ics/tcx2ics.py

@@ -0,0 +1,54 @@
+from datetime import datetime, timedelta, timezone
+from pathlib import Path
+from tcxreader.tcxreader import TCXReader
+
+
+class Tcx2Ics:
+    def __init__(self):
+        self.reader = TCXReader()
+
+    def convert(self, tcx_file: str, ics_file: str):
+        ex = self.reader.read(tcx_file)
+
+        sport = getattr(ex, "activity_type", None) or getattr(ex, "sport", None) or "Workout"
+        start = getattr(ex, "start_time", None)
+        duration = float(getattr(ex, "duration", 0) or 0)   # seconds
+        distance = float(getattr(ex, "distance", 0) or 0)   # meters
+
+        if not isinstance(start, datetime):
+            raise ValueError("No start_time found in TCX")
+
+        if start.tzinfo is None:
+            start = start.replace(tzinfo=timezone.utc)
+        else:
+            start = start.astimezone(timezone.utc)
+
+        end = start + timedelta(seconds=duration)
+
+        dist_km = distance / 1000.0
+        dur_h = int(duration) // 3600
+        dur_m = (int(duration) % 3600) // 60
+        dur_s = int(duration) % 60
+
+        summary = f"{sport} - {dist_km:.2f} km"
+        desc = f"Sport: {sport}\\nTotal duration: {dur_h}:{dur_m:02d}:{dur_s:02d}\\nDistance: {dist_km:.2f} km"
+
+        uid = f"{Path(tcx_file).stem}-{start.strftime('%Y%m%dT%H%M%SZ')}@tcx2ics"
+        now = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
+
+        ics = (
+            "BEGIN:VCALENDAR\r\n"
+            "VERSION:2.0\r\n"
+            "PRODID:-//tcx2ics//EN\r\n"
+            "BEGIN:VEVENT\r\n"
+            f"UID:{uid}\r\n"
+            f"DTSTAMP:{now}\r\n"
+            f"DTSTART:{start.strftime('%Y%m%dT%H%M%SZ')}\r\n"
+            f"DTEND:{end.strftime('%Y%m%dT%H%M%SZ')}\r\n"
+            f"SUMMARY:{summary}\r\n"
+            f"DESCRIPTION:{desc}\r\n"
+            "END:VEVENT\r\n"
+            "END:VCALENDAR\r\n"
+        )
+
+        Path(ics_file).write_text(ics, encoding="utf-8")