Passo 1 de 6
Reconhecer de onde vem um recurso
Diferencie nomes embutidos, módulos da biblioteca padrão, módulos locais e bibliotecas de terceiros antes de escolher uma solução.
Trilha de aprendizado · Nível 5 · Tutorial 4
Localizar recursos já disponíveis no Python e consultar a documentação oficial para usar funções adequadas à tarefa e à versão instalada.
Reconhecer de onde vem um recurso
Diferencie nomes embutidos, módulos da biblioteca padrão, módulos locais e bibliotecas de terceiros antes de escolher uma solução. 1 min
Encontrar uma funcionalidade na documentação oficial
Use diferentes caminhos da documentação oficial para localizar um recurso da biblioteca padrão a partir do módulo ou da tarefa. 2 min
Ler o que uma função faz e exige
Aprenda a reconhecer assinatura, finalidade, retorno e restrições em uma entrada de referência usando math.sqrt. 2 min
Conferir versão e disponibilidade
Compare a versão e a plataforma do interpretador com as notas da documentação antes de usar um recurso. 2 min
Adaptar um exemplo ao seu programa
Consulte o contrato de statistics.mean, execute um script completo e adapte seus dados sem violar a restrição de coleção não vazia. 3 min
Resolver uma tarefa com apoio da documentação
Aplicar o fluxo completo de consulta à documentação oficial para escolher, verificar e usar um recurso da biblioteca padrão. 3 min
Passo 1 de 6
Diferencie nomes embutidos, módulos da biblioteca padrão, módulos locais e bibliotecas de terceiros antes de escolher uma solução.
Um recurso usado no programa pode vir de quatro lugares:
len.math e statistics; normalmente exige importação.Os nomes embutidos e os módulos padrão são apresentados na documentação da biblioteca do Python.
A origem depende de como o recurso é fornecido, não apenas da forma como ele aparece no código.
Exemplo
quantidade = len([10, 20, 30]) # nome embutido
import math # biblioteca padrão
raiz = math.sqrt(25)
import meu_relatorio # pode ser um módulo localmath e meu_relatorio usam import, mas têm origens diferentes. Portanto, encontrar uma importação não permite concluir que o recurso é uma biblioteca de terceiros.
Dica
Consulte primeiro se a tarefa já é atendida por um nome embutido ou pela biblioteca padrão. Isso pode evitar uma dependência externa. Ainda assim, a disponibilidade de certos módulos pode variar conforme a versão ou a plataforma — uma verificação que será feita mais adiante neste tutorial.
Associe cada recurso à descrição correta.
Toque em um item e depois no par correspondente.
Passo 2 de 6
Use diferentes caminhos da documentação oficial para localizar um recurso da biblioteca padrão a partir do módulo ou da tarefa.
A documentação oficial do Python fica no domínio docs.python.org. Nela, a seção de referência da biblioteca padrão reúne páginas sobre recursos embutidos e módulos como math e statistics.
A página também oferece seletores de versão e idioma. Prefira Português do Brasil (pt-BR) quando disponível, mas algumas páginas ou partes delas podem continuar em inglês.
Há três caminhos principais: navegar por uma área temática, abrir o índice quando você conhece o módulo ou pesquisar quando conhece apenas a tarefa.
O melhor caminho depende do que você já sabe: a tarefa, a área ou o nome do módulo.
Use o índice de módulos quando já souber o nome, como math. Na página do módulo, procure o nome da função.
Se você conhecer apenas a necessidade, como “calcular uma raiz quadrada”, use a busca ou navegue por uma área como Módulos Numéricos e Matemáticos. Na busca do navegador, você também pode restringir os resultados com site:docs.python.org.
Dica
Verifique se o resultado permanece em docs.python.org. Outros sites podem explicar o mesmo recurso, mas a documentação oficial é a referência para confirmar nomes e uso.
Exemplo
Necessidade: calcular a raiz quadrada de um número.
Pelo índice: Referência da biblioteca → Índice de módulos → math → procurar sqrt.
Pela área: Referência da biblioteca → Módulos Numéricos e Matemáticos → math → procurar sqrt.
Pela busca: pesquisar raiz quadrada Python math site:docs.python.org.
Os caminhos levam ao nome qualificado math.sqrt. Por enquanto, basta localizar a entrada; a leitura detalhada do que ela exige será feita no próximo step.
No seu navegador, acesse a documentação oficial e localize a função para calcular uma raiz quadrada. Registre o caminho usado e o nome qualificado encontrado.
Escreva pelo menos 30 caracteres (0/30).
Passo 3 de 6
Aprenda a reconhecer assinatura, finalidade, retorno e restrições em uma entrada de referência usando math.sqrt.
Uma entrada da documentação pode distribuir as informações em diferentes partes:
Nem toda informação aparece na assinatura. É preciso ler também o texto ao redor dela.
Leia a entrada como um conjunto: a assinatura apresenta a chamada, enquanto a descrição e as observações completam o contrato da função.
Considere a assinatura math.sqrt(x). O nome x é o parâmetro documentado. Em math.sqrt(16), o valor 16 é o argumento associado a esse parâmetro.
A descrição informa que a função retorna a raiz quadrada de x. Para uma chamada válida neste contexto, x deve representar um número real não negativo. Um valor negativo está fora desse domínio e a documentação indica um erro ValueError — aqui basta reconhecer a restrição, sem tratar o erro.
Execute este código no seu interpretador Python:
import math
numero = 16
raiz = math.sqrt(numero)
print(raiz)Exemplo
A entrada é 16, a chamada é math.sqrt(numero) e o resultado apresentado é 4.0. A assinatura mostra que a função recebe um argumento; a descrição permite entender que o valor retornado é a raiz quadrada.
Leia este resumo documental: math.sqrt(x) retorna a raiz quadrada de x. Se x for negativo, a função indica um erro ValueError.
Qual opção interpreta corretamente essa informação?
Passo 4 de 6
Compare a versão e a plataforma do interpretador com as notas da documentação antes de usar um recurso.
Execute sys.version no mesmo interpretador usado pelo seu programa. O começo do resultado informa a versão: em 3.12.4, por exemplo, 3 é a versão principal e 12 é a secundária. Os demais dados podem incluir a versão de correção e informações de compilação.
Execute este script localmente:
import sys
print(sys.version)Exemplo
Uma saída iniciada por 3.12.4 indica Python 3.12. Para conferir compatibilidade documental neste caso, procure a série 3.12.
Em docs.python.org, confira a versão selecionada antes de ler a referência. Prefira a série principal e secundária do seu interpretador. Evite usar por engano a documentação de outra série ou a versão marcada como em desenvolvimento, pois ela pode descrever recursos que ainda não existem na sua instalação.
A correspondência deve ser feita entre a versão em execução e a mesma série da documentação.
Use a documentação da mesma série do interpretador; versões diferentes exigem atenção às notas de disponibilidade.
Uma nota “Adicionado na versão X” informa quando o recurso passou a existir. Já “Alterado na versão X” indica uma mudança em algo que poderia existir antes — não necessariamente a criação da função. Também observe notas de disponibilidade por sistema operacional.
Exemplo
A documentação informa que math.isqrt foi adicionada no Python 3.8. Portanto, ela não está disponível no Python 3.7, mas pode ser usada a partir do 3.8.
Como exemplo de plataforma, winreg é um módulo da biblioteca padrão disponível no Windows. Sua presença na documentação não significa que ele esteja disponível em outros sistemas, e não é necessário executar suas funções para interpretar essa restrição.
Dica
Confirme três pontos: sua série do Python, a nota de introdução ou alteração do recurso e uma possível restrição de plataforma.
Um programa executado com Python 3.7 pode usar math.isqrt porque essa função aparece na documentação atual.
Todo módulo listado na biblioteca padrão está disponível em qualquer sistema operacional que execute Python.
Passo 5 de 6
Consulte o contrato de statistics.mean, execute um script completo e adapte seus dados sem violar a restrição de coleção não vazia.
Na documentação oficial da sua versão do Python, procure statistics.mean. A função calcula a média aritmética dos valores recebidos pelo parâmetro data.
Para usá-la corretamente, identifique três pontos:
Neste step, usaremos apenas listas numéricas não vazias e não trataremos o erro causado por uma coleção vazia.
A função recebe vários valores numéricos e produz a média aritmética deles.
Em statistics.mean(data), data fornece os valores; o retorno é a média aritmética.
Dica
Antes de adaptar o exemplo, confira se a página pertence a docs.python.org e corresponde à série principal e secundária do Python que executará o script.
Crie um arquivo Python no seu computador, copie o código e execute-o com o interpretador cuja versão você conferiu.
import statistics
valores = [6, 8, 10]
media = statistics.mean(valores)
print(f"Média: {media}")Exemplo
Para [6, 8, 10], a média é (6 + 8 + 10) / 3, ou seja, 8. Portanto, a saída esperada é:
Média: 8O script importa o módulo, mantém os dados em memória, chama a função com uma lista não vazia e apresenta o valor retornado.
Dica
Se a documentação mostrar um exemplo do console interativo, não copie os marcadores >>> nem as linhas que apenas representam a saída. No script, mantenha somente as instruções Python. Você pode alterar os dados e os nomes das variáveis, desde que continue fornecendo uma coleção numérica não vazia à função.
Execute primeiro o script como apresentado. Depois, substitua a lista por [12, 15, 18] e execute novamente.
A média matemática desses valores é 15. Como todos os valores são inteiros e a média é exata, a saída literal esperada neste caso é:
Média: 15Compare essa previsão com o que apareceu no seu terminal.
Qual foi a saída observada depois da alteração? Compare-a com o resultado esperado e explique por que a lista usada respeita a restrição documentada de statistics.mean.
Escreva pelo menos 60 caracteres (0/60).
Passo 6 de 6
Aplicar o fluxo completo de consulta à documentação oficial para escolher, verificar e usar um recurso da biblioteca padrão.
Ao resolver uma tarefa com a biblioteca padrão, siga este fluxo:
A escolha do recurso deve ser justificada pela documentação, e não apenas pelo fato de uma chamada parecer funcionar.
A consulta termina com uma comparação entre o resultado esperado e o observado.
Um terreno quadrado tem área de 81 m². O comprimento de cada lado é o número real não negativo que, multiplicado por ele mesmo, resulta em 81.
Sem partir do nome de uma função, use a documentação oficial em docs.python.org para localizar um recurso já explorado neste tutorial que calcule esse valor. Depois, execute sua solução no próprio computador.
Para registrar sua versão, execute import sys e print(sys.version) no mesmo interpretador. Em sua resposta, inclua:
Escreva pelo menos 200 caracteres (0/200).
Resumo
Reutilize este processo sempre que procurar uma funcionalidade já disponível no Python.
Parabéns! Você concluiu: Consultar a biblioteca padrão e sua documentação
Agora você sabe localizar um recurso padrão, interpretar seu contrato, conferir sua disponibilidade e adaptá-lo ao próprio programa.
100 XP
Milhares de cursos online em vídeo, ebooks e áudiobooks.
Para testar seus conhecimentos no decorrer dos cursos online
Gerado diretamente na galeria de fotos do seu celular e enviado ao seu e-mail
Baixe nosso aplicativo pelo QR Code ou pelos links abaixo:.
Leve o conhecimento no seu bolso.
Baixe o aplicativo Cursa.
São centenas de Cursos gratuitos a disposição, com Certificado de conclusão gratuito que é salvo em sua galeria de imagens do celular.
Baixe o app para ter acesso ao Certificado de conclusão de Curso Gratuitamente.
+ de 10 milhões
de alunos
Certificado grátis e
válido em todo o Brasil
60 mil exercícios
gratuitos
4,8/5 classificação
nas lojas de apps
Cursos gratuitos em
vídeo, ebooks e audiobooks
