mct-cli 0.2.3__tar.gz

mct_cli-0.2.3/.github/workflows/release.yml

@@ -0,0 +1,176 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to release (e.g., v0.2.1)"
+        required: true
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version-file: ".python-version"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Extract version from tag
+        id: version
+        run: |
+          # Use input tag for manual dispatch, otherwise use ref name
+          TAG="${{ inputs.tag || github.ref_name }}"
+          VERSION="${TAG#v}"
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Validate version matches pyproject.toml
+        run: |
+          EXPECTED="${{ steps.version.outputs.version }}"
+          ACTUAL=$(grep -E "^version\s*=" pyproject.toml | sed -E 's/.*"([^"]+)".*/\1/')
+
+          if [ "$ACTUAL" != "$EXPECTED" ]; then
+            echo "Error: Tag version ($EXPECTED) doesn't match pyproject.toml ($ACTUAL)"
+            exit 1
+          fi
+          echo "Version validated: $EXPECTED"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: uv publish
+
+      - name: Generate release notes
+        run: |
+          cat > release_notes.md << 'EOF'
+          ## Installation
+
+          ### Homebrew (recommended)
+          ```bash
+          brew tap ocolunga/mct-cli
+          brew install mct-cli
+          ```
+
+          ### pip
+          ```bash
+          pip install mct-cli
+          ```
+
+          ### uv
+          ```bash
+          uv tool install mct-cli
+          ```
+          EOF
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: "v${{ steps.version.outputs.version }}"
+          body_path: release_notes.md
+          files: |
+            dist/*.whl
+            dist/*.tar.gz
+
+  update-homebrew:
+    needs: release
+    runs-on: macos-latest
+
+    steps:
+      - name: Extract version from tag
+        id: version
+        run: |
+          TAG="${{ inputs.tag || github.ref_name }}"
+          VERSION="${TAG#v}"
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+      - name: Wait for PyPI availability
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          echo "Waiting for mct-cli==$VERSION to be available on PyPI..."
+          for i in {1..30}; do
+            if curl -s "https://pypi.org/pypi/mct-cli/$VERSION/json" | grep -q '"version"'; then
+              echo "Package available on PyPI"
+              exit 0
+            fi
+            echo "Waiting for PyPI... ($i/30)"
+            sleep 10
+          done
+          echo "Warning: Timed out waiting for PyPI, continuing anyway..."
+
+      - name: Set up Homebrew
+        uses: Homebrew/actions/setup-homebrew@master
+
+      - name: Get PyPI package URL and SHA256
+        id: pypi
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          # Fetch package info from PyPI
+          PYPI_JSON=$(curl -s "https://pypi.org/pypi/mct-cli/$VERSION/json")
+
+          # Extract the sdist (source distribution) URL and SHA256
+          URL=$(echo "$PYPI_JSON" | python3 -c "import sys, json; urls = json.load(sys.stdin)['urls']; sdist = next(u for u in urls if u['packagetype'] == 'sdist'); print(sdist['url'])")
+          SHA256=$(echo "$PYPI_JSON" | python3 -c "import sys, json; urls = json.load(sys.stdin)['urls']; sdist = next(u for u in urls if u['packagetype'] == 'sdist'); print(sdist['digests']['sha256'])")
+
+          echo "url=$URL" >> $GITHUB_OUTPUT
+          echo "sha256=$SHA256" >> $GITHUB_OUTPUT
+          echo "Package URL: $URL"
+          echo "SHA256: $SHA256"
+
+      - name: Tap and update formula
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+          SHA256="${{ steps.pypi.outputs.sha256 }}"
+          URL="${{ steps.pypi.outputs.url }}"
+
+          # Tap the repo (installs to proper Homebrew location)
+          brew tap ocolunga/mct-cli
+
+          # Get the tap directory
+          TAP_DIR="$(brew --prefix)/Library/Taps/ocolunga/homebrew-mct-cli"
+          FORMULA="$TAP_DIR/Formula/mct-cli.rb"
+
+          # Update URL and SHA256
+          sed -i '' "s|url \".*\"|url \"${URL}\"|" "$FORMULA"
+          sed -i '' "s|sha256 \".*\"|sha256 \"${SHA256}\"|" "$FORMULA"
+
+          echo "Updated formula:"
+          cat "$FORMULA"
+
+      - name: Update Python resource dependencies
+        run: |
+          echo "Updating Python resources..."
+          brew update-python-resources ocolunga/mct-cli/mct-cli
+          echo "Resources updated successfully"
+
+      - name: Commit and push
+        env:
+          HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+        run: |
+          TAP_DIR="$(brew --prefix)/Library/Taps/ocolunga/homebrew-mct-cli"
+          cd "$TAP_DIR"
+
+          # Configure git with token for push
+          git remote set-url origin "https://x-access-token:${HOMEBREW_TAP_TOKEN}@github.com/ocolunga/homebrew-mct-cli.git"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git add Formula/mct-cli.rb
+          git diff --staged --quiet || git commit -m "Update mct-cli to ${{ steps.version.outputs.version }}"
+          git push

mct_cli-0.2.3/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+*.egg
+.installed.cfg
+MANIFEST
+
+# Build / Distribution
+build/
+dist/
+sdist/
+wheels/
+share/python-wheels/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+var/
+
+# Virtual Environment
+venv/
+.venv/
+env/
+.env
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.DS_Store
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+.tox/
+
+# Type checking / Linting
+.mypy_cache/
+.ruff_cache/

mct_cli-0.2.3/.python-version

@@ -0,0 +1 @@
+3.13

mct_cli-0.2.3/CLAUDE.md

@@ -0,0 +1,68 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+mct (macOS Configuration Tools) is a declarative CLI tool for managing macOS settings, inspired by nix-darwin. It uses Typer for the CLI framework and subprocess calls to `defaults` for modifying macOS preferences.
+
+## Development Commands
+
+```bash
+# Install dependencies (uses uv)
+uv sync --group dev
+
+# Run the CLI
+uv run mct --help
+
+# Type checking (ty)
+uv run ty check src/
+
+# Linting and formatting (ruff)
+uv run ruff check src/
+uv run ruff format src/
+```
+
+## Architecture
+
+### Core Modules
+
+- `src/mct/cli.py` - Main entry point, registers command groups and declarative commands (apply, export, diff, init, settings)
+- `src/mct/config.py` - Configuration management: YAML loading/saving, settings registry, diff computation
+- `src/mct/defaults.py` - Low-level helper for macOS `defaults` read/write/delete operations
+
+### Command Groups
+
+Each file in `src/mct/commands/` exports a `typer.Typer()` instance registered in `cli.py`:
+- `dock.py` - Dock settings (size, auto-hide, lock)
+- `finder.py` - Finder settings (extensions, hidden files, path bar, view style)
+- `keyboard.py` - Keyboard settings (key hold/repeat)
+- `screenshot.py` - Screenshot settings (location, format, shadow)
+- `system.py` - System settings (Touch ID for sudo)
+
+### Settings Registry
+
+All declarative settings are defined in `config.py` in the `SETTINGS` dict. Each setting specifies:
+- `domain`: The macOS defaults domain (e.g., `com.apple.dock`)
+- `key`: The defaults key
+- `value_type`: Type hint (`bool`, `int`, `float`, `string`)
+- `restart_app`: App to restart after changing (e.g., `Dock`, `Finder`)
+
+### Adding New Settings
+
+1. Add the setting to `SETTINGS` dict in `config.py`
+2. Optionally add an imperative command in the appropriate `commands/*.py` file
+
+### Config File
+
+Users can define desired state in `~/.config/mct/config.yaml`:
+```yaml
+dock:
+  size: 48
+  autohide: true
+finder:
+  show_extensions: true
+  show_path_bar: true
+```
+
+Then apply with `mct apply` or preview changes with `mct diff`.

mct_cli-0.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

mct_cli-0.2.3/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: mct-cli
+Version: 0.2.3
+Summary: macOS Configuration Tools
+Author-email: Oscar Colunga <oscar@ancile.dev>
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# macOS Configuration Tools (mct)
+
+A personal collection of CLI tools for managing macOS settings through a simple, intuitive interface.
+
+## Features
+
+Currently implemented:
+
+### General
+- Check version: `mct --version` or `mct -v` - Display the installed version
+
+### Dock Management
+- Set dock size: `mct dock size <value>` (32-128)
+- Show current dock size: `mct dock size`
+- Auto-hide controls:
+  - `mct dock hide` - Enable auto-hide
+  - `mct dock show` - Disable auto-hide
+- Size lock controls:
+  - `mct dock lock` - Lock dock size
+  - `mct dock unlock` - Unlock dock size
+- Reset options:
+  - `mct dock reset -s` - Reset size to default (64)
+  - `mct dock reset -h` - Reset auto-hide to default (disabled)
+  - `mct dock reset -l` - Reset size lock to default (unlocked)
+  - `mct dock reset -a` - Reset all dock settings
+  
+### Keyboard Management
+- Key repeat controls:
+  - `mct keyboard hold` - Enable press-and-hold for accented characters
+  - `mct keyboard repeat` - Enable key repeat (disables accents)
+- Reset options:
+  - `mct keyboard reset -h` - Reset key hold to default (enabled)
+  - `mct keyboard reset -a` - Reset all keyboard settings
+
+### System Management
+- Touch ID for sudo:
+  - `mct system touchid` - Enable Touch ID authentication for sudo with interactive backup management
+  - `mct system reset -t` - Reset Touch ID sudo configuration from backup
+  - `mct system reset -a` - Reset all system settings to defaults
+
+Planned features:
+- Configuration file support (`~/.config/mct/config.toml`) for:
+  - Setting default values for commands
+  - Storing preferred configurations
+  - Batch applying multiple settings at once
+  - Example configuration:
+    ```toml
+    [dock]
+    default_size = 48
+    auto_hide = true
+    size_locked = false
+
+    [keyboard]
+    key_hold = true
+
+    [system]
+    touch_id_sudo = true
+    ```
+- More dock management options
+- System preferences management
+- And more...
+
+## Installation
+
+### Using Homebrew (recommended)
+```bash
+# Add the tap repository
+brew tap ocolunga/mct-cli
+
+# Install mct-cli
+brew install mct-cli
+```
+
+### Using pip
+```bash
+pip install mct-cli
+```
+
+### Using uv
+```bash
+uv tool install mct-cli
+```
+
+### From source
+```bash
+git clone https://github.com/ocolunga/mct.git
+cd mct
+uv sync
+uv run mct --help
+```
+
+## Usage Examples
+
+```bash
+# Show help
+mct --help
+mct dock --help
+mct keyboard --help
+mct system --help
+
+# Check version
+mct --version
+
+# Dock Examples
+mct dock size 48          # Set dock size to 48
+mct dock size            # Show current dock size
+mct dock hide           # Enable auto-hide
+mct dock show           # Disable auto-hide
+mct dock lock           # Lock dock size
+mct dock unlock         # Unlock dock size
+mct dock reset -s -h    # Reset both size and auto-hide
+
+# Keyboard Examples
+mct keyboard hold      # Enable press-and-hold for accents
+mct keyboard repeat    # Enable key repeat (disable accents)
+mct keyboard reset -a  # Reset all keyboard settings
+
+# System Examples
+mct system touchid           # Enable Touch ID for sudo with interactive backup
+mct system reset -t         # Reset Touch ID sudo configuration from backup
+mct system reset -a         # Reset all system settings to defaults
+```
+
+Note: Some commands may require restarting applications to take effect.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

mct_cli-0.2.3/README.md

@@ -0,0 +1,128 @@
+# macOS Configuration Tools (mct)
+
+A personal collection of CLI tools for managing macOS settings through a simple, intuitive interface.
+
+## Features
+
+Currently implemented:
+
+### General
+- Check version: `mct --version` or `mct -v` - Display the installed version
+
+### Dock Management
+- Set dock size: `mct dock size <value>` (32-128)
+- Show current dock size: `mct dock size`
+- Auto-hide controls:
+  - `mct dock hide` - Enable auto-hide
+  - `mct dock show` - Disable auto-hide
+- Size lock controls:
+  - `mct dock lock` - Lock dock size
+  - `mct dock unlock` - Unlock dock size
+- Reset options:
+  - `mct dock reset -s` - Reset size to default (64)
+  - `mct dock reset -h` - Reset auto-hide to default (disabled)
+  - `mct dock reset -l` - Reset size lock to default (unlocked)
+  - `mct dock reset -a` - Reset all dock settings
+  
+### Keyboard Management
+- Key repeat controls:
+  - `mct keyboard hold` - Enable press-and-hold for accented characters
+  - `mct keyboard repeat` - Enable key repeat (disables accents)
+- Reset options:
+  - `mct keyboard reset -h` - Reset key hold to default (enabled)
+  - `mct keyboard reset -a` - Reset all keyboard settings
+
+### System Management
+- Touch ID for sudo:
+  - `mct system touchid` - Enable Touch ID authentication for sudo with interactive backup management
+  - `mct system reset -t` - Reset Touch ID sudo configuration from backup
+  - `mct system reset -a` - Reset all system settings to defaults
+
+Planned features:
+- Configuration file support (`~/.config/mct/config.toml`) for:
+  - Setting default values for commands
+  - Storing preferred configurations
+  - Batch applying multiple settings at once
+  - Example configuration:
+    ```toml
+    [dock]
+    default_size = 48
+    auto_hide = true
+    size_locked = false
+
+    [keyboard]
+    key_hold = true
+
+    [system]
+    touch_id_sudo = true
+    ```
+- More dock management options
+- System preferences management
+- And more...
+
+## Installation
+
+### Using Homebrew (recommended)
+```bash
+# Add the tap repository
+brew tap ocolunga/mct-cli
+
+# Install mct-cli
+brew install mct-cli
+```
+
+### Using pip
+```bash
+pip install mct-cli
+```
+
+### Using uv
+```bash
+uv tool install mct-cli
+```
+
+### From source
+```bash
+git clone https://github.com/ocolunga/mct.git
+cd mct
+uv sync
+uv run mct --help
+```
+
+## Usage Examples
+
+```bash
+# Show help
+mct --help
+mct dock --help
+mct keyboard --help
+mct system --help
+
+# Check version
+mct --version
+
+# Dock Examples
+mct dock size 48          # Set dock size to 48
+mct dock size            # Show current dock size
+mct dock hide           # Enable auto-hide
+mct dock show           # Disable auto-hide
+mct dock lock           # Lock dock size
+mct dock unlock         # Unlock dock size
+mct dock reset -s -h    # Reset both size and auto-hide
+
+# Keyboard Examples
+mct keyboard hold      # Enable press-and-hold for accents
+mct keyboard repeat    # Enable key repeat (disable accents)
+mct keyboard reset -a  # Reset all keyboard settings
+
+# System Examples
+mct system touchid           # Enable Touch ID for sudo with interactive backup
+mct system reset -t         # Reset Touch ID sudo configuration from backup
+mct system reset -a         # Reset all system settings to defaults
+```
+
+Note: Some commands may require restarting applications to take effect.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

mct_cli-0.2.3/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "mct-cli"
+version = "0.2.3"
+authors = [{ name = "Oscar Colunga", email = "oscar@ancile.dev" }]
+description = "macOS Configuration Tools"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = ["typer>=0.9.0", "pyyaml>=6.0"]
+
+[dependency-groups]
+dev = [
+ "ruff>=0.11.4",
+ "ty>=0.0.12",
+]
+
+[project.scripts]
+mct = "mct.cli:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mct"]

mct_cli-0.2.3/src/mct/__init__.py

@@ -0,0 +1,5 @@
+"""macOS Configuration Tools - A CLI for managing macOS settings declaratively."""
+
+from importlib.metadata import version
+
+__version__ = version("macos-config-tools")