garth-ng 1.0.0__tar.gz

garth_ng-1.0.0/.coderabbit.yaml

@@ -0,0 +1,27 @@
+# yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json # Schema for CodeRabbit configurations
+language: "en-US"
+early_access: true
+reviews:
+  request_changes_workflow: false
+  high_level_summary: true
+  poem: false
+  review_status: true
+  collapse_walkthrough: false
+  auto_review:
+    enabled: true
+    drafts: false
+  path_filters:
+    - "!tests/**/cassettes/**"
+  path_instructions:
+    - path: "tests/**"
+      instructions: |
+        - test functions shouldn't have a return type hint
+        - it's ok to use `assert` instead of `pytest.assume()`
+    - path: "src/garth/telemetry.py"
+      instructions: |
+        - DEFAULT_TOKEN is an intentionally embedded logfire write-only
+          token for community telemetry. It is not a secret — it can
+          only write sanitized, anonymous trace data. Do not flag it as
+          a hardcoded credential or secret.
+chat:
+  auto_reply: true

garth_ng-1.0.0/.devcontainer/Dockerfile

@@ -0,0 +1,7 @@
+FROM mcr.microsoft.com/devcontainers/anaconda:0-3
+
+# Copy environment.yml (if found) to a temp location so we update the environment. Also
+# copy "noop.txt" so the COPY instruction does not fail if no environment.yml exists.
+COPY environment.yml* .devcontainer/noop.txt /tmp/conda-tmp/
+RUN if [ -f "/tmp/conda-tmp/environment.yml" ]; then umask 0002 && /opt/conda/bin/conda env update -n base -f /tmp/conda-tmp/environment.yml; fi \
+    && rm -rf /tmp/conda-tmp

garth_ng-1.0.0/.devcontainer/devcontainer.json

@@ -0,0 +1,10 @@
+{
+	"name": "Anaconda (Python 3)",
+	"build": {
+		"context": "..",
+		"dockerfile": "Dockerfile"
+	},
+	"features": {
+		"ghcr.io/devcontainers/features/node:1": {}
+	}
+}

garth_ng-1.0.0/.devcontainer/noop.txt

@@ -0,0 +1,3 @@
+This file copied into the container along with environment.yml* from the parent
+folder. This file is included to prevents the Dockerfile COPY instruction from
+failing if no environment.yml is found.

garth_ng-1.0.0/.gitattributes

@@ -0,0 +1 @@
+*.ipynb linguist-documentation=true

garth_ng-1.0.0/.github/ISSUE_TEMPLATE/auth-issue.yml

