1
00:00:18,750 --> 00:00:19,498
Parâmetros ajudam a gente

2
00:00:19,498 --> 00:00:20,425
a modular o comportamento
de uma função,

3
00:00:20,425 --> 00:00:21,568
e a gente já sabe como
definir parâmetros simples,

4
00:00:21,568 --> 00:00:22,839
que são informados
de forma posicional,

5
00:00:22,839 --> 00:00:24,178
e parâmetros 
de quantidade dinâmica,

6
00:00:24,178 --> 00:00:25,517
em que a gente consegue 
lidar com eles

7
00:00:25,517 --> 00:00:26,139
como se fosse uma coleção qualquer.

8
00:00:26,139 --> 00:00:28,088
Chegou a hora da gente ver 
como lidar com parâmetros

9
00:00:28,088 --> 00:00:29,380
que podem ou não virem
para a nossa função.

10
00:00:29,380 --> 00:00:31,317
O que a gente vai ver
agora são chamados KWARGs,

11
00:00:31,317 --> 00:00:33,267
ou Keyword Arguments, 
que são argumentos

12
00:00:33,267 --> 00:00:35,198
que a gente passa 
no formato de dicionário.

13
00:00:35,198 --> 00:00:37,130
E para que eles servem?

14
00:00:41,790 --> 00:00:44,250
Imagina que você tem que trabalhar
com a função que você tem

15
00:00:44,250 --> 00:00:45,480
um valor específico que tem
que ser informado.

16
00:00:45,480 --> 00:00:47,265
Nesse cenário, você informa para ele 
um parâmetro simples,

17
00:00:47,265 --> 00:00:49,962
que sempre vai estar lá, 
e que se não for informado,

18
00:00:49,962 --> 00:00:52,660
o Python dá um erro.

19
00:00:52,660 --> 00:00:54,592
Por outro lado, se você tem 
uma lista de quantidade dinâmica,

20
00:00:54,592 --> 00:00:56,534
a gente vai ter que usar os args,
para que a gente consiga manipular eles

21
00:00:56,534 --> 00:01:01,060
de forma dinâmica, sem se preocupar
com a quantidade total.

22
00:01:01,060 --> 00:01:04,735
No entanto, a gente pode querer
um parâmetro

23
00:01:04,735 --> 00:01:06,572
que vai estar ou não presente.

24
00:01:06,572 --> 00:01:08,410
Ou seja, ele é uma informação opcional.

25
00:01:08,410 --> 00:01:11,366
Se ele estiver presente, 
a gente faz alguma coisa com ele.

26
00:01:11,366 --> 00:01:14,545
Caso não, a gente não faz
ou assume algum valor padrão.

27
00:01:14,545 --> 00:01:18,102
E para isso, a estrutura de dados
mais adequada que a gente conhece

28
00:01:18,102 --> 00:01:19,135
é o dicionário,

29
00:01:19,135 --> 00:01:22,455
que é justamente o tipo entregue 
quando a gente usa os KWARGs.

30
00:01:22,455 --> 00:01:24,362
Então, agora, vamos
lá para o código e dar uma olhada

31
00:01:24,362 --> 00:01:26,270
em como esse cara funciona.

32
00:01:26,270 --> 00:01:27,951
Aqui no VS Code,

33
00:01:27,951 --> 00:01:28,791
a gente já tem 
um código de exemplo,

34
00:01:28,791 --> 00:01:30,805
que é uma função simples 
que exibe uma mensagem olá

35
00:01:30,805 --> 00:01:32,820
e algum nome que foi entregue.

36
00:01:32,820 --> 00:01:35,357
Se a gente exibir ela aqui,
executar ela, na verdade,

37
00:01:35,357 --> 00:01:37,508
com o comando do Python,

38
00:01:37,508 --> 00:01:39,660
a gente vai ver exatamente 
isso na tela.

39
00:01:39,660 --> 00:01:42,445
Mas, imagina que a gente queira
receber aqui a informação

40
00:01:42,445 --> 00:01:45,140
de se esse aluno 
fez ou não um trabalho prático.

41
00:01:45,140 --> 00:01:46,980
Então, a gente precisa
de uma informação

42
00:01:46,980 --> 00:01:49,075
que vai dizer para a gente,
na verdade,

43
00:01:49,075 --> 00:01:51,170
a nota que ele tirou
nesse trabalho prático.

44
00:01:51,170 --> 00:01:53,660
E se ele não tiver uma nota, 
não significa que ele tirou zero.

45
00:01:53,660 --> 00:01:56,150
Significa que ele não entregou.

46
00:01:56,150 --> 00:01:57,115
Tá bom?

