Webforumu Blog

Uygulamalı anlatım

Python komut satırı aracında argümanlar nasıl doğrulanır?

Zorunlu seçenek, tür ve izinli değerleri argparse ile tanımlayarak komut satırı aracının giriş sözleşmesini açık hale getirin.

Webforumu.net Editör Masası · Yayın: · Güncelleme:

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.

İlgili rehberler