Merge branch 'master' into code-image-generator

Author: KateFinegan

python-asterisk-and-slash-special-parameters/README.md

@@ -0,0 +1,7 @@
+# What Are Python Asterisk and Slash Special Parameters For?
+
+This folder contains supplementary code for the Real Python tutorial [What Are Python Asterisk and Slash Special Parameters For?](https://realpython.com/python-asterisk-and-slash-special-parameters/). You can copy the code examples, or continue your learning by experimenting more with them.
+
+## Setup
+
+No special setup is required for this tutorial. The code snippets were produced using Python 3.11

python-asterisk-and-slash-special-parameters/asterisk_usage.py

@@ -0,0 +1,9 @@
+def asterisk_usage(either, *, keyword_only):
+    print(either, keyword_only)
+
+
+asterisk_usage(either="Frank", keyword_only="Dean")
+asterisk_usage("Frank", keyword_only="Dean")
+
+# This would be invalid:
+# asterisk_usage("Frank", "Dean")

python-asterisk-and-slash-special-parameters/get_average.py

@@ -0,0 +1,7 @@
+def get_average(*args):
+    print(args)
+    return sum(args) / len(args)
+
+
+get_average(1, 2, 3)
+get_average(1, 3, 5, 7, 9)

python-asterisk-and-slash-special-parameters/print_four_members.py

@@ -0,0 +1,8 @@
+def print_four_members(member1, member2, /, member3, *, member4):
+    print(f"member1 is {member1}")
+    print(f"member2 is {member2}")
+    print(f"member3 is {member3}")
+    print(f"member4 is {member4}")
+
+
+print_four_members("Frank", "Dean", member3="Sammy", member4="Joey")

python-asterisk-and-slash-special-parameters/print_three_members_both_operators.py

@@ -0,0 +1,11 @@
+def print_three_members(member1, member2, /, *, member3):
+    print(f"member1 is {member1}")
+    print(f"member2 is {member2}")
+    print(f"member3 is {member3}")
+
+
+print_three_members("Frank", "Dean", member3="Sammy")
+
+# This would be invalid:
+# print_three_members("Frank", "Dean", "Sammy")
+# print_three_members("Frank", member2="Dean", member3="Sammy")

python-asterisk-and-slash-special-parameters/print_three_members_keyword_args.py

@@ -0,0 +1,12 @@
+def print_three_members(*, member1, member2, member3):
+    print(f"member1 is {member1}")
+    print(f"member2 is {member2}")
+    print(f"member3 is {member3}")
+
+
+print_three_members(member1="Frank", member2="Dean", member3="Sammy")
+print_three_members(member1="Frank", member3="Dean", member2="Sammy")
+
+# This would be invalid:
+# print_three_members("Frank", member3="Dean", member2="Sammy")
+# print_three_members("Frank", "Dean", "Sammy")

python-asterisk-and-slash-special-parameters/print_three_members_positional_args.py

@@ -0,0 +1,11 @@
+def print_three_members(member1, member2, member3, /):
+    print(f"member1 is {member1}")
+    print(f"member2 is {member2}")
+    print(f"member3 is {member3}")
+
+
+print_three_members("Frank", "Dean", "Sammy")
+
+# This would be invalid:
+# print_three_members(member1="Frank", member2="Sammy", member3="Dean")
+# print_three_members("Frank", "Dean", member3="Sammy")

python-asterisk-and-slash-special-parameters/print_varying_members.py

@@ -0,0 +1,13 @@
+def print_varying_members(member1, member2, *args, member3):
+    print(f"member1 is {member1}")
+    print(f"member2 is {member2}")
+    print(f"member3 is {member3}")
+    print(f"*args contains {args}")
+
+
+print_varying_members("Frank", member2="Dean", member3="Sammy")
+print_varying_members(member1="Frank", member2="Dean", member3="Sammy")
+print_varying_members("Frank", "Dean", "Peter", "Joey", member3="Sammy")
+
+# This would be invalid:
+# print_varying_members(member1="Frank", "Dean", member3="Sammy")

python-asterisk-and-slash-special-parameters/slash_usage.py

@@ -0,0 +1,10 @@
+def slash_usage(position_only, /, either):
+    print(position_only, either)
+
+
+slash_usage("Frank", either="Dean")
+slash_usage("Frank", "Dean")
+
+# This would be invalid:
+# slash_usage(position_only="Frank", either="Dean")
+# slash_usage(position_only="Frank", "Dean")

python-asterisk-and-slash-special-parameters/username.py

@@ -0,0 +1,8 @@
+def username(fn, ln, /):
+    return ln + fn[0]
+
+
+print(username("Frank", "Sinatra"))
+
+# This would be invalid:
+# print(username(fn="Frank", ln="Sinatra"))