dnspython

مقدمة

dnspython هي مجموعة أدوات DNS للغة Python. تدعم جميع أنواع السجلات تقريبًا. يمكن استخدامها للاستعلامات ونقل المناطق والتحديثات الديناميكية. تدعم الرسائل الموثقة بـ TSIG و EDNS0.

توفر dnspython وصولاً عالي المستوى ومنخفض المستوى إلى DNS. تقوم الفئات عالية المستوى بتنفيذ استعلامات عن بيانات باسم ونوع وفئة معينة، وتعيد مجموعة إجابات. تسمح الفئات منخفضة المستوى بالتعامل المباشر مع مناطق DNS والرسائل والأسماء والسجلات.

اسم الوحدة النمطية لـ dnspython هو dns. لرؤية بعض الطرق التي يمكن بها استخدام dnspython، انظر إلى دليل examples/.

dnspython هي أداة للتعامل مع DNS، لذلك لا يتم استخدام /etc/hosts. لعمليات البحث الأمامية البسيطة في DNS، من الأفضل استخدام socket.getaddrinfo() أو socket.gethostbyname().

نشأت dnspython في Nominum حيث تم تطويرها لتسهيل اختبار برامج DNS.

حول هذا الإصدار

هذا هو إصدار التطوير من dnspython 2.10.0. يرجى قراءة ما الجديد للحصول على معلومات حول التغييرات في هذا الإصدار.

التثبيت

• العديد من التوزيعات تحتوي على dnspython معبأة لك، لذا يجب عليك التحقق هناك أولاً.
• لاستخدام wheel تم تنزيله من PyPi، قم بتشغيل:

    pip install dnspython

• للتثبيت من الكود المصدري، انتقل إلى المستوى الأعلى من الكود المصدري وقم بتشغيل:

    pip install --upgrade pip build
    python -m build
    pip install dist/*.whl

• لتثبيت أحدث إصدار من الفرع الرئيسي، قم بتشغيل pip install git+https://github.com/rthalley/dnspython.git

لا يعتمد التثبيت الافتراضي لـ dnspython على أي وحدات نمطية أخرى غير تلك الموجودة في مكتبة Python القياسية. لاستخدام بعض الميزات، يجب تثبيت وحدات نمطية إضافية. للراحة، تم تعريف خيارات pip للمتطلبات.

إذا كنت تريد استخدام DNS-over-HTTPS، قم بتشغيل pip install dnspython[doh].

إذا كنت تريد استخدام وظائف DNSSEC، قم بتشغيل pip install dnspython[dnssec].

إذا كنت تريد استخدام وظائف أسماء النطاقات الدولية (IDNA)، يجب عليك تشغيل pip install dnspython[idna]

إذا كنت تريد استخدام حزمة الإدخال/الإخراج غير المتزامن Trio، قم بتشغيل pip install dnspython[trio].

إذا كنت تريد استخدام WMI على Windows لتحديد إعدادات DNS النشطة بدلاً من طريقة فحص السجل الافتراضية، قم بتشغيل pip install dnspython[wmi].

إذا كنت تريد تجربة كود DNS-over-QUIC التجريبي، قم بتشغيل pip install dnspython[doq].

لاحظ أنه يمكنك تثبيت أي مجموعة من الخيارات المذكورة أعلاه، على سبيل المثال: pip install dnspython[doh,dnssec,idna]

ملاحظات

انتهى دعم Python 2.x مع إصدار 1.16.0. تدعم dnspython إصدار Python 3.11 وما بعده. الدعم المستقبلي يتماشى مع عمر إصدارات Python 3.

انتقلت الوثائق إلى dnspython.readthedocs.io.