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-libgdiplus trên Linux và macOS (METADATAPYTHON-66)
  • [Enhancement] Thêm FileTypeFeatureSupport và các enum ProductFeature, SupportLevel và FormatFamily và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() cho IptcRecordSet, 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: DllNotFoundException cho aspose.slides.drawing.capi (METADATAPYTHON-50)
  • [Fix] Đọc thẻ EXIF bằng TiffTagID thấ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ủa FileFormat và MetadataType, và FileType.AVIF.
  • groupdocs.metadata.common: FileTypeFeatureSupport, FeatureSupport, và các enum ProductFeature, SupportLevel và FormatFamily.
  • get() trên các gói và bộ sưu tập được đánh chỉ mục — MetadataPackage, ExifDictionaryBasePackage, IptcRecordSet, IptcRecord, XmpLangAlt và các đối tượng khác — như một cách thay thế cho package[key]. Thuộc tính item mà 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.

Tài nguyên