about summary refs log blame commit diff stats
path: root/leo.1
blob: 74637f93481608c0120581e257a234a82b554f55 (plain) (tree) 
04da16d ^

























































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

























































                                                                      
.TH LEO 1 "14 November 2020" "v0.4.0"

.SH NAME
leo \- a simple backup program

.SH SYNOPSIS
.B leo
[--help] [--version] [--verbose] profiles
.P

.SH DESRIPTION
.B leo
is a simple backup program. It creates tar(1) files from a pre-defined
list. It can encrypt/sign files with gpg2(1) & sign files with
signify(1).

I use this to quickly backup some of my files. It works on profiles,
profiles are simple lists of files which get backed up.
.SH PROFILE
Profile is a simple hash table which contains the list of profiles.
The profiles are mapped to a list of file paths which are to be backed
up.
.SH OPTIONS
The options are as follows:
.TP
.B --verbose
Verbose output. This flag will be passed to commands that leo
executes.
.TP
.BI --version
Print version.
.TP
.B --help
Print help. This will also print list of profiles with their
configuration.
.SH ENVIRONMENT VARIABLES
As shown in examples below, environment variables can be used to
configure leo.

Available options are:
.B L_ENCRYPT
.B L_SIGN
.B L_SIGNIFY
.B L_GZIP
.SH EXAMPLES
.TP
.B leo journal emacs
Backup `journal' & `emacs' profile.
.TP
.B L_ENCRYPT=1 leo journal
Backup `journal' & encrypt it. This encrypt option can be over-ridden
by the config file.
.SH BUGS
It'll set the tar & gpg output file's mode to 0600 & there is no way
to configure that.
.SH AUTHOR
Andinus <andinus@nand.sh>
generated by cgit-pink 1.4.1-2-gfad0 (git 2.36.2.497.gbbea4dcf42) at 2024-11-24 21:20:13 +0000
&id=2e00a9c288e9622656189f9c48d40c5e1f17ab98'>^ 
72d104d1 ^


6e05a8fa ^

72d104d1 ^





6e05a8fa ^

72d104d1 ^

2c51a464 ^

966daf14 ^

966daf14 ^

2e00a9c2 ^

966daf14 ^



a7008328 ^








72d104d1 ^

966daf14 ^





74f1512f ^

966daf14 ^


2e00a9c2 ^




966daf14 ^







2c51a464 ^

3640f1df ^



6e05a8fa ^





2c51a464 ^

6e05a8fa ^

966daf14 ^

6e05a8fa ^

966daf14 ^

6e05a8fa ^

2c51a464 ^

966daf14 ^

6e05a8fa ^

966daf14 ^

6e05a8fa ^

966daf14 ^

2c51a464 ^






6e05a8fa ^


2c51a464 ^


72d104d1 ^

2c51a464 ^




72d104d1 ^


6e05a8fa ^

72d104d1 ^





6e05a8fa ^

72d104d1 ^

2c51a464 ^







72d104d1 ^

2c51a464 ^




72d104d1 ^


6e05a8fa ^

72d104d1 ^








2c51a464 ^

966daf14 ^

966daf14 ^


2e00a9c2 ^

966daf14 ^





1d7aae96 ^




2e00a9c2 ^




1d7aae96 ^







2c51a464 ^

3640f1df ^



6e05a8fa ^





2c51a464 ^

6e05a8fa ^

1d7aae96 ^

6e05a8fa ^

1d7aae96 ^

2c51a464 ^


1d7aae96 ^

6e05a8fa ^

1d7aae96 ^

6e05a8fa ^

1d7aae96 ^

2c51a464 ^






6e05a8fa ^


2c51a464 ^


72d104d1 ^

2c51a464 ^




72d104d1 ^


6e05a8fa ^

72d104d1 ^





6e05a8fa ^

72d104d1 ^

2c51a464 ^








72d104d1 ^

2c51a464 ^




72d104d1 ^


6e05a8fa ^

72d104d1 ^








2c51a464 ^

1d7aae96 ^

1d7aae96 ^


2e00a9c2 ^

1d7aae96 ^





a99775b4 ^







2e00a9c2 ^


8cff44fe ^

2e00a9c2 ^

a99775b4 ^








2c51a464 ^

3640f1df ^



2c51a464 ^











72d104d1 ^







2c51a464 ^




a99775b4 ^

2c51a464 ^

8cff44fe ^

72d104d1 ^









cec5ef31 ^

a99775b4 ^

a99775b4 ^

2e00a9c2 ^

a99775b4 ^



8cff44fe ^








72d104d1 ^

a99775b4 ^


a51bc7a1 ^

2e00a9c2 ^


f5ece045 ^

8e182e39 ^

1d7aae96 ^



a99775b4 ^

a51bc7a1 ^

966daf14 ^

a51bc7a1 ^

2e00a9c2 ^


f5ece045 ^

1d7aae96 ^



a99775b4 ^

a51bc7a1 ^

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

126
127

128

129
130
131
132
133

134

135

136
137
138
139
140
141
142

143

144
145
146
147

148
149

150

151
152
153
154
155
156
157
158

159

160

161
162

163

164
165
166
167
168

169
170
171
172

173
174
175
176

177
178
179
180
181
182
183

184

185
186
187

188
189
190
191
192

193

194

195

196

197

198
199

200

201

202

203

204

205
206
207
208
209
210

211
212

213
214

215

216
217
218
219

220
221

222

223
224
225
226
227

228

229

230
231
232
233
234
235
236
237

238

239
240
241
242

243
244

245

246
247
248
249
250
251
252
253

254

255

256
257

258

259
260
261
262
263

264
265
266
267
268
269
270

271
272

273

274

275
276
277
278
279
280
281
282

283

284
285
286

287
288
289
290
291
292
293
294
295
296
297

298
299
300
301
302
303
304

305
306
307
308

309

310

311

312
313
314
315
316
317
318
319
320

321

322

323

324

325
326
327

328
329
330
331
332
333
334
335

336

337
338

339

340
341

342

343

344
345
346

347

348

349

350

351
352

353

354
355
356

357

358







                                                                                                        
                                                     

 

                                                                                                                      
                                      

                                                                                         






                                                  
     


                                                                            

                                                                        
                                                                 
                                                                                

                                                 
                                                                   
         
                                           
                     
                      

                                                             

                                                 


                                  

                                                                                                                 
                                                                                              




                                                                                                                     
                                                                            
                                                                                                      
                                                        
       
     
                      


               







                                                      
                                                                                                




                                                                                                                          
                                                                  

 



                                                                                                                                        






                                                  
     


                                                                            




                                                                                 
                                                      
                                                                   
         
                                           
                     
                      
                                                                  
         
                                                                  
         
                                           
                     





                                                                   

                                                   

                       
                                                                                                          



                                                                   

                                                                                                                   
                                                                                                




                                                                                                                       
                                                                              
                                                                                                        






                                                                   
                                                                                                          



                                                                

                                                                                                                   
                                                                                                







                                                                                                                           
                                                          
         

       
                      




               



                                                                                                                                     



                                                                                                                                                   






                                                  
     


                                                                            




                                                                                 
                                                                 
                                                                   
         
                                           
                     

                                                                             
         
                                                                             
         
                                           
                     





                                                                                         

                                                   

                       
                                                                                                          



                                                                              

                                                                                                                   
                                                                                                




                                                                                                                       
                                                                              
                                                                                                        







                                                                                         
                                                                                                          



                                                                                      

                                                                                                                   
                                                                                                







                                                                                                                                      
                                                          
         

       
                      




               






                                                                                                                                            

                                                                                                                                                          
                        
                                                      







                                                                   
     


                                                                            










                                                                                       






                                                                                                                                       



                                                                        
                                    
                                                                           
                               








                                                                                                                                    
                                                        
       
     
                      


               







                                                      
                                                                                                

 
                              

                                                  
                                                     
                                                                            


                                                                                                     
                                                                                                   
 
 
                                 

                                                  
                                                                  


                                                                                                     
                                                                                                              
 
# Some primitives for checking the state of fake screen objects.

# validate data on screen regardless of attributes (color, bold, etc.)
# Mu doesn't have multi-line strings, so we provide functions for rows or portions of rows.
# Tab characters (that translate into multiple screen cells) not supported.

fn check-screen-row screen: (addr screen), y: int, expected: (addr array byte), msg: (addr array byte) {
  check-screen-row-from screen, 0/x, y, expected, msg
}

fn check-screen-row-from _screen: (addr screen), x: int, y: int, expected: (addr array byte), msg: (addr array byte) {
  var screen/esi: (addr screen) <- copy _screen
  var failure-count/edi: int <- copy 0
  var index/ecx: int <- screen-cell-index screen, x, y
  # compare 'expected' with the screen contents starting at 'index', grapheme by grapheme
  var e: (stream byte 0x100)
  var e-addr/edx: (addr stream byte) <- address e
  write e-addr, expected
  {
    var done?/eax: boolean <- stream-empty? e-addr
    compare done?, 0
    break-if-!=
    {
      var unused?/eax: boolean <- screen-cell-unused-at-index? screen, index
      compare unused?, 0/false
      break-if-!=
      var _c/eax: code-point <- screen-code-point-at-index screen, index
      var c/ebx: code-point <- copy _c
      var expected-grapheme/eax: grapheme <- read-grapheme e-addr
      var expected-code-point/eax: code-point <- to-code-point expected-grapheme
      # compare graphemes
      $check-screen-row-from:compare-graphemes: {
        # if expected-code-point is space, null grapheme is also ok
        {
          compare expected-code-point, 0x20
          break-if-!=
          compare c, 0
          break-if-= $check-screen-row-from:compare-graphemes
        }
        # if (c == expected-code-point) print "."
        compare c, expected-code-point
        break-if-=
        # otherwise print an error
        failure-count <- increment
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected '", 3/fg=cyan, 0/bg
        draw-code-point-at-cursor-over-full-screen 0/screen, expected-code-point, 3/cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "' at (", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") but observed '", 3/fg=cyan, 0/bg
        draw-code-point-at-cursor-over-full-screen 0/screen, c, 3/cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "'", 3/fg=cyan, 0/bg
        move-cursor-to-left-margin-of-next-line 0/screen
      }
    }
    index <- increment
    increment x
    loop
  }
  # if any assertions failed, count the test as failed
  compare failure-count, 0
  {
    break-if-=
    count-test-failure
    return
  }
  # otherwise print a "."
  draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
}

# various variants by screen-cell attribute; spaces in the 'expected' data should not match the attribute

fn check-screen-row-in-color screen: (addr screen), fg: int, y: int, expected: (addr array byte), msg: (addr array byte) {
  check-screen-row-in-color-from screen, fg, y, 0/x, expected, msg
}

fn check-screen-row-in-color-from _screen: (addr screen), fg: int, y: int, x: int, expected: (addr array byte), msg: (addr array byte) {
  var screen/esi: (addr screen) <- copy _screen
  var index/ecx: int <- screen-cell-index screen, x, y
  # compare 'expected' with the screen contents starting at 'index', grapheme by grapheme
  var e: (stream byte 0x100)
  var e-addr/edx: (addr stream byte) <- address e
  write e-addr, expected
  {
    var done?/eax: boolean <- stream-empty? e-addr
    compare done?, 0
    break-if-!=
    {
      var unused?/eax: boolean <- screen-cell-unused-at-index? screen, index
      compare unused?, 0/false
      break-if-!=
      var _c/eax: code-point <- screen-code-point-at-index screen, index
      var c/ebx: code-point <- copy _c
      var expected-grapheme/eax: grapheme <- read-grapheme e-addr
      var _expected-code-point/eax: code-point <- to-code-point expected-grapheme
      var expected-code-point/edi: code-point <- copy _expected-code-point
      $check-screen-row-in-color-from:compare-cells: {
        # if expected-code-point is space, null grapheme is also ok
        {
          compare expected-code-point, 0x20
          break-if-!=
          compare c, 0
          break-if-= $check-screen-row-in-color-from:compare-cells
        }
        # if expected-code-point is space, a different color is ok
        {
          compare expected-code-point, 0x20
          break-if-!=
          var color/eax: int <- screen-color-at-index screen, index
          compare color, fg
          break-if-!= $check-screen-row-in-color-from:compare-cells
        }
        # compare graphemes
        $check-screen-row-in-color-from:compare-graphemes: {
          # if (c == expected-code-point) print "."
          compare c, expected-code-point
          {
            break-if-!=
            draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
            break $check-screen-row-in-color-from:compare-graphemes
          }
          # otherwise print an error
          count-test-failure
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, expected-code-point, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "' at (", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") but observed '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, c, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "'", 3/fg=cyan, 0/bg
          move-cursor-to-left-margin-of-next-line 0/screen
        }
        $check-screen-row-in-color-from:compare-colors: {
          var color/eax: int <- screen-color-at-index screen, index
          compare fg, color
          {
            break-if-!=
            draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
            break $check-screen-row-in-color-from:compare-colors
          }
          # otherwise print an error
          count-test-failure
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, expected-code-point, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "' at (", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") in color ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, fg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, " but observed color ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, color, 3/fg=cyan, 0/bg
          move-cursor-to-left-margin-of-next-line 0/screen
        }
      }
    }
    index <- increment
    increment x
    loop
  }
}

fn check-screen-row-in-background-color screen: (addr screen), bg: int, y: int, expected: (addr array byte), msg: (addr array byte) {
  check-screen-row-in-background-color-from screen, bg, y, 0/x, expected, msg
}

fn check-screen-row-in-background-color-from _screen: (addr screen), bg: int, y: int, x: int, expected: (addr array byte), msg: (addr array byte) {
  var screen/esi: (addr screen) <- copy _screen
  var index/ecx: int <- screen-cell-index screen, x, y
  # compare 'expected' with the screen contents starting at 'index', grapheme by grapheme
  var e: (stream byte 0x100)
  var e-addr/edx: (addr stream byte) <- address e
  write e-addr, expected
  {
    var done?/eax: boolean <- stream-empty? e-addr
    compare done?, 0
    break-if-!=
    {
      var unused?/eax: boolean <- screen-cell-unused-at-index? screen, index
      compare unused?, 0/false
      break-if-!=
      var _g/eax: code-point <- screen-code-point-at-index screen, index
      var g/ebx: code-point <- copy _g
      var expected-grapheme/eax: grapheme <- read-grapheme e-addr
      var _expected-code-point/eax: code-point <- to-code-point expected-grapheme
      var expected-code-point/edi: code-point <- copy _expected-code-point
      $check-screen-row-in-background-color-from:compare-cells: {
        # if expected-code-point is space, null grapheme is also ok
        {
          compare expected-code-point, 0x20
          break-if-!=
          compare g, 0
          break-if-= $check-screen-row-in-background-color-from:compare-cells
        }
        # if expected-code-point is space, a different background-color is ok
        {
          compare expected-code-point, 0x20
          break-if-!=
          var background-color/eax: int <- screen-background-color-at-index screen, index
          compare background-color, bg
          break-if-!= $check-screen-row-in-background-color-from:compare-cells
        }
        # compare graphemes
        $check-screen-row-in-background-color-from:compare-graphemes: {
          # if (g == expected-code-point) print "."
          compare g, expected-code-point
          {
            break-if-!=
            draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
            break $check-screen-row-in-background-color-from:compare-graphemes
          }
          # otherwise print an error
          count-test-failure
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, expected-code-point, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "' at (", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") but observed '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, g, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "'", 3/fg=cyan, 0/bg
          move-cursor-to-left-margin-of-next-line 0/screen
          break $check-screen-row-in-background-color-from:compare-graphemes
        }
        $check-screen-row-in-background-color-from:compare-background-colors: {
          var background-color/eax: int <- screen-background-color-at-index screen, index
          compare bg, background-color
          {
            break-if-!=
            draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
            break $check-screen-row-in-background-color-from:compare-background-colors
          }
          # otherwise print an error
          count-test-failure
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected '", 3/fg=cyan, 0/bg
          draw-code-point-at-cursor-over-full-screen 0/screen, expected-code-point, 3/cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, "' at (", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") in background-color ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, bg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, " but observed background-color ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, background-color, 3/fg=cyan, 0/bg
          move-cursor-to-left-margin-of-next-line 0/screen
        }
      }
    }
    index <- increment
    increment x
    loop
  }
}

# helpers for checking just background color, not screen contents
# these can validate bg for spaces

fn check-background-color-in-screen-row screen: (addr screen), bg: int, y: int, expected-bitmap: (addr array byte), msg: (addr array byte) {
  check-background-color-in-screen-row-from screen, bg, y, 0/x, expected-bitmap, msg
}

fn check-background-color-in-screen-row-from _screen: (addr screen), bg: int, y: int, x: int, expected-bitmap: (addr array byte), msg: (addr array byte) {
  var screen/esi: (addr screen) <- copy _screen
  var failure-count: int
  var index/ecx: int <- screen-cell-index screen, x, y
  # compare background color where 'expected-bitmap' is a non-space
  var e: (stream byte 0x100)
  var e-addr/edx: (addr stream byte) <- address e
  write e-addr, expected-bitmap
  {
    var done?/eax: boolean <- stream-empty? e-addr
    compare done?, 0
    break-if-!=
    {
      var unused?/eax: boolean <- screen-cell-unused-at-index? screen, index
      compare unused?, 0/false
      break-if-!=
      var _expected-bit/eax: grapheme <- read-grapheme e-addr
      var expected-bit/edi: grapheme <- copy _expected-bit
      $check-background-color-in-screen-row-from:compare-cells: {
        var background-color/eax: int <- screen-background-color-at-index screen, index
        # if expected-bit is space, assert that background is NOT bg
        compare expected-bit, 0x20
        {
          break-if-!=
          compare background-color, bg
          break-if-!= $check-background-color-in-screen-row-from:compare-cells
          increment failure-count
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected (", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
          draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") to not be in background-color ", 3/fg=cyan, 0/bg
          draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, bg, 3/fg=cyan, 0/bg
          move-cursor-to-left-margin-of-next-line 0/screen
          break $check-background-color-in-screen-row-from:compare-cells
        }
        # otherwise assert that background IS bg
        compare background-color, bg
        break-if-= $check-background-color-in-screen-row-from:compare-cells
        increment failure-count
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, msg, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ": expected (", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, x, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ", ", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, y, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ") in background-color ", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, bg, 3/fg=cyan, 0/bg
        draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, " but observed background-color ", 3/fg=cyan, 0/bg
        draw-int32-hex-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, background-color, 3/fg=cyan, 0/bg
        move-cursor-to-left-margin-of-next-line 0/screen
      }
    }
    index <- increment
    increment x
    loop
  }
  # if any assertions failed, count the test as failed
  compare failure-count, 0
  {
    break-if-=
    count-test-failure
    return
  }
  # otherwise print a "."
  draw-text-wrapping-right-then-down-from-cursor-over-full-screen 0/screen, ".", 3/fg=cyan, 0/bg
}

fn test-draw-single-grapheme {
  var _screen: screen
  var screen/esi: (addr screen) <- address _screen
  initialize-screen screen, 5, 4, 0/no-pixel-graphics
  var dummy/eax: int <- draw-code-point screen, 0x61/a, 0/x, 0/y, 1/fg, 2/bg
  check-screen-row screen, 0/y, "a", "F - test-draw-single-grapheme"  # top-left corner of the screen
  check-screen-row-in-color screen, 1/fg, 0/y, "a", "F - test-draw-single-grapheme-fg"
  check-screen-row-in-background-color screen, 2/bg, 0/y, "a", "F - test-draw-single-grapheme-bg"
  check-background-color-in-screen-row screen, 2/bg, 0/y, "x ", "F - test-draw-single-grapheme-bg2"
}

fn test-draw-multiple-graphemes {
  var _screen: screen
  var screen/esi: (addr screen) <- address _screen
  initialize-screen screen, 0x10/rows, 4/cols, 0/no-pixel-graphics
  draw-text-wrapping-right-then-down-from-cursor-over-full-screen screen, "Hello, 世界", 1/fg, 2/bg
  check-screen-row screen, 0/y, "Hello, 世界", "F - test-draw-multiple-graphemes"
  check-screen-row-in-color screen, 1/fg, 0/y, "Hello, 世界", "F - test-draw-multiple-graphemes-fg"
  check-background-color-in-screen-row screen, 2/bg, 0/y, "xxxxxxxxx ", "F - test-draw-multiple-graphemes-bg2"
}
generated by cgit-pink 1.4.1-2-gfad0 (git 2.36.2.497.gbbea4dcf42) at 2024-11-24 21:20:11 +0000