Python에서 생성된 호환성 모듈을 사용하여 문서 만들기

Aspose.PDF FOSS for Python는 generated 호환성 서브패키지(aspose_pdf.generated)를 제공하는데, 이는 주요 API 표면의 안정적인 하위 집합을 반영합니다 — 핵심 라이프사이클 작업을 포함한 Document 클래스와 UnsignedContent/UnsignedContentAbsorber, PdfAValidateOptions/PdfAValidationResult이 포함됩니다. 이 서브패키지는 전체 기능을 갖춘 최상위 클래스를 사용하지 않고 보다 좁은 표면을 명시적으로 원하는 호출자들을 위해 존재하며, 그 클래스들은 import aspose_pdf에 의해 자동으로 임포트되지 않습니다 — 직접 aspose_pdf.generated.*에서 임포트합니다. 이 패키지는 순수 Python이며 아래 명령으로 설치됩니다.

단계별 가이드

git clone https://github.com/aspose-pdf-foss/Aspose-PDF-FOSS-for-Python.git
cd Aspose-PDF-FOSS-for-Python
pip install -e .

import aspose_pdf
from aspose_pdf.generated.document import Document
print("aspose-pdf-foss-for-python is ready.")

import aspose_pdf
from aspose_pdf.generated.document import Document
from aspose_pdf.generated.forms import UnsignedContent, UnsignedContentAbsorber
from aspose_pdf.generated.pdfa import PdfAValidateOptions, PdfAValidationResult

from aspose_pdf.generated.document import Document

document = Document("report.pdf")
print(f"Loaded {len(document.pages)} page(s)")

empty_doc = Document()
empty_doc.load_from("report.pdf")

from aspose_pdf.generated.forms import UnsignedContentAbsorber

absorber = UnsignedContentAbsorber()
unsigned = absorber.extract()
print(f"Unsigned pages: {len(unsigned.pages)}")
print(f"Unsigned form fields: {len(unsigned.form_fields)}")

if absorber.has_extracted():
    same_result = absorber.get_extracted()

from aspose_pdf.generated.forms import UnsignedContent

content = UnsignedContent()
content.add_page("page-1")
content.add_annotation("signature-placeholder")
print(content)  # UnsignedContent(pages=1, form_fields=0, annotations=1)

content.remove_annotation("signature-placeholder")
content.reset()

from aspose_pdf.generated.pdfa import PdfAValidateOptions, PdfAValidationResult

options = PdfAValidateOptions()
options.add_input("report.pdf")
options.set_option("pdfa_version", "1b")
print(options.get_options())

result = PdfAValidationResult()
result.add_error("Font 'Arial' is not embedded")
print(result.is_valid)   # False
print(result.to_dict())

일반적인 문제 및 해결 방법

ImportError or AttributeError 접근할 때 aspose_pdf.generated

generated 하위 패키지는 import aspose_pdf에 의해 재내보내지 않습니다 — 예를 들어 from aspose_pdf.generated.document import Document와 같이 각 클래스를 해당 하위 모듈에서 직접 가져오세요, 단순히 import aspose_pdf만 사용한 후 aspose_pdf.generated.Document이 동작할 것으로 기대하지 마세요.

생성된 것을 혼동하는 Document 주된 것과 aspose_pdf.Document

aspose_pdf.Document(import aspose_pdf에 의해 재내보낸 최상위 클래스)는 더 넓은 인터페이스를 가지고 있습니다 — aspose_pdf.generated.document.Document가 구현하지 않은 validate_pdfa, iter_pages, redact_text와 같은 메서드를 추가합니다. 생성된 Document에 메서드가 없으면, 해당 메서드가 최상위 Document 클래스에 속하는지 확인하세요.

save() raises AsposePdfException: Cannot save a disposed document

close()/dispose()은(는) 문서의 내부 상태를 영구적으로 해제합니다 — 폐기된 Document는 이후에 저장, 최적화 또는 복구할 수 없습니다. close()을(를) 호출하기 전에 남은 모든 작업을 수행하거나, 새 Document(...) 호출로 소스에서 다시 로드하십시오.

change_passwords raises PdfSecurityException: Document is not encrypted

change_passwords은(는) 이미 암호화된 문서의 비밀번호만 교체합니다. 먼저 encrypt(password)을(를) 호출하거나, 비밀번호 변경을 시도하기 전에 document.is_encrypted를 확인하십시오.

PdfAValidationResult.add_error raises TypeError

add_error은(는) str 인수가 필요합니다. 예외 객체나 기타 오류 세부 정보를 문자열(str(error))로 변환한 후 add_error에 전달하십시오.

자주 묻는 질문

왜 aspose_pdf.generated가 메인 aspose_pdf.Document와 함께 존재합니까?

이는 해당 축소된 인터페이스에 대해 작성된 코드용 Aspose.PDF API의 더 좁고 안정적인 하위 집합을 그대로 반영합니다. 이 호환성 하위 집합을 특별히 필요로 하지 않는 새로운 코드는 일반적으로 더 많은 작업을 지원하는 최상위 aspose_pdf.Document를 사용해야 합니다 (PDF/A 변환, 페이지 반복, 텍스트 삭제 등).

UnsignedContentAbsorber.extract()가 스캔하기 위한 Document를 받습니까?

extract()는 반환된 UnsignedContent의 pages, form_fields, annotations 컬렉션을 채우는 데 사용되는 위치 인수와 키워드 인수를 받습니다 — 원하는 컬렉션을 키워드 인수(pages=, form_fields=, annotations=)로 전달하십시오.

아무것도 추출하기 전에 UnsignedContentAbsorber에 대해 reset()를 호출하면 어떻게 되나요?

이전의 추출된 결과를 모두 지웁니다. 이후 get_extracted()는 None을 반환하고, has_extracted()는 extract()가 다시 호출될 때까지 False을 반환합니다.

PdfAValidateOptions.add_input를 한 번 이상 호출할 수 있나요?

예 — 각 호출은 inputs 리스트에 또 다른 항목을 추가하고, self을 반환하므로 호출을 체인 형태로 연결할 수 있습니다: options.add_input("a.pdf").add_input("b.pdf").

생성된 Document에서 close()와 dispose()은 다릅니까?

아니요 — close()은(는) 동일한 인수로 dispose()을(를) 호출하는 직접 별칭입니다; 두 이름 모두 문서의 리소스를 해제합니다.

참조

• Python에서 문서를 로드하는 방법
• Python에서 PDF 데이터를 다루는 방법
• 문서 관리 (개발자 가이드)
• 설치 가이드
• API Reference
• GitHub 저장소
• Aspose.PDF for Python — Enterprise Knowledge Base