Passo 1: Clonando o repositório do GitHub

Abra o terminal (Prompt de Comando ou PowerShell no Windows) e vá até o diretório onde deseja clonar o repositório.

Comando:

git clone https://github.com/canalqb/puzzlebtc.git

Passo 2: Configurando o Git

Defina seu nome e e-mail para que os commits sejam corretamente identificados.

Comando para configurar o nome de usuário:

git config --global user.name "SeuNome"

Comando para configurar o e-mail:

git config --global user.email "seuemail@dominio.com"

Passo 3: Autenticando no GitHub

Você pode se autenticar via HTTPS com Token de Acesso Pessoal (PAT) ou por SSH.

Via HTTPS:

1. Gere um token no GitHub (Configurações > Developer settings > Personal access tokens).
2. Ao fazer push, informe seu usuário e cole o token como senha.

Via SSH:

1. Crie a chave com: ssh-keygen -t rsa -b 4096 -C "seuemail@dominio.com"
2. Adicione a chave pública ao GitHub.
3. Teste com: ssh -T git@github.com

Passo 4: Criando o .gitignore

Evite versionar arquivos sensíveis ou desnecessários com o arquivo .gitignore.

Conteúdo exemplo:

.env
node_modules/
*.log

Passo 5: Criando o arquivo .env

Utilize .env para armazenar variáveis sensíveis como senhas e URLs.

Exemplo de conteúdo:

DATABASE_URL=postgresql://usuario:senha@host/banco?sslmode=require

Passo 6: Removendo o vínculo com o GitHub

Se desejar remover o vínculo remoto com o GitHub:

git remote remove origin

Passo 7: Conectando script Python ao .env no GitHub

Você pode carregar o conteúdo do .env direto do repositório com o Python.

Instale as bibliotecas:

pip install requests python-dotenv pg8000

Código Python exemplo:

import os
import requests
from dotenv import dotenv_values
from io import StringIO
import urllib.parse
import pg8000

# URL raw do .env
github_url = 'https://raw.githubusercontent.com/canalqb/puzzlebtc/main/.env'

response = requests.get(github_url)
if response.status_code == 200:
    env_content = response.text
    os.environ.update(dotenv_values(stream=StringIO(env_content)))
    DATABASE_URL = os.getenv("DATABASE_URL")
else:
    print("Erro ao acessar o arquivo .env")

url = urllib.parse.urlparse(DATABASE_URL)

def conectar_banco():
    try:
        return pg8000.connect(
            user=url.username,
            password=url.password,
            host=url.hostname,
            port=5432,
            database=url.path[1:],
            ssl_context=True
        )
    except Exception as e:
        print(f"Erro ao conectar: {e}")

Documentação oficial do GitHub: https://docs.github.com/pt

Documentação oficial do Python dotenv: https://pypi.org/project/python-dotenv/

Documentação pg8000: https://pypi.org/project/pg8000/