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
|
# Licensed under the GPL: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
# For details: https://github.com/PyCQA/pylint/blob/main/LICENSE
# Copyright (c) https://github.com/PyCQA/pylint/blob/main/CONTRIBUTORS.txt
# pylint: disable=too-many-arguments, redefined-builtin
"""Deprecated option actions."""
from __future__ import annotations
import argparse
import warnings
from collections.abc import Sequence
from typing import Any
class _OldNamesAction(argparse._StoreAction):
"""Store action that also sets the value to old names."""
def __init__(
self,
option_strings: Sequence[str],
dest: str,
nargs: None = None,
const: None = None,
default: None = None,
type: None = None,
choices: None = None,
required: bool = False,
help: str = "",
metavar: str = "",
old_names: list[str] | None = None,
) -> None:
assert old_names
self.old_names = old_names
super().__init__(
option_strings,
dest,
1,
const,
default,
type,
choices,
required,
help,
metavar,
)
def __call__(
self,
parser: argparse.ArgumentParser,
namespace: argparse.Namespace,
values: str | Sequence[Any] | None,
option_string: str | None = None,
) -> None:
assert isinstance(values, list)
setattr(namespace, self.dest, values[0])
for old_name in self.old_names:
setattr(namespace, old_name, values[0])
class _NewNamesAction(argparse._StoreAction):
"""Store action that also emits a deprecation warning about a new name."""
def __init__(
self,
option_strings: Sequence[str],
dest: str,
nargs: None = None,
const: None = None,
default: None = None,
type: None = None,
choices: None = None,
required: bool = False,
help: str = "",
metavar: str = "",
new_names: list[str] | None = None,
) -> None:
assert new_names
self.new_names = new_names
super().__init__(
option_strings,
dest,
1,
const,
default,
type,
choices,
required,
help,
metavar,
)
def __call__(
self,
parser: argparse.ArgumentParser,
namespace: argparse.Namespace,
values: str | Sequence[Any] | None,
option_string: str | None = None,
) -> None:
assert isinstance(values, list)
setattr(namespace, self.dest, values[0])
warnings.warn(
f"{self.option_strings[0]} has been deprecated. Please look into "
f"using any of the following options: {', '.join(self.new_names)}.",
DeprecationWarning,
stacklevel=2,
)
|