Alıştırma - Geliştirme ortamı ayarlama

Tamamlandı

Python ile Flask uygulamasını yazmaya başlamak için ortamı ayarlamanız ve bu doğrultuda birkaç bileşen yüklemeniz gerekir. Neyse ki kullanacağımız araçlar yaygın bir şekilde kullanılmaktadır ve bu modülde öğrendikleriniz sonrasında da işinize yarayacaktır. Belki de bunları önceden yüklemiş bile olabilirsiniz! Uygulamayı yerel ortamda geliştirmek ve test etmek için bu araçlardan faydalanacağız.

Bu ünitede Python araçlarını yüklemeyi ve sanal Python ortamı oluşturmayı öğreneceksiniz. Web sitesini oluşturmak için kullanacağımız çerçeve olan Flask'i de yükleyeceksiniz.

Önemli

Bu modülde birçok farklı yazılım paketi yükleyip yapılandıracak ve sanal bir Python ortamı oluşturacaksınız. Sanal ortam komut istemi pencerenizde veya terminalinizde etkinleştirildikten sonra ilgili pencereyi veya terminali açık bırakın. Pencereyi veya terminali kapatırsanız yeni pencerede veya terminalde aynı Python sanal ortamınızı yeniden başlattığınızdan emin olun. Tüm çalışmaları bu modülün başında oluşturduğunuz aynı Python sanal ortamında tamamlamanız önemlidir.

Gerçekleştireceğimiz işlemler aşağıdaki adımlarda özetlenmiştir:

  1. Visual Studio Code'u yükleme (yüklü değilse)
  2. Python'ı yükleme (yüklü değilse)
  3. Kodunuz için bir dizin oluşturma
  4. Sanal ortam oluşturma
  5. Flask'i ve diğer kitaplıkları yükleme

Visual Studio Code’u yükleme

Visual Studio Code, neredeyse her türden uygulamayı oluşturmanızı sağlayan bir açık kaynak kod düzenleyicisidir. Geliştirici olarak hayatınızı kolaylaştıracak eklentiler bulabileceğiniz kapsamlı bir uzantı marketine sahiptir.

Python'ı Yükleme

Bu üniteyi tamamlamak için bilgisayarınızda Python 3.6 veya üzeri yüklü olmalıdır. Özellikle önceden kullandıysanız Python bilgisayarınızda yüklü olabilir. Yüklü olup olmadığını denetlemek için aşağıdaki komutlardan birini yürütebilirsiniz:

# Windows:
python --version

#macOS or Linux
python3 --version

Python yüklüyse çıkışta Python sürüm numarası gösterilir. Python'ı yüklemeniz gerekiyorsa Visual Studio Code için Python 3'ü yükleme belgelerindeki adımları izleyebilirsiniz. Makalenin en üstünden yapılandırmanıza özgü yönergeleri seçin: Windows, Linux veya Mac.

Önemli

Windows kullanıyorsanız yükleyicide Add to PATH (PATH değişkenine ekle) seçeneğini belirtmeyi unutmayın. Bu adımı kaçırırsanız yüklemeyi tamamlamış olsanız dahi "Python isn't found" (Python bulunamadı) hata iletisiyle karşılaşırsınız.

Proje dizinini oluşturma

İstediğiniz yerde bir dizin oluşturun. Bu dizin, proje dizininiz olacak ve oluşturacağınız kod buraya kaydedilecek. Aşağıdaki komutlardan birini kullanarak komut veya terminal penceresinden dizin oluşturabilirsiniz:

# Windows
md contoso
cd contoso

## macOS or Linux
mkdir contoso
cd contoso

Önemli

Komut veya terminal pencerenizi modül bitene kadar kapatmayın.

Python sanal ortamı oluşturma

Python sanal ortamı aslında karmaşık bir ortam değildir. Sanal makine veya kapsayıcı oluşturmak yerine oluşturduğumuz sanal ortam, Python çalışma zamanı dahil olmak üzere uygulamanın çalıştırılması için gerekli olan tüm kitaplıkları içeren bir klasördür. Sanal ortam kullanarak uygulamaları modüler hale getirebilir, bu sayede birbirinden ayrı tutabilir ve sürüm oluşturma sorunlarından kaçınabilirsiniz. En iyi deneyim olarak Python ile çalışırken her zaman sanal ortam kullanmanız önerilir.

Sanal ortamı kullanabilmek için önce oluşturmanız ve etkinleştirmeniz gerekir. Bunu oluşturmak için önceki bölümlerde yer alan Python'ı yükleme yönergeleri kapsamında yüklediğimiz venv modülünü kullanacağız. Modülü etkinleştirerek sistemimize tüm Python ihtiyaçları için oluşturduğumuz klasörü kullanmasını söylemiş oluyoruz.

# Windows
# Create the environment
python -m venv venv
# Activate the environment
.\\venv\\scripts\\activate

# macOS or Linux
# Create the environment
python3 -m venv venv
# Activate the environment
source ./venv/bin/activate

Flask'i ve diğer kitaplıkları yükleme

Sanal ortamımızı oluşturup etkinleştirdiğimize göre artık web sitemiz için ihtiyacımız olan Flask kitaplığını yükleyebiliriz. Flask'i yüklemek için yaygın kullanılan yöntemden faydalanacak ve bir requirements.txt dosyası oluşturacağız. requirements.txt dosyası normalde özel bir dosya değildir, uygulamamız için gerekli olan kitaplıkları listelediğimiz bir metin dosyasıdır. Ancak geliştiriciler genellikle bu yöntemi kullanır ve bu sayede çok sayıda kitaplığın bağımlılık olarak bulunduğu uygulamaları yönetmek daha kolay olur.

Sonraki bölümlerde yer alan alıştırmalarda requests (Translator Metin Çevirisi hizmetini çağırmak için) ve python-dotenv (anahtarlarımızı yönetmek için) gibi birkaç farklı kitaplıktan faydalanacağız. Şu an bunlara ihtiyacımız olmasa da şimdiden yükleyerek işimizi kolaylaştırabiliriz.

  1. Komut veya terminal penceresinde aşağıdaki komutu çalıştırarak dizini Visual Studio Code ile açın:

       code .
    
  2. Yeni Visual Studio Code Gezgini penceresinde Yeni Dosya'ya tıklayın

    Dosya'daki Yeni Dosya düğmesini gösteren Visual Studio Code.

  3. Dosyaya requirements.txt ve aşağıdaki metni ekleyin:

    flask
    python-dotenv
    requests
    
  4. Ctrl-S veya Mac için Cmd-S tuşlarını kullanarak dosyayı kaydedin

  5. Komut veya terminal penceresine geri dönün ve aşağıdaki komutu pip ile çalıştırarak yüklemeyi gerçekleştirin:

    pip install -r requirements.txt
    

Komut, gerekli kitaplıkları ve bağımlılıklarını indirir.

Not

pip sürümünüz güncel değilse hata iletisi alabilirsiniz. Yükseltmeyi gerçekleştirmek için hata iletisindeki yönergeleri izleyin. Bu modül için yükseltme gerekli değildir.

Tebrikler! Geliştirme ortamınızı ayarladınız!