Python ValueError

What It Means

ValueError is raised when a function or operation receives an argument that has the right type but an inappropriate value. For example, calling int("abc") — the argument is a string (correct type for int()), but "abc" cannot be converted to an integer.

Common Causes

• Converting a non-numeric string to int or float (int("abc"))
• Unpacking the wrong number of values
• Passing an out-of-range value to a function
• Invalid argument to math functions (e.g., math.sqrt(-1))
• datetime parsing with wrong format
• json.loads() on invalid JSON
• Removing a value from a list that doesn’t contain it

How to Fix

Fix string-to-number conversion

# Error: ValueError: invalid literal for int() with base 10: 'abc'
number = int("abc")

# Fix: validate before converting
value = "123abc"
if value.isdigit():
    number = int(value)
else:
    print(f"Cannot convert '{value}' to int")

# Or use try/except
def safe_int(value, default=0):
    try:
        return int(value)
    except ValueError:
        return default

number = safe_int("abc", default=0)

Fix unpacking errors

# Error: ValueError: too many values to unpack (expected 2)
a, b = [1, 2, 3]

# Fix: match the number of variables
a, b, c = [1, 2, 3]

# Or use * to capture extras
a, *rest = [1, 2, 3]  # a=1, rest=[2, 3]
first, *middle, last = [1, 2, 3, 4]  # first=1, middle=[2, 3], last=4

# Error: ValueError: not enough values to unpack (expected 3, got 2)
a, b, c = [1, 2]

# Fix: ensure the sequence has enough values
values = [1, 2]
a, b, c = values + [None] * (3 - len(values))

Fix datetime parsing

from datetime import datetime

# Error: ValueError: time data '2024-01-15' does not match format '%m/%d/%Y'
date = datetime.strptime("2024-01-15", "%m/%d/%Y")

# Fix: use the correct format
date = datetime.strptime("2024-01-15", "%Y-%m-%d")
date = datetime.strptime("01/15/2024", "%m/%d/%Y")

# Or use dateutil for flexible parsing
from dateutil import parser
date = parser.parse("2024-01-15")  # Handles many formats

Fix JSON parsing

import json

# Error: ValueError (json.JSONDecodeError): Expecting value
data = json.loads("")          # Empty string
data = json.loads("undefined") # Not valid JSON

# Fix: validate input
def safe_json_loads(text):
    try:
        return json.loads(text)
    except (json.JSONDecodeError, ValueError):
        return None

# Fix: ensure valid JSON
data = json.loads('{"key": "value"}')  # Use double quotes in JSON

Fix list.remove()

# Error: ValueError: list.remove(x): x not in list
my_list = [1, 2, 3]
my_list.remove(4)

# Fix: check before removing
if 4 in my_list:
    my_list.remove(4)

# Or use discard() with sets
my_set = {1, 2, 3}
my_set.discard(4)  # No error even if not present

Fix math errors

import math

# Error: ValueError: math domain error
result = math.sqrt(-1)
result = math.log(0)

# Fix: validate inputs
if x >= 0:
    result = math.sqrt(x)

# Or use cmath for complex numbers
import cmath
result = cmath.sqrt(-1)  # Returns 1j

Related Errors

• Python TypeError - Wrong type entirely (e.g., passing a list where a string is expected).
• Python KeyError - Missing dictionary key, a different kind of “value not found.”
• Python IndexError - List index out of range.