우리는 GroupDocs.Metadata for Python v26.9 릴리스를 발표하게 되어 기쁩니다. 이 릴리스는 2026년 9월부터 이용할 수 있습니다. 이번 릴리스에서는 기본 엔진을 26.6에서 26.8로 업그레이드하고, 명령줄 인터페이스를 도입했으며, 다섯 가지 새로운 압축 형식(Apple Archive, GZIP, BZ2, XZ, Zstandard)을 지원하고, 모든 플랫폼에서 PowerPoint 프레젠테이션 지원을 복구했으며, Python 3.5–3.7 및 오래된 Linux/macOS 시스템에 영향을 주는 중요한 호환성 문제를 해결했습니다. 이 릴리스에는 파괴적인 변경 사항이 포함되어 있습니다: 105개의 포맷 클래스가 하위 네임스페이스에서 상위 모듈로 이동되었습니다.
이번 릴리스의 새로운 기능
- [Feature] 패키지에 명령줄 인터페이스 포함 (METADATAPYTHON-39)
- [Feature] Apple Archive (AAR), GZIP, BZ2, XZ 및 Zstandard 압축 파일 지원 추가 (METADATAPYTHON-62)
- [Enhancement] GroupDocs.Metadata 엔진을 26.6에서 26.8로 업데이트 (METADATAPYTHON-63)
- [Enhancement] 내장 .NET 런타임을 10.0.0에서 10.0.12로 업데이트 (METADATAPYTHON-64)
- [Enhancement] Ogg, FB2, Mobi, MSG, DNG, SVG, raw tag, CR2 및 3D 포맷 클래스를 26.8 엔진과 동일하게 상위 모듈로 이동 (METADATAPYTHON-65)
- [Enhancement] Linux 및 macOS에서
libgdiplus/mono-libgdiplus요구 사항 제거 (METADATAPYTHON-66) - [Enhancement] Python API에
FileTypeFeatureSupport와ProductFeature,SupportLevel,FormatFamily열거형 추가 (METADATAPYTHON-67) - [Enhancement] 인덱싱된 패키지와 컬렉션에
get()추가,IptcRecordSet에append()추가, 인수 없는Rectangle()생성자 추가 (METADATAPYTHON-68) - [Enhancement] 모든 모듈에 대한 API 레퍼런스 공개,
formats.*및standards.*포함 (METADATAPYTHON-69) - [Fix] PowerPoint 프레젠테이션을 열 수 없음:
aspose.slides.drawing.capi에 대한DllNotFoundException(METADATAPYTHON-50) - [Fix]
TiffTagID로 EXIF 태그를 읽는 것이 Python 3.5 – 3.10에서 실패 (METADATAPYTHON-51) - [Fix] Python 3.5 – 3.7에서 패키지를 사용할 수 없음 (METADATAPYTHON-70)
- [Fix] Linux 및 macOS 버전에서 pip가 패키지를 설치하지만 실행할 수 없음 (METADATAPYTHON-71)
공개 API 변경 사항
새로운 클래스 및 멤버
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,FileFormat및MetadataType의 동일한 다섯 멤버, 그리고FileType.AVIF.groupdocs.metadata.common:FileTypeFeatureSupport,FeatureSupport, 그리고ProductFeature,SupportLevel,FormatFamily열거형.- 인덱싱된 패키지와 컬렉션(
MetadataPackage,ExifDictionaryBasePackage,IptcRecordSet,IptcRecord,XmpLangAlt등)에서get()사용 가능 –package[key]의 대안. 이전에 노출되던item속성은 호출할 수 없으며 제거되었습니다. IptcRecordSet.append(), 인수 없는Rectangle()생성자 추가.
상위 모듈로 이동
| 이전 모듈 (26.7) | 새 모듈 (26.9) | 클래스 |
|---|---|---|
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 |
58개 중 56개의 클래스 (Cr2MakerNotePackage, Cr2CameraSettingsPackage, Cr2…Index 열거형 등) |
groupdocs.metadata.formats.three_d.dae / .fbx / .gltf / .stl / .three_ds |
groupdocs.metadata.formats.three_d |
DaeNode, DaePackage, DaeRootPackage, Fbx…, Gltf…, Stl…, ThreeDS… 클래스 |
13개의 이전 모듈이 제거되었습니다. API가 반환하는 객체는 영향을 받지 않으며, root.ogg_package 등은 동일한 클래스를 반환하지만 이제는 새로운 모듈에서 가져옵니다.
새로운 기능
명령줄: groupdocs-metadata
패키지를 설치하면 PATH에 groupdocs-metadata 명령이 추가됩니다(python -m groupdocs.metadata도 가능). 셸, Make 규칙 및 CI 단계에서 사용할 수 있습니다:
groupdocs-metadata info photo.jpg # 포맷, MIME 타입, 크기, 페이지, 암호화 여부
groupdocs-metadata show report.docx --tag person # 저자, 편집자 등과 해당 태그
groupdocs-metadata clean report.docx # 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 또는 xml
groupdocs-metadata list-formats
--tag는 카테고리(person, time, content, …) 또는 해당 카테고리 내의 단일 태그(person.creator)를 지정합니다. 출력 형식은 show 명령과 동일합니다. 파일은 스트림을 통해 읽히므로 읽기 전용 입력도 작동하며, clean/remove는 -o 옵션으로 지정하지 않는 한 입력 파일을 덮어쓰지 않습니다. 모든 명령은 --password를 지원하고, --license는 먼저 라이선스를 적용합니다.
Apple Archive, GZIP, BZ2, XZ 및 Zstandard 압축 파일
26.8 엔진은 다섯 가지 추가 압축 형식의 메타데이터를 읽을 수 있습니다. 각각은 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, zstd_package도 동일하게 동작합니다(Known Issues에서 아직 채워지지 않은 필드를 확인하세요). 26.7에서는 GZIP, BZ2, AAR 파일이 NotImplementedError를 발생시켰고, XZ와 Zstandard 파일은 MP3 오디오로 잘못 읽혔습니다.
PowerPoint 프레젠테이션 다시 열림
PowerPoint 파일(.pptx, .ppt, .pot 등)을 열 때 26.7에서는 Windows, Linux, macOS 모두에서 DllNotFoundException: Unable to load … aspose.slides.drawing.capi… 오류가 발생했습니다. 이는 프레젠테이션에 필요한 네이티브 라이브러리가 휠에 포함되지 않았기 때문입니다. 26.9 휠에는 해당 라이브러리가 포함되어 있으며, Windows에서는 패키지가 자체적으로 로드하므로 Microsoft Store Python에서도 프레젠테이션을 열 수 있습니다(이 환경은 PATH에서 네이티브 라이브러리를 검색하지 않음).
코드 예시
from groupdocs.metadata import Metadata
# 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)
# 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)")
업데이트 받는 방법
PyPI
PyPI를 통해 설치하거나 업그레이드합니다:
pip install groupdocs-metadata-net==26.9.0
패키지 페이지: groupdocs-metadata-net 26.9.0 on PyPI
직접 다운로드
GroupDocs.Metadata for Python 26.9 릴리스 페이지에서 모든 플랫폼용 휠 파일을 다운로드합니다.