Non-empty container types

Feature

It would be very helpful to have a way of specifying that a container type must be non-empty.

Pitch

As an example of why this feature would be helpful, consider the following function, average:

from typing import List


def average(numbers: List[float]) -> float:
    """Return the average of a non-empty list of numbers."""
    return sum(numbers) / len(numbers)

Rather than relying on exceptions for handling the case when the number of numbers is zero, is seems like something along the lines of the following would be more convenient and more explicit:

from typing import List, NonEmpty


def average(numbers: NonEmpty[List[float]]) -> float:
    """Return the average of a non-empty list of numbers."""
    return sum(numbers) / len(numbers)

I don't know anything about the way mypy is implemented so I'm not sure if this is a possible.

La issue propone un tipo NonEmpty per le annotazioni dei container Python, illustrato con NonEmpty[List[float]] e la funzione average. Inizia esaminando il supporto esistente di mypy per il sistema dei tipi e i costrutti di typing; la issue non indica file né test. Per considerare il lavoro completato sarebbero necessari un design concordato e un controllo dei tipi che preservi l’invariante del container non vuoto.