Leitores como você ajudam a apoiar o MUO. Quando você faz uma compra usando links em nosso site, podemos ganhar uma comissão de afiliado.

Os projetos de código aberto estão cada vez mais em demanda, e há um grande número para se aprofundar. Para começar a trabalhar em um projeto de código aberto, ajuda se você puder facilmente clonar o código-fonte e configurar o projeto localmente.

Embora a clonagem possa parecer fácil, pode ser desafiadora com projetos construídos com Django. O Django possui muitas dependências e pacotes que causam conflitos quando não instalados.

Você deve corrigir os conflitos antes que o projeto possa ser executado em sua máquina local. Bem, você não precisa mais sofrer.

Nas próximas etapas, você aprenderá como clonar, configurar e executar seu projeto Django com conflitos mínimos.

O que você vai precisar

Para obter o máximo deste guia, você deve ter o seguinte:

  • Python (Python3 e superior)
  • Um conhecimento prático da Biblioteca Python-Django
  • Pip3
  • Familiaridade com ambientes virtuais Python
    • instagram viewer
  • Conhecimento básico de Git e GitHub
  • Uma conta do GitHub
  • Git instalado em sua máquina local
  • Familiaridade com a linha de comando

Com esses requisitos atendidos, você está pronto para clonar um projeto.

1. Clone o projeto do GitHub

Você pode clonar um projeto de amostra de GitHub e configure-o em sua máquina local.

Para clonar o projeto, clique no botão verde rotulado Código. No menu suspenso, selecione e copie os links HTTP ou SSH. Esses links são as URLs do GitHub para o projeto. Qualquer um deles serve.

Quando você quiser contribuir para um projeto de código aberto usando Git, primeiro você terá que garfo o projeto do repositório do projeto para fazer uma cópia antes da clonagem.

De volta à sua máquina, configure uma pasta chamada clone_boma. Lembre-se de navegar para a pasta com o cd clone_boma comando.

Em seguida, execute o seguinte comando para clonar o projeto na pasta.

git clone <repositório-url>

Portanto, para clonar o projeto de amostra em HTTP, use este comando:

git clone https://github.com/Dindihub/Boma-watch.git

2. Inspecione os arquivos do projeto

Após a clonagem, use o comando ls para verificar se os arquivos do projeto Boma-watch estão presentes. Tipo ls para listar todo o conteúdo da pasta.

Você pode usar um editor de texto de sua escolha para inspecionar o conteúdo de cada arquivo ou visualizá-los no site do GitHub.

3. Configurar um ambiente virtual

Você precisa configurar um ambiente virtual para o projeto. O projeto de amostra vem com um ambiente Pipenv que especifica as dependências do projeto em dois arquivos: PipfileName e Pipfile.lock.

Você encontrará este erro se executar o projeto com o Pipfile antigo:

ModuleNotFoundError: Nenhum módulo chamado 'distutils.core'

Você precisa excluir o ambiente virtual e instalá-lo novamente. Para excluir o ambiente virtual e suas dependências, execute os seguintes comandos consecutivamente.

Para remover o ambiente antigo:

pipenv --rm

Para remover ambos os Pipfiles:

rm Pipfile*

Para instalar suas dependências do Pipenv em sua versão python:

pipenv instalar--python 3.10

Em seguida, execute o seguinte comando para instalar todos os pacotes Pipfiles:

pipenv instalar solicitações de

Em seguida, ative o ambiente virtual:

shell pipenv

Você verá o ambiente virtual ativado no lado direito da janela do seu terminal.

Se você estiver usando o Venv para criar seu ambiente virtual, execute o seguinte para instalar as dependências:

pipinstalar-rrequisitos.TXT

Para listar todas as dependências instaladas:

pip congelar > requisitos.txt

4. Criar um banco de dados

Você precisa instalar um banco de dados para lidar com os dados do projeto. Você pode escolher qualquer tipo de banco de dados que atenda às suas necessidades. Para o projeto de amostra, você deve usar o PostgreSQL.

Aprender como instalar o PostgreSQL no Ubuntu ou instalar o PostgreSQL no Windows.

Depois que tudo estiver definido, inicie o shell do Postgres usando os seguintes comandos:

sudo -i -u postgres
psql

Em seguida, crie um banco de dados chamado new_boma no servidor:

postgres=# cria banco de dados new_boma;

O servidor retorna a palavra CREATE DATABASE quando cria um banco de dados. Confirme se o banco de dados existe listando todos os bancos de dados no sistema com o comando \eu:

Em settings.py, você precisa conectar o banco de dados ao aplicativo. Faça isso substituindo o usuário, nome e senha do banco de dados por seus próprios valores locais:

#...
BANCOS DE DADOS = {
'padrão': {
'MOTOR':'django.db.backends.postgresql',
'NOME':'new_boma',
'DO UTILIZADOR':'postgres',
'SENHA':'senha',
 }
}

Além disso, lembre-se de mudar FUSO HORÁRIO no arquivo settings.py para se adequar à sua localização. Isso manterá seu aplicativo atualizado.

Certifique-se de ter instalado Psycopg2 para acomodar todas as imagens disponíveis:

$ pipenv instalar psicopg2

5. Gerar uma chave secreta

Cada projeto Django tem um único chave secreta. Normalmente, a chave secreta não é exposta online. Deve ser em um ambiente arquivo que você deve incluir em um arquivo .gitignore para excluir do repositório.

Você precisa gerar um novo para que seu projeto seja executado. Crie uma nova chave secreta com um gerador de chave secreta, como Djecrety.

# AVISO DE SEGURANÇA: mantenha a chave secreta usada na produção em segredo!
SECRET_KEY = 'chave-secreta-vem-aqui'

6. Migrar projeto para o banco de dados

Execute o seguinte comando para criar tabelas para o aplicativo no novo banco de dados:

Pitãogerenciar.pyfazer migraçõesaplicativo

Em seguida, execute o seguinte para migrar:

Pitãogerenciar.pymigrar

Quando você executar o python manage.py migrar comando, você encontra erros. Os erros estão notificando você sobre módulos ausentes. Certifique-se de instalar todos os módulos antes de migrar.

Quando tiver todas as dependências instaladas, execute a migração. Se as migrações terminarem, é hora de executar o projeto.

Quando tiver todas as dependências instaladas, execute a migração. Se as migrações forem executadas, é hora de executar o projeto.

7. Executar o Projeto

Execute o projeto para garantir que está tudo bem antes de adicionar sua contribuição. Execute o aplicativo com o seguinte comando:

Pitãogerenciar.pyservidor de execução

Se não houver erros, abra http://127.0.0.1:8000/ em um navegador da web. Você verá a página inicial do projeto conforme mostrado abaixo:

O segredo para clonar um projeto Django

A clonagem de projetos Django ajuda a otimizar seu tempo. Você pode se concentrar no desenvolvimento de novos recursos em vez de iniciar um projeto do zero.

O segredo para clonar e executar um projeto Django em uma máquina local é saber como lidar com as dependências. Após a clonagem, certifique-se de criar um novo ambiente virtual, instalar dependências e conectar-se a um sistema de banco de dados confiável.

Django é uma poderosa biblioteca Python. Aprenda a clonar e usar seus projetos para criar aplicativos incríveis que impactam a comunidade de tecnologia.