Metadata-Version: 2.4
Name: dc-acuity-cli
Version: 1.0.0
Summary: CLI for managing Acuity Scheduling appointments, clients, and availability
Project-URL: Documentation, https://github.com/real-news-pr/acuity-schedule-manager#readme
Project-URL: Issues, https://github.com/real-news-pr/acuity-schedule-manager/issues
Project-URL: Source, https://github.com/real-news-pr/acuity-schedule-manager
Author: Real News PR
License-Expression: MIT
Keywords: acuity,appointments,cli,scheduling
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.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Scheduling
Requires-Python: >=3.10
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: types-requests>=2.28.0; extra == 'dev'
Description-Content-Type: text/markdown

# acuity-cli

Python CLI for managing Acuity Scheduling appointments, clients, and availability.

## Installation

```bash
pip install -e ".[dev]"
```

## Usage

```bash
# Step 1: Get appointment types (ALWAYS FIRST)
acuity types list

# Step 2: Check availability
acuity availability dates --type 12345 --month 2025-01
acuity availability times --type 12345 --date 2025-01-15

# Step 3: Validate slot
acuity availability check --type 12345 --datetime "2025-01-15T14:00:00"

# Step 4: Book appointment
acuity appointments book --type 12345 --datetime "2025-01-15T14:00:00" \
  --first-name Jane --last-name Doe --email jane@example.com
```

## Configuration

Set credentials via environment variables or config file:

```bash
export ACUITY_USER_ID="your-user-id"
export ACUITY_API_KEY="your-api-key"
```

Or create `~/.config/acuity/config.json`:

```json
{
  "user_id": "your-user-id",
  "api_key": "your-api-key",
  "default_timezone": "America/Chicago",
  "output": "json"
}
```

## Development

```bash
# Type checking
mypy acuity_cli

# Linting & formatting
ruff check acuity_cli
ruff format acuity_cli

# Run tests
pytest
```
