Okunabilir Clojure Kodu nasıl yazılır?

Clojure'da yeniyim. Yazdığım kodu anlayabiliyorum ama daha sonra anlamak çok zor oluyor.
Parantezleri eşleştirmek zorlaşır.

Çeşitli durumlarda adlandırma kuralları ve girinti konusunda izlenecek genel kurallar nelerdir?

Örneğin anlamak için örnek bir yapılanma örneği yazdım ama ikinci kez tamamen okunamaz görünüyor.

(defn f [{x :x y :y z :z [a b c] :coll}] (print x " " y  " " z " " a " " b " " c)) 

Yapılandırmanın kaldırılması durumunda, bunu doğrudan parametre düzeyinde yapmak veya izin formunu başlatmak ve sonra devam etmek daha mı iyi?

Adlandırma kuralları

• işlevler için küçük harfte kal

• -tireleme için kullanın (diğer dillerde alt çizgi veya deve örneği).

  (defn add-one [i] (inc i))

• ? Örneklerle sonunu (yani, doğru veya yanlış döndüren işlevleri) tahmin eder:odd? even? nil? empty?

• Devlet değiştirme prosedürleri sona eriyor !. Hatırladın set!değil mi? veyaswap!

• Erişimlerine bağlı olarak kısa değişken adı uzunlukları seçin. Bu, gerçekten küçük bir yardımcı değişkeniniz varsa, genellikle tek harfli bir ad kullanabilirsiniz. (map (fn [[k v]] (inc v)) {:test 4 :blub 5})özellikle çok sayıda kod satırı için kullanılıyorsa ve amaçlarını hemen tahmin edemiyorsanız, gerektiğinde daha uzun değişken adları seçin. (benim fikrim).

  Birçok clojure programcısının jenerik ve kısa isimler kullanmaya eğilimli olduğunu hissediyorum. Ancak bu elbette nesnel bir gözlem değildir. Mesele şu ki, bir çok clojure fonksiyonu aslında oldukça geneldir.

  • Anlamlı isimler kullanın. Prosedürler bir şeyler yapıyor, bu yüzden bunları fiilleri kullanarak en iyi şekilde tanımlayabilirsiniz. Clojure yerleşik işlevleri doğru yolda koymalıyız: drop, take, assoc:, vb Sonra anlamlı bir ad seçmek için yollar anlatan güzel bir makale olduğunda http://ecmendenhall.github.io/blog/blog/2013/09/ 02 / temizlik Clojure-anlamlı-adları /

Lambda fonksiyonları

• Aslında lambda işlevlerini adlandırabilirsiniz. Bu hata ayıklama ve profil oluşturma için uygundur (buradaki deneyimim ClojureScript ile).

  (fn square-em [[k v]] {k (* v v)})

• Satır içi lambda işlevlerini #()uygun olarak kullanın

Beyaz boşluk

• Yalnızca ebeveynler satırları olmamalıdır. Parantezleri hemen kapatın. Unutmayın parens editör ve derleyici için orada, girinti sizin için.

• İşlev parametre listeleri yeni bir satıra gider

   (defn eksileri
     [Ab]
     (ab listesi))

Eğer doktor dizelerini düşünürseniz bu mantıklıdır. Fonksiyon adı ile parametreler arasındadır. Aşağıdaki doc dizesi muhtemelen en akıllısı değildir;)

   (defn eksileri
     "Bir şeyleri eşleştirmek"
     [Ab]
     (ab listesi))

• Eşleştirilen veriler, eşleştirmeyi koruduğunuz sürece yeni bir satırla ayrılabilir

  (defn f 
    [{x: x 
      y: y 
      z: z  
      [abc]: coll}] 
    (x "" y "" z "" a "" b "" c'yi yazdırın)) 

(İstediğiniz ,gibi girebilirsiniz , ancak bu mantıksız geliyor).

• Girinti için yeterince iyi bir editör kullanın. Yıllar önce bu lisp düzenleme için emacs, vim bugün de harika. Tipik clojure IDE'ler de bu işlevselliği sağlamalıdır. Sadece rastgele bir metin editörü kullanmayın.

  Vim'de komut kipinde =düzgün girintilemek için komutu kullanabilirsiniz .

• Komut çok uzun olursa (iç içe geçmiş vb.), İlk bağımsız değişkenden sonra yeni satır ekleyebilirsiniz. Şimdi aşağıdaki kod oldukça anlamsızdır, ancak ifadeleri nasıl gruplayabileceğiniz ve girintileyebileceğinizi gösterir:

(+ (if-let [yaş (: kişisel yaş grubu)]
     (eğer (> 18 yaş)
       yaş
       0))
   (sayım (aralık (- 3 b))
                 (azalt + 
                         (aralık 10, 10)))))

İyi girinti, parantez saymanız gerekmediği anlamına gelir. Köşeli ayraçlar bilgisayar içindir (kaynak kodunu yorumlamak ve girintilemek için). Girinti kolay anlaşılması içindir.

Yüksek mertebeden fonksiyonlar forve doseqformlar

Bir Şema arka planından gelince, anladım mapve lambda işlevlerini vb.Ile gurur duydum.

(map (fn [[k x]] (+ x (k data))) {:a 10 :b 20 :c 30})

Bunu okumak oldukça zor. forForm yolu daha güzel:

(for [[k x] {:a 10 :b 20 :c30}]
  (+ x (k data)))

`haritanın bir çok kullanımı vardır ve adlandırılmış işlevler kullanıyorsanız gerçekten güzel. yani

(map inc [12 30 10]

(map count [[10 20 23] [1 2 3 4 5] (range 5)])

İş Parçacığı makrolarını kullanma

Diş makroları kullanın ->ve ->>aynı zamanda dotone zaman uygulanabilir.

Burada önemli olan nokta, iş parçacığı makrolarının kaynak kodunu işlev kompozisyonundan daha doğrusal göstermesidir. Aşağıdaki kod parçası, iş parçacığı makrosu olmadan oldukça okunamıyor:

   (f (g (h 3) 10) [10 3 2 3])

ile karşılaştırmak

   (-> 
     (h 3)
     (g 10)
     (f [10 3 2 3]))

İş parçacığı makrosu kullanarak, genellikle yalnızca bir kez kullanılan geçici değişkenler girmekten kaçınılabilir.

Diğer şeyler

• Dokümanları kullan
• işlevleri kısa tut
• diğer clojure kodunu oku