lattes2pdf 0.1.0__tar.gz

lattes2pdf-0.1.0/.gitignore

@@ -0,0 +1,176 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+/.local/

lattes2pdf-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,74 @@
+# Como contribuir
+
+Use Python 3.12 ou superior. Na raiz do repositório, crie um ambiente virtual
+e instale as ferramentas de desenvolvimento:
+
+```bash
+python3.12 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e . --group dev
+```
+
+No Windows, crie o ambiente com `py -3 -m venv .venv` e ative-o pelo PowerShell
+com `.venv\Scripts\Activate.ps1`.
+
+## Alterações e verificações
+
+Mantenha cada mudança focada em um problema. Descreva o comportamento alterado
+e como ele foi verificado. Ao corrigir uma falha, acrescente um teste de regressão
+quando ele proteger um comportamento relevante. Use exemplos fictícios ou
+anonimizados para reproduzir problemas de conversão.
+
+Use Ruff para formatar e verificar o código:
+
+```bash
+ruff format .
+ruff check .
+ruff format --check .
+pytest
+python -m build
+python -m twine check --strict dist/*
+git diff --check
+```
+
+As configurações ficam no `pyproject.toml`. Consulte `lattes2pdf --help` e
+o `--help` dos subcomandos para explorar a CLI.
+
+## Commits e releases
+
+Use [Conventional Commits](https://www.conventionalcommits.org/pt-br/v1.0.0/),
+com mudanças agrupadas de forma lógica. Exemplos:
+
+```text
+feat: adicionar seleção de publicações
+fix: preservar datas sem mês informado
+docs: esclarecer a exportação do Lattes
+```
+
+Tags e títulos de releases devem conter somente a versão no formato `vX.Y.Z`,
+por exemplo, `v0.1.0`. Descreva as mudanças no corpo da release. A versão do
+pacote correspondente é `0.1.0`, sem o prefixo `v`.
+
+O CI testa Python 3.12, 3.13 e 3.14 em Linux e macOS. Além da suíte, instala o
+wheel em um ambiente limpo e gera PDFs fora do checkout, incluindo um tema externo
+e a recompilação de um YAML editado. O script `.github/scripts/check_distribution.py`
+também pode ser executado localmente, recebendo o wheel e um XML fictício.
+
+### Publicação
+
+Configure Trusted Publishing nas contas do PyPI e do TestPyPI: projeto
+`lattes2pdf`, proprietário `mpds`, repositório `lattes2pdf`, workflow `release.yml`.
+Use o ambiente GitHub `pypi` para PyPI e `testpypi` para TestPyPI. Não são necessários
+tokens de API no repositório.
+
+1. Atualize a versão em `pyproject.toml` e confira as alterações da release.
+2. Execute manualmente o workflow **Publicação** para ensaiar no TestPyPI.
+3. Confira a página e a instalação da versão no TestPyPI.
+4. Crie a release com tag e título `vX.Y.Z`, descrevendo mudanças e limitações no corpo.
+
+Publicar a release no GitHub dispara uma nova validação e a publicação no PyPI.
+O workflow confere a versão da tag e publica somente os artefatos que passaram
+nos testes; depois anexa wheel e sdist à release. Cada versão publicada é imutável:
+para mudar seu conteúdo, incremente a versão. Um rascunho de release não publica
+o pacote.

lattes2pdf-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Matheus Müller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lattes2pdf-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: lattes2pdf
+Version: 0.1.0
+Summary: Seleção e conversão de currículos Lattes para RenderCV
+Project-URL: Repository, https://github.com/mpds/lattes2pdf
+Project-URL: Issues, https://github.com/mpds/lattes2pdf/issues
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: defusedxml<1,>=0.7.1
+Requires-Dist: pyyaml<7,>=6.0.2
+Requires-Dist: rendercv[full]<2.9,>=2.8
+Description-Content-Type: text/markdown
+
+# lattes2pdf
+
+Transforme seu Currículo Lattes em um CV em PDF, escolhendo o que apresentar e como organizar as informações. Use perfis editáveis para criar versões acadêmicas ou resumidas e temas do [RenderCV](https://rendercv.com) para definir a aparência. O YAML gerado é compatível com o RenderCV e pode ser editado e renderizado diretamente, inclusive com temas personalizados como o [Garamond](https://github.com/mpds/lattes2pdf/tree/main/src/lattes2pdf/themes/garamond), incluído no projeto.
+
+Veja exemplos fictícios: [ModernCV](https://github.com/mpds/lattes2pdf/blob/main/examples/pdfs/moderncv.pdf), nativo do RenderCV, e [Garamond](https://github.com/mpds/lattes2pdf/blob/main/examples/pdfs/garamond.pdf), um tema alternativo criado com o RenderCV e incluído no lattes2pdf.
+
+## Instalação
+
+Requer Python 3.12 ou superior. No Linux ou macOS, instale em um ambiente virtual:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install lattes2pdf
+```
+
+O RenderCV é instalado como dependência; a geração usa Typst e não exige uma instalação de LaTeX.
+
+## Do Lattes ao PDF
+
+Na [Plataforma Lattes](https://lattes.cnpq.br/), acesse a edição do seu currículo e procure **Exportar**, escolhendo o formato **XML**. Salve o arquivo baixado: o lattes2pdf aceita tanto o XML quanto o ZIP que o contém, sem precisar descompactá-lo.
+
+![Fluxo: XML ou ZIP do Lattes, perfil opcional e tema entram no lattes2pdf; saem PDF, YAML editável do RenderCV e relatório JSON. O YAML pode ser editado e recompilado pelo RenderCV.](https://raw.githubusercontent.com/mpds/lattes2pdf/main/examples/workflow.png)
+
+O **perfil** seleciona e organiza o conteúdo. O **tema** define a aparência. Ambos são opcionais.
+
+## Gerar um currículo
+
+```bash
+lattes2pdf render curriculo.xml -o cv.pdf
+```
+
+O comando usa o preset `academico`, com o tema `classic` por padrão. Para incluir todos os detalhes conhecidos do currículo sem aplicar o preset, use `--full`.
+
+Isso gera três arquivos:
+
+| Arquivo | Para que serve |
+| --- | --- |
+| `cv.pdf` | Currículo pronto para visualizar e compartilhar. |
+| `cv.yaml` | Conteúdo e configuração visual no formato do RenderCV. |
+| `cv.report.json` | Relatório das informações incluídas, omitidas e dos avisos de conversão. |
+
+O tema padrão é `classic`. Para experimentar outro, use `--theme garamond` ou um nome listado em `lattes2pdf theme --help`. Use pastas separadas para comparar temas; com temas personalizados, templates e fontes também são copiados junto ao YAML.
+
+Para testar sem o seu Lattes, baixe o [XML fictício](https://raw.githubusercontent.com/mpds/lattes2pdf/main/examples/curriculo.xml) e use-o no lugar de `curriculo.xml`.
+
+## Comece com um perfil
+
+O preset `academico` já é usado por padrão em `render` e `export`. Para escolher outro ou editar suas preferências, copie um preset e use o arquivo na geração:
+
+```bash
+lattes2pdf profile essencial -o profile.yaml  # gera o arquivo de configuração
+lattes2pdf render curriculo.xml --profile profile.yaml -o essencial.pdf  # usa o perfil personalizado
+```
+
+| Preset | Ponto de partida |
+| --- | --- |
+| `academico` | Cobertura ampla, incluindo bio e informações do trabalho de formação. |
+| `essencial` | Bio, formação, experiência e principais seções de produção. |
+| `resumido` | Menos seções, sem bio e sem listas de autores. |
+
+Os presets são arquivos YAML editáveis, podendo ser modificados conforme a necessidade.
+
+## Editar o resultado no RenderCV
+
+Abra o `cv.yaml` gerado, ajuste o texto ou a aparência e compile novamente:
+
+```bash
+rendercv render cv.yaml --pdf-path cv-editado.pdf
+```
+
+O caminho do PDF é relativo à pasta do YAML. Se houver pastas de templates e fontes ao lado dele, mantenha-as junto do arquivo.
+
+Essa edição afeta o documento gerado. Para reaplicar escolhas a uma nova exportação do Lattes, salve-as no `profile.yaml`.
+
+## Escolher o que aparece
+
+Veja as seções e os registros do seu currículo:
+
+```bash
+lattes2pdf inspect curriculo.xml
+lattes2pdf inspect curriculo.xml --section publications.articles
+```
+
+Por exemplo, a publicação do XML fictício aparece assim:
+
+```text
+publications.articles — Artigos publicados (1)
+  publications.articles:5af5a2d20b36  Catálogos abertos & memória digital (2024)
+```
+
+Você pode excluir uma seção inteira ou copiar o ID de um registro específico:
+
+```bash
+lattes2pdf render curriculo.xml --exclude awards -o sem-premios.pdf
+lattes2pdf render curriculo.xml \
+  --exclude-id publications.articles:5af5a2d20b36 -o sem-artigo.pdf
+```
+
+Use os IDs retornados pelo seu próprio `inspect`. Eles podem mudar quando o registro é alterado ou ganha duplicatas. As opções `--exclude` e `--exclude-id` podem ser repetidas para remover mais itens.
+
+## Guardar suas preferências
+
+Edite o preset copiado ou crie um `profile.yaml` com apenas as escolhas de que precisa:
+
+```yaml
+include: [profile, education, experience, publications]
+exclude: [publications.press]
+order: [profile, experience, education, publications]
+theme: garamond
+
+sections:
+  education:
+    title: Formação acadêmica
+    show_advisors: false
+  publications.articles:
+    show_authors: true
+    show_links: true
+```
+
+Para guardar exclusões individuais, acrescente `exclude_ids` com os IDs do `inspect`:
+
+```yaml
+exclude_ids:
+  - publications.articles:5af5a2d20b36
+```
+
+Depois, aplique o arquivo:
+
+```bash
+lattes2pdf render curriculo.xml --profile profile.yaml -o personalizado.pdf
+```
+
+Descubra os nomes das seções e as opções disponíveis sem precisar conhecer os atributos internos do XML:
+
+```bash
+lattes2pdf sections
+lattes2pdf sections education
+lattes2pdf sections publications.articles
+```
+
+Um `--profile` explícito substitui o preset padrão. As opções da linha de comando substituem as correspondentes no perfil. Para filtros por ano, ordenação e outros ajustes, consulte `lattes2pdf render --help`. Use `--force` quando quiser substituir saídas existentes.
+
+## Personalizar um tema
+
+Copie o Garamond para uma pasta editável:
+
+```bash
+lattes2pdf theme garamond -o meu-tema
+lattes2pdf render curriculo.xml --profile profile.yaml \
+  --theme meu-tema/design.yaml -o meu-cv.pdf
+```
+
+Edite `design.yaml` para ajustar fonte, margens e espaçamentos; os templates permitem alterar a composição das entradas. Para usar um tema externo, forneça um YAML com o mapa `design` e mantenha a pasta do tema e suas fontes ao lado dele, conforme a [estrutura de temas do RenderCV](https://docs.rendercv.com/user_guide/how_to/override_default_templates/).
+
+Você também pode salvar `theme: meu-tema/design.yaml` no perfil. Nesse caso, o caminho é relativo ao `profile.yaml`.
+
+## Exportação e limites
+
+Para gerar somente o YAML e o relatório, use `lattes2pdf export curriculo.xml -o cv.yaml`. O modo `--full` inclui todos os registros e detalhes conhecidos permitidos pela ferramenta, podendo produzir um documento extenso; ele não é um preset de apresentação e não aceita filtros de seleção.
+
+Dados privados, como documentos pessoais e endereço residencial, não são exportados. Conteúdo desconhecido e omissões aparecem no relatório; no modo `--full`, campos não mapeados impedem a exportação por padrão.
+
+A integração atual usa RenderCV 2.8. Veja [como contribuir](https://github.com/mpds/lattes2pdf/blob/main/CONTRIBUTING.md) e a [licença MIT](https://github.com/mpds/lattes2pdf/blob/main/LICENSE).

lattes2pdf-0.1.0/README.md

@@ -0,0 +1,164 @@
+# lattes2pdf
+
+Transforme seu Currículo Lattes em um CV em PDF, escolhendo o que apresentar e como organizar as informações. Use perfis editáveis para criar versões acadêmicas ou resumidas e temas do [RenderCV](https://rendercv.com) para definir a aparência. O YAML gerado é compatível com o RenderCV e pode ser editado e renderizado diretamente, inclusive com temas personalizados como o [Garamond](https://github.com/mpds/lattes2pdf/tree/main/src/lattes2pdf/themes/garamond), incluído no projeto.
+
+Veja exemplos fictícios: [ModernCV](https://github.com/mpds/lattes2pdf/blob/main/examples/pdfs/moderncv.pdf), nativo do RenderCV, e [Garamond](https://github.com/mpds/lattes2pdf/blob/main/examples/pdfs/garamond.pdf), um tema alternativo criado com o RenderCV e incluído no lattes2pdf.
+
+## Instalação
+
+Requer Python 3.12 ou superior. No Linux ou macOS, instale em um ambiente virtual:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install lattes2pdf
+```
+
+O RenderCV é instalado como dependência; a geração usa Typst e não exige uma instalação de LaTeX.
+
+## Do Lattes ao PDF
+
+Na [Plataforma Lattes](https://lattes.cnpq.br/), acesse a edição do seu currículo e procure **Exportar**, escolhendo o formato **XML**. Salve o arquivo baixado: o lattes2pdf aceita tanto o XML quanto o ZIP que o contém, sem precisar descompactá-lo.
+
+![Fluxo: XML ou ZIP do Lattes, perfil opcional e tema entram no lattes2pdf; saem PDF, YAML editável do RenderCV e relatório JSON. O YAML pode ser editado e recompilado pelo RenderCV.](https://raw.githubusercontent.com/mpds/lattes2pdf/main/examples/workflow.png)
+
+O **perfil** seleciona e organiza o conteúdo. O **tema** define a aparência. Ambos são opcionais.
+
+## Gerar um currículo
+
+```bash
+lattes2pdf render curriculo.xml -o cv.pdf
+```
+
+O comando usa o preset `academico`, com o tema `classic` por padrão. Para incluir todos os detalhes conhecidos do currículo sem aplicar o preset, use `--full`.
+
+Isso gera três arquivos:
+
+| Arquivo | Para que serve |
+| --- | --- |
+| `cv.pdf` | Currículo pronto para visualizar e compartilhar. |
+| `cv.yaml` | Conteúdo e configuração visual no formato do RenderCV. |
+| `cv.report.json` | Relatório das informações incluídas, omitidas e dos avisos de conversão. |
+
+O tema padrão é `classic`. Para experimentar outro, use `--theme garamond` ou um nome listado em `lattes2pdf theme --help`. Use pastas separadas para comparar temas; com temas personalizados, templates e fontes também são copiados junto ao YAML.
+
+Para testar sem o seu Lattes, baixe o [XML fictício](https://raw.githubusercontent.com/mpds/lattes2pdf/main/examples/curriculo.xml) e use-o no lugar de `curriculo.xml`.
+
+## Comece com um perfil
+
+O preset `academico` já é usado por padrão em `render` e `export`. Para escolher outro ou editar suas preferências, copie um preset e use o arquivo na geração:
+
+```bash
+lattes2pdf profile essencial -o profile.yaml  # gera o arquivo de configuração
+lattes2pdf render curriculo.xml --profile profile.yaml -o essencial.pdf  # usa o perfil personalizado
+```
+
+| Preset | Ponto de partida |
+| --- | --- |
+| `academico` | Cobertura ampla, incluindo bio e informações do trabalho de formação. |
+| `essencial` | Bio, formação, experiência e principais seções de produção. |
+| `resumido` | Menos seções, sem bio e sem listas de autores. |
+
+Os presets são arquivos YAML editáveis, podendo ser modificados conforme a necessidade.
+
+## Editar o resultado no RenderCV
+
+Abra o `cv.yaml` gerado, ajuste o texto ou a aparência e compile novamente:
+
+```bash
+rendercv render cv.yaml --pdf-path cv-editado.pdf
+```
+
+O caminho do PDF é relativo à pasta do YAML. Se houver pastas de templates e fontes ao lado dele, mantenha-as junto do arquivo.
+
+Essa edição afeta o documento gerado. Para reaplicar escolhas a uma nova exportação do Lattes, salve-as no `profile.yaml`.
+
+## Escolher o que aparece
+
+Veja as seções e os registros do seu currículo:
+
+```bash
+lattes2pdf inspect curriculo.xml
+lattes2pdf inspect curriculo.xml --section publications.articles
+```
+
+Por exemplo, a publicação do XML fictício aparece assim:
+
+```text
+publications.articles — Artigos publicados (1)
+  publications.articles:5af5a2d20b36  Catálogos abertos & memória digital (2024)
+```
+
+Você pode excluir uma seção inteira ou copiar o ID de um registro específico:
+
+```bash
+lattes2pdf render curriculo.xml --exclude awards -o sem-premios.pdf
+lattes2pdf render curriculo.xml \
+  --exclude-id publications.articles:5af5a2d20b36 -o sem-artigo.pdf
+```
+
+Use os IDs retornados pelo seu próprio `inspect`. Eles podem mudar quando o registro é alterado ou ganha duplicatas. As opções `--exclude` e `--exclude-id` podem ser repetidas para remover mais itens.
+
+## Guardar suas preferências
+
+Edite o preset copiado ou crie um `profile.yaml` com apenas as escolhas de que precisa:
+
+```yaml
+include: [profile, education, experience, publications]
+exclude: [publications.press]
+order: [profile, experience, education, publications]
+theme: garamond
+
+sections:
+  education:
+    title: Formação acadêmica
+    show_advisors: false
+  publications.articles:
+    show_authors: true
+    show_links: true
+```
+
+Para guardar exclusões individuais, acrescente `exclude_ids` com os IDs do `inspect`:
+
+```yaml
+exclude_ids:
+  - publications.articles:5af5a2d20b36
+```
+
+Depois, aplique o arquivo:
+
+```bash
+lattes2pdf render curriculo.xml --profile profile.yaml -o personalizado.pdf
+```
+
+Descubra os nomes das seções e as opções disponíveis sem precisar conhecer os atributos internos do XML:
+
+```bash
+lattes2pdf sections
+lattes2pdf sections education
+lattes2pdf sections publications.articles
+```
+
+Um `--profile` explícito substitui o preset padrão. As opções da linha de comando substituem as correspondentes no perfil. Para filtros por ano, ordenação e outros ajustes, consulte `lattes2pdf render --help`. Use `--force` quando quiser substituir saídas existentes.
+
+## Personalizar um tema
+
+Copie o Garamond para uma pasta editável:
+
+```bash
+lattes2pdf theme garamond -o meu-tema
+lattes2pdf render curriculo.xml --profile profile.yaml \
+  --theme meu-tema/design.yaml -o meu-cv.pdf
+```
+
+Edite `design.yaml` para ajustar fonte, margens e espaçamentos; os templates permitem alterar a composição das entradas. Para usar um tema externo, forneça um YAML com o mapa `design` e mantenha a pasta do tema e suas fontes ao lado dele, conforme a [estrutura de temas do RenderCV](https://docs.rendercv.com/user_guide/how_to/override_default_templates/).
+
+Você também pode salvar `theme: meu-tema/design.yaml` no perfil. Nesse caso, o caminho é relativo ao `profile.yaml`.
+
+## Exportação e limites
+
+Para gerar somente o YAML e o relatório, use `lattes2pdf export curriculo.xml -o cv.yaml`. O modo `--full` inclui todos os registros e detalhes conhecidos permitidos pela ferramenta, podendo produzir um documento extenso; ele não é um preset de apresentação e não aceita filtros de seleção.
+
+Dados privados, como documentos pessoais e endereço residencial, não são exportados. Conteúdo desconhecido e omissões aparecem no relatório; no modo `--full`, campos não mapeados impedem a exportação por padrão.
+
+A integração atual usa RenderCV 2.8. Veja [como contribuir](https://github.com/mpds/lattes2pdf/blob/main/CONTRIBUTING.md) e a [licença MIT](https://github.com/mpds/lattes2pdf/blob/main/LICENSE).

lattes2pdf-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "lattes2pdf"
+version = "0.1.0"
+description = "Seleção e conversão de currículos Lattes para RenderCV"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE"]
+dependencies = [
+    "defusedxml>=0.7.1,<1",
+    "PyYAML>=6.0.2,<7",
+    "rendercv[full]>=2.8,<2.9",
+]
+
+[project.scripts]
+lattes2pdf = "lattes2pdf.cli:main"
+
+[project.urls]
+Repository = "https://github.com/mpds/lattes2pdf"
+Issues = "https://github.com/mpds/lattes2pdf/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/lattes2pdf"]
+core-metadata-version = "2.4"
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/tests", "/pyproject.toml", "/LICENSE", "/README.md", "/CONTRIBUTING.md"]
+core-metadata-version = "2.4"
+
+[dependency-groups]
+dev = ["ruff>=0.15,<0.17", "pytest>=8,<10", "build>=1.2,<2", "pypdf>=6,<7", "twine>=6,<7"]
+
+[tool.ruff]
+target-version = "py312"
+extend-exclude = [".local"]
+
+[tool.ruff.lint]
+select = ["E4", "E7", "E9", "F", "I"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

lattes2pdf-0.1.0/src/lattes2pdf/__init__.py

@@ -0,0 +1 @@
+"""Read, select, and export Lattes curricula."""