DAT Python Library
GitHub PyPIInstallation
فوری آغاز
یہ مکمل flow CMS سے certificates لیتا، JSON data والا DAT بناتا اور verify کرتا ہے۔
مرحلہ وار
1. CMS سے connect کریں
Issuing service full certificates کا token استعمال کرتی ہے۔ startup پر فوراً synchronization سے certificates ملنے سے پہلے issuance نہیں ہوتا۔
2. DAT issue کریں
یہ مثال public JSON کو plain اور protected user information کو JSON کی صورت secure میں رکھتی ہے۔
3. DAT verify کریں
parse expiration اور signature check کرکے secure decrypt کرتا ہے۔ صرف successful verification کے بعد ملنے والا payload استعمال کریں۔
اہم functions
| Function | مقصد |
|---|---|
sync_or_raise() | Certificates فوراً synchronize کرتا ہے۔ |
issue(plain, secure) | DAT string بناتا ہے۔ |
parse(dat) | DAT verify کرکے DatPayload دیتا ہے۔ |
last_error() | آخری synchronization error دیتا ہے۔ |
Data regions
plain: signed مگر encrypted نہ ہونے والے bytes۔secure: encrypted bytes۔payload: صرفparseکامیاب ہونے کے بعد اعتماد کریں۔
JSON کے علاوہ options
مثالوں میں معروف JSON ہے۔ تیز processing کے لیے binary data، JSON serialization اور parsing سے بچ کر data size کم کر سکتا ہے۔
Simple values text کی صورت یا structured data کو Protobuf یا MessagePack جیسے binary formats میں plain اور secure میں رکھیں۔
bytes براہِ راست دیں اور plain_bytes اور secure_bytes سے لیں۔
Verify-only services
DAT issue نہ کرنے والی service verify-only option اور verify-only token استعمال کرتی اور صرف parse call کرتی ہے۔
Shutdown اور errors
automatic synchronization فعال ہو تو shutdown پر stop() call کریں۔
Error messages کے بجائے error codes اور retry classifications استعمال کریں۔