Merge pull request #680 from realpython/python-init-py

Add Python __init__.py tutorial materials

Author: brendaweles

python-init-py/README.md

@@ -0,0 +1,5 @@
+# What Is Python's `__init__.py` For?
+
+This folder contains the code discussed in the Real Python tutorial on [Python's `__init__.py` file](https://realpython.com/python-init-py/).
+
+You can start a Python interpreter inside this folder, then interact with the modules like shown in the tutorial. Some of the code is currently commented-out. Follow the tutorial instructions for when to uncomment.

python-init-py/media_project/mediatools/__init__.py

@@ -0,0 +1,8 @@
+# print(f"Importing {__name__}")
+
+__version__ = "0.1.0"
+
+# from .audio.utils import enhance as audio_enhance
+# from .audio.utils import wobbulate
+# from .graphics.utils import enhance as graphics_enhance
+# from .graphics.utils import solarize

python-init-py/media_project/mediatools/audio/__init__.py

@@ -0,0 +1 @@
+# print(f"Importing {__name__}")

python-init-py/media_project/mediatools/audio/utils.py

@@ -0,0 +1,13 @@
+# print(f"Importing {__name__}")
+
+
+def wobbulate():
+    print("Wibble wobble")
+
+
+def enhance():
+    print("Enhancing audio")
+
+
+_secret_password = "Alakazam!"
+__top_secret_password = "!mazakalA"

python-init-py/media_project/mediatools/graphics/__init__.py

@@ -0,0 +1 @@
+# print(f"Importing {__name__}")

python-init-py/media_project/mediatools/graphics/utils.py

@@ -0,0 +1,14 @@
+# print(f"Importing {__name__}")
+
+__all__ = ["solarize", "enhance"]
+
+
+def solarize():
+    print("Solarizing")
+
+
+def enhance():
+    print("Enhancing graphics")
+
+
+indiana_pi = 3.2

python-init-py/tools_project/tools/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "1.0.0"
+magic_number = 42