Cómo Utilizar Pycharm
Cómo Utilizar Pycharm
Cómo Utilizar Pycharm
4.1. La sentencia if
Tal vez el tipo más conocido de sentencia sea el if. Por ejemplo:
>>>
>>> x = int(input("Please enter an integer: "))
Please enter an integer: 42
>>> if x < 0:
... x = 0
... print('Negative changed to zero')
... elif x == 0:
... print('Zero')
... elif x == 1:
... print('Single')
... else:
... print('More')
...
More
Puede haber cero o más bloques elif, y el bloque else es opcional. La palabra
reservada elif es una abreviación de “else if”, y es útil para evitar un sangrado excesivo.
Una secuencia if … elif … elif … sustituye las
sentencias switch o case encontradas en otros lenguajes.
Si necesitas comparar un mismo valor con muchas constantes, o comprobar que tenga un
tipo o atributos específicos puede que encuentres útil la sentencia match. Para más detalles
véase La sentencia match.
>>>
>>> # Measure some strings:
... words = ['cat', 'window', 'defenestrate']
>>> for w in words:
... print(w, len(w))
...
cat 3
window 6
defenestrate 12
Código que modifica una colección mientras se itera sobre la misma colección puede ser
complejo de hacer bien. Sin embargo, suele ser más directo iterar sobre una copia de la
colección o crear una nueva colección:
>>>
>>> for i in range(5):
... print(i)
...
0
1
2
3
4
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
El valor final dado nunca es parte de la secuencia; range(10) genera 10 valores, los
índices correspondientes para los ítems de una secuencia de longitud 10. Es posible hacer
que el rango empiece con otro número, o especificar un incremento diferente (incluso
negativo; algunas veces se lo llama “paso”):
>>>
>>> list(range(5, 10))
[5, 6, 7, 8, 9]
Para iterar sobre los índices de una secuencia, puedes combinar range() y len() así:
>>>
>>> a = ['Mary', 'had', 'a', 'little', 'lamb']
>>> for i in range(len(a)):
... print(i, a[i])
...
0 Mary
1 had
2 a
3 little
4 lamb
>>>
>>> range(10)
range(0, 10)
El objeto retornado por range() se comporta de muchas maneras como si fuera una lista,
pero no lo es. Es un objeto que retorna los ítems sucesivos de la secuencia deseada cuando
iteras sobre él, pero realmente no construye la lista, ahorrando entonces espacio.
Decimos que tal objeto es iterable; esto es, que se puede usar en funciones y construcciones
que esperan algo de lo cual obtener ítems sucesivos hasta que se termine. Hemos visto que
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
la declaración for es una de esas construcciones, mientras que un ejemplo de función que
toma un iterable es la función sum():
>>>
>>> sum(range(4)) # 0 + 1 + 2 + 3
6
Más adelante veremos otras funciones que aceptan iterables cómo argumentos o retornan
iterables. En el capítulo Estructuras de datos, discutiremos en más detalle sobre la list().
En un bucle for, la cláusula else se ejecuta después de que el bucle alcance su iteración
final.
En un bucle while, se ejecuta después de que la condición del bucle se vuelva falsa.
>>>
>>> for n in range(2, 10):
... for x in range(2, n):
... if n % x == 0:
... print(n, 'equals', x, '*', n//x)
... break
... else:
... # loop fell through without finding a factor
... print(n, 'is a prime number')
...
2 is a prime number
3 is a prime number
4 equals 2 * 2
5 is a prime number
6 equals 2 * 3
7 is a prime number
8 equals 2 * 4
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
9 equals 3 * 3
(Sí, este es el código correcto. Fíjate bien: el else pertenece al ciclo for, no al if.)
Cuando se usa con un bucle, la cláusula else tiene más en común con el else de una
sentencia try que con el de un if: en una sentencia try la cláusula else se ejecuta
cuando no se genera ninguna excepción, y el else de un bucle se ejecuta cuando no hay
ningún break. Para más sobre la declaración try y excepciones, mira Gestionando
excepciones.
>>>
>>> for num in range(2, 10):
... if num % 2 == 0:
... print("Found an even number", num)
... continue
... print("Found an odd number", num)
...
Found an even number 2
Found an odd number 3
Found an even number 4
Found an odd number 5
Found an even number 6
Found an odd number 7
Found an even number 8
Found an odd number 9
>>>
>>> while True:
... pass # Busy-wait for keyboard interrupt (Ctrl+C)
...
>>>
>>> class MyEmptyClass:
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
... pass
...
Otro lugar donde se puede usar pass es como una marca de lugar para una función o un
cuerpo condicional cuando estás trabajando en código nuevo, lo cual te permite pensar a un
nivel de abstracción mayor. El pass se ignora silenciosamente:
>>>
>>> def initlog(*args):
... pass # Remember to implement this!
...
La forma más simple compara un valor expuesto con uno o más literales:
def http_error(status):
match status:
case 400:
return "Bad request"
case 404:
return "Not found"
case 418:
return "I'm a teapot"
case _:
return "Something's wrong with the internet"
Los patrones pueden también verse como asignaciones que desempaquetan, y pueden
usarse para ligar variables:
¡Observa éste caso con cuidado! El primer patrón tiene dos literales y puede considerarse
una extensión del patrón literal que se mostró anteriormente. Pero los siguientes dos
patrones combinan un literal y una variable, y la variable liga uno de los elementos del
sujeto (point). El cuarto patrón captura ambos elementos, lo que lo hace conceptualmente
similar a la asignación que desempaqueta (x, y) = point.
Si estás usando clases para estructurar tus datos, puedes usar el nombre de la clase seguida
de una lista de argumentos similar a la de un constructor, pero con la capacidad de capturar
atributos en variables:
class Point:
def __init__(self, x, y):
self.x = x
self.y = y
def where_is(point):
match point:
case Point(x=0, y=0):
print("Origin")
case Point(x=0, y=y):
print(f"Y={y}")
case Point(x=x, y=0):
print(f"X={x}")
case Point():
print("Somewhere else")
case _:
print("Not a point")
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
Puedes usar argumentos posicionales en algunas clases incorporadas que proveen un orden
para sus atributos (por ej. dataclasses). También puedes definir una posición especifica para
los atributos de los patrones si asignas en tu clase el atributo especial __match_args__.
Si le asignas («x», «y»), los siguientes patrones son todos equivalentes entre sí (y todos
ligan el atributo y a la variable var):
Point(1, var)
Point(1, y=var)
Point(x=1, y=var)
Point(y=var, x=1)
Una recomendación para leer patrones es verlos como una forma extendida de lo que
pondrías en el lado izquierdo de una asignación, para así entender cuáles variables tomarían
qué valores. Sólo los nombres que aparecen por si solos (cómo var arriba) son asignados
por una sentencia match. Nunca se asigna a los nombres con puntos (como foo.bar),
nombres de atributos (los x= e y= arriba) o nombres de clases (reconocidos por los «(…)»
junto a ellos, como Point arriba).
Los patrones pueden anidarse arbitrariamente. Por ejemplo, si tuviéramos una lista corta de
puntos, con __match_args__ añadido, podríamos aplicar match así:
class Point:
__match_args__ = ('x', 'y')
def __init__(self, x, y):
self.x = x
self.y = y
match points:
case []:
print("No points")
case [Point(0, 0)]:
print("The origin")
case [Point(x, y)]:
print(f"Single point {x}, {y}")
case [Point(0, y1), Point(0, y2)]:
print(f"Two on the Y axis at {y1}, {y2}")
case _:
print("Something else")
match point:
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
case Point(x, y) if x == y:
print(f"Y=X at {x}")
case Point(x, y):
print(f"Not on the diagonal")
Al igual que las asignaciones con desempaquetado, los patrones de lista o tupla
tienen exactamente el mismo sentido y realmente coinciden con cualquier secuencia
arbitraria. Una excepción importante es que no coinciden ni con iteradores ni con
cadenas de caracteres.
Los patrones de secuencia soportan desempaquetado
extendido: [x, y, *otros] y (x, y, *otros) funcionan de manera similar
a las asignaciones con desempaquetado. El nombre luego de * también puede ser _,
con lo cual (x, y, *_) coincide con cualquier secuencia de al menos dos
elementos, sin ligar ninguno de los demás elementos.
Los patrones de
mapeo: {"ancho_de_banda": c, "latencia": l} capturan los
valores "ancho_de_banda" y "latencia" de un diccionario. A diferencia de
los patrones de secuencia, las claves adicionales son ignoradas. Puede usarse un
desempaquetado como **otros . (Aunque **_ sería redundante, con lo cual no
está permitido)
Pueden capturarse subpatrones usando la palabra clave as:
case (Point(x1, y1), Point(x2, y2) as p2): ...
case Color.GREEN:
print("Grass is green")
case Color.BLUE:
print("I'm feeling the blues :(")
Para una explicación más detallada y más ejemplos, puede leerse PEP 636 que está escrita
en un formato de tutorial.
>>>
>>> def fib(n): # write Fibonacci series up to n
... """Print a Fibonacci series up to n."""
... a, b = 0, 1
... while a < n:
... print(a, end=' ')
... a, b = b, a+b
... print()
...
>>> # Now call the function we just defined:
... fib(2000)
0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987 1597
La palabra reservada def se usa para definir funciones. Debe seguirle el nombre de la
función y la lista de parámetros formales entre paréntesis. Las sentencias que forman el
cuerpo de la función empiezan en la línea siguiente, y deben estar con sangría.
La primera sentencia del cuerpo de la función puede ser opcionalmente una cadena de texto
literal; esta es la cadena de texto de documentación de la función, o docstring. (Puedes
encontrar más acerca de docstrings en la sección Cadenas de texto de documentación.).
Existen herramientas que usan las docstrings para producir documentación imprimible
o disponible en línea, o para dejar que los usuarios busquen interactivamente a través del
código; es una buena práctica incluir docstrings en el código que escribes, así que
acostúmbrate a hacerlo.
La ejecución de una función introduce una nueva tabla de símbolos usada para las variables
locales de la función. Más precisamente, todas las asignaciones de variables en la función
almacenan el valor en la tabla de símbolos local; así mismo la referencia a variables
primero mira la tabla de símbolos local, luego en la tabla de símbolos local de las funciones
externas, luego la tabla de símbolos global, y finalmente la tabla de nombres predefinidos.
Así, a variables globales y a variables de funciones que engloban a una función no se les
puede asignar directamente un valor dentro de una función (a menos que se las nombre en
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
Los parámetros reales (argumentos) para una llamada de función se introducen en la tabla
de símbolos local de la función llamada cuando ésta se llama; por lo tanto, los argumentos
se pasan usando llamada por valor (donde el valor es siempre una referencia al objeto, no
el valor del objeto). [1] Cuando una función llama a otra función, o se llama a sí misma de
forma recursiva, se crea una nueva tabla de símbolos locales para esa llamada.
>>>
>>> fib
<function fib at 10042ed0>
>>> f = fib
>>> f(100)
0 1 1 2 3 5 8 13 21 34 55 89
Viniendo de otros lenguajes, puedes objetar que fib no es una función, sino un
procedimiento, porque no retorna un valor. De hecho, técnicamente hablando, los
procedimientos sin return sí retornan un valor, aunque uno bastante aburrido. Este valor
se llama None (es un nombre predefinido). El intérprete por lo general no escribe el
valor None si va a ser el único valor escrito. Puede verlo si realmente lo desea
utilizando print():
>>>
>>> fib(0)
>>> print(fib(0))
None
Es simple escribir una función que retorne una lista con los números de la serie de
Fibonacci en lugar de imprimirlos:
>>>
>>> def fib2(n): # return Fibonacci series up to n
... """Return a list containing the Fibonacci series up to
n."""
... result = []
... a, b = 0, 1
... while a < n:
... result.append(a) # see below
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
... a, b = b, a+b
... return result
...
>>> f100 = fib2(100) # call it
>>> f100 # write the result
[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]
La sentencia return retorna un valor en una función. return sin una expresión
como argumento retorna None. Si se alcanza el final de una función, también se
retorna None.
La sentencia result.append(a) llama a un método del objeto lista result. Un
método es una función que “pertenece” a un objeto y se
nombra obj.methodname, dónde obj es algún objeto (puede ser una expresión),
y methodname es el nombre del método que está definido por el tipo del objeto.
Distintos tipos definen distintos métodos. Métodos de diferentes tipos pueden tener
el mismo nombre sin causar ambigüedad. (Es posible definir tus propios tipos de
objetos y métodos, usando clases, ver Clases). El método append() mostrado en
el ejemplo está definido para objetos lista; añade un nuevo elemento al final de la
lista. En este ejemplo es equivalente a result = result + [a], pero más
eficiente.
4.8. Más sobre definición de funciones
También es posible definir funciones con un número variable de argumentos. Hay tres
formas que pueden ser combinadas.
Este ejemplo también introduce la palabra reservada in, la cual prueba si una secuencia
contiene o no un determinado valor.
i = 5
def f(arg=i):
print(arg)
i = 6
f()
imprimirá 5.
Advertencia importante: El valor por omisión es evaluado solo una vez. Existe una
diferencia cuando el valor por omisión es un objeto mutable como una lista, diccionario, o
instancia de la mayoría de las clases. Por ejemplo, la siguiente función acumula los
argumentos que se le pasan en subsiguientes llamadas:
print(f(1))
print(f(2))
print(f(3))
Imprimirá
[1]
[1, 2]
[1, 2, 3]
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
Si no se quiere que el valor por omisión sea compartido entre subsiguientes llamadas, se
pueden escribir la función así:
parrot(1000) # 1
positional argument
parrot(voltage=1000) # 1
keyword argument
parrot(voltage=1000000, action='VOOOOOM') # 2
keyword arguments
parrot(action='VOOOOOM', voltage=1000000) # 2
keyword arguments
parrot('a million', 'bereft of life', 'jump') # 3
positional arguments
parrot('a thousand', state='pushing up the daisies') # 1
positional, 1 keyword
En una llamada a una función, los argumentos nombrados deben seguir a los argumentos
posicionales. Cada uno de los argumentos nombrados pasados deben coincidir con un
argumento aceptado por la función (por ejemplo, actor no es un argumento válido para la
función parrot), y el orden de los mismos no es importante. Esto también se aplica a los
argumentos obligatorios (por ejemplo, parrot(voltage=1000) también es válido).
Ningún argumento puede recibir más de un valor al mismo tiempo. Aquí hay un ejemplo
que falla debido a esta restricción:
>>>
>>> def function(a):
... pass
...
>>> function(0, a=0)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: function() got multiple values for argument 'a'
Se debe notar que el orden en el cual los argumentos nombrados son impresos está
garantizado para coincidir con el orden en el cual fueron provistos en la llamada a la
función.
>>>
>>> def standard_arg(arg):
... print(arg)
...
>>> def pos_only_arg(arg, /):
... print(arg)
...
>>> def kwd_only_arg(*, arg):
... print(arg)
...
>>> def combined_example(pos_only, /, standard, *, kwd_only):
... print(pos_only, standard, kwd_only)
>>>
>>> standard_arg(2)
2
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
>>> standard_arg(arg=2)
2
>>>
>>> pos_only_arg(1)
1
>>> pos_only_arg(arg=1)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: pos_only_arg() got some positional-only arguments
passed as keyword arguments: 'arg'
La tercer función kwd_only_args solo permite parámetros con palabras clave, indicado
por un * en la definición de la función:
>>>
>>> kwd_only_arg(3)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: kwd_only_arg() takes 0 positional arguments but 1
was given
>>> kwd_only_arg(arg=3)
3
>>>
>>> combined_example(1, 2, 3)
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: combined_example() takes 2 positional arguments but
3 were given
Finalmente, considere esta definición de función que contiene una colisión potencial entre
los parámetros posicionales name y **kwds que incluye name como una clave:
No hay una llamada posible que lo haga retornar True ya que la palabra
clave 'name' siempre se vinculará al primer parámetro. Por ejemplo:
>>>
>>> foo(1, **{'name': 2})
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
TypeError: foo() got multiple values for argument 'name'
>>>
>>>
>>> def foo(name, /, **kwds):
... return 'name' in kwds
...
>>> foo(1, **{'name': 2})
True
4.8.3.5. Resumen
El caso de uso determinará qué parámetros utilizar en una definición de función:
A modo de guía:
>>>
>>> def concat(*args, sep="/"):
... return sep.join(args)
...
>>> concat("earth", "mars", "venus")
'earth/mars/venus'
>>> concat("earth", "mars", "venus", sep=".")
'earth.mars.venus'
>>>
>>> list(range(3, 6)) # normal call with separate
arguments
[3, 4, 5]
>>> args = [3, 6]
>>> list(range(*args)) # call with arguments
unpacked from a list
[3, 4, 5]
Del mismo modo, los diccionarios pueden entregar argumentos nombrados con el
operador **:
>>>
>>> def parrot(voltage, state='a stiff', action='voom'):
... print("-- This parrot wouldn't", action, end=' ')
... print("if you put", voltage, "volts through it.", end='
')
... print("E's", state, "!")
...
>>> d = {"voltage": "four million", "state": "bleedin'
demised", "action": "VOOM"}
>>> parrot(**d)
-- This parrot wouldn't VOOM if you put four million volts
through it. E's bleedin' demised !
>>>
>>> def make_incrementor(n):
... return lambda x: x + n
...
>>> f = make_incrementor(42)
>>> f(0)
42
>>> f(1)
43
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
El ejemplo anterior muestra el uso de una expresión lambda para retornar una función. Otro
uso es para pasar pequeñas funciones como argumentos
>>>
>>> pairs = [(1, 'one'), (2, 'two'), (3, 'three'), (4, 'four')]
>>> pairs.sort(key=lambda pair: pair[1])
>>> pairs
[(4, 'four'), (1, 'one'), (3, 'three'), (2, 'two')]
La primera línea debe ser siempre un resumen corto y conciso del propósito del objeto. Para
ser breve, no se debe mencionar explícitamente el nombre o tipo del objeto, ya que estos
están disponibles de otros modos (excepto si el nombre es un verbo que describe el
funcionamiento de la función). Esta línea debe empezar con una letra mayúscula y terminar
con un punto.
Si hay más líneas en la cadena de texto de documentación, la segunda línea debe estar en
blanco, separando visualmente el resumen del resto de la descripción. Las líneas siguientes
deben ser uno o más párrafos describiendo las convenciones para llamar al objeto, efectos
secundarios, etc.
>>>
>>> def my_function():
... """Do nothing, but document it.
...
... No, really, it doesn't do anything.
... """
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
... pass
...
>>> print(my_function.__doc__)
Do nothing, but document it.
>>>
>>> def f(ham: str, eggs: str = 'eggs') -> str:
... print("Annotations:", f.__annotations__)
... print("Arguments:", ham, eggs)
... return ham + ' and ' + eggs
...
>>> f('spam')
Annotations: {'ham': <class 'str'>, 'return': <class 'str'>,
'eggs': <class 'str'>}
Arguments: spam eggs
'spam and eggs'
Para Python, PEP 8 se erigió como la guía de estilo a la que más proyectos adhirieron;
promueve un estilo de programación fácil de leer y visualmente agradable. Todos los
desarrolladores Python deben leerlo en algún momento; aquí están extraídos los puntos más
importantes:
MODULO 2
CURSO: INTRODUCCIÓN A LA PROGRAMACIÓN CON PYTHON
4 espacios son un buen compromiso entre una sangría pequeña (permite mayor nivel
de sangrado)y una sangría grande (más fácil de leer). Los tabuladores introducen
confusión y es mejor dejarlos de lado.
Esto ayuda a los usuarios con pantallas pequeñas y hace posible tener varios
archivos de código abiertos, uno al lado del otro, en pantallas grandes.
Usar líneas en blanco para separar funciones y clases, y bloques grandes de código
dentro de funciones.
Cuando sea posible, poner comentarios en una sola línea.
Usar docstrings.
Usar espacios alrededor de operadores y luego de las comas, pero no directamente
dentro de paréntesis: a = f(1, 2) + g(3, 4).
Nombrar las clases y funciones consistentemente; la convención es
usar NotacionCamello para clases
y minusculas_con_guiones_bajos para funciones y métodos. Siempre
usa self como el nombre para el primer argumento en los métodos (ver Un primer
vistazo a las clases para más información sobre clases y métodos).
No uses codificaciones estrafalarias si esperas usar el código en entornos
internacionales. El default de Python, UTF-8, o incluso ASCII plano funcionan bien
en la mayoría de los casos.
De la misma manera, no uses caracteres no-ASCII en los identificadores si hay
incluso una pequeñísima chance de que gente que hable otro idioma tenga que leer o
mantener el código.