Chúng tôi rất vui thông báo về việc phát hành GroupDocs.Metadata for Python v26.9, có sẵn từ tháng 9 năm 2026. Bản phát hành này nâng cấp engine nền tảng từ 26.6 lên 26.8, giới thiệu giao diện dòng lệnh, bổ sung hỗ trợ cho năm định dạng lưu trữ mới (Apple Archive, GZIP, BZ2, XZ và Zstandard), khôi phục lại khả năng đọc các bản trình chiếu PowerPoint trên mọi nền tảng, và sửa các vấn đề tương thích quan trọng ảnh hưởng đến Python 3.5–3.7 và các hệ thống Linux/macOS cũ. Lưu ý rằng bản phát hành này bao gồm một thay đổi gây phá vỡ: 105 lớp định dạng đã được chuyển từ các không gian tên phụ vào các mô-đun cha của chúng.
Có gì mới trong bản phát hành này
- [Feature] Cung cấp giao diện dòng lệnh trong gói (METADATAPYTHON-39)
- [Feature] Thêm hỗ trợ đọc Apple Archive (AAR), GZIP, BZ2, XZ và Zstandard (METADATAPYTHON-62)
- [Enhancement] Cập nhật engine GroupDocs.Metadata từ 26.6 lên 26.8 (METADATAPYTHON-63)
- [Enhancement] Cập nhật runtime .NET nhúng từ 10.0.0 lên 10.0.12 (METADATAPYTHON-64)
- [Enhancement] Di chuyển các lớp định dạng Ogg, FB2, Mobi, MSG, DNG, SVG, thẻ raw, CR2 và 3D vào các mô-đun cha, như trong engine 26.8 (METADATAPYTHON-65)
- [Enhancement] Loại bỏ yêu cầu
libgdiplus/mono-libgdiplustrên Linux và macOS (METADATAPYTHON-66) - [Enhancement] Thêm
FileTypeFeatureSupportvà các enumProductFeature,SupportLevelvàFormatFamilyvào API Python (METADATAPYTHON-67) - [Enhancement] Thêm
get()cho các gói và bộ sưu tập được đánh chỉ mục,append()choIptcRecordSet, và một hàm khởi tạo không đối sốRectangle()(METADATAPYTHON-68) - [Enhancement] Công bố tài liệu tham chiếu API cho mọi mô-đun, bao gồm
formats.*vàstandards.*(METADATAPYTHON-69) - [Fix] Không mở được các bản trình chiếu PowerPoint:
DllNotFoundExceptionchoaspose.slides.drawing.capi(METADATAPYTHON-50) - [Fix] Đọc thẻ EXIF bằng
TiffTagIDthất bại trên Python 3.5 – 3.10 (METADATAPYTHON-51) - [Fix] Không thể sử dụng gói trên Python 3.5 – 3.7 (METADATAPYTHON-70)
- [Fix] pip cài đặt gói trên các phiên bản Linux và macOS không thể chạy được (METADATAPYTHON-71)
Thay đổi API công cộng
Các lớp và thành viên mới
groupdocs.metadata.formats.archive:AarRootPackage,AarPackage,AarFile,GzipRootPackage,GzipPackage,Bz2RootPackage,Bz2Package,XzRootPackage,XzPackage,ZstdRootPackage,ZstdPackage.FileType.AAR,FileType.GZIP,FileType.BZ2,FileType.XZ,FileType.ZSTD, cùng năm thành viên tương tự củaFileFormatvàMetadataType, vàFileType.AVIF.groupdocs.metadata.common:FileTypeFeatureSupport,FeatureSupport, và các enumProductFeature,SupportLevelvàFormatFamily.get()trên các gói và bộ sưu tập được đánh chỉ mục —MetadataPackage,ExifDictionaryBasePackage,IptcRecordSet,IptcRecord,XmpLangAltvà các đối tượng khác — như một cách thay thế chopackage[key]. Thuộc tínhitemmà các lớp này trước đây cung cấp không còn khả dụng và đã bị loại bỏ.IptcRecordSet.append(), và một hàm khởi tạo không đối sốRectangle().
Được chuyển vào mô-đun cha
| Mô-đun cũ (26.7) | Mô-đun mới (26.9) | Các lớp |
|---|---|---|
groupdocs.metadata.formats.audio.ogg |
groupdocs.metadata.formats.audio |
OggPackage, OggRootPackage, OggUserComment |
groupdocs.metadata.formats.ebook.fb2 |
groupdocs.metadata.formats.ebook |
Fb2Author, Fb2DocumentInfo, Fb2Genre, Fb2PublishInfo, Fb2Sequence, Fb2TitleInfo |
groupdocs.metadata.formats.ebook.mobi |
groupdocs.metadata.formats.ebook |
MobiHeader, MobiPackage, MobiRootPackage, PDBHeader |
groupdocs.metadata.formats.fb2 |
groupdocs.metadata.formats.ebook |
Fb2Package |
groupdocs.metadata.formats.email.msg |
groupdocs.metadata.formats.email |
MsgKnownProperties |
groupdocs.metadata.formats.image.dng |
groupdocs.metadata.formats.image |
DngPackage, DngRootPackage |
groupdocs.metadata.formats.image.svg |
groupdocs.metadata.formats.image |
SvgPackage, SvgRootPackage |
groupdocs.metadata.formats.image |
groupdocs.metadata.formats.raw |
RawDoubleTag, RawFloatTag, RawRationalTag, RawSByteTag, RawSLongTag, RawSRationalTag, RawSShortTag, RawUndefinedTag |
groupdocs.metadata.formats.raw.tag |
groupdocs.metadata.formats.raw |
RawTag, RawArrayTag, RawAsciiTag, RawByteTag, RawLongTag, RawShortTag |
groupdocs.metadata.formats.raw.cr2 |
groupdocs.metadata.formats.raw |
56 trong số 58 lớp (Cr2MakerNotePackage, Cr2CameraSettingsPackage, các enum Cr2…Index, …) |
groupdocs.metadata.formats.three_d.dae / .fbx / .gltf / .stl / .three_ds |
groupdocs.metadata.formats.three_d |
DaeNode, DaePackage, DaeRootPackage, các lớp Fbx…, Gltf…, Stl… và ThreeDS… |
13 mô-đun cũ đã bị loại bỏ. Các đối tượng trả về bởi API không bị ảnh hưởng: root.ogg_package và các đối tượng tương tự vẫn trả về cùng các lớp, chỉ khác là được nhập từ các mô-đun mới.
Tính năng mới
Dòng lệnh: groupdocs-metadata
Cài đặt gói sẽ đặt lệnh groupdocs-metadata vào PATH (cũng có thể dùng python -m groupdocs.metadata) để sử dụng trong shell, Makefile và các bước CI:
groupdocs-metadata info photo.jpg # định dạng, MIME, kích thước, trang, mã hoá
groupdocs-metadata show report.docx --tag person # tác giả, biên tập viên, … kèm thẻ
groupdocs-metadata clean report.docx # ghi ra report.clean.docx
groupdocs-metadata remove photo.jpg --tag person.creator -o photo-anon.jpg
groupdocs-metadata export report.pdf -o metadata.json # json, csv, xlsx, xls hoặc xml
groupdocs-metadata list-formats
--tag nhận một danh mục (person, time, content, …) hoặc một thẻ trong danh mục đó (person.creator), theo cùng định dạng mà lệnh show xuất ra. Các tệp được đọc qua luồng, vì vậy các đầu vào chỉ‑đọc vẫn hoạt động, và clean / remove sẽ không ghi đè lên tệp đầu vào trừ khi bạn chỉ định -o. Mọi lệnh đều hỗ trợ --password, và --license sẽ áp dụng giấy phép trước khi thực thi.
Apple Archive, GZIP, BZ2, XZ và Zstandard
Engine 26.8 đọc siêu dữ liệu của năm định dạng lưu trữ bổ sung. Mỗi định dạng có một gói gốc riêng trong groupdocs.metadata.formats.archive:
from groupdocs.metadata import Metadata
with Metadata("archive.gz") as metadata:
print(metadata.get_document_info().file_type.file_format.name) # GZIP
print(metadata.get_root_package().gzip_package.total_entries)
with Metadata("archive.aar") as metadata:
aar = metadata.get_root_package().aar_package
print(aar.total_entries)
for entry in aar.files:
print(entry.name, entry.length, entry.is_directory)
bz2_package, xz_package và zstd_package hoạt động tương tự (xem Known Issues để biết các trường chưa được điền). Trong phiên bản 26.7, các tệp GZIP, BZ2 và AAR gây ra NotImplementedError, còn XZ và Zstandard bị đọc nhầm thành tệp âm thanh MP3.
Các bản trình chiếu PowerPoint mở lại
Mở tệp PowerPoint — .pptx, .ppt, .pot và các định dạng trình chiếu khác — đã thất bại trong 26.7 trên Windows, Linux và macOS với lỗi DllNotFoundException: Unable to load … aspose.slides.drawing.capi…, do thư viện gốc cần cho trình chiếu bị thiếu trong wheel. Thư viện này đã được bao gồm trong mọi wheel của 26.9, và trên Windows gói hiện tự tải nó, vì vậy các bản trình chiếu cũng mở được khi dùng Python từ Microsoft Store, vốn không tìm kiếm PATH để tải thư viện gốc.
Ví dụ mã
from groupdocs.metadata import Metadata
# Đọc siêu dữ liệu GZIP
with Metadata("archive.gz") as metadata:
print("Format:", metadata.get_document_info().file_type.file_format.name)
print("Total entries:", metadata.get_root_package().gzip_package.total_entries)
# Đọc siêu dữ liệu Apple Archive
with Metadata("archive.aar") as metadata:
aar = metadata.get_root_package().aar_package
print("Total files:", aar.total_entries)
for entry in aar.files:
print(f"- {entry.name} ({entry.length} bytes)")
Cách nhận bản cập nhật
PyPI
Cài đặt hoặc nâng cấp qua PyPI:
pip install groupdocs-metadata-net==26.9.0
Trang gói: groupdocs-metadata-net 26.9.0 on PyPI
Tải trực tiếp
Tải các tệp wheel cho mọi nền tảng từ trang phát hành GroupDocs.Metadata for Python 26.9.