Metadata-Version: 2.4
Name: open-wearables-rest-cli
Version: 0.1.1
Summary: Generated Open Wearables REST CLI for users, providers, sync status, summaries, timeseries, and webhooks
Project-URL: Homepage, https://github.com/shivaam/openapi-cli-gen
Project-URL: Source, https://github.com/shivaam/openapi-cli-gen/tree/main/wrappers/open-wearables-rest-cli
Project-URL: Issues, https://github.com/shivaam/openapi-cli-gen/issues
Project-URL: Generator, https://github.com/shivaam/openapi-cli-gen
Author: Shivam Rastogi
License: MIT
Keywords: api,cli,generated,openapi,rest
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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 :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: openapi-cli-gen>=0.0.20
Description-Content-Type: text/markdown

# open-wearables-rest-cli

Generated CLI for the [Open Wearables](https://openwearables.io) REST API.

This wrapper is built from the public OpenAPI spec at
`https://api.openwearables.io/openapi.json` using
[`openapi-cli-gen`](https://github.com/shivaam/openapi-cli-gen).

## Install

```bash
pipx install open-wearables-rest-cli
```

For a local deployment:

```bash
export OPEN_WEARABLES_REST_CLI_BASE_URL=http://localhost:8000
```

For the hosted API, the generated package defaults to:

```bash
https://api.openwearables.io
```

## Examples

### Verified Commands

These commands were run successfully before publishing `0.1.0`.

Public/read-only provider inspection against `https://api.openwearables.io`:

```bash
open-wearables-rest-cli external-providers get --output-format json
```

Result marker: the response included known providers such as `Apple Health`.

Local/self-hosted user and sync workflows:

```bash
open-wearables-rest-cli external-users list \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format table

open-wearables-rest-cli external-summaries get-activity-summary \
  --user-id <user_id> \
  --start-date 2026-01-01 \
  --end-date 2026-01-31 \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format json

open-wearables-rest-cli external-timeseries get \
  --user-id <user_id> \
  --start-time 2026-01-01T00:00:00Z \
  --end-time 2026-01-02T00:00:00Z \
  --x-open-wearables-api-key "$OPEN_WEARABLES_API_KEY" \
  --output-format json
```

Webhook debugging:

```bash
open-wearables-rest-cli external-webhooks list-endpoints --output-format table
open-wearables-rest-cli external-webhooks list-messages --output-format json
```

## Auth

Most Open Wearables data endpoints accept `X-Open-Wearables-API-Key`; the
generated CLI exposes that operation header as `--x-open-wearables-api-key`.
Developer/JWT endpoints use the OAuth2 bearer scheme from the spec:

```bash
export OPEN_WEARABLES_REST_CLI_TOKEN=...
```

## Notes

This is an unofficial community wrapper. Avoid using real health data in demos,
screenshots, and test fixtures.
