Python Geliştiricileri İçin Poetry Kullanımı Rehberi

Şahin Bölükbaşı
2 min readApr 15, 2024

--

Python projelerinde bağımlılıkları yönetmek ve proje yapılandırmasını kolaylaştırmak için Poetry gibi araçlar büyük önem taşır. Bu rehberde, Poetry’nin ne olduğunu, nasıl kurulup kullanılacağını ve projelerinizde nasıl etkin bir şekilde kullanabileceğinizi adım adım öğreneceksiniz.

Poetry Nedir ve Ne İşe Yarar?

Poetry, Python projelerinde bağımlılıkları yönetmek için kullanılan bir araçtır. Aynı zamanda proje yapılandırması için de kullanılır. Poetry, projenizin gereksinimlerini belirlemenize ve bu gereksinimleri karşılayacak bağımlılıkları otomatik olarak yönetmenize olanak tanır. Böylece projenizin çevreler arasında tutarlı bir şekilde çalışmasını sağlar.

Poetry ve Pip Arasındaki Fark

Poetry ve pip, Python projelerinde bağımlılıkları yönetmek için kullanılan araçlardır, ancak aralarında bazı önemli farklar vardır. Poetry, projenizin bağımlılıklarını ve proje yapılandırmasını tek bir dosyada, yani pyproject.toml dosyasında yönetir. Bu dosya, proje adı, sürümü, Python sürümü, bağımlılıklar ve diğer proje ayarlarını içerir. Ayrıca Poetry, projeniz için otomatik olarak sanal bir ortam oluşturur ve bu ortamı projenizde kullanır. Bu, projenizin bağımlılıklarını projenin dışındaki Python sistemine kurmaz ve izole bir şekilde tutar. Poetry ayrıca bağımlılıklar arasında çakışmaları ve tutarsızlıkları otomatik olarak çözmeye çalışır, bu sayede projenizdeki bağımlılıkların uyumlu ve çalışabilir olmasını sağlar. Poetry'nin bu özellikleri, projenizi taşımak veya paylaşmak daha kolay hale getirir. Öte yandan, pip bağımlılıkları requirements.txt dosyasında veya herhangi bir dosyada listeler ve sanal ortam yönetimi sağlamaz. Bağımlılıkları global olarak veya sanal ortamda elle yönetmeniz gerekir ve çakışmaları veya tutarsızlıkları otomatik olarak çözmez. Bu farklar göz önüne alındığında, Poetry genellikle daha kapsamlı bir çözüm olarak kabul edilirken, pip daha temel ve esnek bir yaklaşım sunar. Projenizin gereksinimlerine bağlı olarak, hangi aracın kullanılacağına karar vermek önemlidir.

Poetry Nasıl Kurulur?

Poetry’yi yüklemek için Python’un yüklü olması gerekir. Daha sonra aşağıdaki komutu kullanarak Poetry’yi yükleyebilirsiniz:

pip install poetry

Poetry İle Proje Oluşturma ve Bağımlılıkları Yönetme Yeni bir proje oluşturmak için terminal veya komut istemcisinde şu komutu kullanabilirsiniz:

poetry new myproject

Bu komut, “myproject” adında yeni bir proje klasörü oluşturur. Proje klasörüne girdikten sonra pyproject.toml dosyasını düzenleyerek projenizin bağımlılıklarını tanımlayabilirsiniz. Örneğin, Flask kullanmak isterseniz:

[tool.poetry.dependencies]
python = "^3.9"
flask = "^2.0.0"

Bağımlılıkları yüklemek için:

poetry install

Poetry ile Proje Çalıştırma Projenizi çalıştırmak için şu komutu kullanabilirsiniz:

poetry run python app.py

Bu komut, app.py dosyasını çalıştırır ve Flask uygulamanızı başlatır.

Poetry, Python projelerinizde bağımlılıkları yönetmek ve proje yapılandırmasını kolaylaştırmak için güçlü bir araçtır. Bu rehberde, Poetry’nin temel kullanımını öğrendiniz ve projelerinizde nasıl kullanabileceğinizi gördünüz. Artık projelerinizi daha düzenli bir şekilde yönetebilir ve Python geliştirmeye daha fazla odaklanabilirsiniz.

--

--