Jinja Min: filter function to find smallest item

n

Finding the Smallest Item with the Jinja min Filter

nThe Jinja min filter is a fundamental tool for finding the smallest item in a sequence. This filter is incredibly useful for tasks like finding the lowest price in a list of products, the earliest date in a series of events, or the lowest value in a set of numbers. It provides a simple, direct way to extract the minimum value, helping you write cleaner, more expressive templates without needing complex logic. By using min, you can make your templates more focused on presentation rather than data manipulation.nn

---

nn

How the min Filter Works

nThe min filter takes a sequence of items and returns the smallest one. The sequence can be a list of numbers, a list of strings, or a list of objects. By default, it performs a standard comparison to find the minimum. For numbers, this is a straightforward comparison of values. For strings, it compares them alphabetically.nnThe basic syntax is as follows:n

{{ my_list | min }}

nIt’s important to note that if the sequence is empty, the min filter returns an **Undefined** object, which is Jinja’s way of signaling that no value was found. This can help prevent errors in your templates if your data isn’t always present.nnThe min filter also provides two powerful optional parameters to give you more control over the comparison:n

n
• case_sensitive (boolean, default False): This parameter is useful when working with strings. When set to True, the filter will treat uppercase and lowercase letters as distinct. For example, 'A' is considered smaller than 'a' because its ASCII value is lower. If case_sensitive is False (the default), the comparison is case-insensitive.

n

• attribute (string or integer, default None): This is a powerful feature that allows you to find the object with the minimum value of a specific attribute. For example, you can use it to find the product with the lowest price in a list of product objects. The value of this parameter is the name of the attribute (e.g., 'price').

n

nn

---

nn

Practical Examples

nLet’s see the min filter in action with some practical examples.n

Example 1: Finding the Minimum Number

nThis is the most basic use case: finding the lowest value in a simple list of numbers.nnJinja Template:n

{% set temperatures = [22, 18, 25, 15, 20] %}n<p>The lowest temperature recorded was: {{ temperatures | min }}°C</p>

nRendered HTML:n

<p>The lowest temperature recorded was: 15°C</p>

nThe filter correctly identifies 15 as the smallest number in the list.n

Example 2: Finding the Minimum String (Case-Insensitive)

nBy default, string comparisons are case-insensitive.nnJinja Template:n

{% set names = ['Charlie', 'alice', 'Bob'] %}n<p>The name that comes first alphabetically is: {{ names | min }}</p>

nRendered HTML:n

<p>The name that comes first alphabetically is: alice</p>

nBecause case_sensitive is False by default, alice is treated as if it were Alice, and it comes before Bob and Charlie.n

Example 3: Finding the Minimum String (Case-Sensitive)

nTo get a different result, we can explicitly set case_sensitive to True.nnJinja Template:n

{% set names = ['Charlie', 'alice', 'Bob'] %}n<p>The name that comes first alphabetically (case-sensitive) is: {{ names | min(case_sensitive=True) }}</p>

nRendered HTML:n

<p>The name that comes first alphabetically (case-sensitive) is: Bob</p>

nWith case sensitivity enabled, Bob is smaller than Charlie because of the initial capital letter, and alice is larger than both because its initial lowercase letter has a higher ASCII value.n

Example 4: Finding the Object with the Minimum Attribute Value

nThis is where the attribute parameter shines, allowing you to find the object with the smallest value for a specific key.nnPython Code:n

# 'products' is passed to the templatenproducts = [n    {'name': 'Laptop', 'price': 1200.00},n    {'name': 'Mouse', 'price': 25.00},n    {'name': 'Keyboard', 'price': 75.00}n]

nJinja Template:n

{% set cheapest_product = products | min(attribute='price') %}n<h3>Cheapest Product: {{ cheapest_product.name }}</h3>n<p>Price: ${{ cheapest_product.price }}</p>

nRendered HTML:n

<h3>Cheapest Product: Mouse</h3>n<p>Price: $25.00</p>

nThe min filter looks at the price attribute of each object and returns the entire object for the one with the lowest value.nn

---

nn

Conclusion

nThe Jinja min filter is a simple and efficient way to find the smallest item in a sequence. With its optional parameters for case sensitivity and attribute-based comparison, it provides a flexible solution for a wide range of tasks. By using min, you can write more concise and readable templates, offloading the work of finding minimum values to Jinja’s powerful filtering system.nn