Estamos felizes em anunciar o lançamento do GroupDocs.Metadata for Python v26.9, disponível a partir de setembro de 2026. Esta versão atualiza o mecanismo subjacente de 26.6 para 26.8, introduz uma interface de linha de comando, adiciona suporte a cinco novos formatos de arquivo compactado (Apple Archive, GZIP, BZ2, XZ e Zstandard), restaura o suporte a apresentações PowerPoint em todas as plataformas e corrige problemas críticos de compatibilidade que afetavam Python 3.5–3.7 e sistemas Linux/macOS mais antigos. Observe que esta versão inclui uma mudança incompatível: 105 classes de formato foram movidas de sub‑namespaces para seus módulos pai.
O que há de novo nesta versão
- [Feature] Envia interface de linha de comando dentro do pacote (METADATAPYTHON-39)
- [Feature] Adiciona suporte à leitura de Apple Archive (AAR), GZIP, BZ2, XZ e arquivos Zstandard (METADATAPYTHON-62)
- [Enhancement] Atualiza o mecanismo GroupDocs.Metadata de 26.6 para 26.8 (METADATAPYTHON-63)
- [Enhancement] Atualiza o runtime .NET incorporado de 10.0.0 para 10.0.12 (METADATAPYTHON-64)
- [Enhancement] Move as classes de formato Ogg, FB2, Mobi, MSG, DNG, SVG, tag raw, CR2 e 3D para seus módulos pai, como no mecanismo 26.8 (METADATAPYTHON-65)
- [Enhancement] Remove a exigência de
libgdiplus/mono-libgdiplusno Linux e macOS (METADATAPYTHON-66) - [Enhancement] Adiciona
FileTypeFeatureSupporte os enumsProductFeature,SupportLeveleFormatFamilyà API Python (METADATAPYTHON-67) - [Enhancement] Adiciona
get()a pacotes e coleções indexados,append()aIptcRecordSete um construtorRectangle()sem argumentos (METADATAPYTHON-68) - [Enhancement] Publica a referência da API para cada módulo, incluindo
formats.*estandards.*(METADATAPYTHON-69) - [Fix] Não é possível abrir apresentações PowerPoint:
DllNotFoundExceptionparaaspose.slides.drawing.capi(METADATAPYTHON-50) - [Fix] A leitura de uma tag EXIF por
TiffTagIDfalha no Python 3.5 – 3.10 (METADATAPYTHON-51) - [Fix] Não é possível usar o pacote no Python 3.5 – 3.7 (METADATAPYTHON-70)
- [Fix]
pipinstala o pacote em versões do Linux e macOS que não podem executá‑lo (METADATAPYTHON-71)
Alterações na API pública
Novas classes e membros
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, os mesmos cinco membros deFileFormateMetadataType, eFileType.AVIF.groupdocs.metadata.common:FileTypeFeatureSupport,FeatureSupporte os enumsProductFeature,SupportLeveleFormatFamily.get()em pacotes e coleções indexados —MetadataPackage,ExifDictionaryBasePackage,IptcRecordSet,IptcRecord,XmpLangAlte outros — como alternativa apackage[key]. A propriedadeitemexposta por essas classes não podia ser chamada e foi removida.IptcRecordSet.append(), e um construtorRectangle()sem argumentos.
Movido para o módulo pai
| Módulo antigo (26.7) | Novo módulo (26.9) | Classes |
|---|---|---|
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 de suas 58 classes (Cr2MakerNotePackage, Cr2CameraSettingsPackage, os enums Cr2…Index, …) |
groupdocs.metadata.formats.three_d.dae / .fbx / .gltf / .stl / .three_ds |
groupdocs.metadata.formats.three_d |
DaeNode, DaePackage, DaeRootPackage, as classes Fbx…, Gltf…, Stl… e ThreeDS… |
Os 13 módulos antigos foram removidos. Os objetos retornados pela API permanecem inalterados: root.ogg_package e semelhantes retornam as mesmas classes, agora importadas dos novos módulos.
Novos recursos
Linha de comando: groupdocs-metadata
Instalar o pacote coloca o comando groupdocs-metadata no PATH (também python -m groupdocs.metadata), para shells, regras Make e etapas de CI:
groupdocs-metadata info photo.jpg # formato, tipo MIME, tamanho, páginas, criptografia
groupdocs-metadata show report.docx --tag person # autor, editor, ... com suas tags
groupdocs-metadata clean report.docx # grava 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 ou xml
groupdocs-metadata list-formats
--tag aceita uma categoria (person, time, content, …) ou uma tag dentro dela (person.creator), no mesmo formato que show imprime. Os arquivos são lidos por meio de um stream, portanto entradas somente‑leitura funcionam, e clean / remove nunca sobrescrevem a entrada a menos que -o a nomeie. Cada comando aceita --password, e --license aplica uma licença primeiro.
Arquivos Apple Archive, GZIP, BZ2, XZ e Zstandard
O mecanismo 26.8 lê os metadados de mais cinco formatos de arquivo compactado. Cada um tem seu próprio pacote raiz em 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 e zstd_package funcionam da mesma forma (veja Problemas conhecidos para os campos que ainda não são preenchidos). Na versão 26.7, arquivos GZIP, BZ2 e AAR geravam NotImplementedError, e arquivos XZ e Zstandard eram interpretados erroneamente como áudio MP3.
Apresentações PowerPoint abrem novamente
Abrir um arquivo PowerPoint — .pptx, .ppt, .pot e os demais formatos de apresentação — falhava na 26.7 em Windows, Linux e macOS com DllNotFoundException: Unable to load … aspose.slides.drawing.capi…, porque a biblioteca nativa necessária ao mecanismo para apresentações estava ausente do wheel. Ela agora está incluída em todos os wheels da 26.9 e, no Windows, o pacote a carrega automaticamente, de modo que as apresentações também abrem sob o Python da Microsoft Store, que não procura a PATH por bibliotecas nativas.
Exemplo de código
from groupdocs.metadata import Metadata
# Ler metadados GZIP
with Metadata("archive.gz") as metadata:
print("Formato:", metadata.get_document_info().file_type.file_format.name)
print("Total de entradas:", metadata.get_root_package().gzip_package.total_entries)
# Ler metadados Apple Archive
with Metadata("archive.aar") as metadata:
aar = metadata.get_root_package().aar_package
print("Total de arquivos:", aar.total_entries)
for entry in aar.files:
print(f"- {entry.name} ({entry.length} bytes)")
Como obter a atualização
PyPI
Instale ou atualize via PyPI:
pip install groupdocs-metadata-net==26.9.0
Página do pacote: groupdocs-metadata-net 26.9.0 on PyPI
Download direto
Baixe arquivos wheel para todas as plataformas a partir da página de lançamento do GroupDocs.Metadata for Python 26.9.