Skip to content

Commit 7b07a5a

Browse files
authored
Merge branch 'main' into main
2 parents d20b8ef + 15fed7e commit 7b07a5a

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+2114
-15
lines changed

CONTRIBUTING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@ The list of topics for which we are looking for content are provided below along
2424
- Web Scrapping - [Link](https://github.com/animator/learn-python/tree/main/contrib/web-scrapping)
2525
- API Development - [Link](https://github.com/animator/learn-python/tree/main/contrib/api-development)
2626
- Data Structures & Algorithms - [Link](https://github.com/animator/learn-python/tree/main/contrib/ds-algorithms)
27-
- Python Mini Projects - [Link](https://github.com/animator/learn-python/tree/main/contrib/mini-projects)
28-
- Python Question Bank - [Link](https://github.com/animator/learn-python/tree/main/contrib/question-bank)
27+
- Python Mini Projects - [Link](https://github.com/animator/learn-python/tree/main/contrib/mini-projects) **(Not accepting)**
28+
- Python Question Bank - [Link](https://github.com/animator/learn-python/tree/main/contrib/question-bank) **(Not accepting)**
2929

3030
You can check out some content ideas below.
3131

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,192 @@
1+
# Exception Handling in Python
2+
3+
Exception Handling is a way of managing the errors that may occur during a program execution. Python's exception handling mechanism has been designed to avoid the unexpected termination of the program, and offer to either regain control after an error or display a meaningful message to the user.
4+
5+
- **Error** - An error is a mistake or an incorrect result produced by a program. It can be a syntax error, a logical error, or a runtime error. Errors are typically fatal, meaning they prevent the program from continuing to execute.
6+
- **Exception** - An exception is an event that occurs during the execution of a program that disrupts the normal flow of instructions. Exceptions are typically unexpected and can be handled by the program to prevent it from crashing or terminating abnormally. It can be runtime, input/output or system exceptions. Exceptions are designed to be handled by the program, allowing it to recover from the error and continue executing.
7+
8+
## Python Built-in Exceptions
9+
10+
There are plenty of built-in exceptions in Python that are raised when a corresponding error occur.
11+
We can view all the built-in exceptions using the built-in `local()` function as follows:
12+
13+
```python
14+
print(dir(locals()['__builtins__']))
15+
```
16+
17+
|**S.No**|**Exception**|**Description**|
18+
|---|---|---|
19+
|1|SyntaxError|A syntax error occurs when the code we write violates the grammatical rules such as misspelled keywords, missing colon, mismatched parentheses etc.|
20+
|2|TypeError|A type error occurs when we try to perform an operation or use a function with objects that are of incompatible data types.|
21+
|3|NameError|A name error occurs when we try to use a variable, function, module or string without quotes that hasn't been defined or isn't used in a valid way.|
22+
|4|IndexError|A index error occurs when we try to access an element in a sequence (like a list, tuple or string) using an index that's outside the valid range of indices for that sequence.|
23+
|5|KeyError|A key error occurs when we try to access a key that doesn't exist in a dictionary. Attempting to retrieve a value using a non-existent key results this error.|
24+
|6|ValueError|A value error occurs when we provide an argument or value that's inappropriate for a specific operation or function such as doing mathematical operations with incompatible types (e.g., dividing a string by an integer.)|
25+
|7|AttributeError|An attribute error occurs when we try to access an attribute (like a variable or method) on an object that doesn't possess that attribute.|
26+
|8|IOError|An IO (Input/Output) error occurs when an operation involving file or device interaction fails. It signifies that there's an issue during communication between your program and the external system.|
27+
|9|ZeroDivisionError|A ZeroDivisionError occurs when we attempt to divide a number by zero. This operation is mathematically undefined, and Python raises this error to prevent nonsensical results.|
28+
|10|ImportError|An import error occurs when we try to use a module or library that Python can't find or import succesfully.|
29+
30+
## Try and Except Statement - Catching Exception
31+
32+
The `try-except` statement allows us to anticipate potential errors during program execution and define what actions to take when those errors occur. This prevents the program from crashing unexpectedly and makes it more robust.
33+
34+
Here's an example to explain this:
35+
36+
```python
37+
try:
38+
# Code that might raise an exception
39+
result = 10 / 0
40+
except:
41+
print("An error occured!")
42+
```
43+
44+
Output
45+
46+
```markdown
47+
An error occured!
48+
```
49+
50+
In this example, the `try` block contains the code that you suspect might raise an exception. Python attempts to execute the code within this block. If an exception occurs, Python jumps to the `except` block and executes the code within it.
51+
52+
## Specific Exception Handling
53+
54+
You can specify the type of expection you want to catch using the `except` keyword followed by the exception class name. You can also have multiple `except` blocks to handle different exception types.
55+
56+
Here's an example:
57+
58+
```python
59+
try:
60+
# Code that might raise ZeroDivisionError or NameError
61+
result = 10 / 0
62+
name = undefined_variable
63+
except ZeroDivisionError:
64+
print("Oops! You tried to divide by zero.")
65+
except NameError:
66+
print("There's a variable named 'undefined_variable' that hasn't been defined yet.")
67+
```
68+
69+
Output
70+
71+
```markdown
72+
Oops! You tried to divide by zero.
73+
```
74+
75+
If you comment on the line `result = 10 / 0`, then the output will be:
76+
77+
```markdown
78+
There's a variable named 'undefined_variable' that hasn't been defined yet.
79+
```
80+
81+
## Important Note
82+
83+
In this code, the `except` block are specific to each type of expection. If you want to catch both exceptions with a single `except` block, you can use of tuple of exceptions, like this:
84+
85+
```python
86+
try:
87+
# Code that might raise ZeroDivisionError or NameError
88+
result = 10 / 0
89+
name = undefined_variable
90+
except (ZeroDivisionError, NameError):
91+
print("An error occured!")
92+
```
93+
94+
Output
95+
96+
```markdown
97+
An error occured!
98+
```
99+
100+
## Try with Else Clause
101+
102+
The `else` clause in a Python `try-except` block provides a way to execute code only when the `try` block succeeds without raising any exceptions. It's like having a section of code that runs exclusively under the condition that no errors occur during the main operation in the `try` block.
103+
104+
Here's an example to understand this:
105+
106+
```python
107+
def calculate_average(numbers):
108+
if len(numbers) == 0: # Handle empty list case seperately (optional)
109+
return None
110+
try:
111+
total = sum(numbers)
112+
average = total / len(numbers)
113+
except ZeroDivisionError:
114+
print("Cannot calculate average for a list containing zero.")
115+
else:
116+
print("The average is:", average)
117+
return average #Optionally return the average here
118+
119+
# Example usage
120+
numbers = [10, 20, 30]
121+
result = calculate_average(numbers)
122+
123+
if result is not None: # Check if result is available (handles empty list case)
124+
print("Calculation succesfull!")
125+
```
126+
127+
Output
128+
129+
```markdown
130+
The average is: 20.0
131+
```
132+
133+
## Finally Keyword in Python
134+
135+
The `finally` keyword in Python is used within `try-except` statements to execute a block of code **always**, regardless of whether an exception occurs in the `try` block or not.
136+
137+
To understand this, let us take an example:
138+
139+
```python
140+
try:
141+
a = 10 // 0
142+
print(a)
143+
except ZeroDivisionError:
144+
print("Cannot be divided by zero.")
145+
finally:
146+
print("Program executed!")
147+
```
148+
149+
Output
150+
151+
```markdown
152+
Cannot be divided by zero.
153+
Program executed!
154+
```
155+
156+
## Raise Keyword in Python
157+
158+
In Python, raising an exception allows you to signal that an error condition has occured during your program's execution. The `raise` keyword is used to explicity raise an exception.
159+
160+
Let us take an example:
161+
162+
```python
163+
def divide(x, y):
164+
if y == 0:
165+
raise ZeroDivisionError("Can't divide by zero!") # Raise an exception with a message
166+
result = x / y
167+
return result
168+
169+
try:
170+
division_result = divide(10, 0)
171+
print("Result:", division_result)
172+
except ZeroDivisionError as e:
173+
print("An error occured:", e) # Handle the exception and print the message
174+
```
175+
176+
Output
177+
178+
```markdown
179+
An error occured: Can't divide by zero!
180+
```
181+
182+
## Advantages of Exception Handling
183+
184+
- **Improved Error Handling** - It allows you to gracefully handle unexpected situations that arise during program execution. Instead of crashing abruptly, you can define specific actions to take when exceptions occur, providing a smoother experience.
185+
- **Code Robustness** - Exception Handling helps you to write more resilient programs by anticipating potential issues and providing approriate responses.
186+
- **Enhanced Code Readability** - By seperating error handling logic from the core program flow, your code becomes more readable and easier to understand. The `try-except` blocks clearly indicate where potential errors might occur and how they'll be addressed.
187+
188+
## Disadvantages of Exception Handling
189+
190+
- **Hiding Logic Errors** - Relying solely on exception handling might mask underlying logic error in your code. It's essential to write clear and well-tested logic to minimize the need for excessive exception handling.
191+
- **Performance Overhead** - In some cases, using `try-except` blocks can introduce a slight performance overhead compared to code without exception handling. Howerer, this is usually negligible for most applications.
192+
- **Overuse of Exceptions** - Overusing exceptions for common errors or control flow can make code less readable and harder to maintain. It's important to use exceptions judiciously for unexpected situations.

contrib/advanced-python/index.md

+1
Original file line numberDiff line numberDiff line change
@@ -8,3 +8,4 @@
88
- [JSON module](json-module.md)
99
- [Map Function](map-function.md)
1010
- [Protocols](protocols.md)
11+
- [Exception Handling in Python](exception-handling.md)

contrib/api-development/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# List of sections
22

33
- [API Methods](api-methods.md)
4-
- [FastAPI](fast-api.md)
4+
- [FastAPI](fast-api.md)

contrib/ds-algorithms/index.md

+3
Original file line numberDiff line numberDiff line change
@@ -10,3 +10,6 @@
1010
- [Greedy Algorithms](greedy-algorithms.md)
1111
- [Dynamic Programming](dynamic-programming.md)
1212
- [Linked list](linked-list.md)
13+
- [Stacks in Python](stacks.md)
14+
- [Sliding Window Technique](sliding-window.md)
15+
- [Trie](trie.md)

0 commit comments

Comments
 (0)