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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
use schemars::JsonSchema;
use serde::{Deserialize, Serialize};
use super::super::{StringOrBool, deserialize_string_or_bool_opt};
use super::{CommitAuthorConfig, RepositoryConfig};
// ---------------------------------------------------------------------------
// NixConfig
// ---------------------------------------------------------------------------
#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema)]
#[serde(default, deny_unknown_fields)]
pub struct NixConfig {
/// Override the derivation name (default: crate name).
pub name: Option<String>,
/// Path for the .nix file in the repository (default: `pkgs/<name>/default.nix`).
pub path: Option<String>,
/// Unified repository config with branch, token, PR, git SSH support.
pub repository: Option<RepositoryConfig>,
/// Commit author with optional signing.
pub commit_author: Option<CommitAuthorConfig>,
/// Custom commit message template.
pub commit_msg_template: Option<String>,
/// Build IDs filter: only include artifacts whose `id` is in this list.
pub ids: Option<Vec<String>>,
/// Custom URL template for download URLs (overrides release URL).
pub url_template: Option<String>,
/// Skip publishing. `"true"` always skips; `"auto"` skips for prereleases.
/// Accepts bool or template string.
#[serde(deserialize_with = "deserialize_string_or_bool_opt", default)]
pub skip_upload: Option<StringOrBool>,
/// Skip this Nix config. Accepts bool or template string
/// (e.g. `"{{ if .IsSnapshot }}true{{ endif }}"` for conditional skip).
/// Distinct from `skip_upload` so users can model both intents — disable
/// means "don't generate at all", skip_upload means "generate but don't
/// push". Without this field, `nix: { skip: true }` was silently
/// dropped by the serde unknown-field default.
#[serde(deserialize_with = "deserialize_string_or_bool_opt", default)]
pub skip: Option<StringOrBool>,
/// Custom install commands (replaces auto-generated binary install).
pub install: Option<String>,
/// Additional install commands appended after the main install.
pub extra_install: Option<String>,
/// Post-install commands (postInstall phase).
pub post_install: Option<String>,
/// Short description of the Nix derivation.
pub description: Option<String>,
/// Project homepage URL.
pub homepage: Option<String>,
/// License for the derivation's `meta.license`. Accepts a nix
/// `lib.licenses` attribute (e.g. `mit`, `asl20`) or an SPDX expression
/// (e.g. `MIT`, `Apache-2.0`, `MIT OR Apache-2.0`). A known single id maps
/// to `lib.licenses.<attr>`; an `OR`/`AND` list of known ids maps to
/// `with lib.licenses; [ … ]`. An unknown id or an unparseable compound
/// (e.g. a `WITH` exception) degrades to a quoted-string `license` in
/// `meta` — never rejected, never an invalid attr-path. When unset, the
/// license is derived from the crate's `Cargo.toml [package].license`.
pub license: Option<String>,
/// nixpkgs maintainer handles (from `lib.maintainers`) rendered as
/// `maintainers = with lib.maintainers; [ alice bob ];` in the
/// derivation's `meta`. These are nixpkgs *handles* (e.g. `globin`,
/// `zowoq`), NOT `Name <email>` author strings — a nixpkgs review
/// rejects a derivation whose `meta.maintainers` is absent. When unset
/// the derivation still emits `maintainers = [ ];` (an empty-but-present
/// list is valid and clears the "field absent" rejection); a user fills
/// in their handle. Each entry is rendered verbatim as a Nix identifier,
/// so values must be valid `lib.maintainers` attribute names.
pub maintainers: Option<Vec<String>>,
/// URL for `meta.changelog`. When unset, anodizer derives
/// `<host>/<owner>/<repo>/releases/tag/<tag>` from the crate's `release`
/// repository and the release tag (matching what ripgrep/fd set in
/// nixpkgs). Set this to override (e.g. a `…/blob/<tag>/CHANGELOG.md`
/// URL). Templated. Omitted only when no release repo is configured and
/// no explicit value is given.
pub changelog: Option<String>,
/// Long-form description for `meta.longDescription`, rendered as a
/// multi-line `longDescription = '' … '';` block. Optional; omitted when
/// unset. Templated.
pub long_description: Option<String>,
/// Nix package dependencies with optional OS filtering.
pub dependencies: Option<Vec<NixDependency>>,
/// Nix formatter to run on the generated file: "alejandra" or "nixfmt".
pub formatter: Option<String>,
/// amd64 microarchitecture variant filter (e.g. "v1", "v2", "v3", "v4").
/// Only artifacts matching this variant are included. Default: "v1".
pub amd64_variant: Option<String>,
/// Value for `meta.mainProgram` in the generated Nix derivation.
/// When set, the rendered derivation includes
/// `mainProgram = "<value>";` inside the `meta` block, telling Nix
/// which binary `nix run` should execute when the derivation
/// contains multiple executables. Templated: supports
/// `{{ Version }}` etc. Omitted when unset.
pub main_program: Option<String>,
/// Override whether this publisher failing should fail the overall release.
///
/// Default: `false` — a failure here is logged but does not abort the release.
/// Set to `true` to fail the release on any error.
#[serde(default, skip_serializing_if = "Option::is_none")]
pub required: Option<bool>,
/// Template-conditional gate: when the rendered result is falsy
/// (`"false"` / `"0"` / `"no"` / empty), the Nix publisher is
/// skipped. Render failure hard-errors. Config key: `nix[].if:`.
#[serde(rename = "if")]
pub if_condition: Option<String>,
/// When `true`, a triggered rollback leaves this publisher's work in
/// place rather than attempting to undo it. Default `false`.
pub retain_on_rollback: Option<bool>,
}
/// Nix package dependency with optional OS restriction.
#[derive(Debug, Clone, Serialize, Deserialize, Default, JsonSchema)]
#[serde(default, deny_unknown_fields)]
pub struct NixDependency {
/// Nix attribute path for the dependency (e.g., "openssl", "pkgs.libgit2").
pub name: String,
/// OS restriction: "linux", "darwin", or empty for all.
pub os: Option<String>,
}