zoomcli 0.2.0__tar.gz → 0.2.2__tar.gz

zoomcli-0.2.2/.gitignore

@@ -0,0 +1,2 @@
+/target
+/.worktrees

zoomcli-0.2.2/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+
+
+## [0.2.2](https://github.com/rvben/zoom-cli/compare/v0.2.1...v0.2.2) - 2026-04-03
+
+## [0.2.1](https://github.com/rvben/zoom-cli/compare/v0.2.0...v0.2.1) - 2026-04-02
+
+### Added
+
+- show pagination progress when fetching multiple pages ([e5e3364](https://github.com/rvben/zoom-cli/commit/e5e336472b9cb153afed1d5020d0a758b2342359))
+- **config**: add zoom config delete command ([5841781](https://github.com/rvben/zoom-cli/commit/5841781a42e68c0c3568e9f16b06030fa19ec9ed))
+- **reports**: add zoom reports participants command ([fcf08dc](https://github.com/rvben/zoom-cli/commit/fcf08dcf19186a3613f84af701d67114abd27ce6))
+- **recordings**: add transcript download command ([c7b8fff](https://github.com/rvben/zoom-cli/commit/c7b8fff658e57b296d27e2632cf98e9187925ef8))
+- **users**: add create, deactivate, and activate commands ([eb4fc29](https://github.com/rvben/zoom-cli/commit/eb4fc2900837add72d7ecc75227c6e8ae68a5517))
+- **meetings**: add zoom meetings invite command ([051e7e6](https://github.com/rvben/zoom-cli/commit/051e7e6e4471ae01d30e3102c78ca18fe602fe17))
+
+### Fixed
+
+- add clickable link to missing-scope error message ([c71f3ba](https://github.com/rvben/zoom-cli/commit/c71f3bae31479e7fd3103dff05800a6b2afd1e4f))
+- parse Zoom error JSON and give actionable guidance for scope errors ([9ffac38](https://github.com/rvben/zoom-cli/commit/9ffac3889c124684a354be1f05b3538a1837b7fe))
+- hoist safe_topic out of per-file loop in recordings::download ([fa409c8](https://github.com/rvben/zoom-cli/commit/fa409c84f5363c1261a7c2f97b60ccb0873d3861))
+- **config,recordings**: exit non-zero when config delete aborts non-interactively, output structured JSON from transcript ([ed6f9f7](https://github.com/rvben/zoom-cli/commit/ed6f9f73d1379d64394e1747d2c77fb04c3d6c1c))
+
+## [0.2.0](https://github.com/rvben/zoom-cli/compare/v0.1.0...v0.2.0) - 2026-04-02
+
+### Added
+
+- **init**: redesign interactive setup with excellent UX ([2bc79df](https://github.com/rvben/zoom-cli/commit/2bc79dfc82e18f476e69ea7aaaa4416d3fce2c23))
+- **config**: add zoom config show command ([dbe8490](https://github.com/rvben/zoom-cli/commit/dbe84901f3618e6c17542ae6fd8e5c52a741eb29))
+
+### Fixed
+
+- double-encode recording UUIDs and write downloads atomically ([f346939](https://github.com/rvben/zoom-cli/commit/f346939569336d808e5c02f7c2029c55e7273169))
+- unreachable!() in send_with_retry was reachable, causing panics ([ceb905d](https://github.com/rvben/zoom-cli/commit/ceb905d7b12dfbc25fa8a7150daf2a5f09158375))
+- transparent token refresh on 401, --permanent flag for recordings delete ([fdae155](https://github.com/rvben/zoom-cli/commit/fdae155e096e953c4a6634a177abb9c7ce2ab6cf))

{zoomcli-0.2.0 → zoomcli-0.2.2}/Cargo.lock

@@ -2219,7 +2219,7 @@ checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"
 
 [[package]]
 name = "zoom-cli"
-version = "0.2.0"
+version = "0.2.2"
 dependencies = [
  "assert_cmd",
  "base64",
@@ -2235,5 +2235,6 @@ dependencies = [
  "tempfile",
  "tokio",
  "toml",
+ "toml_edit",
  "wiremock",
 ]

{zoomcli-0.2.0 → zoomcli-0.2.2}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "zoom-cli"
-version = "0.2.0"
+version = "0.2.2"
 edition = "2024"
 rust-version = "1.90"
 description = "Agent-friendly Zoom CLI with JSON output, structured exit codes, and schema introspection"
@@ -23,6 +23,7 @@ serde = { version = "1", features = ["derive"] }
 serde_json = "1"
 tokio = { version = "1", features = ["macros", "rt-multi-thread", "fs", "io-util", "time"] }
 toml = "0.8"
+toml_edit = "0.22"
 owo-colors = "4"
 dirs = "6"
 base64 = "0.22"

zoomcli-0.2.2/Formula/zoom-cli.rb

@@ -0,0 +1,32 @@
+class ZoomCli < Formula
+  desc "Agent-friendly Zoom CLI with JSON output, structured exit codes, and schema introspection"
+  homepage "https://github.com/rvben/zoom-cli"
+  version "0.2.0"
+  license "MIT"
+
+  on_macos do
+    on_arm do
+      url "https://github.com/rvben/zoom-cli/releases/download/v0.2.0/zoom-cli-v0.2.0-aarch64-apple-darwin.tar.gz"
+      sha256 "1646d509545baaf0dad29c136f6d63a02d8537c0b2cf42b29c64b2777cca267b"
+    end
+    on_intel do
+      url "https://github.com/rvben/zoom-cli/releases/download/v0.2.0/zoom-cli-v0.2.0-x86_64-apple-darwin.tar.gz"
+      sha256 "94f11f7a6cbb59e1fe5e1b55e8518c52ed2774a1fbbfd7ede824f84258786c18"
+    end
+  end
+
+  def install
+    bin.install "zoom"
+  end
+
+  def caveats
+    <<~EOS
+      Run `zoom init` to set up your Zoom Server-to-Server OAuth credentials.
+      Run `zoom config show` to verify your configuration.
+    EOS
+  end
+
+  test do
+    assert_match "zoom #{version}", shell_output("#{bin}/zoom --version")
+  end
+end

{zoomcli-0.2.0 → zoomcli-0.2.2}/Makefile

@@ -11,7 +11,7 @@ test:
 
 lint:
 	cargo fmt -- --check
-	cargo clippy --all-targets --all-features -- -D warnings
+	cargo clippy -- -D warnings
 
 fmt:
 	cargo fmt

zoomcli-0.2.2/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: zoomcli
+Version: 0.2.2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Communications :: Conferencing
+Summary: Agent-friendly CLI for the Zoom API
+Home-Page: https://github.com/rvben/zoom-cli
+Author-email: "Ruben J. Jongejan" <ruben.jongejan@gmail.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/rvben/zoom-cli
+Project-URL: Repository, https://github.com/rvben/zoom-cli.git
+
+[![CI](https://github.com/rvben/zoom-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/rvben/zoom-cli/actions/workflows/ci.yml)
+[![Crates.io](https://img.shields.io/crates/v/zoom-cli.svg)](https://crates.io/crates/zoom-cli)
+[![PyPI](https://img.shields.io/pypi/v/zoom-cli.svg)](https://pypi.org/project/zoom-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+# zoom-cli
+
+A command-line interface for the [Zoom API](https://developers.zoom.us/docs/api/) -- manage meetings, recordings, users, webinars, and reports from your terminal.
+
+## Install
+
+```bash
+# From crates.io
+cargo install zoom-cli
+
+# From PyPI (pre-built binaries, no Rust toolchain needed)
+pip install zoom-cli
+
+# From GitHub Releases (Linux, macOS)
+curl -fsSL https://github.com/rvben/zoom-cli/releases/latest/download/zoom-$(uname -m)-unknown-linux-gnu.tar.gz | tar xz
+```
+
+## Quick Start
+
+```bash
+# Interactive setup (creates config with your Zoom OAuth credentials)
+zoom init
+
+# List your upcoming meetings
+zoom meetings list
+
+# Create a meeting
+zoom meetings create --topic "Standup" --duration 30
+
+# List cloud recordings from a date range
+zoom recordings list --from 2026-01-01
+
+# Get current user info
+zoom users me
+```
+
+## Configuration
+
+### Config file
+
+`~/.config/zoom-cli/config.toml`
+
+```toml
+[default]
+account_id = "YOUR_ACCOUNT_ID"
+client_id = "YOUR_CLIENT_ID"
+client_secret = "YOUR_CLIENT_SECRET"
+
+[work]
+account_id = "..."
+client_id = "..."
+client_secret = "..."
+```
+
+Requires a [Zoom Server-to-Server OAuth app](https://marketplace.zoom.us/develop/create).
+
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `ZOOM_ACCOUNT_ID` | OAuth account ID |
+| `ZOOM_CLIENT_ID` | OAuth client ID |
+| `ZOOM_CLIENT_SECRET` | OAuth client secret |
+| `ZOOM_PROFILE` | Active profile name (default: `default`) |
+
+### Precedence
+
+CLI flags > environment variables > config file
+
+## Commands
+
+### Meetings
+
+| Command | Description |
+|---------|-------------|
+| `zoom meetings list [--user <id>] [--type <t>]` | List meetings for a user |
+| `zoom meetings get <id>` | Get meeting details |
+| `zoom meetings create --topic <t> [--duration <m>] [--start <dt>] [--password <p>]` | Create a meeting |
+| `zoom meetings update <id> [--topic <t>] [--duration <m>] [--start <dt>]` | Update a meeting |
+| `zoom meetings delete <id>` | Delete a meeting |
+| `zoom meetings end <id>` | End a live meeting |
+| `zoom meetings participants <id>` | List past meeting participants |
+| `zoom meetings invite <id>` | Get meeting invitation text |
+
+### Recordings
+
+| Command | Description |
+|---------|-------------|
+| `zoom recordings list [--user <id>] [--from <date>] [--to <date>]` | List cloud recordings |
+| `zoom recordings get <meeting_id>` | Get recording details |
+| `zoom recordings download <meeting_id> [--out <dir>]` | Download recording files |
+| `zoom recordings delete <meeting_id> [--permanent]` | Delete cloud recordings |
+| `zoom recordings start <meeting_id>` | Start recording a live meeting |
+| `zoom recordings stop <meeting_id>` | Stop recording |
+| `zoom recordings pause <meeting_id>` | Pause recording |
+| `zoom recordings resume <meeting_id>` | Resume recording |
+| `zoom recordings transcript <meeting_id> [--out <dir>]` | Download transcript files |
+
+### Users
+
+| Command | Description |
+|---------|-------------|
+| `zoom users list [--status <s>]` | List account users |
+| `zoom users get <id_or_email>` | Get user details |
+| `zoom users me` | Get current user |
+| `zoom users create --email <e> [--first-name <n>] [--last-name <n>] [--type <t>]` | Create a user |
+| `zoom users deactivate <id_or_email>` | Deactivate a user |
+| `zoom users activate <id_or_email>` | Reactivate a user |
+
+### Webinars
+
+| Command | Description |
+|---------|-------------|
+| `zoom webinars list [--user <id>]` | List webinars |
+| `zoom webinars get <id>` | Get webinar details |
+
+### Reports
+
+| Command | Description |
+|---------|-------------|
+| `zoom reports meetings --from <date> [--to <date>] [--user <id>]` | Meeting summary report |
+| `zoom reports participants <meeting_id>` | Participant report for a past meeting |
+
+### Configuration & Setup
+
+| Command | Description |
+|---------|-------------|
+| `zoom init [--profile <name>]` | Set up credentials interactively |
+| `zoom config show` | Show current configuration |
+| `zoom config delete <profile> [--force]` | Delete a profile |
+| `zoom schema <resource>` | Print field reference for a resource (meetings, recordings, users, reports, webinars) |
+| `zoom completions <shell>` | Generate shell completions (bash, zsh, fish, elvish, powershell) |
+
+## Shell Completions
+
+```bash
+# zsh
+zoom completions zsh > ~/.zsh/completions/_zoom
+
+# bash
+zoom completions bash > /etc/bash_completion.d/zoom
+
+# fish
+zoom completions fish > ~/.config/fish/completions/zoom.fish
+```
+
+## Agent Integration
+
+### JSON output
+
+JSON output is automatic when stdout is not a TTY, or forced with `--json`. Data goes to stdout, messages to stderr.
+
+```bash
+zoom meetings list --json | jq '.[].topic'
+```
+
+### Schema introspection
+
+```bash
+zoom schema meetings | jq '.fields'
+```
+
+The `schema` command outputs a JSON description of resource fields and types -- enabling AI agents to discover operations without parsing help text.
+
+### Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `2` | Auth or config error |
+| `3` | Not found |
+
+## License
+
+MIT
+

zoomcli-0.2.2/README.md

@@ -0,0 +1,181 @@
+[![CI](https://github.com/rvben/zoom-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/rvben/zoom-cli/actions/workflows/ci.yml)
+[![Crates.io](https://img.shields.io/crates/v/zoom-cli.svg)](https://crates.io/crates/zoom-cli)
+[![PyPI](https://img.shields.io/pypi/v/zoom-cli.svg)](https://pypi.org/project/zoom-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+# zoom-cli
+
+A command-line interface for the [Zoom API](https://developers.zoom.us/docs/api/) -- manage meetings, recordings, users, webinars, and reports from your terminal.
+
+## Install
+
+```bash
+# From crates.io
+cargo install zoom-cli
+
+# From PyPI (pre-built binaries, no Rust toolchain needed)
+pip install zoom-cli
+
+# From GitHub Releases (Linux, macOS)
+curl -fsSL https://github.com/rvben/zoom-cli/releases/latest/download/zoom-$(uname -m)-unknown-linux-gnu.tar.gz | tar xz
+```
+
+## Quick Start
+
+```bash
+# Interactive setup (creates config with your Zoom OAuth credentials)
+zoom init
+
+# List your upcoming meetings
+zoom meetings list
+
+# Create a meeting
+zoom meetings create --topic "Standup" --duration 30
+
+# List cloud recordings from a date range
+zoom recordings list --from 2026-01-01
+
+# Get current user info
+zoom users me
+```
+
+## Configuration
+
+### Config file
+
+`~/.config/zoom-cli/config.toml`
+
+```toml
+[default]
+account_id = "YOUR_ACCOUNT_ID"
+client_id = "YOUR_CLIENT_ID"
+client_secret = "YOUR_CLIENT_SECRET"
+
+[work]
+account_id = "..."
+client_id = "..."
+client_secret = "..."
+```
+
+Requires a [Zoom Server-to-Server OAuth app](https://marketplace.zoom.us/develop/create).
+
+### Environment variables
+
+| Variable | Description |
+|---|---|
+| `ZOOM_ACCOUNT_ID` | OAuth account ID |
+| `ZOOM_CLIENT_ID` | OAuth client ID |
+| `ZOOM_CLIENT_SECRET` | OAuth client secret |
+| `ZOOM_PROFILE` | Active profile name (default: `default`) |
+
+### Precedence
+
+CLI flags > environment variables > config file
+
+## Commands
+
+### Meetings
+
+| Command | Description |
+|---------|-------------|
+| `zoom meetings list [--user <id>] [--type <t>]` | List meetings for a user |
+| `zoom meetings get <id>` | Get meeting details |
+| `zoom meetings create --topic <t> [--duration <m>] [--start <dt>] [--password <p>]` | Create a meeting |
+| `zoom meetings update <id> [--topic <t>] [--duration <m>] [--start <dt>]` | Update a meeting |
+| `zoom meetings delete <id>` | Delete a meeting |
+| `zoom meetings end <id>` | End a live meeting |
+| `zoom meetings participants <id>` | List past meeting participants |
+| `zoom meetings invite <id>` | Get meeting invitation text |
+
+### Recordings
+
+| Command | Description |
+|---------|-------------|
+| `zoom recordings list [--user <id>] [--from <date>] [--to <date>]` | List cloud recordings |
+| `zoom recordings get <meeting_id>` | Get recording details |
+| `zoom recordings download <meeting_id> [--out <dir>]` | Download recording files |
+| `zoom recordings delete <meeting_id> [--permanent]` | Delete cloud recordings |
+| `zoom recordings start <meeting_id>` | Start recording a live meeting |
+| `zoom recordings stop <meeting_id>` | Stop recording |
+| `zoom recordings pause <meeting_id>` | Pause recording |
+| `zoom recordings resume <meeting_id>` | Resume recording |
+| `zoom recordings transcript <meeting_id> [--out <dir>]` | Download transcript files |
+
+### Users
+
+| Command | Description |
+|---------|-------------|
+| `zoom users list [--status <s>]` | List account users |
+| `zoom users get <id_or_email>` | Get user details |
+| `zoom users me` | Get current user |
+| `zoom users create --email <e> [--first-name <n>] [--last-name <n>] [--type <t>]` | Create a user |
+| `zoom users deactivate <id_or_email>` | Deactivate a user |
+| `zoom users activate <id_or_email>` | Reactivate a user |
+
+### Webinars
+
+| Command | Description |
+|---------|-------------|
+| `zoom webinars list [--user <id>]` | List webinars |
+| `zoom webinars get <id>` | Get webinar details |
+
+### Reports
+
+| Command | Description |
+|---------|-------------|
+| `zoom reports meetings --from <date> [--to <date>] [--user <id>]` | Meeting summary report |
+| `zoom reports participants <meeting_id>` | Participant report for a past meeting |
+
+### Configuration & Setup
+
+| Command | Description |
+|---------|-------------|
+| `zoom init [--profile <name>]` | Set up credentials interactively |
+| `zoom config show` | Show current configuration |
+| `zoom config delete <profile> [--force]` | Delete a profile |
+| `zoom schema <resource>` | Print field reference for a resource (meetings, recordings, users, reports, webinars) |
+| `zoom completions <shell>` | Generate shell completions (bash, zsh, fish, elvish, powershell) |
+
+## Shell Completions
+
+```bash
+# zsh
+zoom completions zsh > ~/.zsh/completions/_zoom
+
+# bash
+zoom completions bash > /etc/bash_completion.d/zoom
+
+# fish
+zoom completions fish > ~/.config/fish/completions/zoom.fish
+```
+
+## Agent Integration
+
+### JSON output
+
+JSON output is automatic when stdout is not a TTY, or forced with `--json`. Data goes to stdout, messages to stderr.
+
+```bash
+zoom meetings list --json | jq '.[].topic'
+```
+
+### Schema introspection
+
+```bash
+zoom schema meetings | jq '.fields'
+```
+
+The `schema` command outputs a JSON description of resource fields and types -- enabling AI agents to discover operations without parsing help text.
+
+### Exit codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success |
+| `1` | General error |
+| `2` | Auth or config error |
+| `3` | Not found |
+
+## License
+
+MIT