smugmug-cli 0.5.0

A command-line tool for uploading photos to SmugMug with deduplication
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# GitHub Actions Workflows

## docker-publish.yml

Builds and publishes multi-architecture Docker images to GitHub Container Registry (ghcr.io).

### Triggers

- **Version tags** (e.g., `0.2.1`): Builds and publishes images (matches binary release workflow)
- **Pull requests**: Builds only for validation (doesn't publish)
- **Manual dispatch**: Can be triggered manually from GitHub Actions UI

### Image Tags

When you push a version tag like `0.2.1`, the workflow creates:

- `latest` - Latest release version
- `0.2.1` - Full semantic version
- `0.2` - Major.minor version
- `0` - Major version only

For pull requests (validation only, not published):
- `pr-123` - Pull request number

### Platforms

Images are built for:
- `linux/amd64` (x86_64)
- `linux/arm64` (Apple Silicon, ARM servers)

### Features

- **Multi-stage build**: Minimal image size (~23MB)
- **Layer caching**: Uses GitHub Actions cache for faster builds
- **Build attestation**: Generates provenance for supply chain security
- **Non-root user**: Runs as UID 99, GID 100 by default (configurable via PUID/PGID)

### Using Published Images

```bash
# Pull latest
docker pull ghcr.io/jhofker/smugmug-cli:latest

# Pull specific version
docker pull ghcr.io/jhofker/smugmug-cli:0.2.1

# Run
docker run ghcr.io/jhofker/smugmug-cli:latest --version
```

### Publishing a New Release

Both the Docker images and binary releases are published when you push a version tag:

```bash
# Tag the release
git tag 0.2.2
git push origin 0.2.2

# Both workflows will run:
# 1. release.yml - Builds binaries and creates GitHub Release
# 2. docker-publish.yml - Builds and publishes Docker images to GHCR
```

### Permissions

The workflow requires:
- `contents: read` - Read repository contents
- `packages: write` - Push to GitHub Container Registry
- `id-token: write` - Generate attestations

## release.yml

Managed by [cargo-dist](https://github.com/axodotdev/cargo-dist). Builds and publishes native binaries for multiple platforms when version tags are pushed.