Como Criar um Pull Request (PR) no GitHub

 

Como Criar um Pull Request (PR) no GitHub

Um Pull Request (PR) é um recurso essencial no GitHub que permite propor mudanças em um repositório. É como se você estivesse dizendo: "Ei, eu fiz algumas alterações aqui, por favor, dê uma olhada e veja se você quer incluí-las no projeto principal."

Passo a passo para criar um PR:

1. Faça um Fork do Repositório:

   • O que é um fork? É uma cópia do repositório original em sua própria conta. Isso permite que você faça alterações sem afetar o repositório original.
   • Como fazer: Encontre o repositório que você deseja contribuir, clique no botão "Fork" no canto superior direito.

2. Clone o seu Fork para sua máquina:

   • Use o comando git clone para baixar o fork para o seu computador.
   • Exemplo: git clone https://github.com/seu_usuario/nome_do_repositorio.git

3. Crie um novo branch:

   • Por que um novo branch? Isolará suas alterações, permitindo que você trabalhe nelas sem afetar o branch principal do seu fork.
   • Como criar: Use o comando git checkout -b nome_do_seu_branch
   • Exemplo: git checkout -b feature-novo-funcionalidade

4. Faça suas alterações:

   • Edite os arquivos, adicione novos arquivos, etc.
   • Adicione as alterações ao staging: git add .
   • Faça um commit: git commit -m "Descrição clara das suas alterações"

5. Envie as alterações para o seu fork:

   • git push origin nome_do_seu_branch

6. Crie o Pull Request:

   • No GitHub, vá para o seu fork.
   • Você verá uma notificação sobre o novo branch. Clique nela.
   • Clique em "Compare & pull request".
   • Escreva uma descrição clara e concisa do seu PR, explicando o que você fez e por que.
   • Clique em "Create pull request".

Observações importantes:

• Revise seu PR: Antes de enviar, revise cuidadosamente suas alterações para garantir que tudo esteja funcionando como esperado.
• Seja claro na descrição: Uma boa descrição facilita a revisão do seu código e aumenta as chances de seu PR ser aceito.
• Esteja aberto ao feedback: Os mantenedores do projeto podem sugerir mudanças ou pedir mais informações. Seja receptivo a essas sugestões.
• Respeite as convenções do projeto: Cada projeto tem suas próprias convenções de estilo de código e diretrizes de contribuição. Certifique-se de segui-las.

Recursos adicionais:

• Documentação oficial do GitHub: https://docs.github.com/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request  

Pacotes em Python, como importá-los: import ou from ... import ...

Pacotes em Python

Quando importamos pacotes ou modulos em Python, podemos observar que encontramos duas nomenclaturas.

import nome_pacote

ou

from nome_pacote import nome_funcao

 Agora bem, podemos ter a 😏dúvida quando usar import ou from ... import .... ou simplesmente não entender😒 por que é implementada uma ou outra.

Tudo isso ocorre por desconhecimento, já que muitos iniciamos estudando Python, sem ter bem definidas as bases da linguagem. E é por isso que crie este post, para deixar bem explicado as duas nomenclaturas, eu sou Nadi Duno, e sou professora de TI e gosto de criar conteúdo para principiantes, altamente didático e ilustrativo.

Em caso que sejas principiante em Python e desejes, que te explique algum apartado da linguagem, com uma didática diferente que possas entender, deixa aqui tu solicitude, eu amaria💜 poder ajudar-te.

 

Agora sim, mãos na massa.👊

 

Iniciemos entendendo que é um pacote ou modulo.

 

Um pacote é um conjunto de códigos que oferecem funcionalidades especificas, para auxiliar-te.

 

Por exemplo, se desejas fazer um programa que apresente um número aleatório, só escreves uma linha de código e terás esse número aleatório, em lugar de criar um código com várias linhas; se já está criado e está disponível, o usamos, em conclusão, os pacotes estão para facilitar nossa vida.

Agora bem, para usar os pacotes e todas suas funcionalidades só devemos importá-las com a palavra-chave import.

 

