Python Modüllerini Dağıtma
**************************

E-posta:
   distutils-sig@python.org

Popüler bir açık kaynak geliştirme projesi olarak Python,
yazılımlarını diğer Python geliştiricilerinin açık kaynak lisans
koşulları altında kullanmasını sağlayan, aktif destek sağlayan
katılımcı (contributor) ve kullanıcı topluluğuna sahiptir.

Bu, Python kullanıcılarının, ortak havuza kendi çözümleriyle
potansiyel olarak katkıda bulunmanın yanı sıra, ortak (ve hatta bazen
nadir!) sorunlara karşı halihazırda oluşturdukları çözümlerden
yararlanarak, Python kullanıcılarının etkin bir şekilde paylaşımda
bulunmalarına ve işbirliği yapmalarına olanak tanır.

Bu kılavuz, sürecin dağıtım bölümünü kapsar. Diğer Python projelerini
kurmaya yönelik bir kılavuz için installation guide 'e bakın.

Not:

  Kurumsal kullanıcılar için, birçok kuruluşun açık kaynaklı
  yazılımları kullanma ve bunlara katkıda bulunma konusunda kendi
  politikaları olduğunu unutmayın. Python ile sağlanan dağıtım ve
  kurulum araçlarını kullanırken lütfen bu tür politikaları dikkate
  alın.


Anahtar terimler
================

* the Python Packaging Index is a public repository of open source
  licensed packages made available for use by other Python users

* Python Packaging Authority , standart paketleme araçlarının, ilgili
  meta verinin ve dosya formatı standartlarının bakımından ve
  geliştirilmesinden sorumlu geliştiriciler ve dokümantasyon yazarları
  grubudur. Hem GitHub hem de Bitbucket üzerinde çeşitli araçlar,
  dokümantasyon ve sorun izleyicileri bulundururlar.

* "distutils", Python standart kitaplığına ilk kez 1998 yılında
  eklenen orijinal derleme ve dağıtım sistemidir. "distutils" 'in
  doğrudan kullanımı aşamalı olarak kaldırılırken, halen mevcut
  paketleme ve dağıtım altyapısının temelini atmıştır. Yalnızca
  standart kitaplığın bir parçası olmakla kalmaz, adı başka şekillerde
  de yaşar (Python paketleme standartları geliştirmeyi koordine etmek
  için kullanılan posta listesinin adı gibi).

* setuptools ilk olarak 2004'te yayınlanan "distutils" için (büyük
  ölçüde) bir eklentidir. Değiştirilmemiş "distutils" araçlarına göre
  en dikkate değer ilavesi, diğer paketlere bağımlılıkları bildirme
  yeteneğiydi. Şu anda, çok çeşitli Python sürümlerinde daha yeni
  paketleme standartları için tutarlı destek sunan "distutils" 'e daha
  düzenli olarak güncellenen bir alternatif olarak önerilmektedir.

* wheel (bu bağlamda), "bdist_wheel" komutunu "distutils"/setuptools
  dizinine ekleyen bir projedir. Bu, Python kütüphanelerinin, (ikili
  uzantıları içerenlerin bile) bir sisteme yerel olarak kurulmasına
  gerek kalmadan kurulmasına izin veren bir çapraz platform ikili
  paketleme biçimi ("wheels" veya "wheel files" olarak adlandırılır ve
  **PEP 427** 'de tanımlanır) üretir.


Açık kaynak lisanslama ve işbirliği
===================================

Dünyanın çoğu yerinde, yazılım otomatik olarak telif hakkı
kapsamındadır. Bu, diğer geliştiricilerin yazılımı kopyalamak,
kullanmak, değiştirmek ve yeniden dağıtmak için açık izne ihtiyaç
duyduğu anlamına gelir.

Açık kaynak lisanslama, bu tür bir izni nispeten tutarlı bir şekilde
açıkça vermenin bir yoludur ve geliştiricilerin çeşitli sorunlara
ücretsiz olarak ortak çözümler sunarak verimli bir şekilde
paylaşmasına ve işbirliği yapmasına olanak tanır. Bu, birçok
geliştiricinin kendi özel durumlarına nispeten benzersiz olan
sorunlara odaklanmak için daha fazla zaman harcamasına izin verir.

Python ile sağlanan dağıtım araçları, geliştiricilerin, isterlerse bu
ortak yazılım havuzuna kendi katkılarını yapmalarını makul ölçüde
basit hale getirmek için tasarlanmıştır.

Aynı dağıtım araçları, yazılımın açık kaynaklı yazılım olarak
yayınlanıp yayınlanmadığına bakılmaksızın, bir kuruluş içinde yazılımı
dağıtmak için de kullanılabilir.


Araçları yükleme
================

Çekirdek geliştirme ekibi, Python'un eski sürümlerinde bile tutarlı
bir şekilde çalışan standart araçlara sahip olmanın önemli olduğunu
keşfettiğinden, standart kütüphane, modern Python paketleme
standartlarını destekleyen derleme araçlarını içermez.

Şu anda önerilen derleme ve dağıtım araçları, komut satırında "pip"
modülü çağrılarak kurulabilir:

   python -m pip install setuptools wheel twine

Not:

  For POSIX users (including Mac OS X and Linux users), these
  instructions assume the use of a *virtual environment*.Windows
  kullanıcıları için bu talimatlar, Python'u kurarken sistem PATH
  ortam değişkenini ayarlama seçeneğinin seçildiğini varsayar.

Python Packaging Kullanıcı Kılavuzu, currently recommended tools
hakkında daha fazla ayrıntı içerir.


Python Paketleme Kullanım Kılavuzunu Okumak
===========================================

Python Paketleme Kullanıcı Kılavuzu, bir proje oluşturma ve
yayınlamayla ilgili çeşitli temel adımları ve öğeleri kapsar:

* (en) Proje Yapısı ;

* (en) Projeyi inşa etmek ve paketlemek ;

* Uploading the project to the Python Packaging Index

* (en) .pypirc dosyası.


Nasıl yaparım...?
=================

Bunlar, bazı genel görevler için hızlı yanıtlar veya bağlantılardır.


... projem için bir isim seçer misin?
-------------------------------------

Bu kolay bir başlık değil, ancak işte birkaç ipucu:

* check the Python Packaging Index to see if the name is already in
  use

* Bu ada sahip bir proje olup olmadığını görmek için GitHub, Bitbucket
  vb. gibi popüler barındırma sitelerini kontrol edin.

* düşündüğünüz isim için bir web aramasında ne çıktığını kontrol edin

* kullanıcıların yazılımınızı ararken bulmasını
  zorlaştırabileceğinden, özellikle birden çok anlamı olan yaygın
  sözcüklerden kaçının


... ikili uzantılar oluşturup dağıtmak?
---------------------------------------

Bu aslında oldukça karmaşık bir konudur ve tam olarak neyi başarmayı
amaçladığınıza bağlı olarak çeşitli alternatifler mevcuttur. Daha
fazla bilgi ve öneriler için Python Paketleme Kullanıcı Kılavuzuna
bakın.

Ayrıca bkz.: Python Paketleme Kullanıcı Kılavuzu: İkili Uzantılar