47
00:01:57,115 --> 00:01:58,080
Então, vamos começar com isso.

48
00:01:58,080 --> 00:02:01,340
A gente poderia definir
aqui duas variáveis.

49
00:02:01,340 --> 00:02:03,930
Uma para informar se ele fez
ou não um trabalho prático.

50
00:02:03,930 --> 00:02:05,755
E, para isso, a gente usaria 
o tipo booleano.

51
00:02:05,755 --> 00:02:08,415
E, depois, uma outra
para especificar a nota.

52
00:02:08,415 --> 00:02:09,792
Mas, como a gente 
consegue usar os KWARGs,

53
00:02:09,792 --> 00:02:11,911
a gente vai fazer isso 
de uma vez só,

54
00:02:11,911 --> 00:02:13,520
informando apenas a nota.

55
00:02:13,520 --> 00:02:15,130
Então, saca só.

56
00:02:15,130 --> 00:02:17,082
Eu vou colocar aqui
a minha outra variável,

57
00:02:17,082 --> 00:02:18,840
que vai ser o meu
outro parâmetro,

58
00:02:18,840 --> 00:02:25,060
que eu vou chamar
de informações adicionais.

59
00:02:25,060 --> 00:02:28,015
E, nesse caso, para que o Python
entenda que isso daqui é um KWARGs

60
00:02:28,015 --> 00:02:30,970
e não uma variável simples,

61
00:02:30,970 --> 00:02:33,155
eu vou ter que colocar
não um, mas, dessa vez,

62
00:02:33,155 --> 00:02:35,340
dois asteriscos
no começo dela.

63
00:02:35,340 --> 00:02:36,393
Então, pronto.

64
00:02:36,393 --> 00:02:38,263
A partir de agora, 
se eu executar a aplicação

65
00:02:38,263 --> 00:02:40,326
sem mexer na invocação
ou no conteúdo daquela função,

66
00:02:40,326 --> 00:02:45,250
o Python consegue executar isso
sem problema nenhum.

67
00:02:45,250 --> 00:02:47,841
Porque ele já entendeu
que isso se trata de um KWARGs

68
00:02:47,841 --> 00:02:50,650
e que as informações 
que estão ali, elas são opcionais.

69
00:02:50,650 --> 00:02:52,780
Ou seja, eu posso informar ou não.

70
00:02:52,780 --> 00:02:54,582
Se a gente vier aqui 
dentro do bloco de código,

71
00:02:54,582 --> 00:02:56,385
vamos executar um print 
com aquele valor,

72
00:02:56,385 --> 00:02:58,232
só para a gente entender 
o formato que as coisas

73
00:02:58,232 --> 00:03:00,080
estão chegando aqui dentro.

74
00:03:00,080 --> 00:03:04,860
Eu vou copiar o nome da variável e,
aqui, chamar a função nativa print,

75
00:03:04,860 --> 00:03:07,150
passando ela para a gente
ver ali no terminal.

76
00:03:07,150 --> 00:03:08,640
Eu vou executar mais uma vez.

77
00:03:08,640 --> 00:03:10,875
E repara que a mensagem
está aqui e que, aqui embaixo,

78
00:03:10,875 --> 00:03:13,110
dessa vez, eu tenho um dicionário,

79
00:03:13,110 --> 00:03:16,900
que é aquela estrutura que a gente
usa baseada em chave e valor.

80
00:03:16,900 --> 00:03:19,535
Então, eu vou começar aqui, 
na invocação do método,

81
00:03:19,535 --> 00:03:22,171
passando valores
para esse meu KWARGs.

82
00:03:22,171 --> 00:03:26,800
E, para fazer isso, eu posso
passar eles no formato de chaves.

83
00:03:26,800 --> 00:03:28,660
Ou seja, eu tenho que colocar 
o nome e o valor que eu quero

84
00:03:28,660 --> 00:03:30,520
para aquela chave.

85
00:03:30,520 --> 00:03:35,410
No nosso caso, vai ser a nota
do trabalho prático, ou seja, nota tp.

86
00:03:35,410 --> 00:03:38,054
Então, por isso, eu vou
colocar aqui nota tp,

87
00:03:38,054 --> 00:03:41,150
o sinal de igual e o valor
que eu quero informar.

88
00:03:41,150 --> 00:03:43,690
Que, nesse caso, vai
ser, por exemplo, 10.

89
00:03:43,690 --> 00:03:46,135
Eu vou só salvar o meu programa 
e executar de novo

90
00:03:46,135 --> 00:03:48,580
para a gente ver o que mudou.

91
00:03:48,580 --> 00:03:50,933
Aqui, a mensagem continua
a mesma coisa, só que,

