File: Examples.py

package info (click to toggle)
python-pytooling 8.7.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,572 kB
  • sloc: python: 23,936; makefile: 13
file content (78 lines) | stat: -rw-r--r-- 4,915 bytes parent folder | download
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
# ==================================================================================================================== #
#             _____           _ _               ____ _     ___    _    _         _                  _   _              #
#  _ __  _   |_   _|__   ___ | (_)_ __   __ _  / ___| |   |_ _|  / \  | |__  ___| |_ _ __ __ _  ___| |_(_) ___  _ __   #
# | '_ \| | | || |/ _ \ / _ \| | | '_ \ / _` || |   | |    | |  / _ \ | '_ \/ __| __| '__/ _` |/ __| __| |/ _ \| '_ \  #
# | |_) | |_| || | (_) | (_) | | | | | | (_| || |___| |___ | | / ___ \| |_) \__ \ |_| | | (_| | (__| |_| | (_) | | | | #
# | .__/ \__, ||_|\___/ \___/|_|_|_| |_|\__, (_)____|_____|___/_/   \_\_.__/|___/\__|_|  \__,_|\___|\__|_|\___/|_| |_| #
# |_|    |___/                          |___/                                                                          #
# ==================================================================================================================== #
# Authors:                                                                                                             #
#   Patrick Lehmann                                                                                                    #
#                                                                                                                      #
# License:                                                                                                             #
# ==================================================================================================================== #
# Copyright 2017-2025 Patrick Lehmann - Bötzingen, 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                                                                                  #
# ==================================================================================================================== #
#
"""
Abstracted CLI programs as examples for unit tests.

:copyright: Copyright 2007-2025 Patrick Lehmann - Bötzingen, Germany
:license: Apache License, Version 2.0
"""
from pyTooling.MetaClasses                    import ExtendedType
from pyTooling.CLIAbstraction                 import CLIArgument
from pyTooling.CLIAbstraction.Command         import CommandArgument
from pyTooling.CLIAbstraction.Flag            import LongFlag
from pyTooling.CLIAbstraction.ValuedTupleFlag import ShortTupleFlag


if __name__ == "__main__":  # pragma: no cover
	print("ERROR: you called a testcase declaration file as an executable module.")
	print("Use: 'python -m unittest <testcase module>'")
	exit(1)


class GitArgumentsMixin(metaclass=ExtendedType, mixin=True):
	# _executableNames: ClassVar[Dict[str, str]] = {
	_executableNames = {
		"Darwin":  "git",
		"FreeBSD": "git",
		"Linux":   "git",
		"Windows": "git.exe"
	}

	@CLIArgument()
	class FlagVersion(LongFlag, name="version"): ...

	@CLIArgument()
	class FlagHelp(LongFlag, name="help"): ...

	@CLIArgument()
	class CommandHelp(CommandArgument, name="help"): ...

	@CLIArgument()
	class CommandInit(CommandArgument, name="init"): ...

	@CLIArgument()
	class CommandStage(CommandArgument, name="add"): ...

	@CLIArgument()
	class CommandCommit(CommandArgument, name="commit"): ...

	@CLIArgument()
	class ValueCommitMessage(ShortTupleFlag, name="m"): ...