Assim:

import random

 

Random é pacote que apresenta elementos aleatorios, ele contém diferentes funcionalidades como choice, randint, random,  ranrange, shuffle, entre outras.

 

Vamos a ver👀 como pegar as funcionalidades do random.

Caso import

Em caso de quer usar várias ou todas as funcionalidades do pacote implementamos import.

import random

E posteriormente usamos o nome do pacote como prefixo seguido de um ponto e o nome da função que você quer, assim:

nome_pacote.nome_funcao()

random.ranint(1,100)

 

 

Caso from .... import ...

Em caso de quer usar só uma funcionalidade do pacote implementamos from ... import ...

from random import choice

 

O choice você pode usá-la diretamente em seu código sem a necessidade de prefixá-la com o nome do pacote, assim:

nome_funcao()

choice('sim','não')

Em conclusão em Python, a diferença de usar import ou from ... import ... tem a ver com a forma como você acessa as funcionalidades do pacote.

 

A escolha entre import e from ... import ... geralmente depende da preferência pessoal, das convenções de estilo de código e da possibilidade de conflitos de nomes. Se você sabe que vai usar apenas um item específico de um pacote ou módulo.

Usar from ... import ... pode ser conveniente, pois evita a necessidade de digitar o nome do pacote ou módulo repetidamente. No entanto, se houver o risco de conflitos de nomes entre os itens que você está importando e outros itens em seu código, pode ser mais seguro usar a forma import para evitar ambiguidades.

 

Vou deixar dois códigos e o que eles apresentam em tela ao ser executados:

 

Caso import 

Executadando, obtemos

 

Caso from .... import ...

Executadando, obtemos

 

Nos exemplos usamos o pacote random, que não precisa de instalação por que ela faz parte da biblioteca padrão  de python, porém, alguns pacotes devemos instala-o separadamente antes de importá-lo,  para isso devemos usar um “gerenciador de pacotes”, chamado pip, o qual é ativado quando instalamos o python, só deves, ativar o PATH, na hora da instalação do programa, assim podes os comandos de python no terminal.

E um terminal, não é mais cedo que uma interface de linha de comando para interagir com o sistema operacional, mediante comandos de texto.

 

Em Windows podes usar o prompt de comando, para instalar o pacote desejado, usando a seguinte sintaxe:

pip install nome_pacote

 

Vamos a testar com um pacote que não vem na biblioteca padrão de Python, mtplotlib, Senão instalar previamente o pacote matplotlib e rodamos o código, vai gerar um erro indicando que o modulo ou pacote não foi encontrado ou instalado.

 

Bora a instalar,  recomendo abrir o terminal e rodar o comando

pip install matplotlib

Ao  finalizar apresenta um mensagem de sucesso, assim:

Testemos este código usando matplotlib.

Executadando, obtemos

 

Matplolib é um pacote para fazer gráficos que precisa ser instalado previamente.

 

👀Em Windows, recomendo usar o prompt de comando para rodar o pip install.👀

Para mais informação dos pacotes em python  podes entrar no site oficial

https://pypi.org/

Sempre verifica a documentação, é uma boa prática.   😎

Data com python

Você já teve que manipular datas em python?

Ela dá uma confusão e retorna a data errada. 😏

Olha o que estava acontecendo no meu código.

Ele estava retornando como data atual  15 de novembro sendo que hoje é 14 de novembro

Assim estava  meu código

#Importando a biblioteca import datetime

#Obter a data atual

date_today =datetime.datetime.now()

#Formatar a data em "dd/mm/aaaa"

date_formated= date_today.strftime("%d/%m/%Y")

print(date_formated)

15/11/2023

Tudo estava certinho, chamava a função, porém a data retornava errada.

Logo depois de dar umas pesquisadas, descobri 🙀🙀 que acontece pelo fuso horário ou localização incorreta no ambiente do sistema, ele pega a data e pela hora que estamos rodando o código, pode ter uma diferença de um dia.

