vknIdentity

Mock Jutsu HOW-TO | TR

Modern yazılım geliştirme süreçlerinde, özellikle finansal ve ticari sistemlerin test aşamalarında gerçekçi verilere duyulan ihtiyaç her geçen gün artmaktadır. mock-jutsu kütüphanesi, bu ihtiyacı karşılamak adına sunduğu zengin veri üretim yetenekleri arasında Türkiye'ye özgü kimlik ve kurumsal doğrulama mekanizmalarını da barındırır. Identity kategorisi altında yer alan vkn fonksiyonu, kurumsal işlemlerin temel taşı olan Vergi Kimlik Numarası (VKN) üretimini hem hızlı hem de resmi standartlara uygun bir şekilde gerçekleştirmenizi sağlar.

Üretilen vkn verileri sadece rastgele on haneli sayılardan ibaret değildir; bu fonksiyonun en büyük avantajı, Türkiye'deki resmi sistemlerin kullandığı Modulo 11 algoritmasına tam uyumlu test verisi üretmesidir. Modulo 11 doğrulaması, üretilen her numaranın matematiksel bir süzgeçten geçerek geçerli bir yapıya sahip olmasını sağlar. Bu sayede, uygulamanızın giriş formlarında veya API uç noktalarında bulunan doğrulama mantıklarını (validation logic) test ederken "geçersiz format" hatalarıyla vakit kaybetmeden, gerçek dünya senaryolarını birebir simüle edebilirsiniz.

Geliştiriciler için esneklik sunan mock-jutsu, vkn üretimini farklı çalışma ortamlarında destekler. Python projelerinizde doğrudan jutsu.generate('vkn') komutuyla entegrasyon sağlayabilir, terminal üzerinden hızlıca mock data oluşturmak için mockjutsu generate vkn CLI komutunu kullanabilirsiniz. Ayrıca, performans ve yük testleri yürüten QA mühendisleri için JMeter desteği de sunulmaktadır; ${__mockjutsu(vkn,)} söz dizimi ile test senaryolarınızda binlerce geçerli ve benzersiz VKN verisini anında üreterek sisteminizi zorlayabilirsiniz.

Bu fonksiyonun kullanım alanları oldukça geniştir. Özellikle e-fatura, e-arşiv, bankacılık entegrasyonları veya ERP yazılımları geliştiren ekipler için vkn fonksiyonu kritik bir rol oynar. Müşteri kayıt süreçlerinin test edilmesi, veritabanı şemalarının anlamlı verilerle doldurulması veya üçüncü taraf finans servislerine gönderilen isteklerin doğrulanması gibi senaryolarda güvenle kullanılabilir. Gerçek kurum verilerini kullanmanın getirdiği gizlilik risklerini ortadan kaldıran bu yöntem, geliştirme ve test süreçlerinizin güvenliğini ve veri kalitesini bir üst seviyeye taşır.

CLI Kullanımı
mockjutsu generate vknmockjutsu bulk vkn --count 10mockjutsu export vkn --count 10 --format jsonmockjutsu export vkn --count 10 --format csvmockjutsu export vkn --count 10 --format sql# --mask: regulation-compliant output (PCI DSS / GDPR / KVKK)mockjutsu generate vkn --maskmockjutsu bulk vkn --count 5 --mask
Python API
from mockjutsu import jutsujutsu.generate('vkn')jutsu.bulk('vkn', count=10)jutsu.template(['vkn'], count=5)# mask=True: regulation-compliant outputjutsu.generate('vkn', mask=True)jutsu.bulk('vkn', count=5, mask=True)
JMeter
${__mockjutsu_identity(vkn)}# JMeter Function: __mockjutsu_identity# Parameter 1: vkn# Parameter 2: (not required for this function)# Add 'mask' keyword to get a regulation-compliant masked value${__mockjutsu_identity(vkn,mask)}
REST API
GET /generate/vkn# → {"type":"vkn","result":"...","status":"ok"}GET /bulk/vkn?count=10POST /template {"types":["vkn"],"count":1}# mask=true: regulation-compliant outputGET /generate/vkn?mask=trueGET /bulk/vkn?count=5&mask=true

Parametreler

Parametre Değerler Açıklama
--mask true | false Return a regulation-compliant masked value (PCI DSS, GDPR, KVKK…)

Diğer Diller