Answer: Applying paginator to images

image_paginator.py

import streamlit as st
import itertools

def paginator(label, items, items_per_page=10, on_sidebar=True):
    """Lets the user paginate a set of items.

    Parameters
    ----------
    label : str
        The label to display over the pagination widget.
    items : Iterator[Any]
        The items to display in the paginator.
    items_per_page: int
        The number of items to display per page.
    on_sidebar: bool
        Whether to display the paginator widget on the sidebar.
        
    Returns
    -------
    Iterator[Tuple[int, Any]]
        An iterator over *only the items on that page*, including
        the item's index.

    Example
    -------
    This shows how to display a few pages of fruit.
    >>> fruit_list = [
    ...     'Kiwifruit', 'Honeydew', 'Cherry', 'Honeyberry', 'Pear',
    ...     'Apple', 'Nectarine', 'Soursop', 'Pineapple', 'Satsuma',
    ...     'Fig', 'Huckleberry', 'Coconut', 'Plantain', 'Jujube',
    ...     'Guava', 'Clementine', 'Grape', 'Tayberry', 'Salak',
    ...     'Raspberry', 'Loquat', 'Nance', 'Peach', 'Akee'
    ... ]
    ...
    ... for i, fruit in paginator("Select a fruit page", fruit_list):
    ...     st.write('%s. **%s**' % (i, fruit))
    """

    # Figure out where to display the paginator
    if on_sidebar:
        location = st.sidebar.empty()
    else:
        location = st.empty()

    # Display a pagination selectbox in the specified location.
    items = list(items)
    n_pages = len(items)
    n_pages = (len(items) - 1) // items_per_page + 1
    page_format_func = lambda i: "Page %s" % i
    page_number = location.selectbox(label, range(n_pages), format_func=page_format_func)

    # Iterate over the items in the page to let the user display them.
    min_index = page_number * items_per_page
    max_index = min_index + items_per_page
    return itertools.islice(enumerate(items), min_index, max_index)

def demonstrate_image_pagination():
    sunset_imgs = [
        'https://unsplash.com/photos/-IMlv9Jlb24/download?force=true',
        'https://unsplash.com/photos/ESEnXckWlLY/download?force=true',
        'https://unsplash.com/photos/mOcdke2ZQoE/download?force=true',
        'https://unsplash.com/photos/GPPAjJicemU/download?force=true',
        'https://unsplash.com/photos/JFeOy62yjXk/download?force=true',
        'https://unsplash.com/photos/kEgJVDkQkbU/download?force=true',
        'https://unsplash.com/photos/i9Q9bc-WgfE/download?force=true',
        'https://unsplash.com/photos/tIL1v1jSoaY/download?force=true',
        'https://unsplash.com/photos/-G3rw6Y02D0/download?force=true',
        'https://unsplash.com/photos/xP_AGmeEa6s/download?force=true',
        'https://unsplash.com/photos/4iTVoGYY7bM/download?force=true',
        'https://unsplash.com/photos/mBQIfKlvowM/download?force=true',
        'https://unsplash.com/photos/A-11N8ItHZo/download?force=true',
        'https://unsplash.com/photos/kOqBCFsGTs8/download?force=true',
        'https://unsplash.com/photos/8DMuvdp-vso/download?force=true'
    ]
    image_iterator = paginator("Select a sunset page", sunset_imgs)
    indices_on_page, images_on_page = map(list, zip(*image_iterator))
    st.image(images_on_page, width=100, caption=indices_on_page)


if __name__ == '__main__':
    demonstrate_image_pagination()