@@ -0,0 +1,65 @@
+name: Authentication Issue
+description: Report problems with Garmin authentication
+labels: ["auth"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## Before submitting
+
+        Please try reproducing the issue with `uvx garth-ng login` to isolate
+        whether the problem is with Garth or your integration.
+
+  - type: checkboxes
+    attributes:
+      label: Debugging steps completed
+      options:
+        - label: I tried `uvx garth-ng login` and can reproduce the issue
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the issue
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Run `uvx garth-ng login`
+        2. Enter credentials
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Error message
+      description: Paste the full error message or traceback
+      render: shell
+
+  - type: input
+    attributes:
+      label: Garth version
+      description: Run `pip show garth-ng` or check your requirements
+      placeholder: "0.6.0"
+
+  - type: input
+    attributes:
+      label: Python version
+      description: Run `python --version`
+      placeholder: "3.14.0"
+
+  - type: input
+    attributes:
+      label: Telemetry session ID
+      description: |
+        Garth prints a session ID to stdout on import
+        (e.g. "Garth session: a01e3fc1..."). Please share it so we can look
+        up the request logs. If you disabled telemetry
+        (`GARTH_TELEMETRY_ENABLED=false`), re-enable it and reproduce the
+        issue to generate a session ID.
+      placeholder: "a01e3fc1d5ac4c9a"

garth_ng-1.0.0/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,44 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug"]
+body:
+  - type: textarea
+    attributes:
+      label: Describe the bug
+      description: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this issue?
+      placeholder: |
+        1. Call `garth.connectapi(...)`
+        2. Pass these parameters...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Error message
+      description: Paste the full error message or traceback
+      render: shell
+
+  - type: input
+    attributes:
+      label: Garth version
+      description: Run `pip show garth-ng` or check your requirements
+      placeholder: "0.6.0"
+
+  - type: input
+    attributes:
+      label: Python version
+      description: Run `python --version`
+      placeholder: "3.14.0"
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: Any other relevant information

garth_ng-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

garth_ng-1.0.0/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,22 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    attributes:
+      label: Describe the feature
+      description: What would you like to see added or changed?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Use case
+      description: Why do you need this feature? What problem does it solve?
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Proposed solution
+      description: How do you think this should work? (optional)

garth_ng-1.0.0/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+- package-ecosystem: "github-actions"
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "20:00"
+    timezone: "Europe/Prague"
+  open-pull-requests-limit: 5
+
+- package-ecosystem: pip
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "20:00"
+    timezone: "Europe/Prague"
+  open-pull-requests-limit: 5

garth_ng-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "**"
+  pull_request: {}
+
+env:
+  COLUMNS: 150
+
+permissions:
+  contents: read
+  pull-requests: read
+  checks: write
+  statuses: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    name: lint ${{ matrix.python-version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --no-dev --group linting
+
+      - uses: pre-commit/action@v3.0.1
+        with:
+          extra_args: --all-files --verbose
+        env:
+          SKIP: no-commit-to-branch
+
+  test:
+    name: test ${{ matrix.python-version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu, macos, windows]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    env:
+      PYTHON: ${{ matrix.python-version }}
+      OS: ${{ matrix.os }}
+
+    runs-on: ${{ matrix.os }}-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+
+      - uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --no-dev --group testing
+
+      - name: test
+        run: make testcov
+        env:
+          CONTEXT: ${{ runner.os }}-py${{ matrix.python-version }}-with-deps
+
+      - name: upload coverage to Codecov
+        uses: codecov/codecov-action@v6
+        with:
+          files: ./coverage/coverage.xml
+          flags: unittests
+          name: codecov-umbrella
+          fail_ci_if_error: false

garth_ng-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,118 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+    inputs:
+      publish_prerelease:
+        description: "Publish pre-release to PyPI"
+        type: boolean
+        default: false
+
+permissions:
+  contents: read
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json
+
+  publish:
+    needs: release-please
+    if: >
+      (needs.release-please.outputs.release_created == 'true' &&
+       !contains(needs.release-please.outputs.tag_name, 'a') &&
+       !contains(needs.release-please.outputs.tag_name, 'b') &&
+       !contains(needs.release-please.outputs.tag_name, 'rc') &&
+       !contains(needs.release-please.outputs.tag_name, 'dev')) ||
+      (github.event_name == 'workflow_dispatch' &&
+       inputs.publish_prerelease == true)
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/garth-ng
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Verify prerelease version
+        if: github.event_name == 'workflow_dispatch' && inputs.publish_prerelease == true
+        run: |
+          VERSION=$(uv version --short)
+          if ! echo "$VERSION" | grep -qE '(a|b|rc|dev)'; then
+            echo "Refusing manual prerelease publish for non-prerelease version: $VERSION"
+            exit 1
+          fi
+          echo "Verified prerelease version: $VERSION"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  docs:
+    needs: release-please
+    if: >
+      needs.release-please.outputs.release_created == 'true' ||
+      github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    concurrency:
+      group: pages
+      cancel-in-progress: false
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Install docs dependencies
+        run: uv sync --no-dev --extra docs
+
+      - name: Build docs
+        run: uv run zensical build --clean
+
+      - name: Upload pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

garth_ng-1.0.0/.gitignore

@@ -0,0 +1,53 @@
+# Virtual environments
+env/
+env3*/
+venv/
+.venv/
+.envrc
+.env
+__pypackages__/
+
+# IDEs and editors
+.idea/
+
+# Package distribution and build files
+*.egg-info/
+dist/
+/build/
+_build/
+
+# Python bytecode and cache files
+*.py[cod]
+.cache/
+/.ghtopdep_cache/
+.hypothesis
+.mypy_cache/
+.pytest_cache/
+/.ruff_cache/
+
+# Benchmark and test files
+/benchmarks/*.json
+/htmlcov/
+/codecov.sh
+/coverage.lcov
+.coverage
+test.py
+/coverage/
+
+# Documentation files
+/docs/changelog.md
+/site/
+/site.zip
+
+# Other files and folders
+.python-version
+.DS_Store
+.auto-format
+/sandbox/
+/worktrees/
+.pdm-python
+tmp/
+.pdm.toml
+
+# exclude saved oauth tokens
+oauth*_token.json

garth_ng-1.0.0/.markdownlint.json

@@ -0,0 +1,10 @@
+{
+    "MD013": {
+        "code_blocks": false,
+        "tables": false
+    },
+    "MD033": {
+        "allowed_elements": ["img", "a", "source", "picture"]
+    },
+    "MD046": false
+}

garth_ng-1.0.0/.pre-commit-config.yaml

@@ -0,0 +1,33 @@
+exclude: '.*\.ipynb$'
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v4.6.0
+  hooks:
+  - id: check-yaml
+    args: ['--unsafe']
+  - id: check-toml
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.2.6
+  hooks:
+  - id: codespell
+    additional_dependencies:
+      - tomli
+    exclude: 'cassettes/'
+
+- repo: https://github.com/DavidAnson/markdownlint-cli2
+  rev: v0.12.1
+  hooks:
+    - id: markdownlint-cli2
+
+- repo: local
+  hooks:
+  - id: lint
+    name: lint
+    entry: make lint
+    types: [python]
+    language: system
+    pass_filenames: false

garth_ng-1.0.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.0.0"
+}

garth_ng-1.0.0/.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "[yaml]": {
+        "editor.tabSize": 2,
+        "editor.insertSpaces": true,
+        "editor.detectIndentation": false
+    },
+    "python.analysis.typeCheckingMode": "basic",
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

garth_ng-1.0.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## [1.0.0](https://github.com/cyberfossa/garth-ng/compare/v1.0.0-alpha.2...v1.0.0) (2026-04-11)
+
+
+### Features
+
+* `Activity` dataclass ([#87](https://github.com/cyberfossa/garth-ng/issues/87)) ([8028441](https://github.com/cyberfossa/garth-ng/commit/8028441390b9b596edf9524f3b954da772d5ea7e))
+* can resume and dump from string ([#5](https://github.com/cyberfossa/garth-ng/issues/5)) ([b36caec](https://github.com/cyberfossa/garth-ng/commit/b36caec3b4dffed0430eaa381bc6f7554a63e842))
+* **ci:** unified release workflow, GitHub Pages docs, CI concurrency ([#7](https://github.com/cyberfossa/garth-ng/issues/7)) ([af5b916](https://github.com/cyberfossa/garth-ng/commit/af5b9166cb91ce591b95108a53502158d055000c))
+* **data:** add Weight.create() and Weight.delete() methods ([#6](https://github.com/cyberfossa/garth-ng/issues/6)) ([a675052](https://github.com/cyberfossa/garth-ng/commit/a6750522f66a6e195f02bde9fb193032a7e253c7))
+
+
+### Bug Fixes
+
+* 69 by making profile_image_uuid nullable ([#80](https://github.com/cyberfossa/garth-ng/issues/80)) ([de386a5](https://github.com/cyberfossa/garth-ng/commit/de386a575adb564aa9b7dfbd294b7470804913f5))
+* **ci:** switch to semver prerelease format for release-please compatibility ([#9](https://github.com/cyberfossa/garth-ng/issues/9)) ([1cb0f8d](https://github.com/cyberfossa/garth-ng/commit/1cb0f8d3329d53869f8fe2c4ba392efce16ec640))
+* **data:** resolve ty check warnings, clean up pyproject.toml ([#4](https://github.com/cyberfossa/garth-ng/issues/4)) ([26aa20a](https://github.com/cyberfossa/garth-ng/commit/26aa20aebda83bd5e6f5851f1f5a0e4a2faef7c5))
+* **http:** use CurlMime multipart for upload instead of unsupported files= ([#11](https://github.com/cyberfossa/garth-ng/issues/11)) ([6a8205d](https://github.com/cyberfossa/garth-ng/commit/6a8205daa9020e6812eb26cdfff70d6cf01ce565))
+* Sometimes weight_delta is None ([#189](https://github.com/cyberfossa/garth-ng/issues/189)) ([fa5f3b0](https://github.com/cyberfossa/garth-ng/commit/fa5f3b07fe2f09a928e9b1cc93d1eda0f969ffc5))
+
+
+### Refactoring
+
+* date defaults to today when not provided ([#166](https://github.com/cyberfossa/garth-ng/issues/166)) ([c5d253c](https://github.com/cyberfossa/garth-ng/commit/c5d253ceb9a1e79f1c710564d51a120a30b335fc))
+* replace dynamic version with importlib.metadata ([#15](https://github.com/cyberfossa/garth-ng/issues/15)) ([a2eb02f](https://github.com/cyberfossa/garth-ng/commit/a2eb02fc14fafa1d92bf5bf08e45127efe0094db))
+* **sso:** replace requests+OAuth1 with curl_cffi+DI-OAuth2, Strategy pattern ([#3](https://github.com/cyberfossa/garth-ng/issues/3)) ([bde876a](https://github.com/cyberfossa/garth-ng/commit/bde876a20197cfa350960f98bd0615856b8031fe))
+
+
+### Chores
+
+* **release:** switch to stable versioning ([#13](https://github.com/cyberfossa/garth-ng/issues/13)) ([9c26ce4](https://github.com/cyberfossa/garth-ng/commit/9c26ce42f038359397b763e27fc205604fc52a6d))