92
00:03:50,933 --> 00:03:53,500
dessa vez, repara que dentro
do meu dicionário,

93
00:03:53,500 --> 00:03:57,080
eu tenho a chave
nota tp com valor 10.

94
00:03:57,080 --> 00:03:57,849
E, a partir daqui,

95
00:03:57,849 --> 00:04:00,250
a gente já consegue trabalhar
com essa informação.

96
00:04:00,250 --> 00:04:02,395
E é exatamente isso que a gente
vai fazer aqui agora.

97
00:04:02,395 --> 00:04:04,457
Eu vou abrir um espacinho
entre as duas mensagens

98
00:04:04,457 --> 00:04:06,520
e uma coisa que a gente 
tem que lembrar

99
00:04:06,520 --> 00:04:10,350
é que os KWARGs são informações
realmente opcionais.

100
00:04:10,350 --> 00:04:11,322
Então, a gente tem que lidar 
com o cenário

101
00:04:11,322 --> 00:04:14,240
delas estarem presentes ou não.

102
00:04:14,240 --> 00:04:16,845
E a estrutura do dicionário
entrega formas

103
00:04:16,845 --> 00:04:19,450
de a gente lidar com isso
sem problema algum.

104
00:04:19,450 --> 00:04:21,330
Então, eu vou, basicamente,

105
00:04:21,330 --> 00:04:23,210
antes de usar as informações
daquele dicionário,

106
00:04:23,210 --> 00:04:25,095
ver se tem alguma informação 
dentro da chave

107
00:04:25,095 --> 00:04:26,980
que eu estou pretendendo usar.

108
00:04:26,980 --> 00:04:29,360
Então, para isso, a nossa regra
vai ser a seguinte.

109
00:04:29,360 --> 00:04:30,429
Se a gente não tiver
aquela chave,

110
00:04:30,429 --> 00:04:33,680
significa que o aluno 
não fez o trabalho prático.

111
00:04:33,680 --> 00:04:34,565
E, por isso, eu vou,
basicamente,

112
00:04:34,565 --> 00:04:37,810
exibir uma mensagem falando
que a gente não encontrou tp.

113
00:04:37,810 --> 00:04:38,670
Vamos lá.

114
00:04:38,670 --> 00:04:42,548
Aqui dentro, eu vou começar
com uma condicional para que eu veja

115
00:04:42,548 --> 00:04:46,130
se a chave nota tp está
dentro daquela minha variável.

116
00:04:46,130 --> 00:04:49,914
Então, eu vou colocar
aqui entre aspas,

117
00:04:49,914 --> 00:04:53,540
nota tp em informações
adicionais.

118
00:04:53,540 --> 00:04:56,440
Ou seja, se aquela nota estiver 
dentro daquelas informações,

119
00:04:56,440 --> 00:04:59,340
então esse bloco de código
vai ser executado.

120
00:04:59,340 --> 00:05:01,676
Mas como que eu quero
exatamente o contrário,

121
00:05:01,676 --> 00:05:04,260
eu vou colocar uma negação
aqui antes do in.

122
00:05:04,260 --> 00:05:06,000
Então, fica da seguinte forma.

123
00:05:06,000 --> 00:05:08,492
Se a chave nota tp
não estiver dentro do dicionário

124
00:05:08,492 --> 00:05:10,985
informações adicionais,

125
00:05:10,985 --> 00:05:18,140
então eu quero exibir uma mensagem
falando que o tp não foi encontrado.

126
00:05:18,140 --> 00:05:21,960
E como, a partir daqui, 
eu não quero executar mais nada,

127
00:05:21,960 --> 00:05:24,966
eu vou apenas escrever um return
para que o Python entenda

128
00:05:24,966 --> 00:05:28,170
que eu não tenho que executar
mais nada daqui para frente

129
00:05:28,170 --> 00:05:29,970
e saia dessa função.

130
00:05:29,970 --> 00:05:33,075
Vamos rodar aqui de novo
o nosso terminal.

131
00:05:33,075 --> 00:05:36,180
Ou melhor, limpar o terminal
e executar novamente a aplicação

132
00:05:36,180 --> 00:05:39,480
para a gente ver como que as coisas
se comportam do jeito que está.

133
00:05:39,480 --> 00:05:42,820
Desse jeito aqui, a aplicação
não entrou na condicional

134
00:05:42,820 --> 00:05:46,660
e seguiu adiante exibindo aquele 
nosso dicionário de informações adicionais.

135
00:05:46,660 --> 00:05:50,260
Mas se a partir de agora
eu remover essa informação,

