@@ -71,10 +71,14 @@ On macOS:
71
71
>>> appauthor = "Acme"
72
72
>>> user_data_dir(appname, appauthor)
73
73
'/Users/trentm/Library/Application Support/SuperApp'
74
- >>> site_data_dir (appname, appauthor)
75
- '/Library/Application Support/SuperApp'
74
+ >>> user_config_dir (appname, appauthor)
75
+ '/Users/trentm/ Library/Application Support/SuperApp'
76
76
>>> user_cache_dir(appname, appauthor)
77
77
'/Users/trentm/Library/Caches/SuperApp'
78
+ >>> site_data_dir(appname, appauthor)
79
+ '/Library/Application Support/SuperApp'
80
+ >>> site_config_dir(appname, appauthor)
81
+ '/Library/Application Support/SuperApp'
78
82
>>> user_log_dir(appname, appauthor)
79
83
'/Users/trentm/Library/Logs/SuperApp'
80
84
>>> user_documents_dir()
@@ -103,8 +107,14 @@ On Windows:
103
107
'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
104
108
>>> user_data_dir(appname, appauthor, roaming=True)
105
109
'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp'
110
+ >>> user_config_dir(appname, appauthor)
111
+ 'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
106
112
>>> user_cache_dir(appname, appauthor)
107
113
'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache'
114
+ >>> site_data_dir(appname, appauthor)
115
+ 'C:\\ProgramData\\Acme\\SuperApp'
116
+ >>> site_config_dir(appname, appauthor)
117
+ 'C:\\ProgramData\\Acme\\SuperApp'
108
118
>>> user_log_dir(appname, appauthor)
109
119
'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs'
110
120
>>> user_documents_dir()
@@ -131,16 +141,21 @@ On Linux:
131
141
>>> appauthor = "Acme"
132
142
>>> user_data_dir(appname, appauthor)
133
143
'/home/trentm/.local/share/SuperApp'
144
+ >>> user_config_dir(appname)
145
+ '/home/trentm/.config/SuperApp'
146
+ >>> user_cache_dir(appname, appauthor)
147
+ '/home/trentm/.cache/SuperApp'
134
148
>>> site_data_dir(appname, appauthor)
135
149
'/usr/local/share/SuperApp'
136
150
>>> site_data_dir(appname, appauthor, multipath=True)
137
151
'/usr/local/share/SuperApp:/usr/share/SuperApp'
138
- >>> user_cache_dir(appname, appauthor)
139
- '/home/trentm/.cache/SuperApp'
152
+ >>> site_config_dir(appname)
153
+ '/etc/xdg/SuperApp'
154
+ >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"
155
+ >>> site_config_dir(appname, multipath=True)
156
+ '/etc/SuperApp:/usr/local/etc/SuperApp'
140
157
>>> user_log_dir(appname, appauthor)
141
158
'/home/trentm/.local/state/SuperApp/log'
142
- >>> user_config_dir(appname)
143
- '/home/trentm/.config/SuperApp'
144
159
>>> user_documents_dir()
145
160
'/home/trentm/Documents'
146
161
>>> user_downloads_dir()
@@ -155,11 +170,6 @@ On Linux:
155
170
'/home/trentm/Desktop'
156
171
>>> user_runtime_dir(appname, appauthor)
157
172
'/run/user/{os.getuid()}/SuperApp'
158
- >>> site_config_dir(appname)
159
- '/etc/xdg/SuperApp'
160
- >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"
161
- >>> site_config_dir(appname, multipath=True)
162
- '/etc/SuperApp:/usr/local/etc/SuperApp'
163
173
164
174
On Android::
165
175
@@ -168,12 +178,16 @@ On Android::
168
178
>>> appauthor = "Acme"
169
179
>>> user_data_dir(appname, appauthor)
170
180
'/data/data/com.myApp/files/SuperApp'
181
+ >>> user_config_dir(appname)
182
+ '/data/data/com.myApp/shared_prefs/SuperApp'
171
183
>>> user_cache_dir(appname, appauthor)
172
184
'/data/data/com.myApp/cache/SuperApp'
185
+ >>> site_data_dir(appname, appauthor)
186
+ '/data/data/com.myApp/files/SuperApp'
187
+ >>> site_config_dir(appname)
188
+ '/data/data/com.myApp/shared_prefs/SuperApp'
173
189
>>> user_log_dir(appname, appauthor)
174
190
'/data/data/com.myApp/cache/SuperApp/log'
175
- >>> user_config_dir(appname)
176
- '/data/data/com.myApp/shared_prefs/SuperApp'
177
191
>>> user_documents_dir()
178
192
'/storage/emulated/0/Documents'
179
193
>>> user_downloads_dir()
@@ -205,8 +219,14 @@ apps also support ``XDG_*`` environment variables.
205
219
>>> dirs = PlatformDirs("SuperApp", "Acme")
206
220
>>> dirs.user_data_dir
207
221
'/Users/trentm/Library/Application Support/SuperApp'
222
+ >>> dirs.user_config_dir
223
+ '/Users/trentm/Library/Application Support/SuperApp'
224
+ >>> dirs.user_cache_dir
225
+ '/Users/trentm/Library/Caches/SuperApp'
208
226
>>> dirs.site_data_dir
209
227
'/Library/Application Support/SuperApp'
228
+ >>> dirs.site_config_dir
229
+ '/Library/Application Support/SuperApp'
210
230
>>> dirs.user_cache_dir
211
231
'/Users/trentm/Library/Caches/SuperApp'
212
232
>>> dirs.user_log_dir
@@ -237,10 +257,14 @@ dirs::
237
257
>>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0")
238
258
>>> dirs.user_data_dir
239
259
'/Users/trentm/Library/Application Support/SuperApp/1.0'
240
- >>> dirs.site_data_dir
241
- '/Library/Application Support/SuperApp/1.0'
260
+ >>> dirs.user_config_dir
261
+ '/Users/trentm/ Library/Application Support/SuperApp/1.0'
242
262
>>> dirs.user_cache_dir
243
263
'/Users/trentm/Library/Caches/SuperApp/1.0'
264
+ >>> dirs.site_data_dir
265
+ '/Library/Application Support/SuperApp/1.0'
266
+ >>> dirs.site_config_dir
267
+ '/Library/Application Support/SuperApp/1.0'
244
268
>>> dirs.user_log_dir
245
269
'/Users/trentm/Library/Logs/SuperApp/1.0'
246
270
>>> dirs.user_documents_dir
0 commit comments