Komut satırı uygulamalarınızı harika görünen ilerleme çubuklarıyla modernleştirin.
Bir dosya indirdiğinizde veya bir oyun başlattığınızda, tamamlanana kadar kendini güncelleyen estetik bir animasyon görürsünüz. Bu bir ilerleme çubuğu. İlerleme çubuğu, dosya indirme, karşıya yükleme veya aktarma gibi bir görevin ilerlemesini görselleştirmek için kullanılan bir grafik öğedir.
İki tür ilerleme çubuğu vardır: belirli ve belirsiz. İlerleme çubuklarını belirle, bir görevin zaman içindeki ilerlemesini izler. Belirsiz ilerleme çubukları, döngüsel bir animasyonla sonsuz olarak çalışır.
Peki, bir Python CLI programında nasıl belirli bir ilerleme çubuğu oluşturabilirsiniz?
tqdm Modülü Nedir?
tqdm, esas olarak Casper da Costa-Luis ve diğer on üye tarafından yönetilen bir modüldür. tqdm, “ilerleme” anlamına gelen Arapça taqaddum kelimesinden türemiştir ve İspanyolca’da (te quiero demasiado) “Seni çok seviyorum”un kısaltmasıdır.
tqdm modülünü kullanarak terminalinizde çekici, işlevsel bir ilerleme çubuğu oluşturabilirsiniz. tqdm modülünü kurmak için terminalinizi açın ve çalıştırın:
Zaman Modülü Nedir?
Python’un standart yardımcı modülü varsayılan olarak zaman modülünü içerir, bu nedenle yüklemeniz gerekmez. Çubuğun ilerlemesini görselleştirmeye yardımcı olacak uygulamalarınıza gecikme eklemek için zaman modülünde sağlanan uyku işlevini kullanabilirsiniz.
Tarih ve saati almak, görevleri planlamak ve basit bir çalar saat veya kronometre gibi faydalı uygulamalar oluşturmak için zaman modülünü kullanabilirsiniz .
İlerleme Çubuğu Nasıl Eklenir ve Özelleştirilir
Varsayılan ilerleme çubuğunun kullanımı kolaydır ve bunu çeşitli seçeneklerle özelleştirebilirsiniz.
1. Basit İlerleme Çubuğu
tqdm modülünden tqdm sınıfını ve time modülünden uyku fonksiyonunu içe aktararak basit bir ilerleme çubuğu oluşturabilirsiniz. Bir for döngüsü kullanın ve istediğiniz aralıkta tqdm’yi yineleyin.
Aralık 9e9’a (dokuz milyar) kadar herhangi bir şey olabilir. İlerleme çubuğunu görselleştirmek ve çalışırken görebilmek için bir gecikme eklemek için uyku işlevine saniye sayısını iletin.
Bunun gibi basit bir ilerleme çubuğu uygulayabilirsiniz:
from tqdm import tqdm
from time import sleep
for i in tqdm(range(100)):
sleep(.1)
tqdm’yi içe aktarmak yerine, tqdm ve aralığı birleştirmek ve parametreyi doğrudan iletmek için tqdm modülünden trange’i içe aktarabilirsiniz.
from tqdm import trange
from time import sleep
for i in trange(100):
sleep(.1)
2. Açıklama Metni ile İlerleme Çubuğu
Amacını açıklamak için ilerleme çubuğuna açıklayıcı bir etiket ekleyebilirsiniz. Çift tırnak içine alınmış olarak görüntülemek istediğiniz metni desc parametresi olarak iletin:
for i in tqdm(range(0, 10), desc =”Progress: “):
sleep(.4)
3. Özelleştirilmiş Genişliğe Sahip İlerleme Çubuğu
Varsayılan olarak, ilerleme çubuğunun genişliği, çıktı penceresinin boyutuna dinamik olarak ayarlanır. ncols parametresi yardımıyla beğeninize göre özelleştirebilirsiniz .
Özelleştirilmiş genişliğe sahip bir ilerleme çubuğunu şu şekilde uygulayabilirsiniz:
for i in tqdm(range(0, 10), ncols = 100, desc =”Progress: “):
sleep(.1)
4. Renk Kullanan İlerleme Çubuğu
color parametresini kullanarak ilerleme çubuğunun rengini özelleştirebilirsiniz. Bunu iki şekilde yapabilirsiniz:
- Renk adı: Yeşil, siyah, camgöbeği ve daha fazlası gibi rengin adını kullanabilirsiniz.
- Hex Kodu: Hex kodu, bilgisayarın rengi depoladığı bir biçimdir. Onaltılı rengi bir kare (#) ve ardından onaltılık (0-9, af) olarak 6 karakter ile belirtebilirsiniz. #000000 hex kodu siyahı, #ffffff ise beyazı temsil eder. Bu sayıların yoğunluğunu değiştirerek farklı renk tonları elde edersiniz. Hex Code rengini seçip yapıştırmak için Google’ın Renk Seçici aracını kullanabilirsiniz .
Aşağıdaki gibi özelleştirilmiş renklerle bir ilerleme çubuğu uygulayabilirsiniz:
for i in tqdm(range(0, 100), colour=”#00ffff”, desc =”Progress: “):
sleep(.1)
5. Minimum Aralıklı İlerleme Çubuğu
Varsayılan ayar yerine minimum aralıklarla güncellenen ilerleme gösteren bir ilerleme çubuğu oluşturabilirsiniz. İki güncelleme arasındaki aralık olarak hizmet edecek 1.5 veya 2 gibi bir sayı iletebilirsiniz. Minimum aralığın varsayılan değeri 0.1’dir.
Asgari aralıklarla bir ilerleme çubuğu uygulayabilirsiniz:
for i in tqdm(range(0, 100), mininterval = 2, desc =”Progress: “):
sleep(.1)
6. ASCII Karakterlerini Kullanan İlerleme Çubuğu
Ekranda gördüğünüz normal çubuklar yerine ASCII karakterlerini kullanarak ilerleme çubuğu oluşturabilirsiniz. ASCII karakterlerini kullanmak için ascii parametresini istenen formata ayarlayın.
12345* gibi bir şey kullanırsanız , aralığın sütunlarının her biri sırayla bir yıldız işaretine kadar yinelenir. Serin ve özelleştirilebilir olsa da, gerçek uygulamalarda kullanırken kullanıcı dostu kullandığınızdan emin olun.
ASCII karakterlerini kullanarak bir ilerleme çubuğu uygulayabilirsiniz:
for i in tqdm(range(0, 100), ascii =”12345*”):
sleep(.1)
7. Belirtilen Başlangıç Noktasını Kullanan İlerleme Çubuğu
İlerleme çubuğunu sıfırdan başlatmak yerine ilerleme çubuğu için belirli bir başlangıç noktası belirleyebilirsiniz. Başlangıç parametresine 50 gibi bir başlangıç değeri iletin.
Belirli bir başlangıç noktasını şu şekilde kullanarak bir ilerleme çubuğu uygulayabilirsiniz:
for i in tqdm(range(0, 100), initial = 50, desc =”Progress: “):
sleep(.1)
8. Belirli Sayıda Yinelemeli İlerleme Çubuğu
Belirli sayıda yineleme çalıştıran bir ilerleme çubuğu oluşturabilirsiniz. 50000 üzerinden 500 yineleme çalıştırmak istiyorsanız, toplam parametreye aralık olarak 500’ü ve toplam yineleme sayısı olarak 50000’i iletin.
Belirli sayıda yineleme kullanarak bir ilerleme çubuğu uygulayabilirsiniz:
for i in tqdm(range(0, 500), total = 50000, desc =”Progress: “):
sleep(.1)
İlerleme Çubuğunun Uygulamaları
Bir medya oynatıcının oynatılması veya çevrimiçi bir form aracılığıyla adımların gösterilmesi gibi çeşitli durumlarda ilerleme çubukları göreceksiniz.
Bir ilerleme çubuğu estetik görünse de, yokluğunda web sitesinden ayrılacakları kullanıcıya geri bildirim sağlamak için önemli bir iş yapar.