Bir Python sınıfında yöntem sipariş etmenin iyi bir yolu nedir?

Bir Python sınıfında yöntem sipariş etmek istiyorum ama doğru sıranın ne olduğunu bilmiyorum.

Eclipse'de PyDev ile yöntemler çıkardığımda, Eclipse ayıklanan yöntemi değiştirilen yöntemin üstüne koyuyor. Ancak bu, alt düzeydeki ayrıntıları daha yüksek düzeydeki ayrıntıların önüne koyar. Bob Amca'ya göre, kodumun bir gazetenin manşetleri gibi okunması için tam tersini yapmalıyım. Java'yı programladığımda onun tavsiyesine uyuyorum.

Python için en iyi uygulama nedir?

Başkalarının da belirttiği gibi, yöntemlerinizi sipariş etmenin doğru bir yolu yoktur. Belki bir PEP önerisi yararlı olabilir, ama yine de. Sorunuza olabildiğince tarafsız bir şekilde yaklaşmaya çalışmama izin verin.

• Önce arayüzler: Genel yöntemler ve Python sihirli fonksiyonları, sınıfın arayüzünü tanımlar. Çoğu zaman, siz ve diğer geliştiriciler bir sınıfı değiştirmek yerine kullanmak istersiniz. Böylece o sınıfın arayüzüyle ilgilenecekler. Bunu kaynak kodda ilk sıraya koymak, umursamadığınız uygulama ayrıntılarında gezinmeyi önler.

• Özellikler, sihirli yöntemler , genel yöntemler: Hepsi sınıfın arayüzünün bir parçası olan bu üçü arasındaki en iyi sırayı tanımlamak zordur. @EthanFurman'ın dediği gibi, tüm proje için tek bir sisteme bağlı kalmak çok önemlidir. Genel olarak, insanlar __init__()sınıftaki en iyi ilk işlevi bekler , bu yüzden hemen aşağıdaki diğer sihirli yöntemleri takip ederim.

• Okuma sırası: Temel olarak bir hikaye anlatmanın iki yolu vardır: Aşağıdan yukarıya veya yukarıdan aşağıya. Bir geliştirici, üst düzey işlevleri ilk sıraya koyarak, ilk birkaç satırı okuyarak sınıfı kabaca anlayabilir. Aksi takdirde, sınıfı anlamak için tüm dersi okumak gerekir ve çoğu geliştiricinin buna vakti olmaz. Genel bir kural olarak, kendi vücutlarından çağrılan tüm yöntemlerin üzerine yöntemler koyun.

• Sınıf yöntemleri ve statik yöntemler: Genellikle bu, yukarıda açıklanan okuma sırası ile ifade edilir. Normal yöntemler tüm yöntemleri çağırabilir ve bu nedenle önce gelir. Sınıf yöntemleri yalnızca sınıf yöntemlerini ve statik yöntemleri çağırabilir ve sonra gelir. Statik yöntemler, sınıfın diğer yöntemlerini çağırıp sonuncu olamaz.

Bu yardımcı olur umarım. Bu kuralların çoğu bu arada Python'a özgü değildir. Yöntem düzenini uygulayan bir dil bilmiyorum ama öyleyse oldukça ilginç olur ve lütfen yorum yapın.

Doğru bir düzen yok. Bir sistem seçin ve ona bağlı kalın. Kullandığım şu:

class SomeClass(object):
    def __magic_methods__(self):
        "magic methods first, usually in alphabetical order"
    def _private_method(self):
        "worker methods next, also in alpha order"
    def a_method(self):
        "then normal methods, also in alpha order"

Django'nun kaynağında gördüğüm @Ethan'a benzer bir şey yapıyorum, burada asıl fark büyük "############" alanları sınırlandırmak için yorumları engelle. Örneğin,

class SomeClass(object):
    #################
    # Magic Methods #
    #################
    def __magic_methods__(self):
        "magic methods first"

    ##################
    # Public Methods #
    ##################
    def a_method(self):
        "then normal methods, in order of importance"

    ###################
    # Private Methods #
    ###################
    def _private_method(self):
        "then worker methods, grouped by importance or related function"

Açıkçası bu, daha küçük sınıflar için daha az kullanışlıdır.