En Python, usando argparse, permita solo números enteros positivos

El título resume bastante bien lo que me gustaría que sucediera.

Esto es lo que tengo, y aunque el programa no explota en un número entero no positivo, quiero que el usuario sepa que un número entero no positivo es básicamente una tontería.

import argparse
parser = argparse.ArgumentParser()
parser.add_argument("-g", "--games", type=int, default=162,
                    help="The number of games to simulate")
args = parser.parse_args()

Y la salida:

python simulate_many.py -g 20
Setting up...
Playing games...
....................

Salida con un negativo:

python simulate_many.py -g -2
Setting up...
Playing games...

Ahora, obviamente podría agregar un si para determinar if args.games es negativo, pero tenía curiosidad por saber si había una manera de atraparlo en el argparse nivel, para aprovechar la impresión de uso automático.

Idealmente, imprimiría algo similar a esto:

python simulate_many.py -g a
usage: simulate_many.py [-h] [-g GAMES] [-d] [-l LEAGUE]
simulate_many.py: error: argument -g/--games: invalid int value: 'a'

Al igual que:

python simulate_many.py -g -2
usage: simulate_many.py [-h] [-g GAMES] [-d] [-l LEAGUE]
simulate_many.py: error: argument -g/--games: invalid positive int value: '-2'

Por ahora estoy haciendo esto, y supongo que estoy feliz:

if args.games <= 0:
    parser.print_help()
    print "-g/--games: must be positive."
    sys.exit(1)

Esto debería ser posible utilizando type. Aún deberá definir un método real que decida esto por usted:

def check_positive(value):
    ivalue = int(value)
    if ivalue <= 0:
        raise argparse.ArgumentTypeError("%s is an invalid positive int value" % value)
    return ivalue

parser = argparse.ArgumentParser(...)
parser.add_argument('foo', type=check_positive)

Esto es básicamente solo un ejemplo adaptado del perfect_square función en el documentos en argparse.

type sería la opción recomendada para manejar condiciones/controles, como en la respuesta de Yuushi.

En tu caso concreto, también puedes utilizar el choices parámetro si también se conoce su límite superior:

parser.add_argument('foo', type=int, choices=xrange(5, 10))

Nota: Usar range en vez de xrange para pitón 3.x

La forma rápida y sucia, si tiene un máximo predecible y un mínimo para su argumento, es usar choices con un rango

parser.add_argument('foo', type=int, choices=xrange(0, 1000))

Una alternativa más simple, especialmente si se subclasifica argparse.ArgumentParseres iniciar la validación desde dentro del parse_args método.

Dentro de tal subclase:

def parse_args(self, args=None, namespace=None):
    """Parse and validate args."""
    namespace = super().parse_args(args, namespace)
    if namespace.games <= 0:
         raise self.error('The number of games must be a positive integer.')
    return namespace

Esta técnica puede no ser tan genial como un invocable personalizado, pero hace el trabajo.

Sobre ArgumentParser.error(message):

Este método imprime un mensaje de uso que incluye el mensaje de error estándar y finaliza el programa con un código de estado de 2.

Crédito: respuesta de jonatan

En caso de que alguien (como yo) encuentre esta pregunta en una búsqueda de Google, aquí hay un ejemplo de cómo usar un enfoque modular para resolver claramente el problema más general de permitir números enteros argparse solo en un rango especificado:

# Custom argparse type representing a bounded int
class IntRange:

    def __init__(self, imin=None, imax=None):
        self.imin = imin
        self.imax = imax

    def __call__(self, arg):
        try:
            value = int(arg)
        except ValueError:
            raise self.exception()
        if (self.imin is not None and value < self.imin) or (self.imax is not None and value > self.imax):
            raise self.exception()
        return value

    def exception(self):
        if self.imin is not None and self.imax is not None:
            return argparse.ArgumentTypeError(f"Must be an integer in the range [{self.imin}, {self.imax}]")
        elif self.imin is not None:
            return argparse.ArgumentTypeError(f"Must be an integer >= {self.imin}")
        elif self.imax is not None:
            return argparse.ArgumentTypeError(f"Must be an integer <= {self.imax}")
        else:
            return argparse.ArgumentTypeError("Must be an integer")

Esto le permite hacer algo como:

parser = argparse.ArgumentParser(...)
parser.add_argument('foo', type=IntRange(1))     # Must have foo >= 1
parser.add_argument('bar', type=IntRange(1, 7))  # Must have 1 <= bar <= 7

La variable foo ahora solo permite enteros positivoscomo preguntó el OP.

Tenga en cuenta que, además de las formas anteriores, también es posible un máximo con IntRange:

parser.add_argument('other', type=IntRange(imax=10))  # Must have other <= 10

Según la respuesta de Yuushi, también puede definir una función de ayuda simple que puede verificar si un número es positivo para varios tipos numéricos:

def positive(numeric_type):
    def require_positive(value):
        number = numeric_type(value)
        if number <= 0:
            raise ArgumentTypeError(f"Number {value} must be positive.")
        return number

    return require_positive

La función auxiliar se puede utilizar para anotar cualquier tipo de argumento numérico como este:

parser = argparse.ArgumentParser(...)
parser.add_argument("positive-integer", type=positive(int))
parser.add_argument("positive-float", type=positive(float))