(#68) - Update the examples

braboj · braboj · commit 7a9eacf0474b · 2025-06-08T18:08:26.000+03:00
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# Awesome Python!
+# Python Tutorial
 
 by Branimir Georgiev (www.codewithbranko.com)
 
diff --git a/examples/junior/01-hello-world/expressions.py b/examples/junior/01-hello-world/expressions.py
@@ -0,0 +1,11 @@
+# Use expressions to evaluate values in Python.
+# -----------------------------------------------------------------------------
+# An expression is anything that evaluates to a value. The following is true
+# for all expressions:
+#
+#  - An expression always returns a value.
+#  - Expressions can be used in statements (e.g. if, while, for).
+#  - Expressions can be part of other expressions.
+
+1                       # Simple expression
+1 + 2 + 3               # Arithmetic expression
diff --git a/examples/junior/01-hello-world/hello_world.py b/examples/junior/01-hello-world/hello_world.py
@@ -0,0 +1,8 @@
+# Hello World example
+# ----------------------------------------------------------------------------
+# This is a simple example to demonstrate the most basic functionality of
+# Python. It prints "Hello world!" to the console and performs a simple
+# arithmetic operation (1 + 1).
+
+print("Hello world!")
+print(1 + 1)
diff --git a/examples/junior/01-hello-world/intro_expressions.py b/examples/junior/01-hello-world/intro_expressions.py
diff --git a/examples/junior/01-hello-world/intro_hello_world.py b/examples/junior/01-hello-world/intro_hello_world.py
diff --git a/examples/junior/01-hello-world/intro_import.py b/examples/junior/01-hello-world/intro_import.py
diff --git a/examples/junior/01-hello-world/intro_print.py b/examples/junior/01-hello-world/intro_print.py
diff --git a/examples/junior/01-hello-world/intro_statements.py b/examples/junior/01-hello-world/intro_statements.py
diff --git a/examples/junior/01-hello-world/intro_zen_of_python.py b/examples/junior/01-hello-world/intro_zen_of_python.py
diff --git a/examples/junior/01-hello-world/modules.py b/examples/junior/01-hello-world/modules.py
@@ -0,0 +1,11 @@
+# Use import to access python modules
+# -----------------------------------------------------------------------------
+# A module is a file containing Python code. It can define functions,
+# classes, and variables that you can use in your code. You can import a
+# module using the `import` statement.
+
+import math
+from math import pi
+
+print(math.pi)
+print(pi)
diff --git a/examples/junior/01-hello-world/print_statement.py b/examples/junior/01-hello-world/print_statement.py
@@ -0,0 +1,34 @@
+# Use the print() function to output text to the console.
+# -----------------------------------------------------------------------------
+# The print() function is used to output data to the screen. It can take
+# multiple arguments and will convert them to strings before printing them.
+
+# By default, print() ends with a newline character.
+print("Hello")
+print("World")
+# Output:
+#   Hello
+#   World
+
+# You can change this behavior by specifying the end parameter.
+print("Hello", end="")
+print("World", end="")
+# Output:
+#   HelloWorld
+
+# A print statement with no arguments prints a newline character.
+print("Hello", end="")
+print()
+print("World", end="")
+# Output:
+#   Hello
+#   World
+
+# You can also specify the separator symbol
+print("Hello", "World", sep="")
+print("Hello", "World", sep=" ")
+print("Hello", "World", sep=", ")
+# Output:
+#   HelloWorld
+#   Hello World
+#   Hello, World
diff --git a/examples/junior/01-hello-world/statements.py b/examples/junior/01-hello-world/statements.py
@@ -0,0 +1,16 @@
+# Use statements to perform actions in Python.
+# -----------------------------------------------------------------------------
+# A statement is a piece of code that performs an action. It can be as simple
+# as a single line or a more complex block of code. The following is true
+# for all statements:
+#
+#  - A statement does not return a value.
+#  - Statements cannot be used in expressions (e.g. if, while, for).
+#  - It is a standalone operation.
+
+# Valid statements
+x = 5
+print(x)
+
+# Invalid statements
+# if (x = 5):  # SyntaxError (statement cannot be used in an expression)
diff --git a/examples/junior/01-hello-world/zen_of_python.py b/examples/junior/01-hello-world/zen_of_python.py
@@ -0,0 +1,30 @@
+# Import the `this` module to print the Zen of Python
+# -----------------------------------------------------------------------------
+# This is a fun Easter egg in Python that prints the Zen of Python, the
+# guiding principles for writing computer programs in Python. It emphasizes
+# simplicity, readability, and the importance of explicitness in code design.
+
+import this
+
+# Output:
+# The Zen of Python, by Tim Peters
+#
+# Beautiful is better than ugly.
+# Explicit is better than implicit.
+# Simple is better than complex.
+# Complex is better than complicated.
+# Flat is better than nested.
+# Sparse is better than dense.
+# Readability counts.
+# Special cases aren't special enough to break the rules.
+# Although practicality beats purity.
+# Errors should never pass silently.
+# Unless explicitly silenced.
+# In the face of ambiguity, refuse the temptation to guess.
+# There should be one-- and preferably only one --obvious way to do it.
+# Although that way may not be obvious at first unless you're Dutch.
+# Now is better than never.
+# Although never is often better than *right* now.
+# If the implementation is hard to explain, it's a bad idea.
+# If the implementation is easy to explain, it may be a good idea.
+# Namespaces are one honking great idea -- let's do more of those!
diff --git a/examples/junior/02-variables/string_cases.py b/examples/junior/02-variables/string_cases.py
@@ -1,7 +1,26 @@
-text = "HELLO world!"
+# String case manipulation examples
+# -----------------------------------------------------------------------------
+# This code demonstrates various string case manipulation methods in Python.
+
+# Store the string to be manipulated
+text = "AAAA bbbb"
+
 print(text.upper())
+# Output:
+# AAAA BBBB
+
 print(text.lower())
+# Output:
+# aaaa bbbb
+
 print(text.title())
+# Output:
+# Aaaa Bbbb
+
 print(text.capitalize())
-print(text.swapcase())
+# Output:
+# Aaaa bbbb
 
+print(text.swapcase())
+# Output:
+# aaaa BBBB
diff --git a/examples/junior/02-variables/string_concatenation.py b/examples/junior/02-variables/string_concatenation.py
@@ -1,5 +1,16 @@
+# String concatenation example
+# -----------------------------------------------------------------------------
+# This code demonstrates how to concatenate (join) strings in Python. The
+# `+` operator is used to combine multiple strings into one. This is a common
+# operation in Python, especially when constructing messages or combining
+# text from different sources.
+
+
 string1 = 'Hello'
 string2 = "World"
 string3 = "!"
+
 result = string1 + " " + string2 + string3
-print(result)
+print(result)
+# Output:
+# Hello World!
diff --git a/examples/junior/02-variables/string_escaping.py b/examples/junior/02-variables/string_escaping.py
@@ -1,2 +1,19 @@
+# Escape sequences in Python strings
+# -----------------------------------------------------------------------------
+# This code demonstrates how to use escape sequences in Python strings. Escape
+# sequences are special characters that allow you to include characters in a
+# string that would otherwise be difficult or impossible to include directly.
+#
+# Special characters:
+# - `\n` for new line
+# - `\t` for tab
+# - `\\` for backslash
+# - `\'` for single quote
+# - `\"` for double quote
+
 print("Hello\nWorld")           # Print new line inside string
-print("He said, \"Goodbye\"")   # Print double quotes inside string
+print("He said, \"Goodbye\"")   # Print double quotes inside string
+# Output:
+# Hello
+# World
+# He said, "Goodbye"
diff --git a/examples/junior/02-variables/string_indexing.py b/examples/junior/02-variables/string_indexing.py
@@ -1,4 +1,21 @@
+# String indexing
+# -----------------------------------------------------------------------------
+# This code demonstrates how to access individual characters in a string using
+# indexing. In Python, strings are sequences of characters, and you can access
+# each character by its index. The index starts at 0 for the first character,
+# and you can also use negative indices to access characters from the end
+# of the string.
+
 string = "Hello, world!"
+
 print(string[0])    # Print first character
+# Output:
+# H
+
 print(string[1])    # Print second character
+# Output:
+# e
+
 print(string[-1])   # Print last character
+# Output:
+# !
diff --git a/examples/junior/02-variables/string_interpolation.py b/examples/junior/02-variables/string_interpolation.py
@@ -1,11 +1,13 @@
-# Python 2.7+
-first_name = "Branimir"
-last_name = "Georgiev"
-age = 25
-print("My name is {0} {1} and I am {2} years old".format(first_name, last_name, age))
+# String interpolation example
+# -----------------------------------------------------------------------------
+# This code demonstrates how to use f-strings (formatted string literals) in
+# Python to create strings that include variables. F-strings allow you to
+# embed expressions inside string literals, using curly braces `{}`.
 
-# Python 3.6+
 first_name = "Branimir"
 last_name = "Georgiev"
 age = 25
-print(f"My name is {first_name} {last_name} and I am {age} years old")
+
+print(f"My name is {first_name} {last_name} and I am {age} years old")
+# Output:
+# My name is Branimir Georgiev and I am 25 years old

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Awesome Python!`
	`1`	`+# Python Tutorial`
`2`	`2`
`3`	`3`	`by Branimir Georgiev (www.codewithbranko.com)`
`4`	`4`