Ninja Kodları

Ninja programcıların eskiden bu kurnazlıkları yaparak kodu tekrardan düzenleyenleri ağlatırlardı. Kod guruları bu kodları anca test yazarak kontrol edebilirdi. Yeni kod yazmaya başlayanlar bazen daha iyi kullanabilirler.

Dikkatlice oku ve hangisisin bul bakalım – ninja, çaylak, veya kod eleştirmeni.

Özlük aklın ruhudur!

Kodunuzu olabildiğince kısa tutmalısınız. Bu sizin ne kadar zeki olduğunuzu gösterir!

ÖrneÄŸin aÅŸağıdaki '?' kullanımına bakın:

// meşhur bir javascript kütüphanesinden.
i = i ? i < 0 ? Math.max(0, len + i) : i : 0;

Harika deÄŸil mi? EÄŸer böyle yazarsanız, daha sonra gelen programcı bu satıra bakar ve i nin ne olduÄŸunu ve ne yapmaya çalıştığınızı anlamak için uÄŸraşır. Sonra size cevap almaya gelir.

Ona kısa yazmanın her zaman daha iyi olduğunu söyleyin. Sizin yolunuza yani Ninja yoluna çekmeye çalışın!

Tek harf deÄŸiÅŸkenler

Dao kelimesizlikte saklıdır. Sadece Dao doğru başlamıştır ve doğru biter.

DiÄŸer bir ÅŸekilde daha hızlı ( ve daha beter!) kod yazma yöntemi de tek-harfli deÄŸiÅŸkenler kullanmaktır. ÖrneÄŸin a,b ve c gibi.

Kısa değişken isimleri kodun içerisinde aynen bir ninjanın ormanda kaybolduğu gibi kaybolurlar. Kimse onları “arayarak” bulamaz. Hatta birisi bulsa bile ne olduğunu çözemez

…. Fakat bir istisna var. Gerçek ninja hiçbir zaman for döngüsünde sayaç için i kullanmaz. Her yerde kullanır ama orada kullanmaz. Biraz kurcalayın daha çok garip harf var. ÖrneÄŸin x veya y gibi.

Garip deÄŸiÅŸkenler eÄŸer döngü gövdesi 1-2 sayfaysa daha harika olurlar. ( olabildiÄŸince uzun olsun). EÄŸer birisi daha derinlemesine bakarsa, kolayca x in döngü sayacı olduÄŸunu anlayamasın.

Kısaltmalar kullan

Eğer takım tek karakter veya garip kelimeler kullanmanızı engelliyorsa sizde kısaltmalar kullanın

örneğin:

• list → lst.
• userAgent → ua.
• browser → brsr.
• …etc

Sadece gerçekten iyi sezgilere sahip olanlar ne demek istediğinizi anlayacaklar. Her şeyi kısaltın. Sadece sizi anlayabilen insanlar sizin kodunuzu geliştirmeye layıktırlar.

Yükseklere çıkın, soyutlaşın.

Mükemmel karenin köşeleri yoktur
Mükemmel gemi en son inşa edilendir,
Harika nota karmaşık olandır,
Harika görselin belirli bir formu yoktur.

Bir isim seçerken en soyut kelimeyi kullanmaya çalışın. obj, data, value, item, elem gibi.

• Kusursuz deÄŸiÅŸken ismi data nerede isterseniz kullanın. Gerçekten de tüm deÄŸiÅŸkenler data tutmuyorlar zaten, deÄŸil mi?

  …Fakat ya data daha önce alındıysa? value kullanabilirsiniz. O da genel bir tanım. En nihayetinde tüm deÄŸiÅŸkenler bir value alır deÄŸil mi?

• DeÄŸiÅŸkeni tipi ile tanımlayın: str, num… Bir defa deneyin. Genç ninjanın aÄŸzı açık kalsın – böyle isimler gerçekten de kodu kötü mü yapar? Evet!

  Bir taraftan değişken isimleri hala bir şey ifade ediyor. Değişkenin içinde ne var bunu söylüyor: karakter, sayı veya başka bir şey. Fakat dışından başkası kodu anlamaya çalıştığında, şaşıracak ve aslında hiçbir bilgi olmadığını anlayacak

  Gerçekten de değerin tipi hata ayıklarken kolayca bulunabilir. Fakat ya anlamı? Hangi karakter veya sayıyı tutuyor? Bu sorunun cevabı anca iyi bir meditasyon ile bulunabilir!

• …Peki artık bu deÄŸiÅŸkenlerden kalmadıysa? Tabii ki yanlarına sayı ekleyebilirsiniz: data1, item2, elem5 gibi.

Dikkat testi

Sadece gerçekten dikkatli programcılar kodu anlayabilmeli. Fakat bunu nasıl kontrol edebilirsiniz?

