Merge branch 'main' of https://github.com/dualentry/dualentry-cli

Author: Warkanlock

.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## Summary
+
+<!-- What does this PR do and why? -->
+
+## Changes
+
+-
+
+## Test plan
+
+- [ ] Unit tests pass (`uv run pytest`)
+- [ ] Linter passes (`uv run ruff check .`)
+- [ ] Manually tested with `dualentry <command>`

.github/workflows/release.yml

@@ -0,0 +1,122 @@
+name: Release
+
+on:
+  release:
+    types: [published, edited]
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - os: macos-14
+            target: macos-arm64
+          - os: macos-15
+            target: macos-x86_64
+          - os: ubuntu-latest
+            target: linux-x86_64
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.12"
+      - name: Stamp version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i.bak "s/^version = .*/version = \"$VERSION\"/" pyproject.toml
+          sed -i.bak "s/^__version__ = .*/__version__ = \"$VERSION\"/" src/dualentry_cli/__init__.py
+          rm -f pyproject.toml.bak src/dualentry_cli/__init__.py.bak
+      - run: uv sync --dev
+      - run: uv run python scripts/build.py
+      - name: Rename binary
+        run: mv dist/dualentry dist/dualentry-${{ matrix.target }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dualentry-${{ matrix.target }}
+          path: dist/dualentry-${{ matrix.target }}
+
+  upload:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: artifacts
+          merge-multiple: true
+      - name: Upload binaries to release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          for f in artifacts/*; do
+            gh release upload "${{ github.event.release.tag_name }}" "$f" --repo "${{ github.repository }}"
+          done
+
+  update-tap:
+    needs: upload
+    runs-on: ubuntu-latest
+    steps:
+      - name: Update Homebrew tap
+        if: ${{ env.TAP_TOKEN != '' }}
+        env:
+          TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          BASE_URL="https://github.com/${{ github.repository }}/releases/download/${{ github.event.release.tag_name }}"
+
+          SHA_ARM64=$(curl -sL "$BASE_URL/dualentry-macos-arm64" | shasum -a 256 | cut -d' ' -f1)
+          SHA_X86_64=$(curl -sL "$BASE_URL/dualentry-macos-x86_64" | shasum -a 256 | cut -d' ' -f1)
+          SHA_LINUX=$(curl -sL "$BASE_URL/dualentry-linux-x86_64" | shasum -a 256 | cut -d' ' -f1)
+
+          cat > /tmp/dualentry.rb <<'FORMULA'
+          class Dualentry < Formula
+            desc "DualEntry accounting CLI"
+            homepage "https://github.com/dualentry/dualentry-cli"
+            version "VERSION_PLACEHOLDER"
+
+            on_macos do
+              if Hardware::CPU.arm?
+                url "URL_PLACEHOLDER/dualentry-macos-arm64"
+                sha256 "SHA_ARM64_PLACEHOLDER"
+              else
+                url "URL_PLACEHOLDER/dualentry-macos-x86_64"
+                sha256 "SHA_X86_64_PLACEHOLDER"
+              end
+            end
+
+            on_linux do
+              url "URL_PLACEHOLDER/dualentry-linux-x86_64"
+              sha256 "SHA_LINUX_PLACEHOLDER"
+            end
+
+            def install
+              binary = Dir["dualentry-*"].first || "dualentry"
+              bin.install binary => "dualentry"
+            end
+
+            test do
+              assert_match "dualentry-cli", shell_output("#{bin}/dualentry --version")
+            end
+          end
+          FORMULA
+
+          # Substitute placeholders and strip leading whitespace
+          sed -i "s|VERSION_PLACEHOLDER|$VERSION|g" /tmp/dualentry.rb
+          sed -i "s|URL_PLACEHOLDER|$BASE_URL|g" /tmp/dualentry.rb
+          sed -i "s|SHA_ARM64_PLACEHOLDER|$SHA_ARM64|g" /tmp/dualentry.rb
+          sed -i "s|SHA_X86_64_PLACEHOLDER|$SHA_X86_64|g" /tmp/dualentry.rb
+          sed -i "s|SHA_LINUX_PLACEHOLDER|$SHA_LINUX|g" /tmp/dualentry.rb
+          sed -i 's/^          //' /tmp/dualentry.rb
+
+          git clone "https://x-access-token:${TAP_TOKEN}@github.com/dualentry/homebrew-tap.git" /tmp/tap
+          mkdir -p /tmp/tap/Formula
+          cp /tmp/dualentry.rb /tmp/tap/Formula/dualentry.rb
+          cd /tmp/tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/dualentry.rb
+          git commit -m "Update dualentry to $VERSION"
+          git push

.gitignore

@@ -6,3 +6,4 @@ dist/
 build/
 .eggs/
 uv.lock
+*.spec

CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## [0.1.0] - 2026-03-31
+
+- OAuth browser login with API key storage in system keychain
+- List, get, create, and update for all transaction types
+- Table and JSON output formats
+- Pagination, search, and date/status filtering
+- Homebrew tap and install script distribution

README.md

@@ -6,7 +6,7 @@
 
 **Automate your accounting workflows from the command line.**
 
-The DualEntry CLI brings the full power of the DualEntry API to your terminal. Create invoices, sync transactions, and manage your books—all without leaving your workflow.
+The DualEntry CLI brings the full power of the DualEntry API to your terminal. Create invoices, sync transactions, and manage your books: all without leaving your workflow.
 
 ## Why DualEntry CLI?
 
@@ -19,10 +19,22 @@ The DualEntry CLI brings the full power of the DualEntry API to your terminal. C
 
 ### Install
 
+```bash
+brew install dualentry/tap/dualentry
+```
+
+Or with uv:
+
 ```bash
 uv tool install git+https://github.com/dualentry/dualentry-cli.git
 ```
 
+Or via the install script:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/dualentry/dualentry-cli/main/install.sh | sh
+```
+
 ### Authenticate
 
 ```bash
@@ -88,14 +100,16 @@ dualentry invoices list --all
 ## Configuration
 
 ```bash
-# View current settings
 dualentry config show
-
-# Switch environments
-dualentry config set-env dev    # Development
-dualentry config set-env prod   # Production
 ```
 
+**Environment variables** (override config file):
+
+| Variable | Description |
+|----------|-------------|
+| `DUALENTRY_API_URL` | API base URL (overrides config) |
+| `X_API_KEY` | API key (skips OAuth) |
+
 ## Requirements
 
 - Python 3.11+
@@ -107,6 +121,34 @@ dualentry config set-env prod   # Production
 uv tool upgrade dualentry-cli
 ```
 
+## Development
+
+### Setup
+
+```bash
+uv sync --dev
+uv run pre-commit install
+```
+
+### Linting
+
+```bash
+uv run ruff check .
+uv run ruff format --check .
+```
+
+### Tests
+
+```bash
+uv run pytest
+```
+
+With coverage:
+
+```bash
+uv run pytest --cov=dualentry_cli --cov-report=term-missing
+```
+
 ## Documentation
 
 - [API Reference](https://docs.dualentry.com/api)

install.sh

@@ -1,28 +1,57 @@
-#!/usr/bin/env bash
-set -euo pipefail
+#!/bin/sh
+set -e
 
-# DualEntry CLI installer
-# Usage: curl -sSL <raw-url>/install.sh | bash
+REPO="dualentry/dualentry-cli"
+INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
 
-REPO="git+https://github.com/dualentry/dualentry-cli.git"
-TOOL_NAME="dualentry-cli"
+get_arch() {
+  case "$(uname -m)" in
+    x86_64|amd64) echo "x86_64" ;;
+    arm64|aarch64) echo "arm64" ;;
+    *) echo "Unsupported architecture: $(uname -m)" >&2; exit 1 ;;
+  esac
+}
 
-echo "Installing DualEntry CLI..."
+get_os() {
+  case "$(uname -s)" in
+    Darwin) echo "macos" ;;
+    Linux) echo "linux" ;;
+    *) echo "Unsupported OS: $(uname -s)" >&2; exit 1 ;;
+  esac
+}
 
-# Prefer uv, fall back to pipx
-if command -v uv &>/dev/null; then
-    echo "Using uv..."
-    uv tool install "$REPO"
-elif command -v pipx &>/dev/null; then
-    echo "Using pipx..."
-    pipx install "$REPO"
+OS=$(get_os)
+ARCH=$(get_arch)
+TARGET="${OS}-${ARCH}"
+
+if [ "$OS" = "linux" ] && [ "$ARCH" = "arm64" ]; then
+  echo "Linux arm64 is not currently supported." >&2
+  exit 1
+fi
+
+echo "Detecting latest release..."
+LATEST=$(curl -s "https://api.github.com/repos/${REPO}/releases/latest" | grep '"tag_name"' | sed 's/.*: "//;s/".*//')
+
+if [ -z "$LATEST" ]; then
+  echo "Failed to detect latest release." >&2
+  exit 1
+fi
+
+URL="https://github.com/${REPO}/releases/download/${LATEST}/dualentry-${TARGET}"
+TMPFILE=$(mktemp)
+
+echo "Downloading dualentry ${LATEST} for ${TARGET}..."
+curl -fSL "$URL" -o "$TMPFILE"
+
+chmod +x "$TMPFILE"
+mkdir -p "$INSTALL_DIR"
+
+if [ -w "$INSTALL_DIR" ]; then
+  mv "$TMPFILE" "$INSTALL_DIR/dualentry"
 else
-    echo "Error: requires uv or pipx"
-    echo ""
-    echo "Install uv:   curl -LsSf https://astral.sh/uv/install.sh | sh"
-    echo "Install pipx: brew install pipx && pipx ensurepath"
-    exit 1
+  echo "Installing to ${INSTALL_DIR} (requires sudo)..."
+  sudo mv "$TMPFILE" "$INSTALL_DIR/dualentry"
 fi
 
-echo ""
-echo "Installed! Run: dualentry auth login"
+echo "Installed dualentry to ${INSTALL_DIR}/dualentry"
+echo "Run 'dualentry --help' to get started."

pyproject.toml

@@ -23,16 +23,6 @@ packages = ["src/dualentry_cli"]
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 
-[project.optional-dependencies]
-dev = [
-    "pytest>=8.0",
-    "pytest-cov>=6.0",
-    "pytest-mock>=3.14",
-    "respx>=0.21",
-    "ruff>=0.11.11",
-    "pre-commit>=4.2",
-]
-
 [dependency-groups]
 dev = [
     "pytest>=8.0",
@@ -41,6 +31,7 @@ dev = [
     "respx>=0.21",
     "ruff>=0.11.11",
     "pre-commit>=4.2",
+    "pyinstaller>=6.0",
 ]
 
 # ── Ruff ───────────────────────────────────────────────────────────────
@@ -120,12 +111,14 @@ ignore = [
     "T201",
     "PLW0603",
     "PLW2901",
+    "PLR0912",
     "PLR0915",
     "F841",
     "SIM105",
 ]
 
 [tool.ruff.lint.per-file-ignores]
+"scripts/*" = ["INP001", "S603"]
 "tests/*" = [
     "S101",
     "S105",