Custom error messages in Python

Introduction

Custom error messages help you explain what went wrong in your program in a clear and friendly way.

When you want to tell the user why their input is not accepted.

When you want to make debugging easier by showing specific problems.

When you want to stop the program if something important is missing or wrong.

When you want to guide someone using your code on how to fix errors.

When you want to replace confusing default error messages with simple ones.

Syntax

Python

raise ExceptionType("Your custom error message here")

You can use built-in exceptions like ValueError, TypeError, or create your own.

The message inside quotes explains the error in simple words.

Examples

This stops the program and shows a message if a value is wrong.

Python

raise ValueError("Please enter a positive number")

This checks a condition and raises an error with a custom message.

Python

if age < 0:
    raise ValueError("Age cannot be negative")

You can create your own error type and use it with a message.

Python

class MyError(Exception):
    pass

raise MyError("Something special went wrong")

Sample Program

This program checks if the temperature is below absolute zero. If yes, it stops and shows a clear error message.

Python

def check_temperature(temp):
    if temp < -273.15:
        raise ValueError("Temperature cannot be below absolute zero!")
    print(f"Temperature is {temp} degrees Celsius.")

try:
    check_temperature(-300)
except ValueError as e:
    print(f"Error: {e}")

Important Notes

Always make your error messages clear and helpful.

Use try-except blocks to catch and handle errors gracefully.

Custom errors improve user experience and debugging.

Summary

Custom error messages explain problems clearly.

Use raise with a message to stop the program when needed.

Catch errors with try-except to handle them nicely.

Practice

1. What is the main purpose of using raise ValueError('Custom message') in Python?

easy

A. To print a warning message without stopping the program.

B. To stop the program and show a specific error message when a condition is not met.

C. To automatically fix errors in the code.

D. To ignore errors and continue running the program.

Solution

1. Step 1: Understand the raise statement

   The raise keyword is used to stop the program and throw an error.

2. Step 2: Purpose of custom messages

   Adding a message like 'Custom message' helps explain why the error happened.

3. Final Answer:

   To stop the program and show a specific error message when a condition is not met. -> Option B

4. Quick Check:

   raise with message = stop and explain error [OK]

Hint: Raise errors to stop and explain problems clearly [OK]

Common Mistakes:

• Thinking raise only prints messages without stopping
• Confusing raise with print or logging
• Believing raise fixes errors automatically

2. Which of the following is the correct syntax to raise a custom error with message "Invalid input"?

easy

A. raise 'Invalid input' ValueError

B. throw ValueError('Invalid input')

C. error ValueError('Invalid input')

D. raise ValueError('Invalid input')

Solution

1. Step 1: Identify the correct keyword

   In Python, raise is used to throw errors, not throw or error.

2. Step 2: Correct order of error and message

   The syntax is raise ErrorType('message'), so the error type comes first, then the message in parentheses.

3. Final Answer:

   raise ValueError('Invalid input') -> Option D

4. Quick Check:

   raise + ErrorType('message') = correct syntax [OK]

Hint: Use raise ErrorType('message') to create custom errors [OK]

Common Mistakes:

• Using throw instead of raise
• Placing message before error type
• Missing parentheses around the message

3. What will be the output of this code?

def check_age(age):
    if age < 18:
        raise ValueError('Age must be 18 or older')
    return 'Access granted'

print(check_age(16))

medium

A. Access granted

B. None

C. ValueError: Age must be 18 or older

D. SyntaxError

Solution

1. Step 1: Check the condition in the function

   The function raises a ValueError if age is less than 18. Here, age is 16, so the error triggers.

2. Step 2: Understand what happens on raise

   When the error is raised, the program stops and shows the error message instead of returning 'Access granted'.

3. Final Answer:

   ValueError: Age must be 18 or older -> Option C

4. Quick Check:

   raise triggers error output = ValueError message [OK]

Hint: If condition fails, raise stops and shows error message [OK]

Common Mistakes:

• Expecting function to return 'Access granted' anyway
• Confusing error message with print output
• Thinking raise prints message but continues

4. Find the error in this code snippet:

def check_number(num):
    if num < 0:
        raise 'Negative number error'
    return 'Number is positive'

print(check_number(-5))

medium

A. You cannot raise a string directly; it must be an Exception type.

B. The raise statement is missing parentheses.

C. The function should return None instead of a string.

D. The if condition should be num > 0.

Solution

1. Step 1: Check the raise statement

   The code tries to raise a string directly, which is not allowed in Python. Only Exception types can be raised.

2. Step 2: Correct way to raise errors

   Use raise ValueError('message') or another Exception class, not a plain string.

3. Final Answer:

   You cannot raise a string directly; it must be an Exception type. -> Option A

4. Quick Check:

   raise must use Exception type, not string [OK]

Hint: Always raise Exception objects, not strings [OK]

Common Mistakes:

• Raising strings instead of Exception classes
• Forgetting to include parentheses with message
• Changing condition incorrectly

5. You want to create a function validate_score(score) that raises a ValueError with the message "Score must be between 0 and 100" if the score is outside this range. Which code correctly implements this?

hard

A. def validate_score(score):
if score < 0 or score > 100:
raise ValueError('Score must be between 0 and 100')
return 'Valid score'

B. def validate_score(score):
if 0 <= score <= 100:
raise ValueError('Score must be between 0 and 100')
return 'Valid score'

C. def validate_score(score):
if score < 0 and score > 100:
raise ValueError('Score must be between 0 and 100')
return 'Valid score'

D. def validate_score(score):
if score == 0 or score == 100:
raise ValueError('Score must be between 0 and 100')
return 'Valid score'

Solution

1. Step 1: Understand the valid range condition

   The score is valid if it is between 0 and 100 inclusive. So invalid means less than 0 or greater than 100.

2. Step 2: Check the if condition logic

   def validate_score(score): if score < 0 or score > 100: raise ValueError('Score must be between 0 and 100') return 'Valid score' correctly uses if score < 0 or score > 100 to detect invalid scores and raise the error.

3. Final Answer:

   def validate_score(score): if score < 0 or score > 100: raise ValueError('Score must be between 0 and 100') return 'Valid score' -> Option A

4. Quick Check:

   Use or for invalid range, raise error if outside [OK]

Hint: Raise error if score is less than 0 or greater than 100 [OK]

Common Mistakes:

• Using and instead of or in condition
• Raising error for valid scores instead of invalid
• Checking only equality instead of range