Bunlardan biri – benzer deÄŸiÅŸken isimleri kullanın date ve data gibi.

Olabildiğince birbiri ile karıştırın.

Karıştırın ki kodu okuyan kişi kolayca okuyamasın. Eğer bir yazım hatası falan varsa, uzun bir süre takılmışsan, bir çay arası versin.

Zekice eş anlamlı sözler kullanmak

Hepsinden zoru karanlık odada kara kediyi bulmak, hele bir de odada kedi yoksa.

Aynı şeyler için birbirine yakın şeyler kullanmak hayatı daha ilginç kılar ve sizin yaratıcılığınız topluma gösterme açısından iyi bir fırsattır.

ÖrneÄŸin, fonksiyon öneklerini kullanın. EÄŸer bir fonksiyon ekrana çıktı veriyorsa display_ ön eki ile baÅŸlayın. ÖrneÄŸin displayMessage. Sonrasında baÅŸka bir fonksiyonda ekrana yine bir ÅŸey yazdırmak isterseniz bu defa show_ kullanın. ÖrneÄŸin showName

Bu fonksiyonlar için hiçbir farklılık olmasa da sanki farklılık varmış hissi yaratın.

DiÄŸer ninjalarla birleÅŸip: EÄŸer Ahmet ekranda yazı gösteren fonksiyona display.. ile baÅŸlıyorsa, Mehmet render.. ile baÅŸlasın, Mehtapta paint.. kullansın gibi kararlar verebilirsiniz. Düşünün kod ne kadar da ilginç ve çeÅŸitli olur.

… ve şimdi hatrick!!!

birbirinden farklı olan iki önemli fonksiyonu aynı önek ile kullanın.

ÖrneÄŸin, fonksiyon printPage(page) yazıcıyı kullansın. printText(text) ise ekrana yazdırsın. Diyelim ki sizin kodunuza aÅŸina olmayan bir okur bu iki fonksiyonun birbirine yakın isimleri olduÄŸundan karıştırabilir. printMessage “Mesajı nereye yazdırmaktadır? Ekrana mı yoksa yazıcıya mı?” Daha da iÅŸi çıkmaza götürmek ve ustalığınızı belli etmek için printMessage(mesaj) kullanabilirsiniz. Bu da mesajı yeni pencerede göstersin.

İsimleri tekrar kullanın

Bütün taksim edildiğinde, her
birinin isme ihtiyacı var.
Yeteri kadar isim var.
Kişi ne zaman duracağını bilmeli.

Sadece çok gerekli olduğunda yeni değişken ekleyin.

Bunun yerine, var olanı kullanın. Ona yeni değerler atayın

Fonksiyonda sadece paslanan değeri kullanmaya çalışın.

Bu gerçekten o değişkenin içinde şu anda ne olduğunu ve nereden geldiğini anlamayı zor kılar. Az dikkatli birisi hepsinin üzerinden satır satır geçmeli ve her kod dalındaki değişikliği takip etmelidir.

Daha gelişmiş bir yaklaşım ise gizlice(!) bir döngü veya fonksiyon içindeki değişkenin değerini aynısı ile değiştirmek

Örneğin:

function ninjaFonksiyonu(elem) {
  // 20 satır elem ile çalışır

  elem = clone(elem);

  // sonraki 20 satır elemin klonuyla çalışır.
}

elem ile çalışmak isteyen yazılımcı dostunuz fonksiyonun ikinci bölümünde ÅŸaşıracaktır. Sadece hata ayıklarken bunun farkına varabilir. Sonrasında bir de bakar ki aslında klonuyla çalışıyormuÅŸ

Ölümcül derecede etkin bir yoldur. Hatta usta ninjalar bile bu olay karşısında şaşkınlık yaşayabilirler.

Eğlence için alttan çizgi kullanmak.

DeÄŸiÅŸken isimlerinden önce alttan çizgi kullanın _, __ gibi. ÖrneÄŸin _isim veya __deger gibi. Bunun anlamını sadece siz biliyorsanız harika olur. Veya, daha iyisi, bunları eÄŸlencesine ekleyin. hiçbir anlamı olmasın. Farklı yerlerde farklı anlamlara gelsin.

Bir taşla iki kuş vurdunuz. Önce kodu daha uzun ve daha az okunabilir yaptınız, ikinci olarak, yazılımcı dostunuzu tongaya düşürerek alttan çizginin ne anlama geldiğini bulması için uzunca bir süre uğraşmasını sağladınız.

Zeki bir ninja bir yerde alttan çizgi kullanır, başka bir yerde kullanmaz. Böylece ileride kodu hataya hazır hale getirir.

Aşkınızı gösterin

