Skip to content

Commit 25438e5

Browse files
srittausrittau
authored
[tarfile] Use Literal for TarFile.{debug,errorlevel} (#15368)
1 parent 69b19d5 commit 25438e5

File tree

1 file changed

+54
-54
lines changed

1 file changed

+54
-54
lines changed

‎stdlib/tarfile.pyi‎

Lines changed: 54 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -128,8 +128,8 @@ class TarFile:
128128
errors: str
129129
fileobject: type[ExFileObject] # undocumented
130130
pax_headers: Mapping[str, str]
131-
debug: int
132-
errorlevel: int
131+
debug: Literal[0, 1, 2, 3]
132+
errorlevel: Literal[0, 1, 2]
133133
offset: int # undocumented
134134
extraction_filter: _FilterFunction | None
135135
if sys.version_info >= (3, 13):
@@ -146,8 +146,8 @@ class TarFile:
146146
encoding: str | None = None,
147147
errors: str = "surrogateescape",
148148
pax_headers: Mapping[str, str] | None = None,
149-
debug: int | None = None,
150-
errorlevel: int | None = None,
149+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
150+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
151151
copybufsize: int | None = None, # undocumented
152152
stream: bool = False,
153153
) -> None: ...
@@ -164,8 +164,8 @@ class TarFile:
164164
encoding: str | None = None,
165165
errors: str = "surrogateescape",
166166
pax_headers: Mapping[str, str] | None = None,
167-
debug: int | None = None,
168-
errorlevel: int | None = None,
167+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
168+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
169169
copybufsize: int | None = None, # undocumented
170170
) -> None: ...
171171

