Bir rapor aracının kaç kayıt işleyeceğini komut satırından almak kullanışlıdır. Fakat girdiyi doğrudan dosya veya sorgu işlemine aktarmak yerine kabul edilen biçimi önceden tanımlayın. Kullanıcı yanlış yazdığında anlaşılır yardım alabilmelidir.
Aracın giriş sözleşmesini yazın
Argparse, seçeneklerin tanımlanmasına, tür dönüşümüne ve yardım metnine yardımcı olur. Basit bir örnek:
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("--adet", type=int, default=10)
parser.add_argument("--bicim", choices=["json", "csv"])
args = parser.parse_args()
Bu örnekte adet tam sayıya dönüştürülür; biçim belirtilirse izinli seçeneklerden biri olmalıdır. Negatif adet gibi uygulamanın kabul etmeyeceği değerler için ayrıca kural tanımlamanız gerekir.
Tür ile anlamı ayırın
Bir metnin tam sayıya çevrilebilmesi işlemin güvenli büyüklükte olduğunu göstermez. Azami kayıt sayısı veya erişilebilen klasör gibi sınırları iş katmanında denetleyin. Yardım ekranında varsayılan davranışı ve gerekli seçenekleri açıklayın.
Kullanıcı gözüyle deneyin
Seçeneksiz çağrı, bilinmeyen seçenek, yanlış tür ve izinli olmayan biçim için sonucu inceleyin. Hata mesajı kullanıcının düzeltmesi gereken şeyi açıkça söylüyor mu? Dosya yazan bir araçsa geçersiz girişte yarım çıktı oluşturulmadığını da kontrol edin.
Gizli bilgiyi komuta taşımayın
Parola veya API anahtarını doğrudan komut argümanına yazmak kabuk geçmişi ve süreç listesi üzerinden bilgi sızdırabilir. Uygulamanızın güvenli gizli bilgi yöntemini kullanın. Son kontrolü yardım metniyle bitirmeyin; gerçekten tanımlanan seçeneklerin işleyişe doğru bağlandığını ve sınırların uygulandığını doğrulayın.