É por isso que vamos melhorar o código definindo o fuso horário local. 

Vamos a usar uma nova biblioteca pytz e definimos explicitamente o fuso horário de 'America/São_Paulo'

Ficando o código assim

#Instalando pacote pytz com Pip Install Packages

pip install pytz

#Importando as bibliotecas

import datetime

import pytz  

# Obter a data e hora atual com o fuso horário local

datetime_now = datetime.datetime.now(pytz.timezone('America/Sao_Paulo'))

# Obter apenas a parte da data

date_today = datetime_now.date()

# Formatar a data em "dd/mm/aaaa"

date_formatted = date_today.strftime("%d/%m/%Y")

print(date_formatted)

14/11/2023

Agora sim 👌👌 imprime certinho o dia de hoje que é 14 de novembro

Código disponível em: https://github.com/nadiduno/linkColabGoogle/blob/main/datanadiduno.ipynb

Atributo async e defer em JavaScript.

O atributo async é usado quando você está carregando um script externo e deseja que ele seja executado de forma assíncrona. Aqui estão algumas coisas importantes a saber:

1. Carregamento Assíncrono:

   • Quando você inclui o atributo async em uma tag <script>, o navegador começa a baixar o arquivo JavaScript imediatamente, mas não bloqueia a renderização da página enquanto o arquivo está sendo baixado.
   • Isso é útil para melhorar o desempenho da página, especialmente quando você tem muitos scripts externos. A renderização da página não fica bloqueada esperando que todos os scripts sejam baixados.

2. Ordem de Execução:

   • Scripts com o atributo async não garantem uma ordem específica de execução. O primeiro script que terminar de baixar será executado primeiro.
   • Se a ordem de execução for importante (por exemplo, se você tem dependências entre scripts), é melhor usar o atributo defer em vez de async.

3. Compatibilidade com Navegadores:

   • O atributo async é suportado em navegadores modernos, mas pode não funcionar em navegadores mais antigos.
   • Certifique-se de testar seu código em diferentes navegadores para garantir a compatibilidade.

<script src="script.js" async></script>

Python - Ciência de dados

 Python é a linguagem de programação de código aberto mais usada por cientistas da computação. Essa linguagem se impulsionou para a vanguarda do gerenciamento de infraestrutura, análise de dados e desenvolvimento de software. De fato, entre suas qualidades, o Python permite que os desenvolvedores se concentrem no que fazem, em vez de como o fazem.

Para que serve a linguagem Python? Os principais usos do Python pelos desenvolvedores são: a programação de aplicações e a criação de serviços web de metaprogramação de geração de código. Tecnicamente, esta linguagem será usada principalmente para scripts e automação (interação com navegadores web).

Raspagem da web do Python, escrever scripts para limpar e analisar um banco de dados, ver resultados graficamente, visualização de dados são uma das coisas que podemos fazer e para isso temos à disposição as bibliotecas para ajudarmos.

Algumas bibliotecas Python são:

Pandas, que permite manipular e analisar tabelas de dados na forma de um Excel em esteróides.

NumPy, que permite cálculos científicos (especialmente estatísticos e probabilísticos).

Scikit-Learn e Tensorflow, que suportam o desenvolvimento de modelos de aprendizado de máquina e deep learning.

Scrapy e BeautifulSoup, que permitem que os dados sejam extraídos diretamente da Web (chamado de "scraping").

Seaborn e Matplotlib, que ajudam na visualização de dados, principalmente oferecendo ferramentas de construção gráfica.

Biopython facilita o processamento e a análise de dados biológicos.

Pygame é usada para criar videogames 2D ou 3D.

As bibliotecas Python participam assim das duas principais forças da linguagem: sua simplicidade de uso, sua versatilidade. Para usar uma biblioteca, basta importá-la no início do programa (basta uma linha de código).

A riqueza das bibliotecas Python torna possível empurrar os limites da linguagem e enfrentar projetos ambiciosos e exigentes em muitas áreas de aplicação.