@@ -190,8 +190,8 @@ class TarFile:
190190
encoding: str | None = ...,
191191
errors: str = ...,
192192
pax_headers: Mapping[str, str] | None = ...,
193-
debug: int | None = ...,
194-
errorlevel: int | None = ...,
193+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
194+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
195195
) -> Self: ...
196196
if sys.version_info >= (3, 14):
197197
@overload
@@ -210,8 +210,8 @@ class TarFile:
210210
encoding: str | None = ...,
211211
errors: str = ...,
212212
pax_headers: Mapping[str, str] | None = ...,
213-
debug: int | None = ...,
214-
errorlevel: int | None = ...,
213+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
214+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
215215
level: None = None,
216216
options: Mapping[int, int] | None = None,
217217
zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
@@ -233,8 +233,8 @@ class TarFile:
233233
encoding: str | None = ...,
234234
errors: str = ...,
235235
pax_headers: Mapping[str, str] | None = ...,
236-
debug: int | None = ...,
237-
errorlevel: int | None = ...,
236+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
237+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
238238
) -> Self: ...
239239
@overload
240240
@classmethod
@@ -252,8 +252,8 @@ class TarFile:
252252
encoding: str | None = ...,
253253
errors: str = ...,
254254
pax_headers: Mapping[str, str] | None = ...,
255-
debug: int | None = ...,
256-
errorlevel: int | None = ...,
255+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
256+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
257257
) -> Self: ...
258258
@overload
259259
@classmethod
@@ -271,8 +271,8 @@ class TarFile:
271271
encoding: str | None = ...,
272272
errors: str = ...,
273273
pax_headers: Mapping[str, str] | None = ...,
274-
debug: int | None = ...,
275-
errorlevel: int | None = ...,
274+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
275+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
276276
compresslevel: int = 9,
277277
) -> Self: ...
278278
@overload
@@ -291,8 +291,8 @@ class TarFile:
291291
encoding: str | None = ...,
292292
errors: str = ...,
293293
pax_headers: Mapping[str, str] | None = ...,
294-
debug: int | None = ...,
295-
errorlevel: int | None = ...,
294+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
295+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
296296
compresslevel: int = 9,
297297
) -> Self: ...
298298
@overload
@@ -311,8 +311,8 @@ class TarFile:
311311
encoding: str | None = ...,
312312
errors: str = ...,
313313
pax_headers: Mapping[str, str] | None = ...,
314-
debug: int | None = ...,
315-
errorlevel: int | None = ...,
314+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
315+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
316316
preset: Literal[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] | None = ...,
317317
) -> Self: ...
318318
@overload
@@ -331,8 +331,8 @@ class TarFile:
331331
encoding: str | None = ...,
332332
errors: str = ...,
333333
pax_headers: Mapping[str, str] | None = ...,
334-
debug: int | None = ...,
335-
errorlevel: int | None = ...,
334+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
335+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
336336
preset: Literal[0, 1, 2, 3, 4, 5, 6, 7, 8, 9] | None = ...,
337337
) -> Self: ...
338338
if sys.version_info >= (3, 14):
@@ -352,8 +352,8 @@ class TarFile:
352352
encoding: str | None = ...,
353353
errors: str = ...,
354354
pax_headers: Mapping[str, str] | None = ...,
355-
debug: int | None = ...,
356-
errorlevel: int | None = ...,
355+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
356+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
357357
options: Mapping[int, int] | None = None,
358358
zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
359359
) -> Self: ...
@@ -373,8 +373,8 @@ class TarFile:
373373
encoding: str | None = ...,
374374
errors: str = ...,
375375
pax_headers: Mapping[str, str] | None = ...,
376-
debug: int | None = ...,
377-
errorlevel: int | None = ...,
376+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
377+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
378378
options: Mapping[int, int] | None = None,
379379
zstd_dict: ZstdDict | tuple[ZstdDict, int] | None = None,
380380
) -> Self: ...
@@ -395,8 +395,8 @@ class TarFile:
395395
encoding: str | None = ...,
396396
errors: str = ...,
397397
pax_headers: Mapping[str, str] | None = ...,
398-
debug: int | None = ...,
399-
errorlevel: int | None = ...,
398+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
399+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
400400
) -> Self: ...
401401
@overload
402402
@classmethod
@@ -414,8 +414,8 @@ class TarFile:
414414
encoding: str | None = ...,
415415
errors: str = ...,
416416
pax_headers: Mapping[str, str] | None = ...,
417-
debug: int | None = ...,
418-
errorlevel: int | None = ...,
417+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
418+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
419419
) -> Self: ...
420420
@overload
421421
@classmethod
@@ -433,8 +433,8 @@ class TarFile:
433433
encoding: str | None = ...,
434434
errors: str = ...,
435435
pax_headers: Mapping[str, str] | None = ...,
436-
debug: int | None = ...,
437-
errorlevel: int | None = ...,
436+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
437+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
438438
) -> Self: ...
439439
@overload
440440
@classmethod
@@ -452,8 +452,8 @@ class TarFile:
452452
encoding: str | None = ...,
453453
errors: str = ...,
454454
pax_headers: Mapping[str, str] | None = ...,
455-
debug: int | None = ...,
456-
errorlevel: int | None = ...,
455+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
456+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
457457
) -> Self: ...
458458
@overload
459459
@classmethod
@@ -471,8 +471,8 @@ class TarFile:
471471
encoding: str | None = ...,
472472
errors: str = ...,
473473
pax_headers: Mapping[str, str] | None = ...,
474-
debug: int | None = ...,
475-
errorlevel: int | None = ...,
474+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
475+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
476476
compresslevel: int = 9,
477477
) -> Self: ...
478478
@overload
@@ -491,8 +491,8 @@ class TarFile:
491491
encoding: str | None = ...,
492492
errors: str = ...,
493493
pax_headers: Mapping[str, str] | None = ...,
494-
debug: int | None = ...,
495-
errorlevel: int | None = ...,
494+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
495+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
496496
compresslevel: int = 9,
497497
) -> Self: ...
498498
@classmethod
@@ -509,8 +509,8 @@ class TarFile:
509509
ignore_zeros: bool | None = ...,
510510
encoding: str | None = ...,
511511
pax_headers: Mapping[str, str] | None = ...,
512-
debug: int | None = ...,
513-
errorlevel: int | None = ...,
512+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
513+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
514514
) -> Self: ...
515515
@overload
516516
@classmethod
@@ -527,8 +527,8 @@ class TarFile:
527527
ignore_zeros: bool | None = ...,
528528
encoding: str | None = ...,
529529
pax_headers: Mapping[str, str] | None = ...,
530-
debug: int | None = ...,
531-
errorlevel: int | None = ...,
530+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
531+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
532532
) -> Self: ...
533533
@overload
534534
@classmethod
@@ -545,8 +545,8 @@ class TarFile:
545545
ignore_zeros: bool | None = ...,
546546
encoding: str | None = ...,
547547
pax_headers: Mapping[str, str] | None = ...,
548-
debug: int | None = ...,
549-
errorlevel: int | None = ...,
548+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
549+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
550550
) -> Self: ...
551551
@overload
552552
@classmethod
@@ -563,8 +563,8 @@ class TarFile:
563563
ignore_zeros: bool | None = ...,
564564
encoding: str | None = ...,
565565
pax_headers: Mapping[str, str] | None = ...,
566-
debug: int | None = ...,
567-
errorlevel: int | None = ...,
566+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
567+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
568568
) -> Self: ...
569569
@overload
570570
@classmethod
@@ -581,8 +581,8 @@ class TarFile:
581581
ignore_zeros: bool | None = ...,
582582
encoding: str | None = ...,
583583
pax_headers: Mapping[str, str] | None = ...,
584-
debug: int | None = ...,
585-
errorlevel: int | None = ...,
584+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
585+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
586586
) -> Self: ...
587587
@classmethod
588588
def xzopen(
@@ -598,8 +598,8 @@ class TarFile:
598598
ignore_zeros: bool | None = ...,
599599
encoding: str | None = ...,
600600
pax_headers: Mapping[str, str] | None = ...,
601-
debug: int | None = ...,
602-
errorlevel: int | None = ...,
601+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
602+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
603603
) -> Self: ...
604604
if sys.version_info >= (3, 14):
605605
@overload
@@ -619,8 +619,8 @@ class TarFile:
619619
ignore_zeros: bool | None = ...,
620620
encoding: str | None = ...,
621621
pax_headers: Mapping[str, str] | None = ...,
622-
debug: int | None = ...,
623-
errorlevel: int | None = ...,
622+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
623+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
624624
) -> Self: ...
625625
@overload
626626
@classmethod
@@ -639,8 +639,8 @@ class TarFile:
639639
ignore_zeros: bool | None = ...,
640640
encoding: str | None = ...,
641641
pax_headers: Mapping[str, str] | None = ...,
642-
debug: int | None = ...,
643-
errorlevel: int | None = ...,
642+
debug: Literal[0, 1, 2, 3] | None = None, # default 0
643+
errorlevel: Literal[0, 1, 2] | None = None, # default 1
644644
) -> Self: ...
645645

646646
def getmember(self, name: str) -> TarInfo: ...

0 commit comments

Comments
 (0)