PEP 8 İsimlendirme: Profesyonel Python Kodunun Görsel Disiplini

Neden bir stil rehberine ihtiyaç var?#

• Aynı projede 3 farklı stil görmek kafayı karıştırır.
• getUserData
  Python kodunda çağrı yaparken yanlış geliyor — çünkü standart kütüphane
  get_user_data
  ile yazıyor.
• Code review zaman kaybı: "ben snake_case kullanırım", "ben camelCase".

"A foolish consistency is the hobgoblin of little minds." — PEP 8 girişi (Emerson'dan alıntı). Kuralları "şartsız" değil, "topluluk diline uyum" diye al.

Ana isimlendirme konvansiyonları#

Yaygın hata:

camelCase

Python'da yanlış#

# 🚫 Java aksanı
def getUserData(userId):
    db = getDatabase()
    return db.fetchUser(userId)

# ✅ Pythonic
def get_user_data(user_id):
    db = get_database()
    return db.fetch_user(user_id)

Her tipin detaylı kuralları#

Modül adı#

# ✅ İyi
user_service.py
data_loader.py
http_client.py

# 🚫 Kötü
UserService.py        # PascalCase modül adı (yanlış)
user-service.py       # tire (yanlış — Python tireyi minus operatörü olarak parse ediyor!)
USER_SERVICE.py       # büyük harf modül adı (kötü)
userService.py        # camelCase modül adı (yanlış)

import user-service   # SyntaxError!

Paket adı#

my_app/
├── __init__.py
├── core.py
├── utils.py
└── auth/
    ├── __init__.py
    ├── jwt.py
    └── session.py

Değişken adı#

# ✅ İyi
user_count = 0
total_revenue = 1000.50
order_items = []
is_active = True
has_permission = False

# 🚫 Kötü
n = 0                 # tek harf — sadece çok dar scope'ta (ör. for i in range)
userCount = 0         # camelCase
UserCount = 0         # PascalCase (sınıf gibi gözükür)
the_user_count_in_db = 0  # gereksiz uzun

Fonksiyon adı#

# ✅ İyi (fiil ile başlar)
def calculate_total(items): ...
def parse_json(text): ...
def get_user(user_id): ...
def validate_email(email): ...
def is_authenticated(user): ...   # bool dönüyorsa is_/has_/can_ prefix

# 🚫 Kötü
def total(items): ...             # isim, fiil değil — bu fonksiyon mu, değişken mi?
def Calculation(items): ...        # PascalCase (sınıf gibi)
def calc(items): ...              # bilinmedik kısaltma
def doStuff(items): ...           # 'do' generic, ne yaptığı belirsiz

Sınıf adı#

# ✅ İyi
class User: ...
class HttpClient: ...
class JsonParser: ...
class DatabaseConnection: ...

# 🚫 Kötü
class user: ...              # küçük harf (modül gibi gözükür)
class HTTP_CLIENT: ...       # SCREAMING_SNAKE (sabit gibi gözükür)
class httpClient: ...        # camelCase

# ✅ Pythonic — kısaltma da PascalCase'e dahil
class HttpClient: ...
class JsonParser: ...
class XmlReader: ...
class HtmlSanitizer: ...

# 🚫 Java tarzı (yanlış)
class HTTPClient: ...
class JSONParser: ...
class XMLReader: ...

Sabit (constant)#

# ✅ İyi — modül başında, dosya seviyesi sabit
MAX_RETRY = 3
DEFAULT_TIMEOUT = 30
API_BASE_URL = "https://api.example.com"
LOG_LEVEL = "INFO"
DATABASE_URL = "postgresql://..."

# Bunlar fonksiyon çağrılarında "magic number" olmasın diye
def fetch(url, retries=MAX_RETRY, timeout=DEFAULT_TIMEOUT):
    ...

Method adı#

class User:
    def __init__(self, name):
        self.name = name

    def get_full_name(self):
        return f"{self.name}"

    def update_email(self, email):
        self.email = email

    def is_admin(self):
        return self.role == "admin"

Self ve cls#

class Counter:
    def __init__(self, initial=0):
        self.count = initial

    def increment(self):
        self.count += 1

    @classmethod
    def from_zero(cls):
        return cls(initial=0)

_

ve

__

— alt çizgilerin gizli dili#

Tek alt çizgi prefix:

_name

#

# my_module.py
_internal_cache = {}        # private
_helper_function = ...      # private

def public_api():           # public
    ...

İki alt çizgi prefix:

__name

(sınıfta)#

class A:
    def __init__(self):
        self.__secret = 42

class B(A):
    def __init__(self):
        super().__init__()
        self.__secret = "different"   # B'nin kendi attribute'u, A'nın __secret'ını ezmiyor

a = A()
b = B()
print(a._A__secret)         # 42 (mangled)
print(b._B__secret)         # 'different' (mangled)
print(b._A__secret)         # 42 (B, A'dan inherit etti)

__double__

dunder (magic methods)#

class MyClass:
    def __init__(self): ...        # constructor
    def __repr__(self): ...        # debug repr
    def __str__(self): ...         # user-facing str
    def __len__(self): ...         # len() fonksiyonu için
    def __eq__(self, other): ...   # == operator için
    def __add__(self, other): ...  # + operator için

Tek alt çizgi olarak

_

#

for _ in range(10):
    print("Hello")    # 'i' lazım değil, _ kullan

# Tuple unpacking
x, _, z = (1, 2, 3)

>>> 5 + 3
8
>>> _ * 2
16

from gettext import gettext as _
print(_("Hello"))    # çevrilmiş "Merhaba"

Anlamlı isim seçme — sezgisel rehber#

1. Boolean variable'ları

is_

,

has_

,

can_

,

should_

ile başlat#

# ✅
is_active = True
has_permission = False
can_edit = True
should_retry = True
needs_validation = False

# 🚫
active = True               # active what? noun like
permission = False          # permission var mı yok mu? string mi?

2. Liste'ler/koleksiyonlar çoğul#

# ✅
users = [user1, user2, user3]
products = []

# 🚫
user_list = [...]           # 'list' suffix'i gereksiz, dil zaten gösteriyor
list_of_users = [...]       # daha da kötü

3. Tek harfli değişken sadece dar scope#

# ✅
for i in range(10):         # i, j, k loop counter
    print(i)

with open(f) as f:          # bu farklı f'ler — kafa karıştırıcı, kullanma

# Math/algorithm'da
def euclidean_distance(a, b):
    return ((a[0]-b[0])**2 + (a[1]-b[1])**2) ** 0.5

# 🚫
def f(d, t, n):             # f, d, t, n — hiçbiri okunmuyor
    return d * t / n

# Daha iyi
def calculate_speed(distance, time, divisor):
    return distance * time / divisor

4. Kısaltma gereksiz#

# ✅
user_count = 5
calculate_total = ...

# 🚫
usr_cnt = 5
calc_ttl = ...

• db
  (database)
• url
  (URL)
• id
  (identifier)
• http
  (HTTP)
• tz
  (timezone)
• config
  /
  cfg
  (configuration)

5. Magic number'a anlam ver#

# 🚫
if status == 1:
    return result * 0.18

# ✅
ACTIVE_STATUS = 1
TURKEY_VAT_RATE = 0.18

if status == ACTIVE_STATUS:
    return result * TURKEY_VAT_RATE

6. Negatif boolean'dan kaç#

# 🚫
not_found = True
is_invalid = False

if not is_invalid:           # double negative — anlamak zor
    ...

# ✅
found = True
is_valid = True

if is_valid:                 # net
    ...

Türkçe değişken adı kullanmalı mıyım?#

çiçek_sayısı = 100
müşteri_listesi = []
def kullanıcı_getir(id):
    pass

1. Ekosistem İngilizce: Stack Overflow, GitHub, dokümantasyon, kitaplar — hepsi İngilizce. Türkçe değişken kullandığında o ekosisteme entegre olmuyorsun.
2. Takım çalışması zorlaşır: Sırf Türk takımda bile yıllar içinde yabancı geliştirici katılır, kod açık kaynak olur. Türkçe isimler engel olur.
3. Türkçe karakterler bug yaratır: Eski Python sürümlerinde, bazı encoding bağlamlarında, IDE'lerde Türkçe karakter sorunlu.

   ş

   ,

   ğ

   ,

   ı

   /

   İ

   özellikle sorunlu (case conversion'da).
4. AI asistanları İngilizce öğrenildi: Copilot, Claude, ChatGPT İngilizce kod örnekleriyle eğitildi.

   get_user()

   gördüklerinde tahmin iyi;

   kullanıcıGetir()

   gördüklerinde fakir.
5. İş piyasası: Pratisyenler Türkçe isimli kod görüne hemen "amatör" damgası vurur. Şirket eline yeni başlayan junior bunu yapmaz.

Satır uzunluğu — PEP 8'in en tartışmalı kuralı#

• Black (formatter) default'u: 88 karakter.
• Django style guide: 119 karakter.
• Google Python style: 80 karakter (klasik tutuyor).
• Çoğu modern proje: 88-100 karakter.

# 88 karakter sınırında düzgün dur
result = some_function(parameter_one, parameter_two, parameter_three, parameter_four)

# Daha uzunsa kır
result = some_function(
    parameter_one,
    parameter_two,
    parameter_three,
    parameter_four,
)

# Backslash continuation EŞSİZ DURUMLARDA
total = first_part + \
        second_part + \
        third_part

# Daha iyi: parantez içinde implicit continuation
total = (first_part +
         second_part +
         third_part)

// VS Code settings.json
{
  "editor.rulers": [88, 100]
}

PEP 8'i otomatize et —

ruff

#

Ruff — modern champion#

pip install ruff

# Lint (sorunları göster)
ruff check .

# Otomatik düzelt
ruff check --fix .

# Format (PEP 8'e uygun yeniden yaz)
ruff format .

{
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll.ruff": "explicit",
      "source.organizeImports.ruff": "explicit"
    }
  }
}

