Coverage for tests / test_config.py: 100.000%

1# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0 

2# For details: https://github.com/coveragepy/coveragepy/blob/main/NOTICE.txt 

3 

4"""Test the config file handling for coverage.py""" 

5 

6from __future__ import annotations 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

7 

8import os 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

9import tempfile 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

10 

11from pathlib import Path 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

12from unittest import mock 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

13 

14import pytest 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

15 

16import coverage 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

17from coverage import Coverage, env 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

18from coverage.config import CoverageConfig, HandyConfigParser 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

19from coverage.exceptions import ConfigError, CoverageWarning 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

20from coverage.tomlconfig import TomlConfigParser 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

21from coverage.types import FilePathClasses, FilePathType 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

22 

23from tests.coveragetest import CoverageTest, UsingModulesMixin 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

24 

25 

26class ConfigTest(CoverageTest): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

27 """Tests of the different sources of configuration settings.""" 

28 

29 def test_default_config(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

30 # Just constructing a coverage() object gets the right defaults. 

31 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

32 assert not cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

33 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

34 assert cov.config.data_file == ".coverage" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

35 

36 def test_arguments(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

37 # Arguments to the constructor are applied to the configuration. 

38 cov = coverage.Coverage(timid=True, data_file="fooey.dat", concurrency="multiprocessing") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

39 assert cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

40 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

41 assert cov.config.data_file == "fooey.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

42 assert cov.config.concurrency == ["multiprocessing"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

43 

44 def test_config_file(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

45 # A .coveragerc file will be read into the configuration. 

46 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

47 ".coveragerc", 

48 """\ 

49 # This is just a bogus .rc file for testing. 

50 [run] 

51 timid = True 

52 data_file = .hello_kitty.data 

53 """, 

54 ) 

55 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

56 assert cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

57 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

58 assert cov.config.data_file == ".hello_kitty.data" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

59 

60 @pytest.mark.parametrize("file_class", FilePathClasses) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

61 def test_named_config_file(self, file_class: FilePathType) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

62 # You can name the config file what you like. 

63 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

64 "my_cov.ini", 

65 """\ 

66 [run] 

67 timid = True 

68 ; I wouldn't really use this as a data file... 

69 data_file = delete.me 

70 """, 

71 ) 

72 cov = coverage.Coverage(config_file=file_class("my_cov.ini")) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

73 assert cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

74 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

75 assert cov.config.data_file == "delete.me" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

76 

77 def test_toml_config_file(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

78 # A pyproject.toml file will be read into the configuration. 

79 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

80 "pyproject.toml", 

81 """\ 

82 # This is just a bogus toml file for testing. 

83 [tool.somethingelse] 

84 authors = ["Joe D'Ávila <joe@gmail.com>"] 

85 [tool.coverage.run] 

86 concurrency = ["thread", "eventlet"] 

87 timid = true 

88 data_file = ".hello_kitty.data" 

89 plugins = ["plugins.a_plugin"] 

90 [tool.coverage.report] 

91 precision = 3 

92 fail_under = 90.5 

93 [tool.coverage.html] 

94 title = "tabblo & «ταБЬℓσ»" 

95 [tool.coverage.plugins.a_plugin] 

96 hello = "world" 

97 """, 

98 ) 

99 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

100 assert cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

101 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

102 assert cov.config.concurrency == ["thread", "eventlet"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

103 assert cov.config.data_file == ".hello_kitty.data" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

104 assert cov.config.plugins == ["plugins.a_plugin"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

105 assert cov.config.precision == 3 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

106 assert cov.config.html_title == "tabblo & «ταБЬℓσ»" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

107 assert cov.config.fail_under == 90.5 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

108 assert cov.config.get_plugin_options("plugins.a_plugin") == {"hello": "world"} 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

109 

110 def test_toml_ints_can_be_floats(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

111 # Test that our class doesn't reject integers when loading floats 

112 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

113 "pyproject.toml", 

114 """\ 

115 # This is just a bogus toml file for testing. 

116 [tool.coverage.report] 

117 fail_under = 90 

118 """, 

119 ) 

120 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

121 assert cov.config.fail_under == 90 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

122 assert isinstance(cov.config.fail_under, float) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

123 

124 def test_ignored_config_file(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

125 # You can disable reading the .coveragerc file. 

126 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

127 ".coveragerc", 

128 """\ 

129 [run] 

130 timid = True 

131 data_file = delete.me 

132 """, 

133 ) 

134 cov = coverage.Coverage(config_file=False) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

135 assert not cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

136 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

137 assert cov.config.data_file == ".coverage" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

138 

139 def test_config_file_then_args(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

140 # The arguments override the .coveragerc file. 

141 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

142 ".coveragerc", 

143 """\ 

144 [run] 

145 timid = True 

146 data_file = weirdo.file 

147 """, 

148 ) 

149 cov = coverage.Coverage(timid=False, data_file=".mycov") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

150 assert not cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

151 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

152 assert cov.config.data_file == ".mycov" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

153 

154 def test_data_file_from_environment(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

155 # There's an environment variable for the data_file. 

156 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

157 ".coveragerc", 

158 """\ 

159 [run] 

160 timid = True 

161 data_file = weirdo.file 

162 """, 

163 ) 

164 self.set_environ("COVERAGE_FILE", "fromenv.dat") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

165 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

166 assert cov.config.data_file == "fromenv.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

167 # But the constructor arguments override the environment variable. 

168 cov = coverage.Coverage(data_file="fromarg.dat") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

169 assert cov.config.data_file == "fromarg.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

170 

171 def test_debug_from_environment(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

172 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

173 ".coveragerc", 

174 """\ 

175 [run] 

176 debug = dataio, pids 

177 """, 

178 ) 

179 self.set_environ("COVERAGE_DEBUG", "callers, fooey") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

180 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

181 assert cov.config.debug == ["dataio", "pids", "callers", "fooey"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

182 

183 def test_rcfile_from_environment(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

184 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

185 "here.ini", 

186 """\ 

187 [run] 

188 data_file = overthere.dat 

189 """, 

190 ) 

191 self.set_environ("COVERAGE_RCFILE", "here.ini") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

192 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

193 assert cov.config.data_file == "overthere.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

194 

195 def test_missing_rcfile_from_environment(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

196 self.set_environ("COVERAGE_RCFILE", "nowhere.ini") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

197 msg = "Couldn't read 'nowhere.ini' as a config file" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

198 with pytest.raises(ConfigError, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

199 coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

200 

201 @pytest.mark.parametrize("force", [False, True]) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

202 def test_force_environment(self, force: bool) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

203 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

204 ".coveragerc", 

205 """\ 

206 [run] 

207 debug = dataio, pids 

208 """, 

209 ) 

210 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

211 "force.ini", 

212 """\ 

213 [run] 

214 debug = callers, fooey 

215 """, 

216 ) 

217 if force: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

218 self.set_environ("COVERAGE_FORCE_CONFIG", "force.ini") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

219 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

220 if force: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

221 assert cov.config.debug == ["callers", "fooey"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

222 else: 

223 assert cov.config.debug == ["dataio", "pids"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

224 

225 @pytest.mark.parametrize( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

226 "bad_config, msg", 

227 [ 

228 ("[run]\ntimid = maybe?\n", r"maybe[?]"), 

229 ("timid = 1\n", r"no section headers"), 

230 ("[run\n", r"\[run"), 

231 ( 

232 "[report]\nexclude_lines = foo(\n", 

233 r"Invalid \[report\].exclude_lines value 'foo\(': " 

234 + r"(unbalanced parenthesis|missing \))", 

235 ), 

236 ( 

237 "[report]\nexclude_also = foo(\n", 

238 r"Invalid \[report\].exclude_also value 'foo\(': " 

239 + r"(unbalanced parenthesis|missing \))", 

240 ), 

241 ( 

242 "[report]\npartial_branches = foo[\n", 

243 r"Invalid \[report\].partial_branches value 'foo\[': " 

244 + r"(unexpected end of regular expression|unterminated character set)", 

245 ), 

246 ( 

247 "[report]\npartial_also = foo[\n", 

248 r"Invalid \[report\].partial_also value 'foo\[': " 

249 + r"(unexpected end of regular expression|unterminated character set)", 

250 ), 

251 ( 

252 "[report]\npartial_branches_always = foo***\n", 

253 r"Invalid \[report\].partial_branches_always value " 

254 + r"'foo\*\*\*': " 

255 + r"multiple repeat", 

256 ), 

257 ], 

258 ) 

259 def test_parse_errors(self, bad_config: str, msg: str) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

260 # Im-parsable values raise ConfigError, with details. 

261 self.make_file(".coveragerc", bad_config) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

262 with pytest.raises(ConfigError, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

263 coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

264 

265 @pytest.mark.parametrize( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

266 "bad_config, msg", 

267 [ 

268 ('[tool.coverage.run]\ntimid = "maybe?"\n', r"maybe[?]"), 

269 ("[tool.coverage.run\n", None), 

270 ( 

271 '[tool.coverage.report]\nexclude_lines = ["foo("]\n', 

272 r"Invalid \[tool.coverage.report\].exclude_lines value 'foo\(': " 

273 + r"(unbalanced parenthesis|missing \))", 

274 ), 

275 ( 

276 '[tool.coverage.report]\nexclude_also = ["foo("]\n', 

277 r"Invalid \[tool.coverage.report\].exclude_also value 'foo\(': " 

278 + r"(unbalanced parenthesis|missing \))", 

279 ), 

280 ( 

281 '[tool.coverage.report]\npartial_branches = ["foo["]\n', 

282 r"Invalid \[tool.coverage.report\].partial_branches value 'foo\[': " 

283 + r"(unexpected end of regular expression|unterminated character set)", 

284 ), 

285 ( 

286 '[tool.coverage.report]\npartial_also = ["foo["]\n', 

287 r"Invalid \[tool.coverage.report\].partial_also value 'foo\[': " 

288 + r"(unexpected end of regular expression|unterminated character set)", 

289 ), 

290 ( 

291 '[tool.coverage.report]\npartial_branches_always = ["foo***"]\n', 

292 r"Invalid \[tool.coverage.report\].partial_branches_always value " 

293 + r"'foo\*\*\*': " 

294 + r"multiple repeat", 

295 ), 

296 ('[tool.coverage.run]\nconcurrency="foo"', "not a list"), 

297 ("[tool.coverage.report]\nprecision=1.23", "not an integer"), 

298 ('[tool.coverage.report]\nfail_under="s"', "couldn't convert to a float"), 

299 ], 

300 ) 

301 def test_toml_parse_errors(self, bad_config: str, msg: str) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

302 # Im-parsable values raise ConfigError, with details. 

303 self.make_file("pyproject.toml", bad_config) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

304 with pytest.raises(ConfigError, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

305 coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

306 

307 def test_environment_vars_in_config(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

308 # Config files can have $envvars in them. 

309 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

310 ".coveragerc", 

311 """\ 

312 [run] 

313 data_file = $DATA_FILE.fooey 

314 branch = $OKAY 

315 [report] 

316 exclude_lines = 

317 the_$$one 

318 another${THING} 

319 x${THING}y 

320 x${NOTHING}y 

321 huh$${X}what 

322 """, 

323 ) 

324 self.set_environ("DATA_FILE", "hello-world") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

325 self.set_environ("THING", "ZZZ") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

326 self.set_environ("OKAY", "yes") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

327 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

328 assert cov.config.data_file == "hello-world.fooey" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

329 assert cov.config.branch is True 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

330 assert cov.config.exclude_list == ["the_$one", "anotherZZZ", "xZZZy", "xy", "huh${X}what"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

331 

332 def test_environment_vars_in_toml_config(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

333 # Config files can have $envvars in them. 

334 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

335 "pyproject.toml", 

336 """\ 

337 [tool.coverage.run] 

338 data_file = "$DATA_FILE.fooey" 

339 branch = "$BRANCH" 

340 [tool.coverage.report] 

341 precision = "$DIGITS" 

342 fail_under = "$FAIL_UNDER" 

343 exclude_lines = [ 

344 "the_$$one", 

345 "another${THING}", 

346 "x${THING}y", 

347 "x${NOTHING}y", 

348 "huh$${X}what", 

349 ] 

350 [othersection] 

351 # This reproduces the failure from https://github.com/coveragepy/coveragepy/issues/1481 

352 # When OTHER has a backslash that isn't a valid escape, like \\z (see below). 

353 something = "if [ $OTHER ]; then printf '%s\\n' 'Hi'; fi" 

354 """, 

355 ) 

356 self.set_environ("BRANCH", "true") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

357 self.set_environ("DIGITS", "3") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

358 self.set_environ("FAIL_UNDER", "90.5") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

359 self.set_environ("DATA_FILE", "hello-world") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

360 self.set_environ("THING", "ZZZ") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

361 self.set_environ("OTHER", "hi\\zebra") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

362 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

363 assert cov.config.branch is True 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

364 assert cov.config.precision == 3 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

365 assert cov.config.data_file == "hello-world.fooey" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

366 assert cov.config.exclude_list == ["the_$one", "anotherZZZ", "xZZZy", "xy", "huh${X}what"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

367 

368 def test_tilde_in_config(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

369 # Config entries that are file paths can be tilde-expanded. 

370 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

371 ".coveragerc", 

372 """\ 

373 [run] 

374 data_file = ~/data.file 

375 

376 [html] 

377 directory = ~joe/html_dir 

378 

379 [json] 

380 output = ~/json/output.json 

381 

382 [lcov] 

383 output = ~/lcov/~foo.lcov 

384 

385 [xml] 

386 output = ~/somewhere/xml.out 

387 

388 [report] 

389 # Strings that aren't file paths are not tilde-expanded. 

390 exclude_lines = 

391 ~/data.file 

392 ~joe/html_dir 

393 

394 [paths] 

395 mapping = 

396 ~/src 

397 ~joe/source 

398 """, 

399 ) 

400 

401 self.assert_tilde_results() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

402 

403 def test_tilde_in_toml_config(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

404 # Config entries that are file paths can be tilde-expanded. 

405 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

406 "pyproject.toml", 

407 """\ 

408 [tool.coverage.run] 

409 data_file = "~/data.file" 

410 

411 [tool.coverage.html] 

412 directory = "~joe/html_dir" 

413 

414 [tool.coverage.json] 

415 output = "~/json/output.json" 

416 

417 [tool.coverage.lcov] 

418 output = "~/lcov/~foo.lcov" 

419 

420 [tool.coverage.xml] 

421 output = "~/somewhere/xml.out" 

422 

423 [tool.coverage.report] 

424 # Strings that aren't file paths are not tilde-expanded. 

425 exclude_lines = [ 

426 "~/data.file", 

427 "~joe/html_dir", 

428 ] 

429 

430 [tool.coverage.paths] 

431 mapping = [ 

432 "~/src", 

433 "~joe/source", 

434 ] 

435 """, 

436 ) 

437 

438 self.assert_tilde_results() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

439 

440 def assert_tilde_results(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

441 """Common assertions for two tilde tests.""" 

442 

443 def expanduser(s: str) -> str: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

444 """Fake tilde expansion""" 

445 s = s.replace("~/", "/Users/me/") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

446 s = s.replace("~joe/", "/Users/joe/") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

447 return s 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

448 

449 with mock.patch.object( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

450 coverage.config.os.path, # type: ignore[attr-defined] 

451 "expanduser", 

452 new=expanduser, 

453 ): 

454 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

455 assert cov.config.data_file == "/Users/me/data.file" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

456 assert cov.config.html_dir == "/Users/joe/html_dir" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

457 assert cov.config.json_output == "/Users/me/json/output.json" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

458 assert cov.config.lcov_output == "/Users/me/lcov/~foo.lcov" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

459 assert cov.config.xml_output == "/Users/me/somewhere/xml.out" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

460 assert cov.config.exclude_list == ["~/data.file", "~joe/html_dir"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

461 assert cov.config.paths == {"mapping": ["/Users/me/src", "/Users/joe/source"]} 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

462 

463 def test_tweaks_after_constructor(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

464 # set_option can be used after construction to affect the config. 

465 cov = coverage.Coverage(timid=True, data_file="fooey.dat") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

466 cov.set_option("run:timid", False) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

467 

468 assert not cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

469 assert not cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

470 assert cov.config.data_file == "fooey.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

471 

472 assert not cov.get_option("run:timid") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

473 assert not cov.get_option("run:branch") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

474 assert cov.get_option("run:data_file") == "fooey.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

475 

476 def test_tweaks_paths_after_constructor(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

477 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

478 ".coveragerc", 

479 """\ 

480 [paths] 

481 first = 

482 /first/1 

483 /first/2 

484 

485 second = 

486 /second/a 

487 /second/b 

488 """, 

489 ) 

490 old_paths = { 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

491 "first": ["/first/1", "/first/2"], 

492 "second": ["/second/a", "/second/b"], 

493 } 

494 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

495 paths = cov.get_option("paths") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

496 assert paths == old_paths 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

497 

498 new_paths = { 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

499 "magic": ["src", "ok"], 

500 } 

501 cov.set_option("paths", new_paths) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

502 

503 assert cov.get_option("paths") == new_paths 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

504 

505 def test_tweak_error_checking(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

506 # Trying to set an unknown config value raises an error. 

507 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

508 with pytest.raises(ConfigError, match="No such option: 'run:xyzzy'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

509 cov.set_option("run:xyzzy", 12) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

510 with pytest.raises(ConfigError, match="No such option: 'xyzzy:foo'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

511 cov.set_option("xyzzy:foo", 12) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

512 with pytest.raises(ConfigError, match="No such option: 'run:xyzzy'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

513 _ = cov.get_option("run:xyzzy") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

514 with pytest.raises(ConfigError, match="No such option: 'xyzzy:foo'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

515 _ = cov.get_option("xyzzy:foo") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

516 

517 def test_tweak_plugin_options(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

518 # Plugin options have a more flexible syntax. 

519 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

520 cov.set_option("run:plugins", ["fooey.plugin", "xyzzy.coverage.plugin"]) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

521 cov.set_option("fooey.plugin:xyzzy", 17) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

522 cov.set_option("xyzzy.coverage.plugin:plugh", ["a", "b"]) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

523 with pytest.raises(ConfigError, match="No such option: 'no_such.plugin:foo'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

524 cov.set_option("no_such.plugin:foo", 23) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

525 

526 assert cov.get_option("fooey.plugin:xyzzy") == 17 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

527 assert cov.get_option("xyzzy.coverage.plugin:plugh") == ["a", "b"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

528 with pytest.raises(ConfigError, match="No such option: 'no_such.plugin:foo'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

529 _ = cov.get_option("no_such.plugin:foo") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

530 

531 def test_unknown_option(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

532 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

533 ".coveragerc", 

534 """\ 

535 [run] 

536 xyzzy = 17 

537 """, 

538 ) 

539 msg = r"Unrecognized option '\[run\] xyzzy=' in config file .coveragerc" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

540 with pytest.warns(CoverageWarning, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

541 _ = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

542 

543 def test_unknown_option_toml(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

544 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

545 "pyproject.toml", 

546 """\ 

547 [tool.coverage.run] 

548 xyzzy = 17 

549 """, 

550 ) 

551 msg = r"Unrecognized option '\[tool.coverage.run\] xyzzy=' in config file pyproject.toml" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

552 with pytest.warns(CoverageWarning, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

553 _ = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

554 

555 def test_unknown_patch(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

556 self.make_file("foo.py", "a = 1") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

557 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

558 ".coveragerc", 

559 """\ 

560 [run] 

561 patch = 

562 _exit 

563 xyzzy 

564 """, 

565 ) 

566 msg = "Unknown patch 'xyzzy'" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

567 with pytest.raises(ConfigError, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

568 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

569 self.start_import_stop(cov, "foo") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

570 

571 def test_misplaced_option(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

572 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

573 ".coveragerc", 

574 """\ 

575 [report] 

576 branch = True 

577 """, 

578 ) 

579 msg = r"Unrecognized option '\[report\] branch=' in config file .coveragerc" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

580 with pytest.warns(CoverageWarning, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

581 _ = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

582 

583 def test_unknown_option_in_other_ini_file(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

584 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

585 "setup.cfg", 

586 """\ 

587 [coverage:run] 

588 huh = what? 

589 """, 

590 ) 

591 msg = r"Unrecognized option '\[coverage:run\] huh=' in config file setup.cfg" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

592 with pytest.warns(CoverageWarning, match=msg): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

593 _ = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

594 

595 def test_exceptions_from_missing_things(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

596 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

597 "config.ini", 

598 """\ 

599 [run] 

600 branch = True 

601 """, 

602 ) 

603 config = HandyConfigParser(True) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

604 config.read(["config.ini"]) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

605 with pytest.raises(ConfigError, match="No section: 'xyzzy'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

606 config.options("xyzzy") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

607 with pytest.raises(ConfigError, match="No option 'foo' in section: 'xyzzy'"): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

608 config.get("xyzzy", "foo") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

609 

610 def test_exclude_also(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

611 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

612 "pyproject.toml", 

613 """\ 

614 [tool.coverage.report] 

615 exclude_also = ["foobar", "raise .*Error"] 

616 """, 

617 ) 

618 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

619 

620 expected = coverage.config.DEFAULT_EXCLUDE + ["foobar", "raise .*Error"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

621 assert cov.config.exclude_list == expected 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

622 

623 def test_partial_also(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

624 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

625 "pyproject.toml", 

626 """\ 

627 [tool.coverage.report] 

628 partial_also = ["foobar", "raise .*Error"] 

629 """, 

630 ) 

631 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

632 

633 expected = coverage.config.DEFAULT_PARTIAL + ["foobar", "raise .*Error"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

634 assert cov.config.partial_list == expected 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

635 

636 def test_core_option(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

637 # Test that the core option can be set in the configuration file. 

638 self.del_environ("COVERAGE_CORE") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

639 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

640 default_core = cov.config.core 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

641 core_to_set = "ctrace" if default_core == "pytrace" else "pytrace" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

642 

643 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

644 ".coveragerc", 

645 f"""\ 

646 [run] 

647 core = {core_to_set} 

648 """, 

649 ) 

650 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

651 assert cov.config.core == core_to_set 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

652 os.remove(".coveragerc") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

653 

654 self.make_file( 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

655 "pyproject.toml", 

656 f"""\ 

657 [tool.coverage.run] 

658 core = "{core_to_set}" 

659 """, 

660 ) 

661 

662 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

663 assert cov.config.core == core_to_set 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

664 

665 

666class ConfigFileTest(UsingModulesMixin, CoverageTest): 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

667 """Tests of the config file settings in particular.""" 

668 

669 # This sample file tries to use lots of variation of syntax... 

670 # The {section} placeholder lets us nest these settings in another file. 

671 LOTSA_SETTINGS = """\ 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

672 # This is a settings file for coverage.py 

673 [{section}run] 

674 timid = yes 

675 data_file = something_or_other.dat 

676 branch = 1 

677 cover_pylib = TRUE 

678 parallel = on 

679 concurrency = thread 

680 ; this omit is overridden by the omit from [report] 

681 omit = twenty 

682 source = myapp 

683 source_pkgs = ned 

684 source_dirs = cooldir 

685 plugins = 

686 plugins.a_plugin 

687 plugins.another 

688 debug = callers, pids , dataio 

689 disable_warnings = abcd , efgh 

690 

691 [{section}report] 

692 ; these settings affect reporting. 

693 exclude_lines = 

694 if 0: 

695 

696 pragma:?\\s+no cover 

697 another_tab 

698 

699 ignore_errors = TRUE 

700 omit = 

701 one, another, some_more, 

702 yet_more 

703 include = thirty 

704 precision = 3 

705 

706 partial_branches = 

707 pragma:?\\s+no branch 

708 partial_branches_always = 

709 if 0: 

710 while True: 

711 

712 show_missing= TruE 

713 skip_covered = TruE 

714 skip_empty =TruE 

715 

716 include_namespace_packages = TRUE 

717 

718 [{section}html] 

719 

720 directory = c:\\tricky\\dir.somewhere 

721 extra_css=something/extra.css 

722 title = Title & nums # nums! 

723 [{section}xml] 

724 output=mycov.xml 

725 package_depth = 17 

726 

727 [{section}paths] 

728 source = 

729 . 

730 /home/ned/src/ 

731 

732 other = other, /home/ned/other, c:\\Ned\\etc 

733 

734 [{section}plugins.a_plugin] 

735 hello = world 

736 ; comments still work. 

737 names = Jane/John/Jenny 

738 

739 [{section}json] 

740 pretty_print = True 

741 show_contexts = True 

742 """ 

743 

744 # Just some sample setup.cfg text from the docs. 

745 SETUP_CFG = """\ 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

746 [bdist_rpm] 

747 release = 1 

748 packager = Jane Packager <janep@pysoft.com> 

749 doc_files = CHANGES.txt 

750 README.txt 

751 USAGE.txt 

752 doc/ 

753 examples/ 

754 """ 

755 

756 # Just some sample tox.ini text from the docs. 

757 TOX_INI = """\ 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

758 [tox] 

759 envlist = py{26,27,33,34,35}-{c,py}tracer 

760 skip_missing_interpreters = True 

761 

762 [testenv] 

763 commands = 

764 # Create tests/zipmods.zip 

765 python igor.py zip_mods 

766 """ 

767 

768 def assert_config_settings_are_correct(self, cov: Coverage) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

769 """Check that `cov` has all the settings from LOTSA_SETTINGS.""" 

770 assert cov.config.timid 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

771 assert cov.config.data_file == "something_or_other.dat" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

772 assert cov.config.branch 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

773 assert cov.config.cover_pylib 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

774 assert cov.config.debug == ["callers", "pids", "dataio"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

775 assert cov.config.parallel 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

776 assert cov.config.concurrency == ["thread"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

777 assert cov.config.source == ["myapp"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

778 assert cov.config.source_pkgs == ["ned"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

779 assert cov.config.source_dirs == ["cooldir"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

780 assert cov.config.disable_warnings == ["abcd", "efgh"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

781 

782 assert cov.get_exclude_list() == ["if 0:", r"pragma:?\s+no cover", "another_tab"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

783 assert cov.config.ignore_errors 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

784 assert cov.config.run_omit == ["twenty"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

785 assert cov.config.report_omit == ["one", "another", "some_more", "yet_more"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

786 assert cov.config.report_include == ["thirty"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

787 assert cov.config.precision == 3 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

788 

789 assert cov.config.partial_list == [r"pragma:?\s+no branch"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

790 assert cov.config.partial_always_list == ["if 0:", "while True:"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

791 assert cov.config.plugins == ["plugins.a_plugin", "plugins.another"] 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

792 assert cov.config.show_missing 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

793 assert cov.config.skip_covered 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

794 assert cov.config.skip_empty 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

795 assert cov.config.html_dir == r"c:\tricky\dir.somewhere" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

796 assert cov.config.extra_css == "something/extra.css" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

797 assert cov.config.html_title == "Title & nums # nums!" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

798 

799 assert cov.config.xml_output == "mycov.xml" 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

800 assert cov.config.xml_package_depth == 17 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

801 

802 assert cov.config.paths == { 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

803 "source": [".", "/home/ned/src/"], 

804 "other": ["other", "/home/ned/other", "c:\\Ned\\etc"], 

805 } 

806 

807 assert cov.config.get_plugin_options("plugins.a_plugin") == { 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

808 "hello": "world", 

809 "names": "Jane/John/Jenny", 

810 } 

811 assert cov.config.get_plugin_options("plugins.another") == {} 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

812 assert cov.config.json_show_contexts is True 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

813 assert cov.config.json_pretty_print is True 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

814 assert cov.config.include_namespace_packages is True 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

815 

816 def test_config_file_settings(self) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

817 self.make_file(".coveragerc", self.LOTSA_SETTINGS.format(section="")) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

818 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

819 self.assert_config_settings_are_correct(cov) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

820 

821 def check_config_file_settings_in_other_file(self, fname: str, contents: str) -> None: 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

822 """Check config will be read from another file, with prefixed sections.""" 

823 nested = self.LOTSA_SETTINGS.format(section="coverage:") 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

824 fname = self.make_file(fname, nested + "\n" + contents) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

825 cov = coverage.Coverage() 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()

826 self.assert_config_settings_are_correct(cov) 69 ctx1abcdefhijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789!#$%'g()