Charon
c340303314
## Summary - Extract PHP/Laravel commands to `core/php` repo (42 files, standalone module) - Extract CI/release + SDK commands to `core/ci` repo (10 files) - Remove `internal/variants/` build tag system entirely - Move all 30 remaining command packages from `internal/cmd/` to top-level `cmd/` - Rewrite `main.go` with direct imports — no more variant selection - PHP and CI are now optional via commented import lines in main.go Co-authored-by: Claude <developers@lethean.io> Reviewed-on: #2 Co-authored-by: Charon <charon@lthn.ai> Co-committed-by: Charon <charon@lthn.ai>
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# Configuration
|
|
|
|
The `updater` library is highly configurable via the `UpdateServiceConfig` struct.
|
|
|
|
## UpdateServiceConfig
|
|
|
|
When creating a new `UpdateService`, you pass a `UpdateServiceConfig` struct. Here are the available fields:
|
|
|
|
| Field | Type | Description |
|
|
| :--- | :--- | :--- |
|
|
| `RepoURL` | `string` | The URL to the repository for updates. Can be a GitHub repository URL (e.g., `https://github.com/owner/repo`) or a base URL for a generic HTTP update server. |
|
|
| `Channel` | `string` | Specifies the release channel to track (e.g., "stable", "prerelease"). This is **only used for GitHub-based updates**. |
|
|
| `CheckOnStartup` | `StartupCheckMode` | Determines the behavior when the service starts. See [Startup Modes](#startup-modes) below. |
|
|
| `ForceSemVerPrefix` | `bool` | Toggles whether to enforce a 'v' prefix on version tags for display and comparison. If `true`, a 'v' prefix is added if missing. |
|
|
| `ReleaseURLFormat` | `string` | A template for constructing the download URL for a release asset. The placeholder `{tag}` will be replaced with the release tag. |
|
|
|
|
### Startup Modes
|
|
|
|
The `CheckOnStartup` field can take one of the following values:
|
|
|
|
* `updater.NoCheck`: Disables any checks on startup.
|
|
* `updater.CheckOnStartup`: Checks for updates on startup but does not apply them.
|
|
* `updater.CheckAndUpdateOnStartup`: Checks for and applies updates on startup.
|
|
|
|
## CLI Flags
|
|
|
|
If you are using the example CLI provided in `cmd/updater`, the following flags are available:
|
|
|
|
* `--check-update`: Check for new updates without applying them.
|
|
* `--do-update`: Perform an update if available.
|
|
* `--channel`: Set the update channel (e.g., stable, beta, alpha). If not set, it's determined from the current version tag.
|
|
* `--force-semver-prefix`: Force 'v' prefix on semver tags (default `true`).
|
|
* `--release-url-format`: A URL format for release assets.
|
|
* `--pull-request`: Update to a specific pull request (integer ID).
|