Python Yorumlayıcısını Genişletme ve Gömme
******************************************

Bu belge, Python yorumlayıcısını yeni modüllerle genişletmek için C
veya C++'da modüllerin nasıl yazılacağını açıklar. Bu modüller sadece
yeni fonksiyonları değil, aynı zamanda yeni nesne tiplerini ve
metotlarını da tanımlayabilir. Belge ayrıca Python yorumlayıcısının
bir uzantı dili olarak kullanılmak üzere başka bir uygulamaya nasıl
yerleştirileceğini de açıklar. Son olarak, temeldeki işletim sistemi
bu özelliği destekliyorsa, uzantı modüllerinin yorumlayıcıya dinamik
olarak (çalışma zamanında) yüklenebilmesi için nasıl derleneceğini ve
bağlanacağını gösterir.

Bu belge, Python hakkında temel bilgiye sahip olduğunuzu varsayar.
Dile gayri resmi bir giriş için bkz. Python Standart Kütüphanesi.
Python Standart Kütüphanesi, dilin daha resmi bir tanımını verir.
Python Standart Kütüphanesi, dile geniş uygulama yelpazesi sağlayan
mevcut nesne türlerini, işlevleri ve modülleri (hem yerleşik hem de
Python'da yazılmış) belgeler.

Tüm Python/C API'sinin ayrıntılı açıklaması için ayrı Python/C API
Referans Kılavuzu'a bakın.


Önerilen üçüncü taraf araçları
==============================

Bu kılavuz, yalnızca CPython'un bu sürümünün bir parçası olarak
sağlanan uzantıları oluşturmak için temel araçları kapsar. Cython,
cffi, SWIG ve Numba gibi üçüncü taraf araçlar, Python için C ve C++
uzantıları oluşturmaya yönelik hem daha basit hem de daha karmaşık
yaklaşımlar sunar.

Ayrıca bakınız:

  Python Paketleme Kullanıcı Kılavuzu: İkili Uzantılar
     Python Paketleme Kullanıcı Kılavuzu, yalnızca ikili uzantıların
     oluşturulmasını basitleştiren çeşitli mevcut araçları kapsamakla
     kalmaz, aynı zamanda bir uzantı modülü oluşturmanın en başta
     neden istenebileceğinin çeşitli nedenlerini de tartışır.


Üçüncü taraf araçları olmadan uzantılar oluşturma
=================================================

Kılavuzun bu bölümü, üçüncü taraf araçlardan yardım almadan C ve C++
uzantıları oluşturmayı kapsar. Kendi C uzantılarınızı oluşturmanız
için önerilen bir yol olmaktan ziyade, öncelikle bu araçların
yaratıcılarına yöneliktir.

* 1. Extending Python with C or C++

  * 1.1. A Simple Example

  * 1.2. Intermezzo: Errors and Exceptions

  * 1.3. Back to the Example

  * 1.4. The Module's Method Table and Initialization Function

  * 1.5. Compilation and Linkage

  * 1.6. Calling Python Functions from C

  * 1.7. Extracting Parameters in Extension Functions

  * 1.8. Keyword Parameters for Extension Functions

  * 1.9. Building Arbitrary Values

  * 1.10. Reference Counts

  * 1.11. Writing Extensions in C++

  * 1.12. Providing a C API for an Extension Module

* 2. Defining Extension Types: Tutorial

  * 2.1. The Basics

  * 2.2. Adding data and methods to the Basic example

  * 2.3. Providing finer control over data attributes

  * 2.4. Supporting cyclic garbage collection

  * 2.5. Subclassing other types

* 3. Defining Extension Types: Assorted Topics

  * 3.1. Finalization and De-allocation

  * 3.2. Object Presentation

  * 3.3. Attribute Management

  * 3.4. Object Comparison

  * 3.5. Abstract Protocol Support

  * 3.6. Weak Reference Support

  * 3.7. More Suggestions

* 4. Building C and C++ Extensions

  * 4.1. Building C and C++ Extensions with setuptools

* 5. Windows'ta C ve C++ Uzantıları Oluşturmak

  * 5.1. Bir Yemek Kitabı Yaklaşımı

  * 5.2. Unix ve Windows Arasındaki Farklar

  * 5.3. DLL'leri Uygulamada Kullanma


CPython çalışma zamanını daha büyük bir uygulamaya gömme
========================================================

Bazen, ana uygulama olarak Python yorumlayıcısının içinde çalışan bir
uzantı oluşturmak yerine, bunun yerine CPython çalışma zamanını daha
büyük bir uygulamanın içine gömmek tercih edilir. Bu bölüm, bunu
başarılı bir şekilde yapmakla ilgili bazı ayrıntıları içerir.

* 1. Python'ı Başka Bir Uygulamaya Gömme

  * 1.1. Çok Üst Düzey Gömme

  * 1.2. Çok Yüksek Düzeyde Gömmenin Ötesinde: Genel Bir Bakış

  * 1.3. Saf Gömme

  * 1.4. Gömülü Python'u Genişletme

  * 1.5. Python'u C++'a Gömmek

  * 1.6. Unix benzeri sistemler altında Derleme ve Bağlama
