diario-commandline-client

• ما هذا؟
• الافتراضات
• التثبيت
• إعداد المشروع
• الاستخدام

ما هذا؟

مستودع أدوات أُنشئ لتسهيل استهلاك واجهة برمجة تطبيقات diario بكميات كبيرة. حالياً، هذه الوظائف مكتملة التنفيذ:

• رفع ملف (PDF أو مستند Microsoft Office)
• رفع مجلد كامل من الملفات
• الاستعلام عن تجزئة واحدة
• الاستعلام عن قائمة تجزئات (من ملف واحد)

كيف أحصل على حساب DIARIO؟

أرسل بريداً إلكترونياً إلى [email protected]

تحذير وإخلاء مسؤولية

على الرغم من أن DIARIO من المفترض أن يرفع جزءاً فقط من المستند إلى خوادمنا—لتكون متأكداً من أن خصوصيتك محفوظة (مزيد من المعلومات: https://diario.elevenpaths.com) — هذا السكريبت يرفع المستند كاملاً لأنه من المفترض أن يُستخدم لتحليلات البرمجيات الخبيثة. إذا كنت ترغب في رفع مجموعة مستندات والحفاظ على خصوصيتك عن طريق رفع جزء منها فقط، فيرجى استخدام عميلنا لأنظمة Windows/Linux/Mac مع واجهة مستخدم. وهو متاح من https://diario.elevenpaths.com

الافتراضات

• أنت تستخدم Python 3.x
• لديك virtualenv و virtualenvwrapper مثبّتان وتعملان.

التثبيت

cd diario-commandline-client
mkvirtualenv -p `which python3` diario-commandline-client
pip install -r requirements.txt

إعداد المشروع

تأكد من تفعيل البيئة الافتراضية (virtualenv)، إذا لم تكن مفعّلة، شغّل workon diario-bulk.

أولاً، ستحتاج إلى إنشاء عميل API من بوابة إدارة diario، وبذلك سيتم إنشاء app_id وسر (secret). ننصحك باستخدام متغيرات البيئة لتخزين هذه المعلومات API_CLIENT_APP_ID و API_CLIENT_SECRET على التوالي.

يمكنك فعل ذلك باستخدام خطافات virtualenv postactivate و predeactivate الموجودة في مجلد 'bin' داخل مجلد البيئة الافتراضية. إذا كانت البيئة الافتراضية مفعّلة، يمكنك الانتقال إلى مجلد البيئة الافتراضية باستخدام cdvirtualenv.

	# This hook is sourced after this virtualenv is activated.
	export API_CLIENT_APP_ID=XXXXXXXX
	export API_CLIENT_SECRET=XXXXXXXX

	# This hook is sourced before this virtualenv is deactivated.
	unset API_CLIENT_APP_ID
	unset API_CLIENT_SECRET

إذا كنت تفضّل عدم استخدام متغيرات البيئة الموصى بها، يمكنك تمرير كل من app_id و secret كوسائط إلى السكريبت. وسائط السكريبت لها الأولوية على أي متغيرات بيئة موجودة.

الاستخدام

• احصل على مساعدة حول استخدام السكريبتات:

تذكّر: عندما يُشار إلى ، يكون معالج البروتوكول إلزامياً (https://)

upload.py -h

gethash.py -h

• رفع مستند واحد (لا حاجة لتحديد نوع الملف):

./upload.py -f <path_to_file>

• رفع مجلد (مرة أخرى، لا حاجة لتحديد نوع الملف):

./upload.py -d <path_to_directory>

• الاستعلام عن تجزئة واحدة:

./gethash.py --hash <hash>

• الاستعلام عن عدة تجزئات من ملف فهرس (مرة أخرى، لا حاجة لتحديد نوع الملف):

./gethash.py -f <file_with_hashes>

• الاستعلام عن عدة تجزئات وتخزين النتائج في ملف بدلاً من stdout

./gethash.py -f <file_with_hashes> -l <logfile>

• تمرير app_id و secret الخاصة بـ diario كوسائط (يعمل على أي سكريبت). لنرَ مثال رفع:

./upload.py -s <diario_secret> -a <diario_client_id> -d <path_to_directory>

يمكن أن تكون مسارات الملفات والمجلدات مسارات نسبية أو مسارات مطلقة.