Bu rehber, Jack Fields ve onun Python geliştirme için VS Code kurulumunu anlatan makalesinden epey ilham aldı. Daha fazla detay için lütfen makalesine göz at.

Önkoşullar

Başlamadan önce şunların olduğundan emin ol:
  • Python kurulu (3.8 veya üzeri önerilir)
  • Sürüm kontrolü için Git
  • Cursor kurulu ve en son sürüme güncellenmiş

Gerekli Uzantılar

Aşağıdaki uzantılar, Cursor’ı Python geliştirme için tam donanımlı hale getirir. Sözdizimi renklendirme, linting, hata ayıklama ve birim testleri sağlar.

Gelişmiş Python Araçları

Yukarıdaki uzantılar bugüne kadar Cursor’da Python geliştirme için en popüler uzantılar olsa da, Python geliştirmenden en iyi şekilde yararlanmanı sağlayacak bazı ek uzantılar da ekledik.

uv - Python Ortam Yöneticisi

uv, pip’in varsayılan paket yöneticisi olarak yerini almasının yanı sıra sanal ortamlar oluşturup yönetmek için kullanılabilen modern bir Python paket yöneticisidir. uv’yi yüklemek için terminalinde şu komutu çalıştır:
pip install uv

ruff - Python Linter ve Biçimlendirici

Ruff, programlama hatalarını yakalamak, kodlama standartlarını uygulamaya yardımcı olmak ve yeniden düzenleme (refactoring) önerilerinde bulunmak için kullanılabilen modern bir Python linter’ı ve biçimlendiricisidir. Kod biçimlendirme için Black’le birlikte kullanılabilir. Ruff’u kurmak için terminalinde aşağıdaki komutu çalıştır:
pip install ruff

Cursor Yapılandırması

1. Python Yorumlayıcısı

Cursor’da Python yorumlayıcını yapılandır:
  1. Komut Paleti’ni aç (Cmd/Ctrl + Shift + P)
  2. “Python: Select Interpreter” komutunu ara
  3. Python yorumlayıcını (veya bir sanal ortam kullanıyorsan onu) seç

2. Kod Biçimlendirme

Black ile otomatik kod biçimlendirmeyi ayarla:
Black, kodunu tutarlı bir stille otomatik olarak biçimlendiren bir kod biçimlendiricisidir. Yapılandırma gerektirmez ve Python topluluğunda yaygın olarak kullanılır.
Black’i yüklemek için terminalinde aşağıdaki komutu çalıştır:
pip install black
Ardından, kod biçimlendirme için Black’i kullanması için Cursor’ı yapılandırmak üzere settings.json dosyana şunu ekle:
{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "python.formatting.blackArgs": ["--line-length", "88"]
}

3. Linting

Programlama hatalarını kontrol etmek, kodlama standartlarını sağlamaya yardımcı olmak ve yeniden düzenleme (refactoring) önermek için PyLint kullanabiliriz. PyLint’i yüklemek için terminalinde şu komutu çalıştır:
pip install pylint
{
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.lintOnSave": true
}

4. Tür Denetimi

Linting’e ek olarak, tür hatalarını kontrol etmek için MyPy kullanabiliriz. MyPy’yi yüklemek için terminalinde aşağıdaki komutu çalıştır:
pip install mypy
{
  "python.linting.mypyEnabled": true
}

Hata ayıklama

Cursor, Python için güçlü hata ayıklama özellikleri sunar:
  1. Oluk (gutter) alanına tıklayarak kesme noktaları ayarla
  2. Hata Ayıklama (Debug) panelini kullan (Cmd/Ctrl + Shift + D)
  3. Özel hata ayıklama yapılandırmaları için launch.json dosyasını yapılandır

Framework Desteği

Cursor, popüler Python frameworkleriyle sorunsuz çalışır:
  • Web Frameworkleri: Django, Flask, FastAPI
  • Veri Bilimi: Jupyter, NumPy, Pandas
  • Makine Öğrenimi: TensorFlow, PyTorch, scikit-learn
  • Test: pytest, unittest
  • API: requests, aiohttp
  • Veritabanı: SQLAlchemy, psycopg2