Loading repository data…
Loading repository data…
sunr4y / repository
Guía práctica para desarrolladores Python que migran a SAP ABAP Cloud. Comparativas Python vs ABAP Cloud, ejemplos y PDF generado con Typst.
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
Guía práctica de transición para desarrolladores que vienen de Python hacia SAP ABAP Cloud.
Este repositorio publica el material de forma progresiva: conceptos, comparativas Python / ABAP Cloud, legado ABAP clásico y generación de PDF con Typst. Los capítulos viven en typst/sections/. La guía en PDF está en la raíz de main (python-a-abap-vX.Y.Z.pdf, generado por el workflow al publicar un tag) y en GitHub Releases.
build.py y GitHub Actions.| Origen | Archivo |
|---|---|
Última versión en main | python-a-abap-vX.Y.Z.pdf en la raíz (según VERSION; lo sube el bot al publicar el tag) |
| Histórico | Releases |
El PDF de la raíz no se commitea a mano: build.py en local escribe en .build/ (ignorado por git). En CI y al publicar un tag, el PDF se genera en la raíz y el workflow release.yml lo commitea.
python-to-sap-abap-cloud/
VERSION # SemVer de la guía (p. ej. 0.1.0)
python-a-abap-vX.Y.Z.pdf # PDF actual en main (solo vía workflow)
build.py
.build/ # PDF local (gitignored)
typst/
fonts/ # DejaVu (misma tipografía local y CI)
_style.typ
_cover.typ
_toc.typ
sections/ # capítulos publicados
highlight/
media/
.github/workflows/
ci.yml
release.yml
Requisitos: Python 3 y Typst instalado y accesible (en el PATH o vía ). Sin Typst solo se generará , pero el PDF no podrá compilarse.
TYPST_PATHtypst/main-publish.typpython build.py
typst/main-publish.typ con todas las secciones de typst/sections/.VERSION y genera .build/python-a-abap-vX.Y.Z.pdf (no se incluye en commits).GUIDE_PDF_PUBLISH=1, el PDF se escribe en la raíz del repo.typst compile usa --root en la raíz del repo para resolver typst/highlight/ y las secciones.
| Opción | Efecto |
|---|---|
--no-pdf | Solo genera main-publish.typ |
Publicar una nueva versión
VERSION (p. ej. 0.1.0 → 0.2.0).python build.pymain (sin el PDF local de .build/).v0.2.0 y git push origin v0.2.0 → el workflow compila, commitea python-a-abap-v0.2.0.pdf en la raíz de main y lo adjunta al GitHub Release..github/workflows/ci.yml en cada PR y push a main: Typst 0.13.1 y python build.py. Comprueba que el material compila. No commitea PDF ni crea Release.
| Tipo | Ejemplo | Uso |
|---|---|---|
| PATCH | 0.1.0 → 0.1.1 | Correcciones |
| MINOR | 0.1.0 → 0.2.0 | Capítulos nuevos |
| MAJOR | → 1.0.0 | Hito guía completa |
.github/workflows/release.yml se ejecuta al pushear un tag v*.*.*: compila el PDF, lo commitea en la raíz de main y lo publica en Releases.
Una guía útil, pública y mantenible para quien quiera dar el salto de Python al ecosistema SAP ABAP Cloud con enfoque práctico.