# Como reutilizar o código de outras pessoas nos seus projetos
Aumente sua eficiência em codificação e seus conhecimentos integrando o código existente aos seus projetos.
Uma das melhores coisas sobre open source software é a capacidade de reutilizar o código de outras pessoas. A reutilização de código ajuda você a economizar tempo, descobrir novas funcionalidades e aprender outros estilos de programação. Há duas maneiras principais de reutilizar o código:
* **Copiar e colar um snippet de código diretamente no projeto.** Se você ainda estiver se familiarizando com a codificação, essa será a maneira mais rápida de começar a reutilizar um código.
* **Importar uma biblioteca para o projeto.** Embora essa abordagem exija algum tempo para ser aprendida, ela é, no final, mais simples e eficiente. Também é uma habilidade fundamental para o desenvolvimento de software.
Neste artigo, aprenderemos sobre ambos os aspectos ao trabalhar por meio de um exemplo: reutilizando o código Python que calcula o fatorial de um número.
## Como usar snippets de código de outras pessoas no seu projeto
Ao aprender a codificação pela primeira vez, você pode começar com a reutilização copiando e colando snippets de código de outras pessoas no seu projeto. É uma ótima forma de economizar tempo, mas há algumas etapas importantes que você sempre deve realizar antes de copiar o código de outros desenvolvedores.
### 1. Como encontrar e entender um snippet de código
Primeiro, você precisa encontrar e entender o snippet de código que deseja reutilizar. Para este exemplo, vamos escolher o repositório [`new2code/python-factorial`](https://github.com/new2code/python-factorial).
Primeiro, **abra**[`factorial_finder.py`](https://github.com/new2code/python-factorial/blob/main/factorial_finder.py), que implementa a calculadora usando um loop:
```python
# Initialize the factorial result to 1
factorial = 1
# Initialize the input number to 6
number = 6
# Loop from 1 to number (inclusive) and multiply factorial by each number
for i in range(1, number + 1):
factorial *= i
print(f"The factorial of {number} is {factorial}")
```
Em seguida, na barra de menus na parte superior do arquivo, clique para iniciar uma conversa com Copilot.
Na janela de chat, pergunte Copilot:
```text copy
Explain this program.
```
### 2. Noções básicas sobre licenciamento de projeto
Para reutilizar o código encontrado, você precisa entender como funciona o licenciamento dele. As licenças determinam como você pode usar o código em um projeto, incluindo sua capacidade de copiar, modificar e distribuir esse código.
Para identificar a licença de [new2code/python-factorial](https://github.com/new2code/python-factorial), localize a seção “Sobre” na página principal do repositório. Nela, você verá que o repositório está licenciado sob a licença MIT. Para ler a licença, clique na **licença do MIT**.
Queremos copiar todo o arquivo `factorial_finder.py`, portanto, a licença MIT indica que devemos incluir uma cópia da licença em nosso projeto. Na parte superior do arquivo Python, cole a licença como um comentário.
> \[!TIP] Saiba o que é permitido por outras licenças comuns com a ferramenta [Choose a license](https://choosealicense.com/licenses/).
### 3. Como usar e modificar snippets de código
Agora está tudo pronto para você colar o snippet de código no projeto. Embora às vezes você possa usar snippets de código no estado em que se encontram, muitas vezes o ideal será **modificá-los** para o caso de uso específico. Vamos praticar isso agora.
Digamos que queremos calcular rapidamente os fatoriais de 5, 7, 9 e 10. Em vez de copiar e colar todo o programa para cada número, podemos mover a calculadora para uma **função** que usa um número como argumento.
Use [Bate-papo do Copilot](https://github.com/copilot) para sugerir e explicar uma implementação. Cole o código atual na janela de chat, seguido por esta solicitação:
```text copy
Wrap the Python code above in a function.
```
Copilot gerará um código semelhante a este:
```python copy
def calculate_factorial(number):
# Initialize the factorial result to 1
factorial = 1
# Loop from 1 to number (inclusive) and multiply factorial by each number
for i in range(1, number + 1):
factorial *= i
return factorial
```
Com nossa nova função, podemos facilmente encontrar os fatores de nossos números adicionando o seguinte código ao nosso projeto e, em seguida, executando o programa Python:
```python copy
print(calculate_factorial(5))
print(calculate_factorial(7))
print(calculate_factorial(9))
print(calculate_factorial(10))
```
Parabéns! Você encontrou, entendeu e modificou com sucesso um exemplo de snippet de código.
## Como usar um código de bibliotecas no seu projeto
Agora vamos aprender a usar bibliotecas, que é uma **prática padrão** para desenvolvedores. As bibliotecas são essencialmente coleções de códigos escritas por outros desenvolvedores para executar tarefas específicas. Você pode importar bibliotecas para seu projeto para usar o código pré-escrito, economizando tempo e esforço.
Nesta seção, continuaremos trabalhando com o exemplo da calculadora fatorial Python da seção anterior. Para referência, este é o código atual:
```python copy
def calculate_factorial(number):
# Initialize the factorial result to 1
factorial = 1
# Loop from 1 to number (inclusive) and multiply factorial by each number
for i in range(1, number + 1):
factorial *= i
return factorial
print(calculate_factorial(5))
print(calculate_factorial(7))
print(calculate_factorial(9))
print(calculate_factorial(10))
```
### 1. Como encontrar uma biblioteca
Depois de saber a funcionalidade que você deseja adicionar ao projeto, pesquise uma biblioteca com o código relevante.
Bate-papo do Copilot é uma maneira fácil de procurar bibliotecas, pois você pode usar a linguagem natural para descrever exatamente o que está procurando.
Encontrar um fatorial é uma função bastante comum e é bem provável que alguém tenha incluído essa função em uma biblioteca existente. Abra [Bate-papo do Copilot](https://github.com/copilot)e pergunte:
```text copy
Is there a Python library with a function for calculating a factorial?
```
Copilot nos informará que uma função fatorial está incluída no [`math`](https://docs.python.org/3/library/math.html) módulo da biblioteca padrão do Python.
### 2. Como priorizar a segurança no seu projeto
Ao adicionar uma biblioteca ou um módulo ao seu projeto, você cria o que é chamado de **dependência**. As dependências são pacotes de código pré-escritos dos quais o projeto depende para funcionar corretamente. Se elas não forem escritas com atenção ou não receberem uma manutenção adequada, poderão introduzir vulnerabilidades de segurança no seu trabalho.
A boa notícia é que há algumas etapas que você pode realizar para proteger melhor seu projeto. Vamos praticá-las agora.
#### Como usar bibliotecas populares
As bibliotecas populares costumam ser mais seguras porque são mantidas e usadas ativamente por muitos desenvolvedores. Um bom indicador de popularidade é o número de **estrelas** que um repositório tem. Se você não conseguir encontrar o repositório GitHub para uma dependência, poderá pedir ajuda a Copilot.
Abra [Bate-papo do Copilot](https://github.com/copilot)e pergunte:
```text copy
Find the GitHub repository containing the code for the math module in Python.
```
Copilot informará que o `math` módulo está definido em [`python/cpython`](https://github.com/python/cpython), que tem mais de 64.000 estrelas.
#### Habilitando Dependabot alerts para seu projeto
Quando habilitado, Dependabot alerts é gerado automaticamente quando Dependabot detecta um problema de segurança em suas dependências, ajudando você a corrigir rapidamente as vulnerabilidades.
Dependabot está disponível **gratuitamente** em todos os repositórios de software GitHub livre.
Ative Dependabot alerts para o seu repositório agora. Clique na aba ** Security and quality** do repositório do seu projeto GitHub. Clique ao lado de Dependabot alerts, em **Habilitar Dependabot alerts**. Você pode acessar Dependabot alerts pela guia **Dependabot** da barra lateral.
### 3. Como implementar o código de uma biblioteca
Agora está tudo pronto para você importar a biblioteca para seu projeto e, em seguida, usar o conteúdo dela no código. Você pode ler a documentação da biblioteca para saber como fazer isso por conta própria ou pode pedir Copilot para sugerir e explicar uma implementação para você.
Abra [Bate-papo do Copilot](https://github.com/copilot)e pergunte:
```text copy
How do I use the factorial function of the math module in my Python project?
```
Copilot em seguida, sugerirá uma versão do seguinte código:
```python copy
import math
# Calculate the factorial of a number
number = 5
result = math.factorial(number)
print(f"The factorial of {number} is {result}")
```
Depois de substituir o código existente no projeto pela implementação acima, você terá utilizado com sucesso o código de uma biblioteca no seu projeto de exemplo!
## Compartilhando seu trabalho
Com este tutorial, você aprendeu a reutilizar com segurança o código de outras pessoas em seu trabalho. Para comemorar, compartilhe como você reaproveitou o código e se baseou no projeto de exemplo em nossa [discussão na comunidade](https://github.com/orgs/community/discussions/153140).
## Leitura adicional
* [Localizando e entendendo código de exemplo](/pt/get-started/learning-to-code/finding-and-understanding-example-code)