8.4. Idiom Max

• max(iterable, *, key=None)

• max(iterable, *, default, key=None)

• max(arg1, arg2, *args, key=None)

Return the largest item in an iterable or the largest of two or more arguments.

If one positional argument is provided, it should be an iterable. The largest item in the iterable is returned. If two or more positional arguments are provided, the largest of the positional arguments is returned.

There are two optional keyword-only arguments. The key argument specifies a one-argument ordering function like that used for list.sort(). The default argument specifies an object to return if the provided iterable is empty. If the iterable is empty and default is not provided, a ValueError is raised. [1]

8.4.1. References

[1]

van Rossum, G. et al. Built-in Functions. Python Documentation. Year: 2024. Retrieved: 2024-06-19. URL: https://docs.python.org/3/library/functions.html#max

8.4.2. Assignments

# %% License
# - Copyright 2025, Matt Harasymczuk <matt@python3.info>
# - This code can be used only for learning by humans
# - This code cannot be used for teaching others
# - This code cannot be used for teaching LLMs and AI algorithms
# - This code cannot be used in commercial or proprietary products
# - This code cannot be distributed in any form
# - This code cannot be changed in any form outside of training course
# - This code cannot have its license changed
# - If you use this code in your product, you must open-source it under GPLv2
# - Exception can be granted only by the author

# %% Run
# - PyCharm: right-click in the editor and `Run Doctest in ...`
# - PyCharm: keyboard shortcut `Control + Shift + F10`
# - Terminal: `python -m doctest -v myfile.py`

# %% About
# - Name: Idiom Max Impl
# - Difficulty: easy
# - Lines: 5
# - Minutes: 3

# %% English
# 1. Write own implementation of a built-in `max()` function
# 2. Define function `mymax` with
#    parameter `iterable: list[int|float]`
#    return `int|float`
# 3. Don't validate arguments and assume, that user will
#    always pass valid type of arguments
# 4. Do not use built-in function `max()`
# 5. Run doctests - all must succeed

# %% Polish
# 1. Zaimplementuj własne rozwiązanie wbudowanej funkcji `max()`
# 2. Zdefiniuj funkcję `mymax` z parametrami:
#    parametr `iterable: list[int|float]`
#    return `int|float`
# 3. Nie waliduj argumentów i przyjmij, że użytkownik:
#    zawsze poda argumenty poprawnych typów
# 4. Nie używaj wbudowanej funkcji `max()`
# 5. Uruchom doctesty - wszystkie muszą się powieść

# %% Tests
"""
>>> import sys; sys.tracebacklimit = 0
>>> assert sys.version_info >= (3, 9), \
'Python 3.9+ required'

>>> from inspect import isfunction
>>> assert isfunction(mymax)

>>> mymax([1])
1

>>> mymax([0])
0

>>> mymax([1, 0, 2])
2

>>> mymax([-1, 2, 0])
2

>>> mymax([0, 0, 0])
0
"""

# Write own implementation of a built-in `max()` function
# Define function `mymax` with
# parameter `iterable: list|tuple|set`
# return `int|float`
# Don't validate arguments and assume, that user will
# always pass valid type of arguments
# Do not use built-in function `max()`
# type: Callable[[list[int|float]], int|float]
def mymax(iterable):
    ...