add: examples (#1)

examples/pkg-nested/sub-folder/__main__.py

@@ -0,0 +1,4 @@
+"""Example: package with nested folder"""
+
+if "__main__" == __name__:
+    print(__doc__)

examples/pkg-with-init/__init__.py

@@ -0,0 +1,4 @@
+"""Example: package with __init__.py"""
+
+if __name__ == "__main__":
+    print(__doc__)

examples/pkg-with-main/__main__.py

@@ -0,0 +1,3 @@
+from .pkg import main
+
+main()

examples/pkg-with-main/pkg.py

@@ -0,0 +1,5 @@
+"""Example: package with __main__.py"""
+
+
+def main() -> None:
+    print(__doc__)

examples/single-file/file-no-docstring.py

@@ -0,0 +1,2 @@
+if __name__ == "__main__":
+    print("Example: file without docstring")

examples/single-file/file-no-main.py

@@ -0,0 +1,6 @@
+"""Example: file without `__main__`"""
+
+# if __name__ == "__main__":
+#     print(__doc__)
+
+print(__doc__)

examples/single-file/file-with-main.py

@@ -0,0 +1,5 @@
+#!/usr/bin/env python
+"""Example: file with `__main__`"""
+
+if __name__ == "__main__":
+    print(__doc__)