fitbit-cli 1.5.2__tar.gz → 1.6.0__tar.gz

{fitbit_cli-1.5.2/fitbit_cli.egg-info → fitbit_cli-1.6.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: fitbit-cli
-Version: 1.5.2
+Version: 1.6.0
 Summary: Access your Fitbit data at your terminal.
 Home-page: https://github.com/veerendra2/fitbit-cli
-Download-URL: https://github.com/veerendra2/fitbit-cli/archive/1.5.2.tar.gz
+Download-URL: https://github.com/veerendra2/fitbit-cli/archive/1.6.0.tar.gz
 Author: veerendra2
 Author-email: vk.tyk23@simplelogin.com
 License: MIT
@@ -11,22 +11,21 @@ Project-URL: Documentation, https://github.com/veerendra2/fitbit-cli
 Keywords: fitbit,fitbit-api,cli,python
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: End Users/Desktop
-Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests==2.32.5
-Requires-Dist: rich==14.3.2
+Requires-Dist: requests==2.33.0
+Requires-Dist: rich==14.3.3
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -49,10 +48,12 @@ Dynamic: summary
 ](https://pypi.org/project/fitbit-cli/) [![ClickPy Stats](https://img.shields.io/badge/ClickPy%20Stats-A5951E)
 ](https://clickpy.clickhouse.com/dashboard/fitbit-cli)
 
-> This is not an official Fitbit CLI
+> _This is not an official Fitbit CLI_
 
 Access your Fitbit data directly from your terminal 💻. View 💤 sleep logs, ❤️ heart rate, 🏋️‍♂️ activity levels, 🩸 SpO2, and more, all presented in a simple, easy-to-read table format!
 
+> **AI agent-friendly** 🤖 — since v1.6.0, use `--json` for minimized, token-efficient JSON output or `--raw-json` for the full Fitbit API response. No spinners, pure JSON.
+
 <p align="center">
   <img alt="Fitbit logo", width="350" src="https://raw.githubusercontent.com/veerendra2/fitbit-cli/refs/heads/main/assets/Fitbit_Logo_White_RGB.jpg">
 </p>
@@ -86,13 +87,16 @@ python -m pip install fitbit-cli
 
 ```bash
 fitbit-cli -h
-usage: fitbit-cli [-h] [-i] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]] [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
+usage: fitbit-cli [-h] [-i] [-j] [-r] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]]
+                  [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
 
 Fitbit CLI -- Access your Fitbit data at your terminal.
 
 options:
   -h, --help            show this help message and exit
   -i, --init-auth       Initialize Fitbit iterative authentication setup
+  -j, --json            Output table data as JSON.
+  -r, --raw-json        Output raw JSON from the Fitbit API.
   -v, --version         Show fitbit-cli version
 
 APIs:

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/README.md

@@ -5,10 +5,12 @@
 ](https://pypi.org/project/fitbit-cli/) [![ClickPy Stats](https://img.shields.io/badge/ClickPy%20Stats-A5951E)
 ](https://clickpy.clickhouse.com/dashboard/fitbit-cli)
 
-> This is not an official Fitbit CLI
+> _This is not an official Fitbit CLI_
 
 Access your Fitbit data directly from your terminal 💻. View 💤 sleep logs, ❤️ heart rate, 🏋️‍♂️ activity levels, 🩸 SpO2, and more, all presented in a simple, easy-to-read table format!
 
+> **AI agent-friendly** 🤖 — since v1.6.0, use `--json` for minimized, token-efficient JSON output or `--raw-json` for the full Fitbit API response. No spinners, pure JSON.
+
 <p align="center">
   <img alt="Fitbit logo", width="350" src="https://raw.githubusercontent.com/veerendra2/fitbit-cli/refs/heads/main/assets/Fitbit_Logo_White_RGB.jpg">
 </p>
@@ -42,13 +44,16 @@ python -m pip install fitbit-cli
 
 ```bash
 fitbit-cli -h
-usage: fitbit-cli [-h] [-i] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]] [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
+usage: fitbit-cli [-h] [-i] [-j] [-r] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]]
+                  [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
 
 Fitbit CLI -- Access your Fitbit data at your terminal.
 
 options:
   -h, --help            show this help message and exit
   -i, --init-auth       Initialize Fitbit iterative authentication setup
+  -j, --json            Output table data as JSON.
+  -r, --raw-json        Output raw JSON from the Fitbit API.
   -v, --version         Show fitbit-cli version
 
 APIs:

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/fitbit_cli/__init__.py

@@ -3,4 +3,4 @@
 fitbit_cli Module
 """
 
-__version__ = "1.5.2"
+__version__ = "1.6.0"

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/fitbit_cli/cli.py

@@ -72,6 +72,20 @@ def parse_arguments():
         help="Initialize Fitbit iterative authentication setup",
     )
 
+    parser.add_argument(
+        "-j",
+        "--json",
+        action="store_true",
+        help="Output table data as JSON.",
+    )
+
+    parser.add_argument(
+        "-r",
+        "--raw-json",
+        action="store_true",
+        help="Output raw JSON from the Fitbit API.",
+    )
+
     group = parser.add_argument_group(
         "APIs",
         "Specify a date, date range (YYYY-MM-DD[,YYYY-MM-DD]), or relative date.\n"
@@ -155,7 +169,13 @@ def parse_arguments():
 
     args = parser.parse_args()
 
-    if not any(vars(args).values()):
+    data_args = {
+        k: v
+        for k, v in vars(args).items()
+        if k not in ("json", "raw_json", "init_auth", "version")
+    }
+
+    if not args.init_auth and not any(data_args.values()):
         parser.error("No arguments provided. At least one argument is required.")
 
     return args

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/fitbit_cli/formatter.py

@@ -2,6 +2,7 @@
 """
 Json Data Formatter
 """
+
 from rich.console import Console
 from rich.table import Table
 from rich.text import Text
@@ -9,7 +10,7 @@ from rich.text import Text
 CONSOLE = Console()
 
 
-def display_user_profile(user_data):
+def display_user_profile(user_data, as_json=False):
     """User data formatter"""
 
     user = user_data["user"]
@@ -20,6 +21,22 @@ def display_user_profile(user_data):
     elif user["weightUnit"] == "US":
         weight_unit = "pounds"
 
+    if as_json:
+        return {
+            "user_profile": {
+                "first_name": user["firstName"],
+                "last_name": user["lastName"],
+                "date_of_birth": user["dateOfBirth"],
+                "age": user["age"],
+                "gender": user["gender"],
+                "height": f"{user['height']:.1f} {height_unit}",
+                "weight": f"{user['weight']:.1f} {weight_unit}",
+                "average_daily_steps": user["averageDailySteps"],
+                "member_since": user["memberSince"],
+                "timezone": user["timezone"],
+            }
+        }
+
     table = Table(title=f"Hello, {user['displayName']} :wave:", show_header=False)
 
     table.add_column("")
@@ -37,11 +54,34 @@ def display_user_profile(user_data):
     table.add_row(":clock1: Time Zone", user["timezone"])
 
     CONSOLE.print(table)
+    return None
 
 
-def display_sleep(sleep_data):
+def display_sleep(sleep_data, as_json=False):
     """Sleep data formatter"""
 
+    if as_json:
+        return {
+            "sleep": [
+                {
+                    "date": s["dateOfSleep"],
+                    "deep_minutes": s["levels"]["summary"]
+                    .get("deep", {})
+                    .get("minutes"),
+                    "light_minutes": s["levels"]["summary"]
+                    .get("light", {})
+                    .get("minutes"),
+                    "rem_minutes": s["levels"]["summary"].get("rem", {}).get("minutes"),
+                    "wake_minutes": s["levels"]["summary"]
+                    .get("wake", {})
+                    .get("minutes"),
+                    "efficiency": s["efficiency"],
+                    "time_in_bed_hours": round(s["timeInBed"] / 60, 1),
+                }
+                for s in sleep_data["sleep"]
+            ]
+        }
+
     table = Table(title="Sleep Data Summary :sleeping:", show_header=True)
 
     table.add_column("Date :calendar:")
@@ -64,11 +104,28 @@ def display_sleep(sleep_data):
         )
 
     CONSOLE.print(table)
+    return None
 
 
-def display_spo2(spo2_data):
+def display_spo2(spo2_data, as_json=False):
     """SpO2 data formatter"""
 
+    if isinstance(spo2_data, dict):
+        spo2_data = [spo2_data]
+
+    if as_json:
+        return {
+            "spo2": [
+                {
+                    "date": s.get("dateTime"),
+                    "min": s.get("value", {}).get("min"),
+                    "avg": s.get("value", {}).get("avg"),
+                    "max": s.get("value", {}).get("max"),
+                }
+                for s in spo2_data
+            ]
+        }
+
     table = Table(title="SpO2 Data Summary :heart:", show_header=True)
 
     table.add_column("Date :calendar:")
@@ -76,9 +133,6 @@ def display_spo2(spo2_data):
     table.add_column("Average :blue_circle:")
     table.add_column("Maximum :green_circle:")
 
-    if isinstance(spo2_data, dict):
-        spo2_data = [spo2_data]
-
     for spo2 in spo2_data:
         table.add_row(
             spo2.get("dateTime", "N/A"),
@@ -88,11 +142,37 @@ def display_spo2(spo2_data):
         )
 
     CONSOLE.print(table)
+    return None
 
 
-def display_heart_data(heart_data):
+def display_heart_data(heart_data, as_json=False):
     """Heart data formatter"""
 
+    if as_json:
+        return {
+            "heart": [
+                {
+                    "date": a.get("dateTime"),
+                    "resting_heart_rate": a.get("value", {}).get("restingHeartRate"),
+                    "zones": [
+                        {
+                            "name": z.get("name"),
+                            "min": z.get("min"),
+                            "max": z.get("max"),
+                            "minutes": z.get("minutes"),
+                            "calories_out": (
+                                round(z["caloriesOut"], 2)
+                                if isinstance(z.get("caloriesOut"), (int, float))
+                                else None
+                            ),
+                        }
+                        for z in a.get("value", {}).get("heartRateZones", [])
+                    ],
+                }
+                for a in heart_data.get("activities-heart", [])
+            ]
+        }
+
     table = Table(title="Heart Rate Time Series :heart:", show_header=True)
 
     table.add_column("Date :calendar:")
@@ -123,15 +203,30 @@ def display_heart_data(heart_data):
                     else "N/A"
                 ),
             )
-
         table.add_row(date, str(resting_heart_rate), zones_table)
-
     CONSOLE.print(table)
+    return None
 
 
-def display_azm_time_series(azm_data):
+def display_azm_time_series(azm_data, as_json=False):
     """AZM Time Series data formatter"""
 
+    if as_json:
+        return {
+            "active_zone": [
+                {
+                    "date": a.get("dateTime"),
+                    "active_zone_minutes": a.get("value", {}).get("activeZoneMinutes"),
+                    "fat_burn_minutes": a.get("value", {}).get(
+                        "fatBurnActiveZoneMinutes"
+                    ),
+                    "cardio_minutes": a.get("value", {}).get("cardioActiveZoneMinutes"),
+                    "peak_minutes": a.get("value", {}).get("peakActiveZoneMinutes"),
+                }
+                for a in azm_data.get("activities-active-zone-minutes", [])
+            ]
+        }
+
     table = Table(title="AZM Time Series :runner:", show_header=True)
 
     table.add_column("Date :calendar:")
@@ -152,11 +247,23 @@ def display_azm_time_series(azm_data):
         )
 
     CONSOLE.print(table)
+    return None
 
 
-def display_breathing_rate(breathing_rate_data):
+def display_breathing_rate(breathing_rate_data, as_json=False):
     """Breathing Rate data formatter"""
 
+    if as_json:
+        return {
+            "breathing_rate": [
+                {
+                    "date": br.get("dateTime"),
+                    "breathing_rate": br.get("value", {}).get("breathingRate"),
+                }
+                for br in breathing_rate_data.get("br", [])
+            ]
+        }
+
     table = Table(title="Breathing Rate Summary 🫁", show_header=True)
 
     table.add_column("Date :calendar:")
@@ -169,9 +276,10 @@ def display_breathing_rate(breathing_rate_data):
         )
 
     CONSOLE.print(table)
+    return None
 
 
-def display_devices(devices):
+def display_devices(devices, as_json=False):
     """Devices list formatter"""
 
     def format_mac(mac):
@@ -179,6 +287,20 @@ def display_devices(devices):
             return mac
         return ":".join(mac[i : i + 2] for i in range(0, len(mac), 2))
 
+    if as_json:
+        return {
+            "devices": [
+                {
+                    "battery_level": device.get("batteryLevel"),
+                    "device": device.get("deviceVersion"),
+                    "type": device.get("type"),
+                    "last_sync_time": device.get("lastSyncTime"),
+                    "mac_address": format_mac(str(device.get("mac", "N/A"))),
+                }
+                for device in devices
+            ]
+        }
+
     table = Table(title="Devices List :link:", show_header=True)
 
     table.add_column("Battery % :battery:")
@@ -190,7 +312,7 @@ def display_devices(devices):
     for device in devices:
         mac_address = format_mac(str(device.get("mac", "N/A")))
         table.add_row(
-            f"{str(device.get("batteryLevel", "N/A"))}%",
+            f"{str(device.get('batteryLevel', 'N/A'))}%",
             str(device.get("deviceVersion", "N/A")),
             str(device.get("type", "N/A")),
             str(device.get("lastSyncTime", "N/A")),
@@ -198,14 +320,39 @@ def display_devices(devices):
         )
 
     CONSOLE.print(table)
+    return None
 
 
-def display_activity(activity_data, unit_system):
+def display_activity(activity_data, unit_system, as_json=False):
     """Activity data formatter"""
 
-    dis_unit = "km"
-    if unit_system == "US":
-        dis_unit = "miles"
+    dis_unit = "km" if unit_system != "US" else "miles"
+
+    if as_json:
+        return {
+            "activities": [
+                {
+                    "date": day.get("date"),
+                    "activities": [
+                        {
+                            "start_time": a.get("startTime"),
+                            "name": a.get("name"),
+                            "description": a.get("description"),
+                            "distance": (
+                                f"{a.get('distance', 'N/A')} {dis_unit}"
+                                if a.get("distance") is not None
+                                else None
+                            ),
+                            "steps": a.get("steps"),
+                            "calories": a.get("calories"),
+                            "duration_minutes": round(a.get("duration", 0) / 60000, 1),
+                        }
+                        for a in day.get("activities", [])
+                    ],
+                }
+                for day in activity_data
+            ]
+        }
 
     table = Table(title="Daily Activities :runner:", show_header=True)
 
@@ -236,3 +383,4 @@ def display_activity(activity_data, unit_system):
         table.add_row(activity_day.get("date", ""), activity_table)
 
     CONSOLE.print(table)
+    return None

fitbit_cli-1.6.0/fitbit_cli/main.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+"""
+Main Module
+"""
+
+from . import fitbit_setup as setup
+from . import output
+from .cli import parse_arguments
+from .fitbit_api import FitbitAPI
+
+
+def main():
+    """Main function"""
+
+    args = parse_arguments()
+
+    if args.init_auth:
+        setup.fitbit_init_setup()
+        return
+
+    credentials = setup.read_fitbit_token()
+
+    fitbit = FitbitAPI(
+        client_id=credentials["client_id"],
+        client_secret=credentials["secret"],
+        access_token=credentials["access_token"],
+        refresh_token=credentials["refresh_token"],
+    )
+
+    if args.raw_json:
+        output.raw_json_display(fitbit, args)
+    elif args.json:
+        output.json_display(fitbit, args)
+    else:
+        output.table_display(fitbit, args)

fitbit_cli-1.6.0/fitbit_cli/output.py

@@ -0,0 +1,137 @@
+# -*- coding: utf-8 -*-
+"""
+Output modes for the Fitbit CLI
+"""
+
+import json
+from datetime import date, datetime, timedelta
+
+from . import formatter as fmt
+
+
+def collect_activities(fitbit, args):
+    """Fetch activity data for a date or date range."""
+    start_date, end_date = args.activities
+    if end_date is None:
+        data = fitbit.get_daily_activity_summary(str(start_date))
+        return [{**data, "date": str(start_date)}]
+    start = (
+        start_date
+        if isinstance(start_date, date)
+        else datetime.strptime(start_date, "%Y-%m-%d").date()
+    )
+    end = (
+        end_date
+        if isinstance(end_date, date)
+        else datetime.strptime(end_date, "%Y-%m-%d").date()
+    )
+    return [
+        {
+            **fitbit.get_daily_activity_summary(
+                (start + timedelta(days=i)).strftime("%Y-%m-%d")
+            ),
+            "date": (start + timedelta(days=i)).strftime("%Y-%m-%d"),
+        }
+        for i in range((end - start).days + 1)
+    ]
+
+
+def json_display(fitbit, args):
+    """Fetch data and render each requested endpoint as a single JSON object to stdout."""
+    result = {}
+    profile = None
+
+    if args.user_profile:
+        profile = fitbit.get_user_profile()
+        result.update(fmt.display_user_profile(profile, as_json=True))
+    if args.devices:
+        result.update(fmt.display_devices(fitbit.get_devices(), as_json=True))
+    if args.sleep:
+        result.update(
+            fmt.display_sleep(fitbit.get_sleep_log(*args.sleep), as_json=True)
+        )
+    if args.spo2:
+        result.update(
+            fmt.display_spo2(fitbit.get_spo2_summary(*args.spo2), as_json=True)
+        )
+    if args.heart:
+        result.update(
+            fmt.display_heart_data(
+                fitbit.get_heart_rate_time_series(*args.heart), as_json=True
+            )
+        )
+    if args.active_zone:
+        result.update(
+            fmt.display_azm_time_series(
+                fitbit.get_azm_time_series(*args.active_zone), as_json=True
+            )
+        )
+    if args.breathing_rate:
+        result.update(
+            fmt.display_breathing_rate(
+                fitbit.get_breathing_rate_summary(*args.breathing_rate), as_json=True
+            )
+        )
+    if args.activities:
+        activity_data = collect_activities(fitbit, args)
+        if profile is None:
+            profile = fitbit.get_user_profile()
+        unit_system = profile.get("user", {}).get("distanceUnit", "METRIC")
+        result.update(fmt.display_activity(activity_data, unit_system, as_json=True))
+
+    print(json.dumps(result, separators=(",", ":")))
+
+
+def raw_json_display(fitbit, args):
+    """Collect raw API responses and print compact JSON to stdout."""
+    result = {}
+
+    if args.user_profile:
+        result["user_profile"] = fitbit.get_user_profile()
+    if args.devices:
+        result["devices"] = fitbit.get_devices()
+    if args.sleep:
+        result["sleep"] = fitbit.get_sleep_log(*args.sleep)
+    if args.spo2:
+        result["spo2"] = fitbit.get_spo2_summary(*args.spo2)
+    if args.heart:
+        result["heart"] = fitbit.get_heart_rate_time_series(*args.heart)
+    if args.active_zone:
+        result["active_zone"] = fitbit.get_azm_time_series(*args.active_zone)
+    if args.breathing_rate:
+        result["breathing_rate"] = fitbit.get_breathing_rate_summary(
+            *args.breathing_rate
+        )
+    if args.activities:
+        result["activities"] = collect_activities(fitbit, args)
+
+    print(json.dumps(result, separators=(",", ":")))
+
+
+def table_display(fitbit, args):
+    """Fetch data and render rich tables to the terminal."""
+    with fmt.CONSOLE.status("[bold green]Fetching data...") as _:
+        profile = None
+        if args.user_profile:
+            profile = fitbit.get_user_profile()
+            fmt.display_user_profile(profile)
+        if args.devices:
+            fmt.display_devices(fitbit.get_devices())
+        if args.sleep:
+            fmt.display_sleep(fitbit.get_sleep_log(*args.sleep))
+        if args.spo2:
+            fmt.display_spo2(fitbit.get_spo2_summary(*args.spo2))
+        if args.heart:
+            fmt.display_heart_data(fitbit.get_heart_rate_time_series(*args.heart))
+        if args.active_zone:
+            fmt.display_azm_time_series(fitbit.get_azm_time_series(*args.active_zone))
+        if args.breathing_rate:
+            fmt.display_breathing_rate(
+                fitbit.get_breathing_rate_summary(*args.breathing_rate)
+            )
+        if args.activities:
+            activity_data = collect_activities(fitbit, args)
+            if profile is None:
+                profile = fitbit.get_user_profile()
+            unit_system = profile.get("user", {}).get("distanceUnit", "METRIC")
+            fmt.display_activity(activity_data, unit_system)

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0/fitbit_cli.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: fitbit-cli
-Version: 1.5.2
+Version: 1.6.0
 Summary: Access your Fitbit data at your terminal.
 Home-page: https://github.com/veerendra2/fitbit-cli
-Download-URL: https://github.com/veerendra2/fitbit-cli/archive/1.5.2.tar.gz
+Download-URL: https://github.com/veerendra2/fitbit-cli/archive/1.6.0.tar.gz
 Author: veerendra2
 Author-email: vk.tyk23@simplelogin.com
 License: MIT
@@ -11,22 +11,21 @@ Project-URL: Documentation, https://github.com/veerendra2/fitbit-cli
 Keywords: fitbit,fitbit-api,cli,python
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: End Users/Desktop
-Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests==2.32.5
-Requires-Dist: rich==14.3.2
+Requires-Dist: requests==2.33.0
+Requires-Dist: rich==14.3.3
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -49,10 +48,12 @@ Dynamic: summary
 ](https://pypi.org/project/fitbit-cli/) [![ClickPy Stats](https://img.shields.io/badge/ClickPy%20Stats-A5951E)
 ](https://clickpy.clickhouse.com/dashboard/fitbit-cli)
 
-> This is not an official Fitbit CLI
+> _This is not an official Fitbit CLI_
 
 Access your Fitbit data directly from your terminal 💻. View 💤 sleep logs, ❤️ heart rate, 🏋️‍♂️ activity levels, 🩸 SpO2, and more, all presented in a simple, easy-to-read table format!
 
+> **AI agent-friendly** 🤖 — since v1.6.0, use `--json` for minimized, token-efficient JSON output or `--raw-json` for the full Fitbit API response. No spinners, pure JSON.
+
 <p align="center">
   <img alt="Fitbit logo", width="350" src="https://raw.githubusercontent.com/veerendra2/fitbit-cli/refs/heads/main/assets/Fitbit_Logo_White_RGB.jpg">
 </p>
@@ -86,13 +87,16 @@ python -m pip install fitbit-cli
 
 ```bash
 fitbit-cli -h
-usage: fitbit-cli [-h] [-i] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]] [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
+usage: fitbit-cli [-h] [-i] [-j] [-r] [-s [DATE[,DATE]|RELATIVE]] [-o [DATE[,DATE]|RELATIVE]] [-e [DATE[,DATE]|RELATIVE]] [-a [DATE[,DATE]|RELATIVE]]
+                  [-b [DATE[,DATE]|RELATIVE]] [-t [DATE[,DATE]|RELATIVE]] [-u] [-d] [-v]
 
 Fitbit CLI -- Access your Fitbit data at your terminal.
 
 options:
   -h, --help            show this help message and exit
   -i, --init-auth       Initialize Fitbit iterative authentication setup
+  -j, --json            Output table data as JSON.
+  -r, --raw-json        Output raw JSON from the Fitbit API.
   -v, --version         Show fitbit-cli version
 
 APIs:

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/fitbit_cli.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ fitbit_cli/fitbit_api.py
 fitbit_cli/fitbit_setup.py
 fitbit_cli/formatter.py
 fitbit_cli/main.py
+fitbit_cli/output.py
 fitbit_cli.egg-info/PKG-INFO
 fitbit_cli.egg-info/SOURCES.txt
 fitbit_cli.egg-info/dependency_links.txt

fitbit_cli-1.6.0/fitbit_cli.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests==2.33.0
+rich==14.3.3

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/setup.py

@@ -34,22 +34,21 @@ setup(
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: End Users/Desktop",
-        "License :: OSI Approved :: Apache Software License",
+        "License :: OSI Approved :: MIT License",
         "Natural Language :: English",
         "Operating System :: MacOS",
         "Operating System :: POSIX :: Linux",
         "Programming Language :: Python :: 3 :: Only",
         "Programming Language :: Python :: 3.12",
         "Programming Language :: Python :: 3.13",
-        "Programming Language :: Python :: 3.9",
-        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.14",
         "Programming Language :: Python",
         "Topic :: Utilities",
     ],
     install_requires=[
-        "requests==2.32.5",
-        "rich==14.3.2",
+        "requests==2.33.0",
+        "rich==14.3.3",
     ],
-    python_requires=">=3.9",
+    python_requires=">=3.12",
     entry_points={"console_scripts": ["fitbit-cli = fitbit_cli.main:main"]},
 )

{fitbit_cli-1.5.2 → fitbit_cli-1.6.0}/tests/cli_test.py

@@ -13,7 +13,12 @@ from unittest.mock import patch
 sys.path.insert(0, os.path.abspath(os.path.dirname(os.path.dirname(__file__))))
 
 # pylint: disable=C0413
-from fitbit_cli.cli import _get_date_range, _parse_relative_dates, parse_date_range
+from fitbit_cli.cli import (
+    _get_date_range,
+    _parse_relative_dates,
+    parse_arguments,
+    parse_date_range,
+)
 
 
 class TestCLIDateFunctions(unittest.TestCase):
@@ -148,6 +153,38 @@ class TestCLIDateFunctions(unittest.TestCase):
         with self.assertRaises(ValueError):
             parse_date_range("invalid-date-format")
 
+    @patch("sys.argv", ["fitbit-cli", "--json"])
+    def test_json_flag_alone_raises_error(self):
+        """Test that --json alone (without a data flag) triggers the no-arguments error."""
+        with self.assertRaises(SystemExit):
+            parse_arguments()
+
+    @patch("sys.argv", ["fitbit-cli", "--raw-json"])
+    def test_raw_json_flag_alone_raises_error(self):
+        """Test that --raw-json alone (without a data flag) triggers the no-arguments error."""
+        with self.assertRaises(SystemExit):
+            parse_arguments()
+
+    @patch("sys.argv", ["fitbit-cli", "--json", "--user-profile"])
+    def test_json_with_data_flag_parses_successfully(self):
+        """Test that --json combined with a data flag parses without error."""
+        args = parse_arguments()
+        self.assertTrue(args.json)
+        self.assertTrue(args.user_profile)
+
+    @patch("sys.argv", ["fitbit-cli", "--raw-json", "--devices"])
+    def test_raw_json_with_data_flag_parses_successfully(self):
+        """Test that --raw-json combined with a data flag parses without error."""
+        args = parse_arguments()
+        self.assertTrue(args.raw_json)
+        self.assertTrue(args.devices)
+
+    @patch("sys.argv", ["fitbit-cli", "--init-auth"])
+    def test_init_auth_alone_parses_successfully(self):
+        """Test that --init-auth alone does not trigger the no-arguments error."""
+        args = parse_arguments()
+        self.assertTrue(args.init_auth)
+
 
 if __name__ == "__main__":
     unittest.main()

fitbit_cli-1.5.2/fitbit_cli/main.py

@@ -1,76 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Main Module
-"""
-
-from datetime import datetime, timedelta
-
-from . import fitbit_setup as setup
-from . import formatter as fmt
-from .cli import parse_arguments
-from .fitbit_api import FitbitAPI
-
-
-def main():
-    """Main function"""
-
-    args = parse_arguments()
-
-    if args.init_auth:
-        setup.fitbit_init_setup()
-
-    credentials = setup.read_fitbit_token()
-
-    fitbit = FitbitAPI(
-        client_id=credentials["client_id"],
-        client_secret=credentials["secret"],
-        access_token=credentials["access_token"],
-        refresh_token=credentials["refresh_token"],
-    )
-
-    with fmt.CONSOLE.status("[bold green]Fetching data...") as _:
-        if args.user_profile:
-            fmt.display_user_profile(fitbit.get_user_profile())
-        if args.devices:
-            fmt.display_devices(fitbit.get_devices())
-        if args.sleep:
-            fmt.display_sleep(fitbit.get_sleep_log(*args.sleep))
-        if args.spo2:
-            fmt.display_spo2(fitbit.get_spo2_summary(*args.spo2))
-        if args.heart:
-            fmt.display_heart_data(fitbit.get_heart_rate_time_series(*args.heart))
-        if args.active_zone:
-            fmt.display_azm_time_series(fitbit.get_azm_time_series(*args.active_zone))
-        if args.breathing_rate:
-            fmt.display_breathing_rate(
-                fitbit.get_breathing_rate_summary(*args.breathing_rate)
-            )
-        if args.activities:
-            start_date, end_date = args.activities
-            activity_data = []
-
-            # Get unit system from profile
-            unit_system = (
-                fitbit.get_user_profile().get("user", "").get("distanceUnit", "METRIC")
-            )
-
-            # 'Get Daily Activity Summary' API only accepts single date
-            # So we either fetch one date or iterate through a range
-            if end_date is None:
-                data = fitbit.get_daily_activity_summary(start_date)
-                data["date"] = str(start_date)
-                activity_data = [data]
-            else:
-                start = datetime.strptime(start_date, "%Y-%m-%d")
-                end = datetime.strptime(end_date, "%Y-%m-%d")
-                activity_data = [
-                    {
-                        **fitbit.get_daily_activity_summary(
-                            (start + timedelta(days=i)).strftime("%Y-%m-%d")
-                        ),
-                        "date": (start + timedelta(days=i)).strftime("%Y-%m-%d"),
-                    }
-                    for i in range((end - start).days + 1)
-                ]
-
-            fmt.display_activity(activity_data, unit_system)

fitbit_cli-1.5.2/fitbit_cli.egg-info/requires.txt

@@ -1,2 +0,0 @@
-requests==2.32.5
-rich==14.3.2