Curso de Raku / Avanzado / Pruebas y documentación 🆕 / Documentar código / Exercises / Una sección Pod

Solución: Una sección Pod

Aquí tienes una posible solución a la tarea.

Código

=begin pod

=head1 My Module

This module does something useful.

=end pod

say $=pod[0].contents.elems;

🦋 Puedes encontrar el código fuente en el archivo a-pod-section.raku.

Salida

2

Comentarios

  1. $=pod contiene el Pod del archivo como una lista de bloques; $=pod[0] es el único bloque =begin pod.

  2. Su .contents son los bloques anidados dentro de él — el encabezado =head1 y el párrafo — así que .contents.elems es 2. Recorrer la estructura de esta manera es como un programa lee su propia documentación como datos.

Una sección Pod   |   Objetos, entrada/salida y excepciones