Açık kaynaklı projeler giderek daha fazla talep görüyor ve dikkatinizi çekecek çok sayıda proje var. Açık kaynaklı bir proje üzerinde çalışmaya başlamak için, kaynak kodunu kolayca klonlayıp projeyi yerel olarak kurabilmeniz yardımcı olur.

Klonlama kolay gibi görünse de Django ile yapılan projelerde zorlayıcı olabilir. Django, kurulmadığında çakışmalara neden olan birçok bağımlılık ve pakete sahiptir.

Proje yerel makinenizde çalıştırılmadan önce çakışmaları düzeltmelisiniz. Pekala, artık acı çekmene gerek yok.

Sonraki adımlarda, minimum çakışma ile Django projenizi nasıl klonlayacağınızı, kuracağınızı ve çalıştıracağınızı öğreneceksiniz.

Neye ihtiyacınız olacak

Bu kılavuzdan en iyi şekilde yararlanmak için aşağıdakilere sahip olmalısınız:

• Python (Python3 ve üzeri)
• Python-Django Kitaplığı hakkında çalışma bilgisi
• pip3
• Python sanal ortamlarına aşinalık
• Git ve GitHub hakkında temel bilgiler
• GitHub hesabı
• Yerel makinenizde yüklü Git
• Komut satırı ile aşinalık
• Bu gereksinimler karşılandığında, bir projeyi klonlamaya hazırsınız.

1. Projeyi GitHub’dan Klonlayın

GitHub’dan örnek bir projeyi klonlayabilir ve yerel makinenizde yapılandırabilirsiniz.

Resim, GitHub’da klonlanacak Django projesini gösteriyor

Projeyi klonlamak için Kod etiketli yeşil düğmeye tıklayın. Açılır menüde, HTTP veya SSH bağlantılarından birini seçip kopyalayın. Bu bağlantılar, projenin GitHub URL’leridir. Herhangi biri yapacak.

Git kullanarak açık kaynaklı bir projeye katkıda bulunmak istediğinizde, klonlamadan önce bir kopya oluşturmak için önce projeyi projenin deposundan çatallamanız gerekir.

Makinenize geri dönün, clone_boma adlı bir klasör oluşturun . cd clone_boma komutuyla klasöre gitmeyi unutmayın .

Ardından, projeyi klasöre klonlamak için aşağıdaki komutu çalıştırın.

git clone <repository-url>

Bu nedenle, örnek projeyi HTTP üzerinden klonlamak için şu komutu kullanın:

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

2. Proje Dosyalarını İnceleyin

Klonlamadan sonra , Boma-watch projesindeki dosyaların mevcut olup olmadığını kontrol etmek için ls komutunu kullanın. Klasördeki tüm içeriği listelemek için ls yazın .

Her dosyanın içeriğini incelemek veya GitHub web sitesinde görüntülemek için seçtiğiniz bir metin düzenleyiciyi kullanabilirsiniz.

3. Sanal Bir Ortam Kurun

Proje için sanal bir ortam kurmanız gerekiyor. Örnek proje, projenin bağımlılıklarını iki dosyada belirten bir Pipenv ortamıyla birlikte gelir: Pipfile ve Pipfile.lock .

Projeyi eski Pipfile ile çalıştırırsanız bu hatayla karşılaşırsınız:

ModuleNotFoundError: ‘distutils.core’ adında modül yok

Sanal ortamı silmeniz ve yeniden yüklemeniz gerekir. Sanal ortamı ve bağımlılıklarını silmek için aşağıdaki komutları arka arkaya çalıştırın.

Eski ortamı kaldırmak için:

pipenv –rm

Her iki Pipfile’ı da kaldırmak için:

rm Pipfile*

Pipenv bağımlılıklarınızı python sürümünüze kurmak için:

pipenv install –python 3.10

Ardından, tüm Pipfiles paketlerini kurmak için aşağıdaki komutu çalıştırın:

pipenv install requests

Ardından sanal ortamı etkinleştirin:

pipenv shell

Terminal pencerenizin sağ tarafında sanal ortamın aktif olduğunu göreceksiniz.

Sanal ortamınızı oluşturmak için Venv kullanıyorsanız, bağımlılıkları yüklemek için aşağıdakileri çalıştırın:

pip install -r requirements.txt

Yüklü tüm bağımlılıkları listelemek için:

pip freeze > requirements.txt

4. Bir Veritabanı Oluşturun

