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
|
"""
Python scripts to test libgimp API.
Specifically, test GimpResource class and subclasses.
Test methods common to most resource classes, and class methods.
Methods specific to each class are tested elsewhere.
Usage:
=====
This is not a GIMP plugin.
Just copy and paste into the GIMP Python Console.
Expect no exceptions.
You can quickly look for red text.
There are no messages from the test program,
only exceptions from assert to indicate a failure.
Requires PyGObject binding to libgimp,
which the GIMP Python Console does automatically.
Trash:
=====
This test program may leave trash, especially for failed runs.
Trash means resources persisted by GIMP.
!!! Do not run this in a production environment (using GIMP to create graphics.)
You can run it in a GIMP development environment,
but you may need to clean up trash manually.
Deleting the .config/GIMP directory will clean up the trash.
Setup in the GIMP app:
=====================
Choose current resources to match what this test uses:
e.g. brush '2. Hardness 050'
Use the standard default initial resources for a clean build,
by deleting .config/GIMP.
Ensure test resources from prior runs are deleted
otherwise they interfere with testing i.e. name clash.
E.g. delete brush '2. Hardness 050 copy #1'
"""
"""
Test return value is-a resource.
Get resource from context
"""
brush = Gimp.context_get_brush()
font = Gimp.context_get_font()
gradient = Gimp.context_get_gradient()
palette = Gimp.context_get_palette()
pattern = Gimp.context_get_pattern()
assert isinstance(brush, Gimp.Brush)
assert isinstance(font, Gimp.Font)
assert isinstance(gradient, Gimp.Gradient)
assert isinstance(palette, Gimp.Palette)
assert isinstance(pattern, Gimp.Pattern)
"""
Test is_valid method
Expect True
"""
assert brush.is_valid()
assert font.is_valid()
assert gradient.is_valid()
assert palette.is_valid()
assert pattern.is_valid()
"""
Test get_id method
Expect string
"""
print( brush.get_id() )
print( font.get_id() )
print( gradient.get_id() )
print( palette.get_id() )
print( pattern.get_id() )
assert brush.get_id() == '2. Hardness 050'
assert font.get_id() == 'Sans-serif'
assert gradient.get_id() == 'FG to BG (RGB)'
assert palette.get_id() == 'Color History'
assert pattern.get_id() == 'Pine'
"""
Test resource as an arg
Pass the resource back to the context
Expect no exceptions
"""
assert Gimp.context_set_brush(brush) == True
assert Gimp.context_set_font(font) == True
assert Gimp.context_set_gradient(gradient) == True
assert Gimp.context_set_palette(palette) == True
assert Gimp.context_set_pattern(pattern) == True
"""
Test new() methods
Not Font, Pattern.
Pass desired name.
"""
brush_new = Gimp.Brush.new("New Brush")
# expect a valid brush object, not a name
assert brush_new.is_valid()
# expect id is the desired one (assuming no clash)
assert brush_new.get_id()=="New Brush"
gradient_new = Gimp.Gradient.new("New Gradient")
assert gradient_new.is_valid()
assert gradient_new.get_id()=="New Gradient"
palette_new = Gimp.Palette.new("New Palette")
assert palette_new.is_valid()
assert palette_new.get_id()=="New Palette"
"""
Test delete methods.
Delete the new resources we just made
After deletion, reference is invalid
"""
assert brush_new.delete() == True
assert brush_new.is_valid()==False
assert gradient_new.delete() == True
assert gradient_new.is_valid()==False
assert palette_new.delete() == True
assert palette_new.is_valid()==False
"""
Test copy methods.
Copy the original resources from context.
Assert that GIMP adds " copy"
"""
brush_copy = brush.duplicate()
assert brush_copy.is_valid()
assert brush_copy.get_id()=='2. Hardness 050 copy'
gradient_copy = gradient.duplicate()
assert gradient_copy.is_valid()
assert gradient_copy.get_id()=='FG to BG (RGB) copy'
palette_copy = palette.duplicate()
assert palette_copy.is_valid()
assert palette_copy.get_id()== 'Color History copy'
"""
Test rename methods.
Renaming returns a reference that must be kept. !!!
Rename existing copy to a desired name.
!!! assign to a new named var
"""
brush_renamed = brush_copy.rename("Renamed Brush")
assert brush_renamed.is_valid()
assert brush_renamed.get_id()=="Renamed Brush"
# assert renaming invalidates any old reference,
assert brush_copy.is_valid()==False
gradient_renamed = gradient_copy.rename("Renamed Gradient")
assert gradient_renamed.is_valid()
assert gradient_renamed.get_id()=="Renamed Gradient"
# assert renaming invalidates any old reference,
assert gradient_copy.is_valid()==False
palette_renamed = palette_copy.rename("Renamed Palette")
assert palette_renamed.is_valid()
assert palette_renamed.get_id()=="Renamed Palette"
# assert renaming invalidates any old reference,
assert palette_copy.is_valid()==False
"""
Test renaming when name is already in use.
If "Renamed Brush" is already in use, then the name will be
"Renamed Brush copy #1"
that is, renaming added suffix "#1"
This is due to core behavior, not libgimp resource class per se,
so we don't test it here.
"""
"""
Test delete methods
Delete the renamed copies we just made
After deletion, reference is invalid
"""
brush_renamed.delete()
assert brush_renamed.is_valid()==False
gradient_renamed.delete()
assert gradient_renamed.is_valid()==False
palette_renamed.delete()
assert palette_renamed.is_valid()==False
'''
Test class method
!!! Expect no error dialog in GIMP.
The app code generated from foo.pdb should clear the GError.
'''
assert Gimp.Brush.id_is_valid ("invalid name")==False
assert Gimp.Font.id_is_valid ("invalid name")==False
assert Gimp.Gradient.id_is_valid("invalid name")==False
assert Gimp.Palette.id_is_valid ("invalid name")==False
assert Gimp.Pattern.id_is_valid ("invalid name")==False
'''
Test constructor
Not something author's should do, but test it anyway
'''
brush2 = Gimp.Brush()
font2 = Gimp.Font()
gradient2 = Gimp.Gradient()
palette2 = Gimp.Palette()
pattern2 = Gimp.Pattern()
assert isinstance(brush2, Gimp.Brush)
assert isinstance(font2, Gimp.Font)
assert isinstance(gradient2, Gimp.Gradient)
assert isinstance(palette2, Gimp.Palette)
assert isinstance(pattern2, Gimp.Pattern)
# a created instance is invalid until it's ID is set
assert brush2.is_valid()==False
assert font2.is_valid()==False
assert gradient2.is_valid()==False
assert palette2.is_valid()==False
assert pattern2.is_valid()==False
"""
test set_property methods
Use a name that exists. Creating de novo a reference to an existing brush.
Reference is valid since it's data exists in app core
"""
brush2.set_property("id", "2. Star")
assert brush2.get_id()=="2. Star"
assert brush2.is_valid()
font2.set_property("id", "Sans-serif")
assert font2.get_id() =="Sans-serif"
assert font2.is_valid()
gradient2.set_property("id", 'FG to BG (RGB)')
assert gradient2.get_id() =='FG to BG (RGB)'
assert gradient2.is_valid()
palette2.set_property("id", 'Color History')
assert palette2.get_id() =='Color History'
assert palette2.is_valid()
pattern2.set_property("id", 'Pine')
assert pattern2.get_id() =='Pine'
assert pattern2.is_valid()
|
