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
|
# ==================================================================================================================== #
# _ _ _ _ _ _ _ ____ #
# / \ | |_| |_ _ __(_) |__ _ _| |_ ___ ___ / \ _ __ __ _| _ \ __ _ _ __ ___ ___ #
# / _ \| __| __| '__| | '_ \| | | | __/ _ \/ __| / _ \ | '__/ _` | |_) / _` | '__/ __|/ _ \ #
# _ _ _ / ___ \ |_| |_| | | | |_) | |_| | || __/\__ \_ / ___ \| | | (_| | __/ (_| | | \__ \ __/ #
# (_|_|_)_/ \_\__|\__|_| |_|_.__/ \__,_|\__\___||___(_)_/ \_\_| \__, |_| \__,_|_| |___/\___| #
# |___/ #
# ==================================================================================================================== #
# Authors: #
# Patrick Lehmann #
# #
# License: #
# ==================================================================================================================== #
# Copyright 2017-2024 Patrick Lehmann - Bötzingen, Germany #
# Copyright 2007-2016 Patrick Lehmann - Dresden, Germany #
# #
# Licensed under the Apache License, Version 2.0 (the "License"); #
# you may not use this file except in compliance with the License. #
# You may obtain a copy of the License at #
# #
# http://www.apache.org/licenses/LICENSE-2.0 #
# #
# Unless required by applicable law or agreed to in writing, software #
# distributed under the License is distributed on an "AS IS" BASIS, #
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. #
# See the License for the specific language governing permissions and #
# limitations under the License. #
# #
# SPDX-License-Identifier: Apache-2.0 #
# ==================================================================================================================== #
#
from typing import Optional as Nullable
try:
from pyTooling.Decorators import export
from pyTooling.Attributes.ArgParse.Argument import NamedAndValuedArgument
except (ImportError, ModuleNotFoundError): # pragma: no cover
print("[pyTooling.Attributes.ArgParse.OptionalValuedFlag] Could not import from 'pyTooling.*'!")
try:
from Decorators import export
from Attributes.ArgParse.Argument import NamedAndValuedArgument
except (ImportError, ModuleNotFoundError) as ex: # pragma: no cover
print("[pyTooling.Attributes.ArgParse.OptionalValuedFlag] Could not import directly!")
raise ex
@export
class OptionalValuedFlag(NamedAndValuedArgument):
"""
Defines a switch argument like ``--help``.
Some of the named parameters passed to :meth:`~ArgumentParser.add_argument` are predefined (or overwritten) to create
a boolean parameter passed to the registered handler method. The boolean parameter is ``True`` if the switch argument
is present in the commandline arguments, otherwise ``False``.
"""
def __init__(self, short: Nullable[str] = None, long: Nullable[str] = None, dest: Nullable[str] = None, help: Nullable[str] = None):
"""
The constructor expects positional (``*args``), the destination parameter name ``dest`` and/or named parameters
(``**kwargs``) which are passed to :meth:`~ArgumentParser.add_argument`.
To implement a switch argument, the following named parameters are predefined:
* ``action="store_const"``
* ``const=True``
* ``default=False``
This implements a boolean parameter passed to the handler method.
"""
args = []
if short is not None:
args.append(short)
if long is not None:
args.append(long)
kwargs = {
"dest": dest,
"action": "store_const",
"const": True,
"default": False,
"help": help,
}
super().__init__(*args, **kwargs)
@export
class ShortOptionalValuedFlag(OptionalValuedFlag):
def __init__(self, short: Nullable[str] = None, dest: Nullable[str] = None, help: Nullable[str] = None):
super().__init__(short=short, dest=dest, help=help)
@export
class LongOptionalValuedFlag(OptionalValuedFlag):
def __init__(self, long: Nullable[str] = None, dest: Nullable[str] = None, help: Nullable[str] = None):
super().__init__(long=long, dest=dest, help=help)
|