Merge branch 'master' into subprocess

Author: iansedano

python-argparse/README.md

@@ -0,0 +1,3 @@
+# Build Command-Line Interfaces With Python's argparse
+
+This folder provides the code examples for the article [Build Command-Line Interfaces With Python's argparse](https://realpython.com/command-line-interfaces-python-argparse/).

python-argparse/abbreviate.py

@@ -0,0 +1,9 @@
+import argparse
+
+parser = argparse.ArgumentParser(allow_abbrev=False)
+
+parser.add_argument("--argument-with-a-long-name")
+
+args = parser.parse_args()
+
+print(args.argument_with_a_long_name)

python-argparse/actions.py

@@ -0,0 +1,19 @@
+import argparse
+
+parser = argparse.ArgumentParser()
+
+parser.add_argument(
+    "--name", action="store"
+)  # Equivalent to arg_parser.add_argument("--name")
+parser.add_argument("--pi", action="store_const", const=3.14)
+parser.add_argument("--is-valid", action="store_true")
+parser.add_argument("--is-invalid", action="store_false")
+parser.add_argument("--item", action="append")
+parser.add_argument("--repeated", action="append_const", const=42)
+parser.add_argument("--add-one", action="count")
+parser.add_argument("--version", action="version", version="%(prog)s 0.1.0")
+
+
+args = parser.parse_args()
+
+print(args)

python-argparse/args.txt

@@ -0,0 +1,3 @@
+first
+second
+third

python-argparse/calc.py

@@ -0,0 +1,51 @@
+import argparse
+
+
+def add(a, b):
+    return a + b
+
+
+def sub(a, b):
+    return a - b
+
+
+def mul(a, b):
+    return a * b
+
+
+def div(a, b):
+    return a / b
+
+
+global_parser = argparse.ArgumentParser(prog="calc")
+subparsers = global_parser.add_subparsers(
+    title="subcommands", help="arithmetic operations"
+)
+
+arg_template = {
+    "dest": "operands",
+    "type": float,
+    "nargs": 2,
+    "metavar": "OPERAND",
+    "help": "a numeric value",
+}
+
+add_parser = subparsers.add_parser("add", help="add two numbers a and b")
+add_parser.add_argument(**arg_template)
+add_parser.set_defaults(func=add)
+
+sub_parser = subparsers.add_parser("sub", help="subtract two numbers a and b")
+sub_parser.add_argument(**arg_template)
+sub_parser.set_defaults(func=sub)
+
+mul_parser = subparsers.add_parser("mul", help="multiply two numbers a and b")
+mul_parser.add_argument(**arg_template)
+mul_parser.set_defaults(func=mul)
+
+div_parser = subparsers.add_parser("div", help="divide two numbers a and b")
+div_parser.add_argument(**arg_template)
+div_parser.set_defaults(func=div)
+
+args = global_parser.parse_args()
+
+print(args.func(*args.operands))

python-argparse/cooking.py

@@ -0,0 +1,10 @@
+import argparse
+
+arg_parser = argparse.ArgumentParser()
+
+arg_parser.add_argument("--veggies", nargs="+")
+arg_parser.add_argument("--fruits", nargs="*")
+
+args = arg_parser.parse_args()
+
+print(args)

python-argparse/coordinates.py

@@ -0,0 +1,14 @@
+import argparse
+
+arg_parser = argparse.ArgumentParser()
+
+arg_parser.add_argument(
+    "--coordinates",
+    nargs=2,
+    metavar=("X", "Y"),
+    help="take the Cartesian coordinates %(metavar)s",
+)
+
+args = arg_parser.parse_args()
+
+print(args)

python-argparse/custom_action.py

@@ -0,0 +1,16 @@
+import argparse
+
+
+class VerboseStore(argparse.Action):
+    def __call__(self, parser, namespace, values, option_string=None):
+        print(f"Storing {values} in the {option_string} option...")
+        setattr(namespace, self.dest, values)
+
+
+arg_parser = argparse.ArgumentParser()
+
+arg_parser.add_argument("-n", "--name", action=VerboseStore)
+
+args = arg_parser.parse_args()
+
+print(args)

python-argparse/days.py

@@ -0,0 +1,9 @@
+import argparse
+
+my_parser = argparse.ArgumentParser()
+
+my_parser.add_argument("--weekday", type=int, choices=range(1, 8))
+
+args = my_parser.parse_args()
+
+print(args)

python-argparse/divide.py

@@ -0,0 +1,10 @@
+import argparse
+
+arg_parser = argparse.ArgumentParser()
+
+arg_parser.add_argument("--dividend", type=float)
+arg_parser.add_argument("--divisor", type=float)
+
+args = arg_parser.parse_args()
+
+print(args.dividend / args.divisor)