fitbit-cli 0.1.0__tar.gz

fitbit_cli-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+recursive-include tests *.py *.txt *.yml

fitbit_cli-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: fitbit-cli
+Version: 0.1.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/0.1.0.tar.gz
+Author: veerendra2
+Author-email: vk.tyk23@simplelogin.com
+License: MIT
+Project-URL: Documentation, https://github.com/veerendra2/fitbit-cli
+Keywords: fitbit,cli,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.32.3
+Requires-Dist: rich==13.9.4
+
+# 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!
+
+<p align="center">
+  <img alt="Fitbit logo", width="250" src="./assets/Fitbit_Logo_White_RGB.jpg">
+</p>
+
+## Supported Web APIs
+
+> Only `GET` APIs are supported!
+
+| API                                                                                                                     | Status |
+| ----------------------------------------------------------------------------------------------------------------------- | ------ |
+| [User](https://dev.fitbit.com/build/reference/web-api/user/)                                                            | ✅     |
+| [Sleep](https://dev.fitbit.com/build/reference/web-api/sleep/)                                                          | ✅     |
+| [SpO2](https://dev.fitbit.com/build/reference/web-api/spo2/)                                                            | ✅     |
+| [Heart Rate Time Series](https://dev.fitbit.com/build/reference/web-api/heartrate-timeseries/)                          | ✅     |
+| [Active Zone Minutes (AZM) Time Series](https://dev.fitbit.com/build/reference/web-api/active-zone-minutes-timeseries/) | ✅     |
+| [Activity](https://dev.fitbit.com/build/reference/web-api/activity/)                                                    | 👷     |
+
+## Install
+
+```bash
+python -m pip install fitbit-cli
+
+fitbit-cli -h
+usage: fitbit-cli [-h] [-d | -i] [-s [DATE[,DATE]]] [-o [DATE[,DATE]]] [-e [DATE[,DATE]]] [-a [DATE[,DATE]]] [-u] [-v]
+
+Fitbit CLI -- Access your Fitbit data at your terminal.
+
+options:
+  -h, --help            show this help message and exit
+  -d, --json-dump       Dump all your Fitbit data in json files.
+  -i, --init            Run interative setup to fetch token.
+  -v, --version         Show fitbit-cli version
+
+APIs:
+  Specify date ranges (ISO 8601 format: YYYY-MM-DD) for the following arguments.
+  You can provide a single date or a range (start,end). If not provided, defaults to today's date.
+
+  -s, --sleep [DATE[,DATE]]
+                        Sleep data
+  -o, --spo2 [DATE[,DATE]]
+                        SpO2 data
+  -e, --heart [DATE[,DATE]]
+                        Heart Rate Time Series
+  -a, --active-zone [DATE[,DATE]]
+                        Active Zone Minutes (AZM) Time Series
+  -u, --show-user-profile
+                        Show user profile data
+```
+
+## Register Fitbit App
+
+1. Go to [https://dev.fitbit.com/apps](https://dev.fitbit.com/apps)
+2. Click on "REGISTER AN APP" tab
+3. Follow below example and register an app
+
+<p align="left">
+  <img alt="Fitbit logo", width="700" src="./assets/fitbit-app-registration.png">
+</p>
+
+## Local Development
+
+- [Fitbit Docs](https://dev.fitbit.com/build/reference/web-api/)
+- [OAuth Tutorial](https://dev.fitbit.com/build/reference/web-api/troubleshooting-guide/oauth2-tutorial/)
+
+```bash
+git clone git@github.com:veerendra2/fitbit-cli.git
+cd fitbit-cli
+
+python -m venv venv
+source venv/bin/activate
+python -m pip install -e .
+```

fitbit_cli-0.1.0/README.md

@@ -0,0 +1,78 @@
+# 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!
+
+<p align="center">
+  <img alt="Fitbit logo", width="250" src="./assets/Fitbit_Logo_White_RGB.jpg">
+</p>
+
+## Supported Web APIs
+
+> Only `GET` APIs are supported!
+
+| API                                                                                                                     | Status |
+| ----------------------------------------------------------------------------------------------------------------------- | ------ |
+| [User](https://dev.fitbit.com/build/reference/web-api/user/)                                                            | ✅     |
+| [Sleep](https://dev.fitbit.com/build/reference/web-api/sleep/)                                                          | ✅     |
+| [SpO2](https://dev.fitbit.com/build/reference/web-api/spo2/)                                                            | ✅     |
+| [Heart Rate Time Series](https://dev.fitbit.com/build/reference/web-api/heartrate-timeseries/)                          | ✅     |
+| [Active Zone Minutes (AZM) Time Series](https://dev.fitbit.com/build/reference/web-api/active-zone-minutes-timeseries/) | ✅     |
+| [Activity](https://dev.fitbit.com/build/reference/web-api/activity/)                                                    | 👷     |
+
+## Install
+
+```bash
+python -m pip install fitbit-cli
+
+fitbit-cli -h
+usage: fitbit-cli [-h] [-d | -i] [-s [DATE[,DATE]]] [-o [DATE[,DATE]]] [-e [DATE[,DATE]]] [-a [DATE[,DATE]]] [-u] [-v]
+
+Fitbit CLI -- Access your Fitbit data at your terminal.
+
+options:
+  -h, --help            show this help message and exit
+  -d, --json-dump       Dump all your Fitbit data in json files.
+  -i, --init            Run interative setup to fetch token.
+  -v, --version         Show fitbit-cli version
+
+APIs:
+  Specify date ranges (ISO 8601 format: YYYY-MM-DD) for the following arguments.
+  You can provide a single date or a range (start,end). If not provided, defaults to today's date.
+
+  -s, --sleep [DATE[,DATE]]
+                        Sleep data
+  -o, --spo2 [DATE[,DATE]]
+                        SpO2 data
+  -e, --heart [DATE[,DATE]]
+                        Heart Rate Time Series
+  -a, --active-zone [DATE[,DATE]]
+                        Active Zone Minutes (AZM) Time Series
+  -u, --show-user-profile
+                        Show user profile data
+```
+
+## Register Fitbit App
+
+1. Go to [https://dev.fitbit.com/apps](https://dev.fitbit.com/apps)
+2. Click on "REGISTER AN APP" tab
+3. Follow below example and register an app
+
+<p align="left">
+  <img alt="Fitbit logo", width="700" src="./assets/fitbit-app-registration.png">
+</p>
+
+## Local Development
+
+- [Fitbit Docs](https://dev.fitbit.com/build/reference/web-api/)
+- [OAuth Tutorial](https://dev.fitbit.com/build/reference/web-api/troubleshooting-guide/oauth2-tutorial/)
+
+```bash
+git clone git@github.com:veerendra2/fitbit-cli.git
+cd fitbit-cli
+
+python -m venv venv
+source venv/bin/activate
+python -m pip install -e .
+```

fitbit_cli-0.1.0/fitbit_cli/__init__.py

@@ -0,0 +1,6 @@
+# -*- coding: utf-8 -*-
+"""
+fitbit_cli Module
+"""
+
+__version__ = "0.1.0"

fitbit_cli-0.1.0/fitbit_cli/cli.py

@@ -0,0 +1,106 @@
+# -*- coding: utf-8 -*-
+"""
+CLI Arguments Parser
+"""
+
+import argparse
+from datetime import datetime
+
+from . import __version__
+
+
+def parse_date_range(date_str):
+    """Date parser"""
+
+    dates = date_str.split(",")
+    start_date = datetime.strptime(dates[0], "%Y-%m-%d").date()
+    try:
+        end_date = datetime.strptime(dates[1], "%Y-%m-%d").date()
+        if start_date > end_date:
+            raise ValueError("Start date must not be after end date")
+    except IndexError:
+        end_date = None
+
+    return (start_date, end_date)
+
+
+def parse_arguments():
+    """Argument parser"""
+
+    parser = argparse.ArgumentParser(
+        description="Fitbit CLI -- Access your Fitbit data at your terminal.",
+        formatter_class=argparse.RawTextHelpFormatter,
+    )
+
+    mutex_group = parser.add_mutually_exclusive_group(required=False)
+
+    mutex_group.add_argument(
+        "-d",
+        "--json-dump",
+        action="store_true",
+        help="Dump all your Fitbit data in json files.",
+    )
+    mutex_group.add_argument(
+        "-i",
+        "--init",
+        action="store_true",
+        help="Run interative setup to fetch token.",
+    )
+
+    group = parser.add_argument_group(
+        "APIs",
+        "Specify date ranges (ISO 8601 format: YYYY-MM-DD) for the following arguments.\n"
+        "You can provide a single date or a range (start,end). If not provided, defaults to today's date.",
+    )
+    group.add_argument(
+        "-s",
+        "--sleep",
+        type=parse_date_range,
+        nargs="?",
+        const=(datetime.today().date(), None),
+        metavar="DATE[,DATE]",
+        help="Sleep data",
+    )
+    group.add_argument(
+        "-o",
+        "--spo2",
+        type=parse_date_range,
+        nargs="?",
+        const=(datetime.today().date(), None),
+        metavar="DATE[,DATE]",
+        help="SpO2 data",
+    )
+    group.add_argument(
+        "-e",
+        "--heart",
+        type=parse_date_range,
+        nargs="?",
+        const=(datetime.today().date(), None),
+        metavar="DATE[,DATE]",
+        help="Heart Rate Time Series",
+    )
+    group.add_argument(
+        "-a",
+        "--active-zone",
+        type=parse_date_range,
+        nargs="?",
+        const=(datetime.today().date(), None),
+        metavar="DATE[,DATE]",
+        help="Active Zone Minutes (AZM) Time Series",
+    )
+    group.add_argument(
+        "-u",
+        "--show-user-profile",
+        action="store_true",
+        help="Show user profile data",
+    )
+
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"%(prog)s v{__version__}",
+        help="Show fitbit-cli version",
+    )
+
+    return parser.parse_args()

fitbit_cli-0.1.0/fitbit_cli/exceptions.py

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+"""
+Exceptions for Fitbit CLI
+"""
+
+
+class FitbitInitError(Exception):
+    """Custom exception for Fitbit initial setup"""
+
+    def __init__(self, message):
+        super().__init__(message)
+        self.message = message
+
+
+class FitbitAPIError(Exception):
+    """Custom exception for Fitbit API"""
+
+    def __init__(self, message):
+        super().__init__(message)
+        self.message = message

fitbit_cli-0.1.0/fitbit_cli/fitbit_api.py

@@ -0,0 +1,142 @@
+# -*- coding: utf-8 -*-
+"""
+Fitbit API
+"""
+
+import requests
+
+from .exceptions import FitbitAPIError
+
+
+class FitbitAPI:
+    """Fitbit API"""
+
+    TOKEN_API = "https://api.fitbit.com/oauth2/token"
+
+    def __init__(self, client_id, client_secret, access_token, refresh_token):
+        self.client_id = client_id
+        self.client_secret = client_secret
+        self.access_token = access_token
+        self.refresh_token = refresh_token
+        self.headers = self._create_headers()
+
+    def _create_headers(self):
+        return {
+            "Authorization": f"Bearer {self.access_token}",
+            "Content-Type": "application/json",
+        }
+
+    def refresh_access_token(self):
+        """Refresh token"""
+
+        payload = {
+            "grant_type": "refresh_token",
+            "client_id": self.client_id,
+            "refresh_token": self.refresh_token,
+        }
+        headers = {
+            "Authorization": f"Basic {self.client_secret}",
+            "Content-Type": "application/x-www-form-urlencoded",
+        }
+        response = requests.post(
+            FitbitAPI.TOKEN_API, data=payload, headers=headers, timeout=5
+        )
+
+        if response.status_code == 200:
+            tokens = response.json()
+            self.access_token = tokens.get("access_token")
+            self.refresh_token = tokens.get("refresh_token")
+            self.headers = self._create_headers()
+        else:
+            raise FitbitAPIError("Failed to refresh access token")
+
+    def make_request(self, method, url, **kwargs):
+        """Make an API request and handle token refresh if needed."""
+
+        try:
+            response = requests.request(
+                method, url, headers=self.headers, timeout=5, **kwargs
+            )
+            response.raise_for_status()
+        except requests.exceptions.HTTPError as e:
+            if response.status_code == 401:
+                self.refresh_access_token()
+                response = requests.request(
+                    method, url, headers=self.headers, timeout=5, **kwargs
+                )
+                response.raise_for_status()
+            else:
+                raise FitbitAPIError(f"HTTP error occurred: {response.json()}") from e
+
+        return response
+
+    def get_user_profile(self):
+        """Get Profile"""
+
+        url = "https://api.fitbit.com/1/user/-/profile.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_sleep_log(self, start_date, end_date=None):
+        """Get Sleep Logs by Date Range and Date"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else start_date
+        url = f"https://api.fitbit.com/1.2/user/-/sleep/date/{date_range}.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_heart_rate_time_series(self, start_date, end_date=None):
+        """Get Heart Rate Time Series by Date Range and Date"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else f"{start_date}/1d"
+        url = f"https://api.fitbit.com/1/user/-/activities/heart/date/{date_range}.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_spo2_summary(self, start_date, end_date=None):
+        """Get SpO2 Summary by Interval and Date"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else start_date
+        url = f"https://api.fitbit.com/1/user/-/spo2/date/{date_range}.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_spo2_intraday(self, start_date, end_date=None):
+        """Get SpO2 Intraday by Interval and Date"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else start_date
+        url = f"https://api.fitbit.com/1/user/-/spo2/date/{date_range}/all.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_azm_time_series(self, start_date, end_date=None):
+        """Get AZM Time Series by Interval and Data"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else f"{start_date}/1d"
+        url = f"https://api.fitbit.com/1/user/-/activities/active-zone-minutes/date/{date_range}.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_azm_intraday(self, start_date, end_date=None):
+        """Get AZM Intraday by Interval and Data"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else f"{start_date}/1d"
+        url = f"https://api.fitbit.com/1/user/-/activities/active-zone-minutes/date/{date_range}/1min.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_breathing_rate_summary(self, start_date, end_date=None):
+        """Get Breathing Rate Summary by Interval and Data"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else start_date
+        url = f"https://api.fitbit.com/1/user/-/br/date/{date_range}.json"
+        response = self.make_request("GET", url)
+        return response.json()
+
+    def get_breathing_rate_intraday(self, start_date, end_date=None):
+        """Get Breathing Rate Intraday by Interval and Data"""
+
+        date_range = f"{start_date}/{end_date}" if end_date else start_date
+        url = f"https://api.fitbit.com/1/user/-/br/date/{date_range}/all.json"
+        response = self.make_request("GET", url)
+        return response.json()

fitbit_cli-0.1.0/fitbit_cli/fitbit_init.py

@@ -0,0 +1,165 @@
+# -*- coding: utf-8 -*-
+"""
+Fitbit initial setup
+"""
+
+import getpass
+import json
+import secrets
+import string
+import threading
+import webbrowser
+from base64 import b64encode, urlsafe_b64encode
+from hashlib import sha256
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from pathlib import Path
+from urllib.parse import parse_qs, urlparse
+
+import requests
+from rich.prompt import Prompt
+
+from .exceptions import FitbitInitError
+from .formatter import CONSOLE
+
+BASE_URL = "https://www.fitbit.com/oauth2/authorize"
+FITBIT_TOKEN_PATH = f"{Path.home()}/.fitbit/token.json"
+SCOPE = [
+    "activity",
+    "cardio_fitness",
+    "electrocardiogram",
+    "heartrate",
+    "irregular_rhythm_notifications",
+    "location",
+    "nutrition",
+    "oxygen_saturation",
+    "profile",
+    "respiratory_rate",
+    "settings",
+    "sleep",
+    "social",
+    "temperature",
+    "weight",
+]
+TOKEN_URL = "https://api.fitbit.com/oauth2/token"
+
+
+class RequestHandler(BaseHTTPRequestHandler):
+    """Simple HTTP request handler"""
+
+    code = None
+
+    def do_GET(self):  # pylint: disable=C0103
+        """Handle GET request"""
+        parsed_url = urlparse(self.path)
+        query_params = parse_qs(parsed_url.query)
+        RequestHandler.code = query_params.get("code", [""])[0]
+
+        self.send_response(200)
+        self.send_header("Content-type", "text/html")
+        self.end_headers()
+        self.wfile.write(b"You can close this window now")
+
+        threading.Thread(target=self.server.shutdown).start()
+
+
+def start_server():
+    """Start simple HTTP server to catch token"""
+
+    with HTTPServer(("127.0.0.1", 8080), RequestHandler) as httpd:
+        CONSOLE.print(":computer: Serving on http://127.0.0.1:8080")
+        httpd.serve_forever()
+    return RequestHandler.code
+
+
+def fitbit_init_setup():
+    """Fitbit initial setup"""
+
+    # --------- Generate code challenge using random strings ---------
+    code_verifier = "".join(
+        secrets.choice(string.ascii_letters + string.digits) for _ in range(128)
+    )
+    code_challenge = (
+        urlsafe_b64encode(sha256(code_verifier.encode("utf-8")).digest())
+        .rstrip(b"=")
+        .decode("utf-8")
+    )
+
+    # --------- Get client ID and constructs authorization URL ---------
+    client_id = Prompt.ask(":bust_in_silhouette: Enter your Client ID")
+    assert client_id, "Invalid Client ID"
+
+    authorization_url = (
+        f"{BASE_URL}?client_id={client_id}&response_type=code"
+        f"&code_challenge={code_challenge}&code_challenge_method=S256"
+        f"&scope={'+'.join(SCOPE)}"
+    )
+
+    # --------- Get authorization code ---------
+    CONSOLE.print(
+        f":earth_asia: Opening below URL in browser to authorize the app \n\n{authorization_url}\n"
+    )
+    try:
+        browser_status = webbrowser.open(authorization_url)
+        if browser_status:
+            CONSOLE.print(
+                ":satellite: Waiting for authorization... "
+                + "(Check your browser or press 'Ctrl+C', authrize the app by opening the"
+                + " above URL in your browser and past the redirect URL manually.)\n"
+            )
+            authorization_code = start_server()
+        else:
+            raise FitbitInitError("Failed to open the URL in browser")
+    except (KeyboardInterrupt, FitbitInitError):
+        CONSOLE.print("\n:unamused: Error while opening the URL...")
+        CONSOLE.print(
+            ":neutral_face: Authrize the app by opening the above URL in your"
+            + "browser and past the redirect URL"
+        )
+        redirect_url = Prompt.ask(":clipboard: Paste the redirect URL: ")
+        assert redirect_url, "Invalid URL"
+
+        authorization_code = parse_qs(urlparse(redirect_url).query).get("code", [None])[
+            0
+        ]
+
+    # --------- Get access and refresh tokens ---------
+    client_secret = getpass.getpass("\n🔑 Enter your Client Secret: ")
+    assert client_secret, "Invalid Client Secret"
+
+    encoded_auth = b64encode(f"{client_id}:{client_secret}".encode()).decode()
+    response = requests.post(
+        TOKEN_URL,
+        headers={
+            "Authorization": f"Basic {encoded_auth}",
+            "Content-Type": "application/x-www-form-urlencoded",
+        },
+        data={
+            "client_id": client_id,
+            "grant_type": "authorization_code",
+            "code": authorization_code,
+            "code_verifier": code_verifier,
+        },
+        timeout=5,
+    )
+
+    if response.status_code == 200:
+        response_json = response.json()
+        Path(FITBIT_TOKEN_PATH).parent.mkdir(parents=True, exist_ok=True)
+        token_content = {
+            "access_token": response_json.get("access_token", ""),
+            "refresh_token": response_json.get("refresh_token", ""),
+            "client_id": client_id,
+            "secret": encoded_auth,
+        }
+        with open(FITBIT_TOKEN_PATH, "w", encoding="utf-8") as f:
+            json.dump(token_content, f)
+
+        CONSOLE.print(
+            f":floppy_disk: Saving fitbit token in {FITBIT_TOKEN_PATH}",
+            style="bold green",
+        )
+    else:
+        CONSOLE.print(
+            f":unamused: Failed to get tokens: {response.json()['errors'][0]['errorType']}",
+            style="bold red",
+        )

fitbit_cli-0.1.0/fitbit_cli/formatter.py

@@ -0,0 +1,147 @@
+# -*- coding: utf-8 -*-
+"""
+Json Data Formatter
+"""
+from rich.console import Console
+from rich.table import Table
+
+CONSOLE = Console()
+
+
+def display_user_profile(user_data):
+    """User data formatter"""
+
+    table = Table(
+        title=f"Hello, {user_data['user']['displayName']} :wave:", show_header=False
+    )
+
+    table.add_column("")
+    table.add_column("")
+
+    table.add_row(":bust_in_silhouette: First Name", user_data["user"]["firstName"])
+    table.add_row(":family: Last Name", user_data["user"]["lastName"])
+    table.add_row(":birthday: Date Of Birth", user_data["user"]["dateOfBirth"])
+    table.add_row(":hourglass_flowing_sand: Age", str(user_data["user"]["age"]))
+    table.add_row(":restroom: Gender", user_data["user"]["gender"])
+    table.add_row(":straight_ruler: Height", f"{user_data['user']['height']:.1f}")
+    table.add_row(":weight_lifter:  Weight", f"{user_data['user']['weight']:.1f}")
+    table.add_row(
+        ":footprints: Average Daily Steps", str(user_data["user"]["averageDailySteps"])
+    )
+    table.add_row(":calendar: Member Since", user_data["user"]["memberSince"])
+    table.add_row(":clock1: Time Zone", user_data["user"]["timezone"])
+
+    CONSOLE.print(table)
+
+
+def display_sleep(sleep_data):
+    """Sleep data formatter"""
+
+    table = Table(title="Sleep Data Summary :sleeping:", show_header=True)
+
+    table.add_column("Date :calendar:")
+    table.add_column("Deep Sleep :bed:")
+    table.add_column("Light Sleep :zzz:")
+    table.add_column("REM Sleep :crescent_moon:")
+    table.add_column("Wake Time :alarm_clock:")
+    table.add_column("Efficiency :100:")
+
+    for sleep in sleep_data["sleep"]:
+        table.add_row(
+            sleep["dateOfSleep"],
+            f"{sleep['levels']['summary'].get('deep', {}).get('minutes', 'N/A')} min",
+            f"{sleep['levels']['summary'].get('light', {}).get('minutes', 'N/A')} min",
+            f"{sleep['levels']['summary'].get('rem', {}).get('minutes', 'N/A')} min",
+            f"{sleep['levels']['summary'].get('wake', {}).get('minutes', 'N/A')} min",
+            f"{sleep['efficiency']}%",
+        )
+
+    CONSOLE.print(table)
+
+
+def display_spo2(spo2_data):
+    """SpO2 data formatter"""
+
+    table = Table(title="SpO2 Data Summary :heart:", show_header=True)
+
+    table.add_column("Date :calendar:")
+    table.add_column("Minimum :red_circle:")
+    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["dateTime"],
+            str(spo2["value"].get("min", "N/A")),
+            str(spo2["value"].get("avg", "N/A")),
+            str(spo2["value"].get("max", "N/A")),
+        )
+
+    CONSOLE.print(table)
+
+
+def display_heart_data(heart_data):
+    """Heart data formatter"""
+
+    table = Table(title="Heart Rate Time Series :heart:", show_header=True)
+
+    table.add_column("Date :calendar:")
+    table.add_column("Resting Heart Rate :heartpulse:")
+    table.add_column("Heart Rate Zones :dart:")
+
+    for activity in heart_data.get("activities-heart", []):
+        date = activity.get("dateTime", "N/A")
+        value = activity.get("value", {})
+        resting_heart_rate = value.get("restingHeartRate", "N/A")
+
+        zones_table = Table(show_header=True, header_style="bold magenta")
+        zones_table.add_column("Zone :dart:")
+        zones_table.add_column("Min :arrow_down:")
+        zones_table.add_column("Max :arrow_up:")
+        zones_table.add_column("Minutes :hourglass:")
+        zones_table.add_column("Calories Out :fire:")
+
+        for zone in value.get("heartRateZones", []):
+            zones_table.add_row(
+                zone.get("name", "N/A"),
+                str(zone.get("min", "N/A")),
+                str(zone.get("max", "N/A")),
+                str(zone.get("minutes", "N/A")),
+                (
+                    f"{zone.get('caloriesOut', 'N/A'):.2f}"
+                    if isinstance(zone.get("caloriesOut"), (int, float))
+                    else "N/A"
+                ),
+            )
+
+        table.add_row(date, str(resting_heart_rate), zones_table)
+
+    CONSOLE.print(table)
+
+
+def display_azm_time_series(azm_data):
+    """AZM Time Series data formatter"""
+
+    table = Table(title="AZM Time Series :runner:", show_header=True)
+
+    table.add_column("Date :calendar:")
+    table.add_column("Active Zone Minutes :stopwatch:")
+    table.add_column("Fat Burn :fire:")
+    table.add_column("Cardio :heart:")
+    table.add_column("Peak :mountain:")
+
+    for activity in azm_data.get("activities-active-zone-minutes", []):
+        date = activity.get("dateTime", "N/A")
+        value = activity.get("value", {})
+        table.add_row(
+            date,
+            str(value.get("activeZoneMinutes", "N/A")),
+            str(value.get("fatBurnActiveZoneMinutes", "N/A")),
+            str(value.get("cardioActiveZoneMinutes", "N/A")),
+            str(value.get("peakActiveZoneMinutes", "N/A")),
+        )
+
+    CONSOLE.print(table)

fitbit_cli-0.1.0/fitbit_cli/main.py

@@ -0,0 +1,53 @@
+# -*- coding: utf-8 -*-
+"""
+Main Module
+"""
+
+import json
+import sys
+
+from . import formatter
+from .cli import parse_arguments
+from .fitbit_api import FitbitAPI
+from .fitbit_init import FITBIT_TOKEN_PATH, fitbit_init_setup
+
+
+def main():
+    """Main function"""
+
+    args = parse_arguments()
+
+    if args.init:
+        fitbit_init_setup()
+
+    try:
+        with open(FITBIT_TOKEN_PATH, encoding="utf-8") as f:
+            credentials = json.load(f)
+    except FileNotFoundError:
+        formatter.CONSOLE.print(
+            ":grimacing: Fitbit token file not found. "
+            "If this is your first time running the CLI, use '--init' argument to set up the token.",
+            style="bold red",
+        )
+        sys.exit(1)
+
+    fitbit = FitbitAPI(
+        client_id=credentials["client_id"],
+        client_secret=credentials["secret"],
+        access_token=credentials["access_token"],
+        refresh_token=credentials["refresh_token"],
+    )
+
+    with formatter.CONSOLE.status("[bold green]Fetching data...") as _:
+        if args.show_user_profile:
+            formatter.display_user_profile(fitbit.get_user_profile())
+        if args.sleep:
+            formatter.display_sleep(fitbit.get_sleep_log(*args.sleep))
+        if args.spo2:
+            formatter.display_spo2(fitbit.get_spo2_summary(*args.spo2))
+        if args.heart:
+            formatter.display_heart_data(fitbit.get_heart_rate_time_series(*args.heart))
+        if args.active_zone:
+            formatter.display_azm_time_series(
+                fitbit.get_azm_time_series(*args.active_zone)
+            )

fitbit_cli-0.1.0/fitbit_cli.egg-info/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.1
+Name: fitbit-cli
+Version: 0.1.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/0.1.0.tar.gz
+Author: veerendra2
+Author-email: vk.tyk23@simplelogin.com
+License: MIT
+Project-URL: Documentation, https://github.com/veerendra2/fitbit-cli
+Keywords: fitbit,cli,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests==2.32.3
+Requires-Dist: rich==13.9.4
+
+# 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!
+
+<p align="center">
+  <img alt="Fitbit logo", width="250" src="./assets/Fitbit_Logo_White_RGB.jpg">
+</p>
+
+## Supported Web APIs
+
+> Only `GET` APIs are supported!
+
+| API                                                                                                                     | Status |
+| ----------------------------------------------------------------------------------------------------------------------- | ------ |
+| [User](https://dev.fitbit.com/build/reference/web-api/user/)                                                            | ✅     |
+| [Sleep](https://dev.fitbit.com/build/reference/web-api/sleep/)                                                          | ✅     |
+| [SpO2](https://dev.fitbit.com/build/reference/web-api/spo2/)                                                            | ✅     |
+| [Heart Rate Time Series](https://dev.fitbit.com/build/reference/web-api/heartrate-timeseries/)                          | ✅     |
+| [Active Zone Minutes (AZM) Time Series](https://dev.fitbit.com/build/reference/web-api/active-zone-minutes-timeseries/) | ✅     |
+| [Activity](https://dev.fitbit.com/build/reference/web-api/activity/)                                                    | 👷     |
+
+## Install
+
+```bash
+python -m pip install fitbit-cli
+
+fitbit-cli -h
+usage: fitbit-cli [-h] [-d | -i] [-s [DATE[,DATE]]] [-o [DATE[,DATE]]] [-e [DATE[,DATE]]] [-a [DATE[,DATE]]] [-u] [-v]
+
+Fitbit CLI -- Access your Fitbit data at your terminal.
+
+options:
+  -h, --help            show this help message and exit
+  -d, --json-dump       Dump all your Fitbit data in json files.
+  -i, --init            Run interative setup to fetch token.
+  -v, --version         Show fitbit-cli version
+
+APIs:
+  Specify date ranges (ISO 8601 format: YYYY-MM-DD) for the following arguments.
+  You can provide a single date or a range (start,end). If not provided, defaults to today's date.
+
+  -s, --sleep [DATE[,DATE]]
+                        Sleep data
+  -o, --spo2 [DATE[,DATE]]
+                        SpO2 data
+  -e, --heart [DATE[,DATE]]
+                        Heart Rate Time Series
+  -a, --active-zone [DATE[,DATE]]
+                        Active Zone Minutes (AZM) Time Series
+  -u, --show-user-profile
+                        Show user profile data
+```
+
+## Register Fitbit App
+
+1. Go to [https://dev.fitbit.com/apps](https://dev.fitbit.com/apps)
+2. Click on "REGISTER AN APP" tab
+3. Follow below example and register an app
+
+<p align="left">
+  <img alt="Fitbit logo", width="700" src="./assets/fitbit-app-registration.png">
+</p>
+
+## Local Development
+
+- [Fitbit Docs](https://dev.fitbit.com/build/reference/web-api/)
+- [OAuth Tutorial](https://dev.fitbit.com/build/reference/web-api/troubleshooting-guide/oauth2-tutorial/)
+
+```bash
+git clone git@github.com:veerendra2/fitbit-cli.git
+cd fitbit-cli
+
+python -m venv venv
+source venv/bin/activate
+python -m pip install -e .
+```

fitbit_cli-0.1.0/fitbit_cli.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+fitbit_cli/__init__.py
+fitbit_cli/cli.py
+fitbit_cli/exceptions.py
+fitbit_cli/fitbit_api.py
+fitbit_cli/fitbit_init.py
+fitbit_cli/formatter.py
+fitbit_cli/main.py
+fitbit_cli.egg-info/PKG-INFO
+fitbit_cli.egg-info/SOURCES.txt
+fitbit_cli.egg-info/dependency_links.txt
+fitbit_cli.egg-info/entry_points.txt
+fitbit_cli.egg-info/requires.txt
+fitbit_cli.egg-info/top_level.txt

fitbit_cli-0.1.0/fitbit_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fitbit_cli-0.1.0/fitbit_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fitbit-cli = fitbit_cli.main:main

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

@@ -0,0 +1,2 @@
+requests==2.32.3
+rich==13.9.4

fitbit_cli-0.1.0/fitbit_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+fitbit_cli

fitbit_cli-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.black]
+line-length = 88
+
+[tool.pylint.messages_control]
+disable = ["E0401"]
+
+[tool.isort]
+profile = "black"
+
+[tool.mypy]
+ignore_missing_imports = true
+
+[tool.pylint.report]
+output-format = "colorized"
+
+[tool.pylint.reporter]
+max-line-length = 120

fitbit_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fitbit_cli-0.1.0/setup.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+"""
+setup.py
+"""
+# pylint: disable=C0301
+
+import re
+
+from setuptools import find_packages, setup
+
+with open("fitbit_cli/__init__.py", encoding="utf-8") as file:
+    REGEX_VERSION = r'^__version__\s*=\s*[\'"]([^\'"]*)[\'"]'
+    version = re.search(REGEX_VERSION, file.read(), re.MULTILINE).group(1)  # type: ignore[union-attr]
+
+with open("README.md", encoding="utf-8") as file:
+    readme = file.read()
+
+setup(
+    name="fitbit-cli",
+    version=version,
+    packages=find_packages(),
+    description="Access your Fitbit data at your terminal.",
+    long_description=readme,
+    long_description_content_type="text/markdown",
+    author="veerendra2",
+    author_email="vk.tyk23@simplelogin.com",
+    url="https://github.com/veerendra2/fitbit-cli",
+    download_url=f"https://github.com/veerendra2/fitbit-cli/archive/{version}.tar.gz",
+    project_urls={
+        "Documentation": "https://github.com/veerendra2/fitbit-cli",
+    },
+    keywords=["fitbit", "cli", "python"],
+    license="MIT",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: End Users/Desktop",
+        "License :: OSI Approved :: Apache Software License",
+        "Natural Language :: English",
+        "Operating System :: POSIX :: Linux",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Topic :: Utilities",
+    ],
+    install_requires=[
+        "requests==2.32.3",
+        "rich==13.9.4",
+    ],
+    python_requires=">=3.9",
+    entry_points={"console_scripts": ["fitbit-cli = fitbit_cli.main:main"]},
+)