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
119
120
121
122
123
124
125
|
package examples
import (
"os"
. "codeberg.org/snonux/gonf/api"
. "codeberg.org/snonux/gonf/api/options"
)
func Run() error {
// 1. Regular file with content
File("/tmp/gonf_hello.txt", WithContent("Hello World!"))
// 2. Regular file from a source template
File("/tmp/gonf_example.conf", WithSource("assets/testfiles/test.tmpl"))
// 3. Regular file with specific mode and owner
File(
"/tmp/gonf_secret.txt",
WithContent("top secret"),
WithMode(0o600),
)
// 4. A directory
Dir("/tmp/gonf_dir", WithMode(0o755))
// 5. A symlink
Link("/tmp/gonf_link", WithSymlink("/tmp/gonf_hello.txt"))
// 6. A hardlink
Link("/tmp/gonf_hardlink", WithHardlink("/tmp/gonf_hello.txt"))
// 7. Ensuring something is absent (two equivalent styles; each resource
// path may only be declared once per run, so they use distinct paths)
File("/tmp/gonf_old.txt", IsAbsent)
NoFile("/tmp/gonf_old_alt.txt") // Alternative way
// 8. A directory tree copied from source, reconciled, with a distinct
// file mode from the directory's own mode
Dir(
"/tmp/gonf_dir_from_source",
WithSource("assets/testfiles"),
WithPrune,
WithFileMode(0o644),
)
// 9. Recursively removing a directory tree. Each resource path can only
// be declared once per run, so this pre-populates its own scratch tree
// (rather than reusing #8's path) to give WithPrune's recursive removal
// something real to demonstrate.
_ = os.MkdirAll("/tmp/gonf_stale_dir/nested", 0o755)
Dir("/tmp/gonf_stale_dir", IsAbsent, WithPrune)
_ = os.MkdirAll("/tmp/gonf_stale_dir_alt/nested", 0o755)
NoDir("/tmp/gonf_stale_dir_alt", WithPrune) // Alternative way
// 10. Non-recursively removing an empty directory
_ = os.Mkdir("/tmp/gonf_stale_empty_dir", 0o755)
Dir("/tmp/gonf_stale_empty_dir", IsAbsent)
// 11. Ensuring a symlink is absent
_ = os.Symlink("/tmp/gonf_hello.txt", "/tmp/gonf_stale_link")
Link("/tmp/gonf_stale_link", IsAbsent)
_ = os.Symlink("/tmp/gonf_hello.txt", "/tmp/gonf_stale_link_alt")
NoLink("/tmp/gonf_stale_link_alt") // Alternative way
// 12. Ensuring a hardlink is absent
_ = os.Link("/tmp/gonf_hello.txt", "/tmp/gonf_stale_hardlink")
Link("/tmp/gonf_stale_hardlink", IsAbsent)
// // 13. Package management
// Package("tig") // Ensure installed (Present)
// Package("vim", IsLatest) // Ensure installed and latest version
// NoPackage("nano") // Ensure absent
// 14. Multi-resource declarations
// Create multiple files with the same options
File(Elems(
"/tmp/gonf_multi1.txt",
"/tmp/gonf_multi2.txt",
), WithContent("Multi-file content"), WithMode(0o644))
// Create multiple directories
Dir(Elems(
"/tmp/gonf_multi_dir1",
"/tmp/gonf_multi_dir2",
), WithMode(0o755))
// Install multiple packages and ensure they are latest
// Package(Elems(
// "htop",
// "curl",
// "wget",
// ), IsLatest)
// // Remove multiple packages
// NoPackage(Elems(
// "old-pkg1",
// "old-pkg2",
// ))
// Remove multiple files
NoFile(Elems(
"/tmp/stale1.txt",
"/tmp/stale2.txt",
))
// 15. Ordering with DependsOn. bar.txt is only applied after foo.txt.
fooRes := File("/tmp/gonf_foo.txt", WithContent("foo"))
File("/tmp/gonf_bar.txt", WithContent("bar"), DependsOn(fooRes))
// DependsOn also accepts multi-resources; the dependent then waits for
// every individual member of the multi.
multiRes := File(Elems(
"/tmp/gonf_dep1.txt",
"/tmp/gonf_dep2.txt",
), WithContent("dep"))
File("/tmp/gonf_after_multi.txt", WithContent("after"), DependsOn(multiRes))
// DependsOn works across resource types and accepts several resources at
// once: this directory is created only after both the file and the multi
// above have been applied.
Dir("/tmp/gonf_after_dir", DependsOn(fooRes, multiRes))
return Apply()
}
|
