wealthbox-cli 1.0.0__tar.gz → 1.0.1__tar.gz

{wealthbox_cli-1.0.0 → wealthbox_cli-1.0.1}/CONTRIBUTING.md

@@ -15,7 +15,13 @@ source .venv/bin/activate  # macOS/Linux
 pip install -e ".[dev]"
 ```
 
-Copy `.env.example` to `.env` and add your Wealthbox API token.
+Configure your Wealthbox API token:
+
+```bash
+wbox config set-token
+```
+
+Or copy `.env.example` to `.env` and add your token there.
 
 ## Running Tests
 
@@ -32,8 +38,8 @@ ruff check src/
 mypy src/
 ```
 
-- **ruff** for linting (E, F, I rules; 100-char line length)
-- **mypy** in strict mode
+- **ruff** for linting (E, F, I rules; 120-char line length)
+- **mypy** in strict mode (has known `untyped-decorator` warnings from Typer — not currently enforced in CI)
 
 ## Project Architecture
 
@@ -55,11 +61,20 @@ Three layers under `src/wealthbox_tools/`:
 6. If the resource has category types, add them via `make_category_command()` in the resource's `categories` sub-app
 7. Add tests in `tests/test_<resource>_create.py` and `tests/test_<resource>_update.py`
 
+## CI
+
+Pull requests and pushes to `main` run GitHub Actions CI:
+
+- **Lint:** `ruff check src/ tests/`
+- **Test:** `pytest` across Python 3.11, 3.12, 3.13
+
+Both must pass before merging.
+
 ## Pull Requests
 
 - Keep PRs focused — one feature or fix per PR
 - All tests must pass (`pytest`)
-- No ruff or mypy errors
+- No ruff errors
 - Update the CLI reference docs if commands change
 
 ## Reporting Issues

{wealthbox_cli-1.0.0 → wealthbox_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wealthbox-cli
-Version: 1.0.0
+Version: 1.0.1
 Summary: CLI and client library for the Wealthbox CRM API
 Project-URL: Homepage, https://github.com/massive-value/wealthbox-cli
 Project-URL: Issues, https://github.com/massive-value/wealthbox-cli/issues
@@ -92,26 +92,44 @@ pip install -e ".[dev]"
 
 ## Configuration
 
-Copy `.env.example` to `.env` and fill in your token:
+### Getting your API token
 
-```
-WEALTHBOX_TOKEN=your_api_token_here
+1. Log in to [Wealthbox](https://app.crmworkspace.com)
+2. Click the three dots menu (**...**) in the top right
+3. Go to **Settings** -> **API Access**
+4. Click **Create Access Token**
+
+### Storing your token
+
+``` bash
+wbox config set-token
 ```
 
-Or set it as an environment variable:
+This prompts for your Wealthbox API token (input is masked) and stores it in
+`~/.config/wbox/config.json` (Linux/macOS) or `%APPDATA%\wbox\config.json` (Windows).
 
-**macOS/Linux**
+Other configuration commands:
 
 ``` bash
-export WEALTHBOX_TOKEN="your_api_token_here"
+wbox config show     # display stored config (token masked)
+wbox config clear    # remove stored config
 ```
 
-**Windows (PowerShell)**
+**Alternative methods** (for CI, scripting, or containers):
 
-``` powershell
-setx WEALTHBOX_TOKEN "your_api_token_here"
+``` bash
+# Environment variable
+export WEALTHBOX_TOKEN="your_api_token_here"
+
+# .env file in working directory
+echo 'WEALTHBOX_TOKEN=your_api_token_here' > .env
+
+# Per-command flag
+wbox contacts list --token your_api_token_here
 ```
 
+Token is resolved in this order: `--token` flag > `WEALTHBOX_TOKEN` env var > config file > `.env` file.
+
 ------------------------------------------------------------------------
 
 ## Usage

{wealthbox_cli-1.0.0 → wealthbox_cli-1.0.1}/README.md

@@ -61,26 +61,44 @@ pip install -e ".[dev]"
 
 ## Configuration
 
-Copy `.env.example` to `.env` and fill in your token:
+### Getting your API token
 
-```
-WEALTHBOX_TOKEN=your_api_token_here
+1. Log in to [Wealthbox](https://app.crmworkspace.com)
+2. Click the three dots menu (**...**) in the top right
+3. Go to **Settings** -> **API Access**
+4. Click **Create Access Token**
+
+### Storing your token
+
+``` bash
+wbox config set-token
 ```
 
-Or set it as an environment variable:
+This prompts for your Wealthbox API token (input is masked) and stores it in
+`~/.config/wbox/config.json` (Linux/macOS) or `%APPDATA%\wbox\config.json` (Windows).
 
-**macOS/Linux**
+Other configuration commands:
 
 ``` bash
-export WEALTHBOX_TOKEN="your_api_token_here"
+wbox config show     # display stored config (token masked)
+wbox config clear    # remove stored config
 ```
 
-**Windows (PowerShell)**
+**Alternative methods** (for CI, scripting, or containers):
 
-``` powershell
-setx WEALTHBOX_TOKEN "your_api_token_here"
+``` bash
+# Environment variable
+export WEALTHBOX_TOKEN="your_api_token_here"
+
+# .env file in working directory
+echo 'WEALTHBOX_TOKEN=your_api_token_here' > .env
+
+# Per-command flag
+wbox contacts list --token your_api_token_here
 ```
 
+Token is resolved in this order: `--token` flag > `WEALTHBOX_TOKEN` env var > config file > `.env` file.
+
 ------------------------------------------------------------------------
 
 ## Usage

{wealthbox_cli-1.0.0 → wealthbox_cli-1.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wealthbox-cli"
-version = "1.0.0"
+version = "1.0.1"
 description = "CLI and client library for the Wealthbox CRM API"
 readme = "README.md"
 requires-python = ">=3.11"