Documento
Visão geral
Document é o ponto de entrada principal do Aspose.Words for Python. Ele fornece a API pública para carregar documentos Word (DOC, DOCX, RTF, TXT, Markdown), salvar em vários formatos de saída (PDF, DOCX, Markdown, TXT) e extrair texto simples.
Definido em: aspose/words_foss/document.py
Construtor
| Signature | Description |
|---|---|
Document(filepath=None, *, stream=None, data=None) | Carregue um documento a partir de um caminho de arquivo, fluxo binário ou bytes brutos. Pelo menos uma fonte deve ser fornecida. |
Parâmetros:
| Name | Type | Description |
|---|---|---|
filepath | Optional[Union[str, Path]] | Caminho para o arquivo de documento a ser carregado. |
stream | Optional[BinaryIO] | Fluxo binário contendo os dados do documento. |
data | Optional[bytes] | Bytes brutos do conteúdo do documento. |
Métodos
| Assinatura | Descrição |
|---|---|
save(output_path, save_format_or_options=None) → None | Salve o documento no formato especificado. O formato pode ser uma constante de string SaveFormat ou um objeto de opções de salvamento (PdfSaveOptions, MarkdownSaveOptions). |
get_text() → str | Extraia o texto simples do documento carregado. |
Propriedades
| Nome | Tipo | Acesso | Descrição |
|---|---|---|---|
light_document_model | ldm.Document | Leitura | Acesse o modelo de documento leve subjacente para inspeção avançada da estrutura do documento (parágrafos, tabelas, estilos, seções). |
Uso
import aspose.words_foss as aw
# Load a DOCX file
doc = aw.Document("input.docx")
# Extract plain text
text = doc.get_text()
# Save as PDF
doc.save("output.pdf", aw.SaveFormat.PDF)
# Save as Markdown
doc.save("output.md", aw.SaveFormat.MARKDOWN)Modelo de Documento Leve
A propriedade light_document_model fornece acesso à estrutura interna do documento (ldm.Document, definida em light_document_model.py). Este pydantic BaseModel expõe parágrafos analisados, tabelas, estilos, seções, cabeçalhos, rodapés e consultas estruturais como find_style() e headings(). A maioria dos usuários não precisa acessar o LDM diretamente — os métodos públicos Document acima cobrem fluxos de trabalho padrão.