Herkese varlıklarınızın (entity) ne kadar mükemmel olduÄŸunu gösterin. ÖrneÄŸin harikaElement, guzelAlert, cokAkilliNinja gibi isimlendirmeler kodunuzu okuyanları aydınlatacaktır.

Gerçekten de bir yandan super..., harika..., mega... gibi kullanmış fakat diÄŸer yandan hiçbir detay vermemiÅŸ olursunuz. Okuyucunun bunun altında yatan anlamı bulması için birkaç saat meditasyon yapıp hayatını sorgulaması gerekmektedir.

Global değişkenlerin veya dıştaki değişkenlerin üzerine başka değer yazın

Işıktayken karanlıktaki hiçbir şey görünmez
Karanlıktayken, aydınlıktaki her şey görünür.

Fonksiyonun içinde ve dışında aynı değişken isimleri kullanın. Basit, fazladan efora hiç gerek yok!

let kullanici = kullaniciBilgisi();

function yaz() {
  let kullanici = farkliBirFonksiyon();
  ...
  ...bir sürü satır...
  ...
  ... // <-- bir yazılımcı kullanici değişkeniyle çalışmak istiyor...
  ...
}

yaz fonksiyonunun içine bakan bir programcı muhtemelen, global kullanici deÄŸiÅŸkeninin üzerine yazan yerel bir kullanici deÄŸiÅŸkeni olduÄŸunu göremeyecektir.

Sonrasında dışta bulunan kullanici deÄŸiÅŸkenine bakacak ve kullaniciBilgisi fonksiyonunda bir yanlış olduÄŸu kanaatine varacak. Ver elini hata ayıklama!

Her yerde yan etki!

Bazı fonksiyonlar hiçbir ÅŸey deÄŸiÅŸtirmiyormuÅŸ gibi görünür. ÖrneÄŸin hazirMi(), izinKontrol(), tagbul() gibi. Hesaplamaları yapıp veriyi geri döndürdüğü ve bunun dışında bir deÄŸiÅŸiklik yapılmadığı tahmin edilsin. DiÄŸer bir deyiÅŸle “yan etkisi” olmadığı.

En güzel kurnazlık bunlara kendi görevleri dışında “işe yarar” bir eylem yaptırın

Ä°ÅŸ arkadaşınızın yüzündeki ÅŸaÅŸkınlığı düşünebiliyor musunuz? hazirMi,kontrolEt, bul... gibi fonksiyonlar bir ÅŸeyleri deÄŸiÅŸtiriyor. Gerçekten de sınırları zorlayan bir yöntem.

Yine bir başka şaşkınlık yaratacak yöntem ise standart olmayan bir sonuç döndürmek

Gerçekten ne düşündüğünüzü gösterin! izinKontrol mesela true/false dönmesin de daha karmaşık bir obje dönsün.

Her kim ki if(checkPermission(..)) yazarsa neden çalışmadığını anlayamasın. Onlara “Dökümantasyonu oku” diyebilirsiniz. Sonra bu dosyayı ona verin.

Güçlü fonksiyonlar!

Büyük Tao her yerden akar,
saÄŸa ve sola.

Fonksiyonu ismiyle sınırlı tutmayın! Daha geniş tutun.

ÖrneÄŸin, emailDogruluga(email) diye bir fonksiyon sadece bu email’in doÄŸruluÄŸunu söylemesin, hata versin ve tekrardan email girilmesi gerektiÄŸini söylesin.

Ek eylemler fonksiyonun isminde kesinlikle belirtilmesin. Gerçek bir ninja programcı, kodda da bunları açık bir şekilde belirtmeyecektir.

Birçok eylemi bir fonksiyona yazın ki kodun tekrardan kullanılmasını engelleyin

Düşünün ki, diÄŸer yazılımcı sadece email’i kontrol etmek istiyor ve ekrana çıktı vermek istemiyor. Sizin fonksiyonunuz emailDogrula(email) ve hem doÄŸruluk kontrolü yapıyor hem de ekrana hata çıktısı veriyor. Bundan dolayı size bu yazılımcının soracağı bir ÅŸey olamaz. Siz zaten ikisini de yapmışsınız.

Özet

Yukarıda bulunan tavsiyeler gerçek kodlardan alınmıştır. Bazıları deneyimli geliştiriciler tarafından yazılmıştır. Belki de sizden bile deneyimli programcılardan ;)

• Tavsiyelerden bazılarını uygularsanız kodunuz tamamen sürprizlerle dolar.
• ÇoÄŸunu uygularsanız, kodunuz gerçekten de sadece size ait olur. Kimse deÄŸiÅŸtiremez.
• Hepsini uygularsanız aydınlanma arayışında olan genç geliÅŸtiricilere iyi bir ders vermiÅŸ olursunuz.