___________________

Um artigo extraído e traduzido ao português https://ln.ijaba.info/2023/04/foundational-python-for-data-science.html

Descarga do livro em PDF Python Data Science

Você poderá trabalhar para EUNERD de diversas partes do Brasil.

 Se você deseja trabalhar por conta própria com informática e se tornar um profissional autónomo, o site da EUNERD é uma grande oportunidade para você. Nele você encontrará diversas oportunidades de trabalho como:

Especialistas em Suporte;

Técnicos em Informática;

Analistas de Sistemas;

Engenheiros de Inovações;

Gerentes de Projetos.

Toda uma gama de oportunidades para você se inscrever e começar a trabalhar.

Você poderá trabalhar para EUNERD de diversas partes do Brasil. Para isso você irá passar por provas e testes técnicos que comprovem a sua experiência e uma certificação antes de se tornar mais um membro desta grande comunidade de Nerds.

A EUNERD já conta com mais de 20.000 Nerds em todo o Brasil e você pode fazer parte desta comunidade. Portanto aproveite esta chance e seja um Nerd.

https://encontreumnerd.com.br/seja-um-nerd

https://encontreumnerd.com.br/blog/sites-para-tecnicos-informatica

Freelancer onde você pode encontrar trabalhos e projetos:

 Aqui estão alguns sites populares de freelancer onde você pode encontrar trabalhos e projetos:

1. Upwork (www.upwork.com)

2. Freelancer (www.freelancer.com)

3. Fiverr (www.fiverr.com)

4. Toptal (www.toptal.com)

5. Guru (www.guru.com)

6. PeoplePerHour (www.peopleperhour.com)

7. 99designs (www.99designs.com)

8. Simply Hired (www.simplyhired.com)

9. Crowded (www.crowded.com)

10. DesignCrowd (www.designcrowd.com)

11. Envato Studio (studio.envato.com)

12. FlexJobs (www.flexjobs.com)

13. TaskRabbit (www.taskrabbit.com)

14. Freelanced (www.freelanced.com)

15. Gigster (www.gigster.com)

16. Workana (www.workana.com)

17. Zeerk (www.zeerk.com)

18. Outsourcely (www.outsourcely.com)

19. Bark (www.bark.com)

20. SolidGigs (www.solidgigs.com)

Instalar Node para windows com Chocolatey

Windows

Para o Windows utilizaremos o gerenciador de pacotes Chocolatey, porém antes dos passos de instalação vamos falar brevemente sobre qual shell você deve usar.

Site oficial: https://chocolatey.org/

Powershell: novo shell apresentado pela Microsoft por volta de 2005, ele apresenta diversas melhorias em relação ao CMD, tornando-o popular atualmente.

Escolhido o shell, vamos começar a instalação:

- Busque no campo de busca do Windows por Windows Powershell, clique com o botão direito em cima do programa e escolha a opção Executar como administrador.

- O Powershell trabalha com um esquema de autorizações (conhecido como Execution Policy) para execução de scripts e, por isso, precisamos verificar se o presente no sistema está compatível com o que o Chocolatey precisa.

Execute o seguinte comando:

Get-ExecutionPolicy

Caso ele retorne Restricted, execute o comando:

Set-ExecutionPolicy RemoteSigned

E escolha a opção [A] Sim para Todos

 Caso o comando acima apresente erro, tente usar:

Set-ExecutionPolicy Bypass -Scope Process

Verifique se alteração de permissão ocorreu com sucesso executando novamente o comando:

Get-ExecutionPolicy

Alterada a permissão, basta instalar o Chocolatey com o comando:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('<https://community.chocolatey.org/install.ps1>'))

  Caso o comando acima apresente um erro, verifique se a sua máquina atende às requisições mínimas

Windows 7+ / Windows Server 2003+ PowerShell v3+ .NET Framework 4.5+

Caso o erro apresentado seja Exceção ao definir "SecurityProtocol": "Não é possível converter o valor "3312", siga:

https://blog.chocolatey.org/2020/01/remove-support-for-old-tls-versions/

Após o fim da instalação, feche e abra o Windows Powershell como administrador novamente e execute:

choco -v

Caso ele retorne a versão do Chocolatey, a instalação foi um sucesso.

Agora, para instalarmos o Node.js é recomendado, pelo próprio site do Node, usarmos o NVS

Para instalar o nvs execute:

choco install nvs

E escolha a opção [A]ll - yes to all

Após isso, reinicie o Powershell e execute:

nvs add lts

Com isso, o nvs irá baixar e instalar a versão LTS do Node.js (atualmente a v16) mas ainda será necessário informar ao nvs que é essa versão que desejamos usar. Para isso:

nvs link lts

Se o comando rodou sem erro, passe para o próximo passo. Caso seja retornado algum erro como:

Você pode rodar o comando:

nvs ls

Esse comando vai retornar as versões do Node que você possui instalada. Basta copiar a versão (como no exemplo a v16) e adicionar na frente do comando nvs link:

nvs link **node/16.13.0/x64**

Após isso, feche e abra o Powershell novamente e execute:

node -v
npm -v

Caso retorne as versões do Node e npm, sua instalação foi um sucesso!

Otras opções em caso de erro, entre no site de chocolatey

https://docs.chocolatey.org/en-us/choco/setup

Install with cmd.exe

choco install nodejs.install

Criando o projeto com git bash

Passo 1: Abrir git bash 

Ao abrir git bash ele abre no diretório raíz, por isso esse tilde na cor amarelo, podemos criar uma pasta para poder usar e criar este e outros projeto, para que não fique tudo no diretório raíz.

Eu gosto de ter uma pasta chamada project e aí vou guardando todos os projectos que vou desenvolvendo.

Passo 2: Criar uma pasta principal para organizar os projetos, digite no terminal o comando

mkdir project

e pressione enter

Passo 3: Para observar se sua pasta foi criada, digite

ls

e pressione enter, para listar.

Com a pasta criada, vamos a entrar

Passo 4: Entrar na pasta, digite 

cd project

e pressione enter

O diretório vai mudar, observe as letras amarelas, agora diz ~/project, que dizer que estamos no diretório projeto que está no diretório raíz.

E é aqui onde vamos criar nossos projetos, é uma forma ordenada de concentrar este e os próximos projetos.

Passo 5: Criar um pasta para guardar o projeto, com o comando

mkdir portfolio

e pressione enter

Passo 6: Entrar na pasta, digite 

cd portfolio

e pressione enter

O diretório vai mudar, observe as letras amarelas no terminal.

Passo 7: Criar os arquivo do projeto, digite 

touch index.html style.css README.md

e pressione enter

Passo 8: Vamos a ver os arquivos, digite 

ls

e pressione enter

Wuiiii, arquivos criados agora, vamos para visual studio code, para codar.

Passo 9: Abrir visual studio code, digite 

code .

e pressione enter

Agora como os arquivos criados, bora a codar, dá importância também ao README.md o qual dá formalidade na apresentação de seu repositório.

No início vai parecer complexo aprender os comandos de git bash, porém viu que já conseguimos destravar juntos, é a forma de como é ensinado, não tem nada que não possamos aprender, só precisamos entender como funciona e praticar muito.

Repete, repete até conseguir fazer sem ajuda dos tutoriais.

Dica: É muito importante aprender a usar os comandos, porque te deixa mais esperto e poupa tempo na produção.

Qualquer dúvida ou sugestão estou na disposição.

Em caso de ser iniciante, aqui está um exemplo de um programa, seguindo passo a passo.

https://devrelnadiduno.blogspot.com/2023/06/fronteditor-para-codar.html

Com </💜NadiDuno> 

______________________

Nadi Duno | Ela/Dela | Venezuelana em Salvador

Apaixonada por ensinar, criar conteúdo e codar.

Embaixadora da Toti Diversidade

Programming Teacher | Web Developer