مقدمة Aspose.BarCode FOSS for Python

مقدمة

نحن نُصدر Aspose.BarCode FOSS لـ Python، مكتبة pure-Python لتوليد رموز شريطية 1D و2D متوافقة مع المعايير. المصدر متاح على GitHub as aspose-barcode-foss، تحمل رخصة MIT، ولا توجد تبعيات خارجية.

تدعم المكتبة سبع رموز رمزية: Code 128، Code 39، EAN-13، EAN-8، QR Code، UPC-A، و UPC-E. كل باركود يُظهر مباشرةً كـ SVG أو PNG. لا توجد امتدادات أصلية، ولا حزم نظام لتثبيتها، ولا حاجة إلى برامج تشغيل رسومية — قم بالبناء من المصدر على Windows وLinux وmacOS.

الميزات الرئيسية

إنشاء عالي المستوى API

دالة generate() العليا تقبل اسم الرمز الرمزي وسلسلة البيانات، وتعيد كائن Barcode. المساعدون المخصصون لكل رمز رمزي — code128()، code39()، ean13()، ean8()، qr()، upca()، وupce() — يوفرون نقاط دخول آمنة من حيث النوع لكل تنسيق.

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

خيارات الترميز الخاصة بالرموز الرمزية

كل رموز القنص تقبل فئة خيارات تتحكم في سلوك الترميز. Code128Options يوفر encode_mode (AUTO, CODE_A, CODE_B, CODE_C, CODE_AB, CODE_AC, CODE_BC). Code39Options يدعم وضعيات BASE و FULL_ASCII. QrOptions يُظهر error_correction_level (L, M, Q, H)، version، mask، وencoding_mode (AUTO, NUMERIC, ALPHANUMERIC, BYTE, KANJI).

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)
png_bytes = bc.to_png()

ضوابط العرض

RenderOptions يتحكم في المخرجات البصرية: scale، dpi، module_width، module_height، quiet_zone، foreground_color، background_color، transparent_background، show_text، font_family، وfont_size. كلا من to_svg() وto_png() يقبلان معاملًا اختياريًا RenderOptions.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.ean13("590123412345")
svg = bc.to_svg(options=RenderOptions(
    scale=2.0,
    foreground_color="#003366",
    quiet_zone=10.0,
    show_text=True,
))

أرقام التحقق التلقائية

EAN-13، EAN-8، UPC-A و UPC-E تحسب أرقام التحقق تلقائيًا من سلسلة البيانات. تزود فقط بأرقام الحمولة؛ المكتبة تُضيف رقم التحقق الصحيح أثناء الترميز.

التحقق من صحة الإدخال

كل رموز القنص لديها InputParser مخصص يتحقق من صحة البيانات قبل الترميز. يتم اكتشاف الأحرف غير الصالحة، الأطوال غير الصحيحة، وانتهاكات التنسيق مبكرًا باستخدام استثناءات محددة النوع: InvalidInputError، EncodingError، SymbologyNotFoundError، وUnsupportedCapabilityError — جميعها ترث من BarcodeError.

البدء السريع

git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .

إنشاء رمز شريطي Code 128 وكتابة ملف SVG إلى ملف:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.code128("Hello World")
svg = bc.to_svg(options=RenderOptions(show_text=True))

with open("barcode.svg", "w") as f:
    f.write(svg)

إنشاء QR code وحفظه كملف PNG:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

المكتبة تتطلب Python 3.12 أو أحدث.

الصيغ المدعومة

صيغ الإخراج:

المصدر المفتوح والترخيص

المكتبة مرخصة بموجب رخصة MIT. يمكنك استخدامها في التطبيقات التجارية، تعديلها، وإعادة توزيعها دون أي قيود. المصدر متاح على GitHub. لا توجد مستويات استخدام، ولا حدود للرموز، ولا تتبع. كل المعالجة تتم محليًا.

البدء

• البدء
• دليل المطور
• مقالات KB
• API Reference
• PyPI: aspose-barcode-foss

الموارد ذات الصلة

• Aspose.BarCode for Python Enterprise Product
• Aspose.BarCode — Enterprise Blog