Proje verilerini işlemek için bir veritabanı kurmanız gerekir. İhtiyaçlarınıza uygun herhangi bir veritabanı türünü seçebilirsiniz. Örnek proje için PostgresSQL kullanmalısınız.

PostgreSQL’i Ubuntu’ya nasıl kuracağınızı veya PostgreSQL’i Windows’a nasıl kuracağınızı öğrenin .

Her şey ayarlandıktan sonra, aşağıdaki komutları kullanarak Postgres kabuğunu başlatın:

sudo -i -u postgres

psql

Ardından sunucuda new_boma adlı bir veritabanı oluşturun:

postgres=# create database new_boma;

Sunucu, bir veritabanı oluşturduğunda CREATE DATABASE kelimesini döndürür. l komutuyla sistemdeki tüm veritabanlarını listeleyerek veritabanının var olduğunu onaylayın :

Resim, sistemde yeni oluşturulan veritabanını gösterir

settings.py içinde , veritabanını uygulamaya bağlamanız gerekir. Bunu, veritabanı kullanıcısını, adını ve parolasını kendi yerel değerlerinizle değiştirerek yapın:

#……

DATABASES = {

    ‘default’: {

        ‘ENGINE’:’django.db.backends.postgresql’,

        ‘NAME’:’new_boma’,

        ‘USER’:’postgres’,

        ‘PASSWORD’:’password’,

    }

}

Ayrıca, settings.py dosyasındaki TIME_ZONE’ı konumunuza uyacak şekilde değiştirmeyi unutmayın. Bu, uygulamanızı güncel tutacaktır.

Mevcut tüm görüntüleri barındırmak için Psycopg2’yi yüklediğinizden emin olun :

$ pipenv install psycopg2

5. Gizli Anahtar Oluşturun

Her Django projesinin benzersiz bir gizli anahtarı vardır. Genellikle, gizli anahtar çevrimiçi olarak gösterilmez. Depodan hariç tutmak için bir .gitignore dosyasına dahil etmeniz gereken bir env dosyasında olmalıdır.

Projenizin çalışması için yeni bir tane oluşturmanız gerekir. Djecrety gibi bir gizli anahtar oluşturucuyla yeni bir gizli anahtar oluşturun .

# SECURITY WARNING: keep the secret key used in production secret!

SECRET_KEY = ‘secret-key-comes-here’

6. Projeyi Veritabanına Taşıyın

Yeni veritabanında uygulama için tablolar oluşturmak için aşağıdaki komutu çalıştırın:

python manage.py makemigrations app

Ardından, geçiş yapmak için aşağıdakileri çalıştırın:

python manage.py migrate

python Manage.py Migration komutunu çalıştırdığınızda hatalarla karşılaşıyorsunuz. Hatalar, eksik modülleri size bildiriyor. Geçiş yapmadan önce tüm modülleri kurduğunuzdan emin olun.

Tüm bağımlılıkları yükledikten sonra geçişi çalıştırın. Geçişler biterse, projeyi çalıştırma zamanı.

Tüm bağımlılıkları yükledikten sonra geçişi çalıştırın. Geçişler çalışırsa, projeyi çalıştırmanın zamanı gelmiştir.

7. Projeyi Çalıştırın

Katkınızı eklemeden önce her şeyin yolunda olduğundan emin olmak için projeyi çalıştırın. Uygulamayı aşağıdaki komutla çalıştırın:

python manage.py runserver

Hata yoksa http :// 127’yi açın . 0 . 0 . 1 : 8000 / bir web tarayıcısında. Aşağıda gösterildiği gibi projenin açılış sayfasını göreceksiniz:

Resim proje açılış sayfasını gösteriyor

Django Projesini Klonlamanın Sırrı

Django projelerini klonlamak, zamanınızı optimize etmenize yardımcı olur. Sıfırdan bir projeye başlamak yerine yeni özellikler geliştirmeye odaklanabilirsiniz.

Yerel bir makinede bir Django projesini klonlamanın ve çalıştırmanın sırrı, bağımlılıkların nasıl ele alınacağını bilmektir. Klonlamadan sonra yeni bir sanal ortam oluşturduğunuzdan, bağımlılıkları kurduğunuzdan ve güvenilir bir veritabanı sistemine bağlandığınızdan emin olun.

Django, güçlü bir Python kütüphanesidir. Teknoloji topluluğunu etkileyen harika uygulamalar oluşturmak için projelerini nasıl klonlayacağınızı ve kullanacağınızı öğrenin.