Introduktion
Vi släpper Aspose.BarCode FOSS för Python, ett rent-Python bibliotek för att generera standardkompatibla 1D- och 2D-streckkoder. Källkoden finns på GitHub as aspose-barcode-foss, har en MIT-licens och har noll externa beroenden.
Biblioteket stöder sju symboler: Code 128, Code 39, EAN-13, EAN-8, QR Code, UPC-A och UPC-E. Varje streckkod renderas direkt till SVG eller PNG. Det finns inga inhemska tillägg, inga systempaket att installera och inga grafikdrivrutiner krävs — bygg från källkod på Windows, Linux och macOS.
Viktiga funktioner
Hög nivå-generering API
Den översta generate()-funktionen accepterar ett symbolnamn och en datasträng och returnerar ett Barcode-objekt. Dedikerade per-symbolhjälpare — code128(), code39(), ean13(), ean8(), qr(), upca() och upce() — tillhandahåller typsäkra ingångspunkter för varje format.
import aspose_barcode_foss as barcode
bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()
Symbolspecifika kodningsalternativ
Varje symbolik accepterar en alternativklass som styr kodningsbeteendet. Code128Options tillhandahåller encode_mode (AUTO, CODE_A, CODE_B, CODE_C, CODE_AB, CODE_AC, CODE_BC). Code39Options stöder BASE- och FULL_ASCII-lägen. QrOptions exponerar error_correction_level (L, M, Q, H), version, mask och 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()
Renderingskontroller
RenderOptions styr den visuella utdata: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family och font_size. Både to_svg() och to_png() accepterar en valfri RenderOptions-parameter.
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,
))
Automatiska kontrollsiffror
EAN-13, EAN-8, UPC-A och UPC-E beräknar kontrollsiffror automatiskt från datasträngen. Du anger endast nyttolastens siffror; biblioteket lägger till den korrekta kontrollsiffran under kodning.
Inmatningsvalidering
Varje symbolik har en dedikerad InputParser som validerar data före kodning. Ogiltiga tecken, felaktiga längder och formatöverträdelser fångas tidigt med typade undantag: InvalidInputError, EncodingError, SymbologyNotFoundError och UnsupportedCapabilityError — alla ärver från BarcodeError.
Snabbstart
git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .Generera en Code 128 streckkod och skriv SVG-filen till en fil:
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)
Generera en QR code och spara den som 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())
Biblioteket kräver Python 3.12 eller senare.
Stödda format
| Symbology | Typ | Kontrollsiffra | Alternativklass |
|---|---|---|---|
| Code 128 | 1D | Inbyggd | Code128Options |
| Code 39 | 1D | Optional | Code39Options |
| EAN-13 | 1D | Automatic | Ean13Options |
| EAN-8 | 1D | Automatic | Ean8Options |
| QR Code | 2D | Inbyggd | QrOptions |
| UPC-A | 1D | Automatic | UpcaOptions |
| UPC-E | 1D | Automatic | UpceOptions |
Utdataformat:
| Format | Tillägg | Export |
|---|---|---|
| SVG | .svg | ✓ |
| PNG | .png | ✓ |
Öppen källkod & licensiering
Biblioteket är licensierat under MIT. Du kan använda det i kommersiella applikationer, modifiera det och distribuera det utan begränsning. Källkoden finns tillgänglig på GitHub. Det finns inga användningsnivåer, inga token-gränser och ingen telemetri. All bearbetning sker lokalt.