Skip to content

Commit 4df2cb9

Browse files
authored
Merge branch 'main' into main
2 parents 0189c28 + 0595830 commit 4df2cb9

Some content is hidden

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

49 files changed

+2133
-28
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
@@ -7,3 +7,4 @@
77
- [Regular Expressions in Python](regular_expressions.md)
88
- [JSON module](json-module.md)
99
- [Map Function](map-function.md)
10+
- [Exception Handling in Python](exception-handling.md)

contrib/database/index.md

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

33
- [Introduction to MySQL and Queries](intro_mysql_queries.md)
4+
- [SQLAlchemy and Aggregation Functions](sqlalchemy-aggregation.md)
+123
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,123 @@
1+
# SQLAlchemy
2+
SQLAlchemy is a powerful and flexible SQL toolkit and Object-Relational Mapping (ORM) library for Python. It is a versatile library that bridges the gap between Python applications and relational databases.
3+
4+
SQLAlchemy allows the user to write database-agnostic code that can work with a variety of relational databases such as SQLite, MySQL, PostgreSQL, Oracle, and Microsoft SQL Server. The ORM layer in SQLAlchemy allows developers to map Python classes to database tables. This means you can interact with your database using Python objects instead of writing raw SQL queries.
5+
6+
## Setting up the Environment
7+
* Python and MySQL Server must be installed and configured.
8+
* The library: **mysql-connector-python** and **sqlalchemy** must be installed.
9+
10+
```bash
11+
pip install sqlalchemy mysql-connector-python
12+
```
13+
14+
* If not installed, you can install them using the above command in terminal,
15+
16+
## Establishing Connection with Database
17+
18+
* Create a connection with the database using the following code snippet:
19+
```python
20+
from sqlalchemy import create_engine
21+
from sqlalchemy.orm import declarative_base
22+
from sqlalchemy.orm import sessionmaker
23+
24+
DATABASE_URL = 'mysql+mysqlconnector://root:12345@localhost/gssoc'
25+
26+
engine = create_engine(DATABASE_URL)
27+
Session = sessionmaker(bind=engine)
28+
session = Session()
29+
30+
Base = declarative_base()
31+
```
32+
33+
* The connection string **DATABASE_URL** is passed as an argument to **create_engine** function which is used to create a connection to the database. This connection string contains the database credentials such as the database type, username, password, and database name.
34+
* The **sessionmaker** function is used to create a session object which is used to interact with the database
35+
* The **declarative_base** function is used to create a base class for all the database models. This base class is used to define the structure of the database tables.
36+
37+
## Creating Tables
38+
39+
* The following code snippet creates a table named **"products"** in the database:
40+
```python
41+
from sqlalchemy import Column, Integer, String, Float
42+
43+
class Product(Base):
44+
__tablename__ = 'products'
45+
id = Column(Integer, primary_key=True)
46+
name = Column(String(50))
47+
category = Column(String(50))
48+
price = Column(Float)
49+
quantity = Column(Integer)
50+
51+
Base.metadata.create_all(engine)
52+
```
53+
54+
* The **Product class** inherits from **Base**, which is a base class for all the database models.
55+
* The **Base.metadata.create_all(engine)** statement is used to create the table in the database. The engine object is a connection to the database that was created earlier.
56+
57+
## Inserting Data for Aggregation Functions
58+
59+
* The following code snippet inserts data into the **"products"** table:
60+
```python
61+
products = [
62+
Product(name='Laptop', category='Electronics', price=1000, quantity=50),
63+
Product(name='Smartphone', category='Electronics', price=700, quantity=150),
64+
Product(name='Tablet', category='Electronics', price=400, quantity=100),
65+
Product(name='Headphones', category='Accessories', price=100, quantity=200),
66+
Product(name='Charger', category='Accessories', price=20, quantity=300),
67+
]
68+
69+
session.add_all(products)
70+
session.commit()
71+
```
72+
73+
* A list of **Product** objects is created. Each Product object represents a row in the **products table** in the database.
74+
* The **add_all** method of the session object is used to add all the Product objects to the session. This method takes a **list of objects as an argument** and adds them to the session.
75+
* The **commit** method of the session object is used to commit the changes made to the database.
76+
77+
## Aggregation Functions
78+
79+
SQLAlchemy provides functions that correspond to SQL aggregation functions and are available in the **sqlalchemy.func module**.
80+
81+
### COUNT
82+
83+
The **COUNT** function returns the number of rows in a result set. It can be demonstrated using the following code snippet:
84+
```python
85+
from sqlalchemy import func
86+
87+
total_products = session.query(func.count(Product.id)).scalar()
88+
print(f'Total products: {total_products}')
89+
```
90+
91+
### SUM
92+
93+
The **SUM** function returns the sum of all values in a column. It can be demonstrated using the following code snippet:
94+
```python
95+
total_price = session.query(func.sum(Product.price)).scalar()
96+
print(f'Total price of all products: {total_price}')
97+
```
98+
99+
### AVG
100+
101+
The **AVG** function returns the average of all values in a column. It can be demonstrated by the following code snippet:
102+
```python
103+
average_price = session.query(func.avg(Product.price)).scalar()
104+
print(f'Average price of products: {average_price}')
105+
```
106+
107+
### MAX
108+
109+
The **MAX** function returns the maximum value in a column. It can be demonstrated using the following code snippet :
110+
```python
111+
max_price = session.query(func.max(Product.price)).scalar()
112+
print(f'Maximum price of products: {max_price}')
113+
```
114+
115+
### MIN
116+
117+
The **MIN** function returns the minimum value in a column. It can be demonstrated using the following code snippet:
118+
```python
119+
min_price = session.query(func.min(Product.price)).scalar()
120+
print(f'Minimum price of products: {min_price}')
121+
```
122+
123+
In general, the aggregation functions can be implemented by utilising the **session** object to execute the desired query on the table present in a database using the **query()** method. The **scalar()** method is called on the query object to execute the query and return a single value

contrib/ds-algorithms/index.md

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

3+
- [Time & Space Complexity](time-space-complexity.md)
34
- [Queues in Python](Queues.md)
45
- [Graphs](graph.md)
56
- [Sorting Algorithms](sorting-algorithms.md)

0 commit comments

Comments
 (0)