136
00:05:50,260 --> 00:05:53,200
ele entra na condicional
e exibe a mensagem para a gente.

137
00:05:53,200 --> 00:05:56,195
Então eu vou voltar com ela daqui 
para que a gente coloque

138
00:05:56,195 --> 00:05:59,190
mais coisa aqui no fluxo 
do nosso programa.

139
00:05:59,190 --> 00:06:00,268
E a partir desse momento,

140
00:06:00,268 --> 00:06:02,069
a gente está trabalhando
com a possibilidade

141
00:06:02,069 --> 00:06:03,870
de que a nota está sendo entregue.

142
00:06:03,870 --> 00:06:07,490
Então eu vou colocar um if para ver
se essa nota é maior do que 7.

143
00:06:07,490 --> 00:06:09,183
Se for, então o aluno
está aprovado.

144
00:06:09,183 --> 00:06:11,610
Se não for, então o aluno 
está reaprovado.

145
00:06:11,610 --> 00:06:13,894
Então eu vou começar
com mais uma condicional

146
00:06:13,894 --> 00:06:16,355
e eu vou acessar
o informações adicionais

147
00:06:16,355 --> 00:06:19,750
e usar o método get
para pegar aquela chave.

148
00:06:19,750 --> 00:06:21,600
Qual é a chave?

149
00:06:21,600 --> 00:06:22,950
a nota tp.

150
00:06:22,950 --> 00:06:26,430
Eu copio aqui e vejo se
ela é maior do que 7.

151
00:06:26,430 --> 00:06:30,210
Se ela for maior do que 7,
eu vou copiar aqui essa mensagem

152
00:06:30,210 --> 00:06:31,670
e eu vou editar para que ela seja.

153
00:06:33,740 --> 00:06:37,900
"Parabéns, você foi aprovado no tp".

154
00:06:37,900 --> 00:06:41,030
E eu também vou definir
um caso padrão, que é o Else,

155
00:06:41,030 --> 00:06:43,435
para quando essa condicional
não for atendida.

156
00:06:43,435 --> 00:06:46,190
E se esse for o caso,
eu vou exibir a mensagem.

157
00:06:48,500 --> 00:06:51,430
"Infelizmente, você não
foi aprovado no tp".

158
00:06:51,430 --> 00:06:52,730
E pronto.

159
00:06:52,730 --> 00:06:56,240
Deixa eu só tirar essa mensagem
aqui de baixo, limpar o terminal,

160
00:06:56,240 --> 00:06:58,167
e se a gente executa
a nossa aplicação novamente,

161
00:06:58,167 --> 00:07:00,094
a gente tem a mensagem

162
00:07:00,094 --> 00:07:04,240
"Olá aluno, que a gente não mexeu,
e parabéns, você foi aprovado no tp".

163
00:07:04,240 --> 00:07:06,634
Se a gente abaixa
um pouco essa nota aqui,

164
00:07:06,634 --> 00:07:07,892
para algo próximo de 10,

165
00:07:07,892 --> 00:07:09,874
mas um pouco abaixo de 7, 
por exemplo, 1,

166
00:07:09,874 --> 00:07:12,297
a gente vai ter a mensagem

167
00:07:12,297 --> 00:07:14,720
"Infelizmente, você não
foi aprovado no tp".

168
00:07:14,720 --> 00:07:17,715
E é dessa forma que a gente
consegue preparar as nossas funções

169
00:07:17,715 --> 00:07:21,090
para que elas consigam lidar
com informações opcionais, ou seja,

170
00:07:21,090 --> 00:07:24,190
que podem ou não serem formadas.

171
00:07:24,190 --> 00:07:26,957
Claro, a gente poderia
também lidar com informações

172
00:07:26,957 --> 00:07:29,630
do tipo se a variável
estiver com um valor vazio,

173
00:07:29,630 --> 00:07:30,924
ou se uma boleana estiver
informando algo,

174
00:07:30,924 --> 00:07:35,460
então eu posso assumir 
que uma outra variável tem um valor.

175
00:07:35,460 --> 00:07:38,911
Mas está começando a ficar bem claro
que isso ficaria muito complicado

176
00:07:38,911 --> 00:07:42,480
de dar manutenção e até mesmo
de entender o que está acontecendo.

177
00:07:42,480 --> 00:07:45,850
E da mesma forma com que a gente
tem diversas estruturas de dados,

178
00:07:45,850 --> 00:07:47,890
a gente também tem
diversas possibilidades.

179
00:07:47,890 --> 00:07:49,308
Cada um atende um cenário
e cabe a gente a decidir

180
00:07:49,308 --> 00:07:53,310
qual que é a melhor para o nosso 
caso de uso específico.