• PEP 8'e uygun format
• Import'lar sıralı
• Kullanılmayan import'lar silinir
• Yaygın hata pattern'leri otomatik düzeltilir

pyproject.toml ile config#

[tool.ruff]
line-length = 88
target-version = "py313"

[tool.ruff.lint]
select = [
    "E",      # pycodestyle errors
    "W",      # pycodestyle warnings
    "F",      # pyflakes
    "I",      # isort
    "N",      # pep8-naming  ← isimlendirme!
    "UP",     # pyupgrade
    "B",      # flake8-bugbear
    "C4",     # flake8-comprehensions
    "RUF",    # ruff-specific
]
ignore = []

[tool.ruff.lint.pep8-naming]
classmethod-decorators = ["classmethod", "validator"]

Pre-commit hook ile zorla#

# .pre-commit-config.yaml
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.7.0
    hooks:
      - id: ruff
        args: [--fix]
      - id: ruff-format

Pratik: Aşağıdaki kodu PEP 8'e uygun hale getir#

class userManager:
    MaxUsers = 1000
    def __init__(self, dbCon):
        self.DB = dbCon
        self.cnt = 0
        self.userlist = []
    def AddUser(self, U):
        if self.cnt >= self.MaxUsers:
            return False
        self.userlist.append(U)
        self.cnt += 1
        return True
    def GET_USER(self, ID):
        for u in self.userlist:
            if u.ID == ID:
                return u
    def isFull(self):
        return self.cnt == self.MaxUsers

MAX_USERS = 1000   # modül seviyesinde sabit, modülün başına


class UserManager:
    def __init__(self, db_connection):
        self.db = db_connection
        self.users = []         # 'cnt' yerine listenin len'ini kullan

    def add_user(self, user):
        if len(self.users) >= MAX_USERS:
            return False
        self.users.append(user)
        return True

    def get_user(self, user_id):
        for user in self.users:
            if user.id == user_id:
                return user
        return None             # explicit return None

    def is_full(self):
        return len(self.users) >= MAX_USERS

• userManager
  →
  UserManager
  (PascalCase)
• MaxUsers
  →
  MAX_USERS
  modül seviyesinde (constant convention)
• dbCon
  →
  db_connection
  (snake_case + tam kelime)
• cnt
  ve
  userlist
  → tek attr
  users
  (count zaten len'de)
• AddUser
  ,
  GET_USER
  ,
  isFull
  →
  add_user
  ,
  get_user
  ,
  is_full
  (snake_case)
• U
  ,
  ID
  →
  user
  ,
  user_id
  (anlamlı, snake_case)
• get_user
  explicit
  return None
  ekledi (best practice)
• u.ID
  →
  u.id

Bu derste neler kazandın?#