feat: aur backup (#3366)

closes #3353

internal/pipe/aur/aur.go

@@ -292,6 +292,7 @@ func dataFor(ctx *context.Context, cfg config.AUR, cl client.Client, artifacts [
 		Contributors: cfg.Contributors,
 		Provides:     cfg.Provides,
 		Conflicts:    cfg.Conflicts,
+		Backup:       cfg.Backup,
 		Depends:      cfg.Depends,
 		OptDepends:   cfg.OptDepends,
 		Package:      cfg.Package,

internal/pipe/aur/aur_test.go

@@ -33,6 +33,10 @@ func createTemplateData() templateData {
 		Rel:        "1",
 		Provides:   []string{"test"},
 		OptDepends: []string{"nfpm"},
+		Backup: []string{
+			"/etc/mypkg.conf",
+			"/var/share/mypkg",
+		},
 		Maintainers: []string{
 			"Ciclano <ciclano@example.com>",
 			"Cicrano <cicrano@example.com>",

internal/pipe/aur/testdata/TestFullAur.golden

@@ -15,6 +15,7 @@ provides=('test')
 conflicts=('nope')
 depends=('nope')
 optdepends=('nfpm')
+backup=('/etc/mypkg.conf' '/var/share/mypkg')
 
 source_x86_64=("${pkgname}_${pkgver}_x86_64.tar.gz::https://github.com/caarlos0/test/releases/download/v0.1.3/test_Linux_x86_64.tar.gz")
 sha256sums_x86_64=('1633f61598ab0791e213135923624eb342196b3494909c91899bcd0560f84c67')

internal/pipe/aur/tmpl.go

@@ -11,6 +11,7 @@ type templateData struct {
 	Contributors    []string
 	Provides        []string
 	Conflicts       []string
+	Backup          []string
 	Depends         []string
 	OptDepends      []string
 	Arches          []string
@@ -53,6 +54,9 @@ depends=({{ pkgArray . }})
 {{- with .OptDepends }}
 optdepends=({{ pkgArray . }})
 {{- end }}
+{{- with .Backup }}
+backup=({{ pkgArray . }})
+{{- end }}
 
 {{ range .ReleasePackages -}}
 source_{{ .Arch }}=("${pkgname}_${pkgver}_{{ .Arch }}.{{ .Format }}::{{ .DownloadURL }}")

pkg/config/config.go

@@ -140,6 +140,7 @@ type AUR struct {
 	Conflicts             []string     `yaml:"conflicts,omitempty" json:"conflicts,omitempty"`
 	Depends               []string     `yaml:"depends,omitempty" json:"depends,omitempty"`
 	OptDepends            []string     `yaml:"optdepends,omitempty" json:"optdepends,omitempty"`
+	Backup                []string     `yaml:"backup,omitempty" json:"backup,omitempty"`
 	Rel                   string       `yaml:"rel,omitempty" json:"rel,omitempty"`
 	Package               string       `yaml:"package,omitempty" json:"package,omitempty"`
 	GitURL                string       `yaml:"git_url,omitempty" json:"git_url,omitempty"`

www/docs/customization/aur.md

@@ -101,6 +101,14 @@ aurs:
     optdepends:
       - 'wget: for downloading things'
 
+    # List of files that can contain user-made changes and should be preserved
+    # during package upgrades and removals.
+    #
+    # Default: empty.
+    # Since: v1.12
+    backup:
+      - /etc/foo.conf
+
     # Custom package instructions.
     #
     # Defaults to `install -Dm755 "./PROJECT_NAME" "${pkgdir}/usr/bin/PROJECT_NAME",